feat: add verticalTitle option in book spine.

Also, adding more examples in both docs and comments.
BITNP · Sep 15, 2022 · 411cedf · 411cedf
1 parent 74a2780
commit 411cedf
Show file tree

Hide file tree

Showing 6 changed files with 76 additions and 57 deletions.
diff --git a/bithesis.dtx b/bithesis.dtx
@@ -487,6 +487,28 @@
 %   论文标题。
 % \end{function}
 %
+% \begin{function}{info/verticalTitle}
+%   \begin{bitsyntax}[emph={[1]verticalTitle}]
+%     verticalTitle = (*\marg{字符串}*)
+%   \end{bitsyntax}
+%
+%   书籍页竖排标题。此选项默认为空。为空时，会被 \kvopt{info/title}{字符串} 替代。
+%
+%   如想要使用竖排英文，可以使用 \lstinline|{X }|。其中 X 为英文字符，每个竖排英文间需要空一格。
+%   比如，想要竖排「LaTeX」，可以使用：
+%
+%   \begin{latex}[emph={[1]}]
+%      verticalTitle = {其他文字{L } {a } {T } {e } {X }其他文字}
+%   \end{latex}
+%
+%   如果想要使用旋转竖排英文，可以使用 \lstinline|\rotatebox[origin=c]{-90}{English text}|。
+%
+%   \begin{latex}[emph={[1]}]
+%      verticalTitle = {其他文字 \lstinline{\rotatebox[origin=c]{-90}{English text}} 其他文字}
+%   \end{latex}
+%
+% \end{function}
+%
 % \begin{function}{info/school,info/schoolEn}
 %   \begin{bitsyntax}[emph={[1]school,schoolEn}]
 %     school = (*\marg{字符串}*)
@@ -1590,6 +1612,7 @@
   {
     title .tl_set:N = \l_@@_value_title_tl,
     titleEn .tl_set:N = \l_@@_value_title_en_tl,
+    verticalTitle .tl_set:N = \l_@@_value_vertical_title_tl,
     school .tl_set:N = \l_@@_value_school_tl,
     major .tl_set:N = \l_@@_value_major_tl,
     author .tl_set:N = \l_@@_value_author_tl,
@@ -2184,7 +2207,7 @@
     \setstretch{1.1}
     \begin{minipage}[t][19.7cm]{2em}
       \begin{center}
-        {\heiti\zihao{3}\l_@@_value_title_tl}
+        {\heiti\zihao{3} \tl_if_blank:VTF \l_@@_value_vertical_title_tl {\l_@@_value_title_tl}{\l_@@_value_vertical_title_tl}}
           \vfill
         {\heiti\zihao{3}\l_@@_value_author_tl}
           \vfill
@@ -5026,3 +5049,4 @@ footskip=0.7cm% 页脚 1.8cm %
 %  TeX-master: t
 %  End:
 % \fi
+
diff --git a/templates/graduate-thesis/bithesis.cls b/templates/graduate-thesis/bithesis.cls
@@ -39,15 +39,12 @@
 \seq_new:N \l__bithesis_right_seq
 \seq_new:N \l__bithesis_left_seq
 
-
 \cs_generate_variant:Nn \tl_if_empty:nTF {x}
 \cs_generate_variant:Nn \seq_set_split:Nnn {Nnx}
-
 \cs_new:Npn \__bithesis_same_page: {
   \let\clearpage\relax
   \let\cleardoublepage\relax
 }
-
 \cs_new:Npn \__bithesis_if_graduate:TF #1#2 {
     \int_compare:nNnTF {3} < {\g__bithesis_thesis_type_int}
       {#1}
@@ -88,6 +85,16 @@
     \tl_const:cn { c__bithesis_ #1 _label_ #2 _en_tl } {#4}
   }
 
+\cs_new:Npn \smallgap: {
+  \hspace{0.45ex}
+}
+
+\cs_new:Npn \label_space: {
+  \__bithesis_if_bachelor_thesis:T {
+    \quad
+  }
+}
+
 \clist_map_inline:nn
   {
     {code} {代码},
@@ -130,16 +137,6 @@
     },
   } {\__bithesis_define_label_by_thesis_type:nnn {bachelor_english} #1}
 
-\cs_new:Npn \smallgap: {
-  \hspace{0.45ex}
-}
-
-\cs_new:Npn \label_space: {
-  \__bithesis_if_bachelor_thesis:T {
-    \quad
-  }
-}
-
 \clist_map_inline:nn
   {
     {originality} {研究成果声明},
@@ -253,6 +250,7 @@
   {
     title .tl_set:N = \l__bithesis_value_title_tl,
     titleEn .tl_set:N = \l__bithesis_value_title_en_tl,
+    verticalTitle .tl_set:N = \l__bithesis_value_vertical_title_tl,
     school .tl_set:N = \l__bithesis_value_school_tl,
     major .tl_set:N = \l__bithesis_value_major_tl,
     author .tl_set:N = \l__bithesis_value_author_tl,
@@ -784,7 +782,7 @@
     \setstretch{1.1}
     \begin{minipage}[t][19.7cm]{2em}
       \begin{center}
-        {\heiti\zihao{3}\l__bithesis_value_title_tl}
+        {\heiti\zihao{3} \tl_if_blank:VTF \l__bithesis_value_vertical_title_tl {\l__bithesis_value_title_tl}{\l__bithesis_value_vertical_title_tl}}
           \vfill
         {\heiti\zihao{3}\l__bithesis_value_author_tl}
           \vfill

diff --git a/templates/graduate-thesis/main.tex b/templates/graduate-thesis/main.tex
@@ -35,6 +35,9 @@
     classification = TQ028.1,
     UDC = 540,
     title = 形状记忆聚氨酯的合成及其在织物中的应用,
+    % 如需覆盖竖排标题，请配置以下选项。
+    % 下面的例子展示了如何在竖排标题中使用垂直或者旋转的英文。
+    % verticalTitle = {形状记忆聚氨酯{L } {T } {X }的合成 \rotatebox[origin=c]{-90}{Feng Kaiyu} 及其在织物中的应用},
     titleEn = Synthesisand Application on textile of the Shape Memory Polyurethane,
     author = 张三,
     major = 材料科学与工程,

diff --git a/templates/paper-translation/bithesis.cls b/templates/paper-translation/bithesis.cls
@@ -39,15 +39,12 @@
 \seq_new:N \l__bithesis_right_seq
 \seq_new:N \l__bithesis_left_seq
 
-
 \cs_generate_variant:Nn \tl_if_empty:nTF {x}
 \cs_generate_variant:Nn \seq_set_split:Nnn {Nnx}
-
 \cs_new:Npn \__bithesis_same_page: {
   \let\clearpage\relax
   \let\cleardoublepage\relax
 }
-
 \cs_new:Npn \__bithesis_if_graduate:TF #1#2 {
     \int_compare:nNnTF {3} < {\g__bithesis_thesis_type_int}
       {#1}
@@ -88,6 +85,16 @@
     \tl_const:cn { c__bithesis_ #1 _label_ #2 _en_tl } {#4}
   }
 
+\cs_new:Npn \smallgap: {
+  \hspace{0.45ex}
+}
+
+\cs_new:Npn \label_space: {
+  \__bithesis_if_bachelor_thesis:T {
+    \quad
+  }
+}
+
 \clist_map_inline:nn
   {
     {code} {代码},
@@ -130,16 +137,6 @@
     },
   } {\__bithesis_define_label_by_thesis_type:nnn {bachelor_english} #1}
 
-\cs_new:Npn \smallgap: {
-  \hspace{0.45ex}
-}
-
-\cs_new:Npn \label_space: {
-  \__bithesis_if_bachelor_thesis:T {
-    \quad
-  }
-}
-
 \clist_map_inline:nn
   {
     {originality} {研究成果声明},
@@ -253,6 +250,7 @@
   {
     title .tl_set:N = \l__bithesis_value_title_tl,
     titleEn .tl_set:N = \l__bithesis_value_title_en_tl,
+    verticalTitle .tl_set:N = \l__bithesis_value_vertical_title_tl,
     school .tl_set:N = \l__bithesis_value_school_tl,
     major .tl_set:N = \l__bithesis_value_major_tl,
     author .tl_set:N = \l__bithesis_value_author_tl,
@@ -784,7 +782,7 @@
     \setstretch{1.1}
     \begin{minipage}[t][19.7cm]{2em}
       \begin{center}
-        {\heiti\zihao{3}\l__bithesis_value_title_tl}
+        {\heiti\zihao{3} \tl_if_blank:VTF \l__bithesis_value_vertical_title_tl {\l__bithesis_value_title_tl}{\l__bithesis_value_vertical_title_tl}}
           \vfill
         {\heiti\zihao{3}\l__bithesis_value_author_tl}
           \vfill

diff --git a/templates/undergraduate-thesis-en/bithesis.cls b/templates/undergraduate-thesis-en/bithesis.cls
@@ -39,15 +39,12 @@
 \seq_new:N \l__bithesis_right_seq
 \seq_new:N \l__bithesis_left_seq
 
-
 \cs_generate_variant:Nn \tl_if_empty:nTF {x}
 \cs_generate_variant:Nn \seq_set_split:Nnn {Nnx}
-
 \cs_new:Npn \__bithesis_same_page: {
   \let\clearpage\relax
   \let\cleardoublepage\relax
 }
-
 \cs_new:Npn \__bithesis_if_graduate:TF #1#2 {
     \int_compare:nNnTF {3} < {\g__bithesis_thesis_type_int}
       {#1}
@@ -88,6 +85,16 @@
     \tl_const:cn { c__bithesis_ #1 _label_ #2 _en_tl } {#4}
   }
 
+\cs_new:Npn \smallgap: {
+  \hspace{0.45ex}
+}
+
+\cs_new:Npn \label_space: {
+  \__bithesis_if_bachelor_thesis:T {
+    \quad
+  }
+}
+
 \clist_map_inline:nn
   {
     {code} {代码},
@@ -130,16 +137,6 @@
     },
   } {\__bithesis_define_label_by_thesis_type:nnn {bachelor_english} #1}
 
-\cs_new:Npn \smallgap: {
-  \hspace{0.45ex}
-}
-
-\cs_new:Npn \label_space: {
-  \__bithesis_if_bachelor_thesis:T {
-    \quad
-  }
-}
-
 \clist_map_inline:nn
   {
     {originality} {研究成果声明},
@@ -253,6 +250,7 @@
   {
     title .tl_set:N = \l__bithesis_value_title_tl,
     titleEn .tl_set:N = \l__bithesis_value_title_en_tl,
+    verticalTitle .tl_set:N = \l__bithesis_value_vertical_title_tl,
     school .tl_set:N = \l__bithesis_value_school_tl,
     major .tl_set:N = \l__bithesis_value_major_tl,
     author .tl_set:N = \l__bithesis_value_author_tl,
@@ -784,7 +782,7 @@
     \setstretch{1.1}
     \begin{minipage}[t][19.7cm]{2em}
       \begin{center}
-        {\heiti\zihao{3}\l__bithesis_value_title_tl}
+        {\heiti\zihao{3} \tl_if_blank:VTF \l__bithesis_value_vertical_title_tl {\l__bithesis_value_title_tl}{\l__bithesis_value_vertical_title_tl}}
           \vfill
         {\heiti\zihao{3}\l__bithesis_value_author_tl}
           \vfill

diff --git a/templates/undergraduate-thesis/bithesis.cls b/templates/undergraduate-thesis/bithesis.cls
@@ -39,15 +39,12 @@
 \seq_new:N \l__bithesis_right_seq
 \seq_new:N \l__bithesis_left_seq
 
-
 \cs_generate_variant:Nn \tl_if_empty:nTF {x}
 \cs_generate_variant:Nn \seq_set_split:Nnn {Nnx}
-
 \cs_new:Npn \__bithesis_same_page: {
   \let\clearpage\relax
   \let\cleardoublepage\relax
 }
-
 \cs_new:Npn \__bithesis_if_graduate:TF #1#2 {
     \int_compare:nNnTF {3} < {\g__bithesis_thesis_type_int}
       {#1}
@@ -88,6 +85,16 @@
     \tl_const:cn { c__bithesis_ #1 _label_ #2 _en_tl } {#4}
   }
 
+\cs_new:Npn \smallgap: {
+  \hspace{0.45ex}
+}
+
+\cs_new:Npn \label_space: {
+  \__bithesis_if_bachelor_thesis:T {
+    \quad
+  }
+}
+
 \clist_map_inline:nn
   {
     {code} {代码},
@@ -130,16 +137,6 @@
     },
   } {\__bithesis_define_label_by_thesis_type:nnn {bachelor_english} #1}
 
-\cs_new:Npn \smallgap: {
-  \hspace{0.45ex}
-}
-
-\cs_new:Npn \label_space: {
-  \__bithesis_if_bachelor_thesis:T {
-    \quad
-  }
-}
-
 \clist_map_inline:nn
   {
     {originality} {研究成果声明},
@@ -253,6 +250,7 @@
   {
     title .tl_set:N = \l__bithesis_value_title_tl,
     titleEn .tl_set:N = \l__bithesis_value_title_en_tl,
+    verticalTitle .tl_set:N = \l__bithesis_value_vertical_title_tl,
     school .tl_set:N = \l__bithesis_value_school_tl,
     major .tl_set:N = \l__bithesis_value_major_tl,
     author .tl_set:N = \l__bithesis_value_author_tl,
@@ -784,7 +782,7 @@
     \setstretch{1.1}
     \begin{minipage}[t][19.7cm]{2em}
       \begin{center}
-        {\heiti\zihao{3}\l__bithesis_value_title_tl}
+        {\heiti\zihao{3} \tl_if_blank:VTF \l__bithesis_value_vertical_title_tl {\l__bithesis_value_title_tl}{\l__bithesis_value_vertical_title_tl}}
           \vfill
         {\heiti\zihao{3}\l__bithesis_value_author_tl}
           \vfill