From 59302a340cccceacdfd930c9040dfb7d9942b7d9 Mon Sep 17 00:00:00 2001
From: "Y.D.X." <73375426+YDX-2147483647@users.noreply.github.com>
Date: Tue, 9 Jul 2024 01:29:10 +0800
Subject: [PATCH] =?UTF-8?q?doc:=20`appendices/title`=E7=AD=89=E9=80=89?=
 =?UTF-8?q?=E9=A1=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 bithesis-doc.tex                           | 12 ++++++++----
 bithesis.dtx                               |  6 ++++--
 templates/undergraduate-thesis-en/main.tex |  4 ++++
 3 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/bithesis-doc.tex b/bithesis-doc.tex
index 482bc0fa..3acba3f8 100644
--- a/bithesis-doc.tex
+++ b/bithesis-doc.tex
@@ -1140,18 +1140,22 @@ \subsubsection{附录选项}
 
 \begin{function}{appendices/title}
 \begin{bitsyntax}[emph={[1]title}]
-title = (*(附录)|\meta{字符串}*)
+title = (*\meta{字符串}*)
 \end{bitsyntax}
 
- 可以覆盖附录的标题名称，默认为「附录」。
+  附录部分的总标题。默认会按论文类型自动设置为「附录」、「附\quad{}录」或“Appendices”。
+
+  仅在 |appendices/chapterLevel| 为 |false| 时有效。
 \end{function}
 
 \begin{function}{appendices/TOCTitle}
 \begin{bitsyntax}[emph={[1]TOCTitle}]
-TOCTitle = (*(附录)|\meta{字符串}*)
+TOCTitle = (*\meta{字符串}*)
 \end{bitsyntax}
 
- 可以覆盖附录在目录中的名称，默认为「附录」。
+  附录在目录中的名称。默认会按论文类型自动设置为「附录」、「附\quad{}录」或“Appendices”。
+
+  仅在 |appendices/chapterLevel| 为 |false| 时有效。
 \end{function}
 
 \subsubsection{攻读学位期间发表论文与研究成果清单选项}
diff --git a/bithesis.dtx b/bithesis.dtx
index b6413537..6ea8fe9a 100644
--- a/bithesis.dtx
+++ b/bithesis.dtx
@@ -491,10 +491,12 @@
     {toc} {目\label_space: 录} {Table~of~Contents},
     {abstract} {摘\label_space: 要} {Abstract},
     {conclusion} {结\label_space: 论} {Conclusions},
+    % 附录部分的总标题
     {appendix} {附\label_space: 录} {Appendices},
     {ack} {致\label_space: 谢} {Acknowledgement},
     {figure} {插\label_space: 图} {Illustrations},
     {table} {表\label_space: 格} {Tables},
+    % 附录下各部分编号的前缀
     {appendix_prefix} {附录} {Appendix},
     {reference} {参考文献} {References},
     {university} {北京理工大学} {Beijing~Institute~of~Technology},
@@ -2954,7 +2956,7 @@
     }
 
     \bool_if:NTF \l_@@_appendices_chapter_level_bool {
-      % 附录章节级别
+      % 使用以「chapter」为顶层的附录格式
 
       % 仅设置 \setcounter{chapter}{0} 时，pdf 目录会索引到正文章节。
       % 因此，需要使用 \appendix 重置计数器，并将附录后面的
@@ -2973,7 +2975,7 @@
         \Alph{chapter}
       }
     } {
-      % 附录节（section）级别
+      % 使用以「section」为顶层的附录格式
 
       % 因为不需要用到 chapter counter, 所以直接加一即可。
       \stepcounter{chapter}
diff --git a/templates/undergraduate-thesis-en/main.tex b/templates/undergraduate-thesis-en/main.tex
index 73c9a5d7..cdf9e112 100644
--- a/templates/undergraduate-thesis-en/main.tex
+++ b/templates/undergraduate-thesis-en/main.tex
@@ -72,6 +72,10 @@
     % 若要将封面的“Degree:”改为“Major:”，请解除下一行的注释。
     % info/major = {Major},
   },
+  %
+  % 若要将“Appendices”改为单数，请解除以下两行的注释：
+  % appendices/title = {Appendix},
+  % appendices/TOCTitle = {Appendix},
 }
 
 % 使用 listings 宏包进行代码块使用，并使用了预定义的样式，