njuthesis.dtx

% \end{function}
%
% \begin{function}[updated=2021-10-01]{info/student-id}
%   \begin{syntax}
%     student-id = \Arg{学号}
%   \end{syntax}
% 学号。南京大学本科生为9位数字学号，研究生为两位大写字母标识加上八位数字组成的学号。
% \end{function}
%
% \begin{function}[updated=2021-10-01]{info/author,info/author*}
%   \begin{syntax}
%     author  = \Arg{你的名字}
%     author* = \Arg{姓名拼音}
%   \end{syntax}
% 姓名。
% \end{function}
%
% \begin{function}[updated=2021-10-01]{info/department,info/department*}
%   \begin{syntax}
%     department  = \Arg{院系}
%     department* = \Arg{院系}
%   \end{syntax}
% 院系。
% \end{function}
%
% \begin{function}[updated=2021-10-01]{info/major,info/major*}
%   \begin{syntax}
%     major  = \Arg{专业}
%     major* = \Arg{专业}
%   \end{syntax}
% 专业。
% \end{function}
%
% \begin{function}[updated=2021-10-01]{info/field,info/field*}
%   \begin{syntax}
%     field = \Arg{方向}
%     field* = \Arg{方向}
%   \end{syntax}
% 研究领域。只有研究生存在研究领域的说法，本科生无需填写。
% \end{function}
%
% \begin{function}[updated=2022-01-12]{info/supervisor,info/supervisor*}
%   \begin{syntax}
%     supervisor = \Arg{导师姓名,职称}
%     supervisor* = \Arg{导师英文全称}
%   \end{syntax}
% 导师全称。请使用逗号（ |,| ）分隔导师的中文姓名与职称，英文名则不需添加逗号。
% \end{function}
%
% \begin{function}[updated=2021-01-12]{info/supervisor-ii,info/supervisor-ii*}
%   \begin{syntax}
%     supervisor-ii = \Arg{第二导师姓名,职称}
%     supervisor-ii* = \Arg{第二导师英文全称}
%   \end{syntax}
% 第二导师全称。无第二导师时不填即可。
% \end{function}
%
% \begin{function}[updated=2022-01-14]{info/submit-date}
%   \begin{syntax}
%     submit-date = \Arg{yyyy-mm-dd}
%   \end{syntax}
% 提交日期。中英文日期现在可以由 ISO 日期格式\cite{gb-t-7408-2005}的字符串统一生成。如果留空，则自动使用编译当天日期。
% \end{function}
%
% \begin{function}[updated=2021-01-14]{info/defend-date}
%   \begin{syntax}
%     defend-date = \Arg{yyyy-mm-dd}
%   \end{syntax}
% 答辩日期，只对研究生有效，要求同提交日期。
% \end{function}
%
% \begin{function}[updated=2021-10-01]{info/chairman,info/reviewer}
%   \begin{syntax}
%     chairman = \Arg{答辩主席}
%     reviewer = \Arg{评委姓名职称}
%   \end{syntax}
% 答辩委员会信息，分别为评审委员会主席及四位成员的姓名加职称，只对研究生有效。四位评审成员是以列表的形式存储的，填写方法同关键词。如果是盲审，填入“盲审”二字即可。
% \end{function}
%
% \begin{function}[updated=2021-10-01]{info/clc,info/secret-level,info/udc,info/supervisor-contact}
%   \begin{syntax}
%     clc = \Arg{中图分类号}
%     secret-level = <不涉密|秘密|机密|绝密>
%     udc = \Arg{udc}
%     supervisor-contact = \Arg{导师联系方式}
%   \end{syntax}
% 国家图书馆封面相关，包括中图分类号、密级、UDC 分类号和导师联系方式。
% \end{function}
%
% \begin{function}{info/titlea,info/titleb,info/titlec,info/supervisora,info/supervisora*,info/supervisora-title,info/supervisora-title*,info/supervisorb,info/supervisorb*,info/supervisorb-title,info/supervisorb-title*}
% 这些选项已在 v0.13 弃置，请不要使用。
% \end{function}
%
% \begin{function}{info/supervisor-title,info/supervisor-title*,info/supervisor-ii-title,info/supervisor-ii-title*,info/submit-date*}
% 这些选项已在 v0.14 弃置，请不要使用。
% \end{function}
%
%
% \subsubsection{输入示范}
%
% 本科生可以参考如下范例输入个人信息。注意不能有空行。
%
% \begin{latexexample}[moretexcs={\njusetup},emph={[2]info}]
%   \njusetup {
%       info = {
%           title = {第一行标题\\第二行标题},
%           title* = {My title in English},
%           keywords = {我,就是,充数的,关键词},
%           keywords* = {Dummy,Keywords,Here,{it is}},
%           grade = {2018},
%           student-id = {189114514},
%           author = {周煜华},
%           author* = {Zhou Yuhua},
%           department = {化学化工学院},
%           department* = {School of Chemistry and Chemical Engineering},
%           major = {化学},
%           major* = {Chemistry},
%           supervisor = {李成殿,教授},
%           supervisor*= {Professor Li Chengdian},
%           submit-date = {2021-09-12}
%         }
%     }
% \end{latexexample}
%
% 研究生可以参考如下列表输入个人信息
%
% \begin{latexexample}[moretexcs={\njusetup},emph={[2]info}]
%   \njusetup {
%       info = {
%           title = {第一行标题\\第二行标题\\第三行标题},
%           title* = {My title in English},
%           keywords = {我,就是,充数的,关键词},
%           keywords* = {Dummy,Keywords,Here,{it is}},
%           grade = {2018},
%           student-id = {DZ18114514},
%           author = {周煜华},
%           author* = {Zhou Yuhua},
%           department = {化学化工学院},
%           department* = {School of Chemistry and Chemical Engineering},
%           major = {化学},
%           major* = {Chemistry},
%           field = {物理化学},
%           field* = {Physical Chemistry},
%           supervisor = {李成殿,教授},
%           supervisor*= {Professor Li Chengdian},
%           submit-date = {2021-09-12},
%           defend-date = {2022-01-15},
%           chairman = {张晓山~教授},
%           reviewer = {王瑞希~教授,郭德纲~副教授,华芈库~教授,戴菲菲~教授},
%           clc = {0175.2},
%           secret-level = {限制},
%           udc = {004.72},
%           supervisor-contact = {拉太赫科学与技术学院 枝江市结丘路 19 号 114514}
%         }
%     }
% \end{latexexample}
%
%
% \subsection{编写正文}
%
% 与导言区相对的是正文，位于 \env{document} 环境内。
%
% \begin{function}{\mainmatter}
%   \cs{mainmatter} 标志着正文的开始，使用阿拉伯数字重新进行页码编号，并设置页眉格式。
% \end{function}
%
% \begin{function}{\chapter,\section,\subsection,\subsubsection}
%   \begin{syntax}
%     \tn{chapter}\oarg{短描述}\marg{完整的章标题}
%     \tn{section}\oarg{短描述}\marg{完整的节标题}
%     \tn{subsection}\oarg{短描述}\marg{完整的节标题}
%     \tn{subsection}\oarg{短描述}\marg{完整的节标题}
%   \end{syntax}
% 对于过长的标题，目录和页眉中会使用其短描述。
% \end{function}
%
% \begin{function}{\chaptermark,\sectionmark}
%   \begin{syntax}
%     \tn{chapter}\oarg{用在页眉的章标题}\marg{完整的章标题}
%     \tn{sectionmark}\marg{用在目录的章标题}
%     \tn{section}\oarg{用在页眉的章标题}\marg{完整的节标题}
%     \tn{sectionmark}\marg{用在目录节标题}
%   \end{syntax}
% 如果页眉内容发生了冲突，可使用这两个命令细化定制。
% \end{function}
%
%
% \subsubsection{页面}
%
% 在本模板预定义的页面样式中：本科生使用 \opt{plain} 样式，无页眉，
% 页面编号使用五号罗马体，居中位于页脚；研究生使用 \opt{headings} 样式，
% 页眉使用五号楷体，包括章名（奇数页右侧）和节名（偶数页左侧），
% 页面编号使用五号罗马体，居中位于页脚。在单面模式下，页眉会同时显示章节名。
%
% 考虑到各个院系对于页眉内容的规定并不一致，本模板提供了若干个自定义选项。
%
% \begin{function}{style/header/format,style/footer/format,
%   style/header,style/header*,style/footer,style/footer*}
%   \begin{syntax}
%     header/format = \Arg{格式}
%     footer/format = \Arg{格式}
%     header  = \{\Arg{位置}\Arg{内容},\Arg{位置}\Arg{内容},...\}
%     header* = \{\Arg{位置}\Arg{内容},\Arg{位置}\Arg{内容},...\}
%     footer  = \{\Arg{位置}\Arg{内容},\Arg{位置}\Arg{内容},...\}
%     footer* = \{\Arg{位置}\Arg{内容},\Arg{位置}\Arg{内容},...\}
%   \end{syntax}
% 页眉页脚的格式与内容设置。带有星号的设置项供单面模式下使用。
% \end{function}
%
% 页眉页脚的内容设置是一个逗号分隔的列表，实际上是 \cs{fancyhead} 和
% \cs{fancyfoot} 命令的选项。前一个花括号内为大写字母指定的位置选项，
% 可使用左（\opt{L}）、中（\opt{C}）、右（\opt{R}）。
% 双面模式下可额外指定出现在奇数页（\opt{O}）还是偶数页（\opt{E}）。
% 详细说明请参考 \pkg{fancyhdr} 的手册。
%
% 接下来展示了一个手动设置页眉内容的例子。这里我们清空了页脚，
% 并将页眉格式设置成五号黑体，奇数页左侧为节名，右侧为页码，
% 偶数页左侧为页码，右侧为章名。
% \begin{latexexample}[moretexcs={\njusetup,\sffamily},emph={[2]style}]
%   \njusetup {
%       style = {
%           header/format = \small \sffamily,
%           header = {
%               { OR } { \thepage }, { OL } { \rightmark },
%               { EL } { \thepage }, { ER } { \leftmark  }
%             },
%           footer = {},
%         }
%     }
% \end{latexexample}
%
%
% \subsubsection{文字}
%
% \begin{function}{\songti,\heiti,\kaishu,\fangsong,\zihao}
%   \begin{syntax}
%     \tn{zihao}\Arg{字号}
%   \end{syntax}
% 字形与字号设置。
% \end{function}
%
% 本模板继承 \pkg{ctex} 宏集提供的字形字号设置，以备不时之需。换句话说，
% 除非你有十足的把握，认为某处字体产生了偏差\footnote{在此情况下也应当直接到
% GitHub 反馈}，否则无需动用这些命令处理样式问题。
%
% \begin{function}[added=2021-09-22]{\njuline}
%   \begin{syntax}
%     \tn{njuline}\Arg{文字}
%   \end{syntax}
% 为了避免原生\tn{uline}命令在中文环境下不能正常换行的问题，本模板使用\tn{njuline}作为替代方案，分别对 \hologo{XeLaTeX} 的 \pkg{xeCJKfntef} 包和 \hologo{LuaLaTeX} 的 \pkg{lua-ul} 包中的下划线命令进行了包装。
% \end{function}
%
% \begin{function}{\footnote}
%   \begin{syntax}
%     \tn{footnote}\Arg{脚注}
%   \end{syntax}
% 添加脚注。
% \end{function}
%
%
% \subsubsection{图片}
%
% \begin{function}{\graphicspath}
%   \begin{syntax}
%     \tn{graphicspath}\{\marg{路径1}\marg{路径2}\}
%   \end{syntax}
% 添加图像路径。
% \end{function}
%
% \pkg{graphicx} 宏包会对一些常见路径进行搜索。使用自己的图片时，如果提示不能找到文件，需要在导言区通过本命令添加图片存放路径。
%
% 在使用特定类型的图片文件时，可以省略其扩展名，包括 \file{*.jpg}, \file{*.png}, \file{*.pdf}, \file{*.eps}。
%
%
% \paragraph{图片}
%
% 下面这个例子展示了如何插入一张名称为 \file{myfig.jpg}，宽度占页面文字宽度一半的图片。注意标签命令 \tn{label} 必须放在图注命令 \tn{caption} 之后。
% \begin{latexexample}[moretexcs={\includegraphics},emph={[1]figure}]
%   \begin{figure}[h]
%       \centering
%       \includegraphics[width=0.5\textwidth]{myfig}
%       \caption{我的图}
%       \label{fig:myfig}
%   \end{figure}
% \end{latexexample}
%
% \emph{以下图片相关功能的实现均需要手动载入相关宏包}。
%
%
% \paragraph{文字环绕}
%
% 对于较为瘦长，或者仅起到辅助作用的图像，可以使用 \pkg{wrapfig} 宏包提供的 \env{wrapfigure} 实现文字环绕效果。注意这个环境后紧跟的一行不能为空。
% \begin{latexexample}[moretexcs={\includegraphics},emph={[1]wrapfigure}]
%   \begin{wrapfigure}{r}{0cm}
%       \centering
%       \includegraphics[width=0.15\textwidth]{myfig}
%       \caption{我的图}
%       \label{fig:myfig}
%   \end{wrapfigure}
%   <text>
% \end{latexexample}
%
%
% \paragraph{多张嵌套}
%
% 使用 \pkg{subcaption} 宏包提供的 \env{subfigure} 环境可以实现多张图片嵌套的效果。
% \begin{latexexample}[moretexcs={\includegraphics},emph={[1]figure,subfigure}]
%   \begin{figure}
%       \begin{subfigure}{.32\textwidth}
%          \centering
%          \includegraphics[width=\textwidth]{fig1}
%          \caption{fig1}
%       \end{subfigure}
%       \begin{subfigure}{.32\textwidth}
%          \centering
%           \includegraphics[width=\textwidth]{fig2}
%           \caption{fig2}
%       \end{subfigure}
%       \begin{subfigure}{.32\textwidth}
%           \centering
%           \includegraphics[width=\textwidth]{fig3}
%           \caption{fig3}
%       \end{subfigure}
%       \caption{subfigures}
%   \end{figure}
% \end{latexexample}
%
% 请尽量避免使用较为老旧的 \pkg{subfig} 宏包，完全不要使用过时的 \pkg{subfigure} 宏包。两者的 CTAN 页面上均建议转移至更新的 \pkg{subcaption} 宏包。
%
%
% \subsubsection{表格}
%
% 下面这个例子展示了如何插入一张表格。通过 \pkg{booktabs} 宏包提供的 \tn{toprule}、\tn{midrule} 和 \tn{bottomrule} 命令，我们可以很轻松地绘制出一张漂亮规范的三线表。
% \begin{latexexample}[moretexcs={\toprule,\midrule,\bottomrule},emph={[1]table,tabular}]
%   \begin{table}[htbp]
%       \centering
%       \caption{我的表}
%       \label{tab:testtab}
%       \begin{tabular}{ccc}
%           \toprule
%           OS & TeX & 测试情况 \\
%           \midrule
%           南大TeX & Overleaf & √ \\
%           \bottomrule
%       \end{tabular}
%   \end{table}
% \end{latexexample}
%
% \emph{以下表格功能的实现均需要手动载入相关宏包。}
%
%
% \paragraph{合并单元格}
%
% \begin{function}{\multirow,\multicolumn}
%   \begin{syntax}
%     \tn{multirow}\Arg{nrows}\oarg{bigstructs}\Arg{width}\oarg{fixup}\Arg{text}
%     \tn{multicolumn}\Arg{nrows}\Arg{width}\Arg{text}
%   \end{syntax}
% 合并单元格。
% \end{function}
%
% TODO：\pkg{multirow} 宏包的使用方法，命令较为复杂。
% \url{http://www.ctex.org/documents/packages/table/multirow.htm}
%
%
% \paragraph{更多样式}
%
% \pkg{tabularray} 宏包\cite{tabularray}运用 \hologo{LaTeX3} 语法重新实现了表格的绘制，提供了简明的用户接口与丰富的单元格样式，详见其使用手册。
%
%
% \subsubsection{数学}
%
% 行内公式形如 |$\mathrm{e}^{(a+2b)x}$|。
%
% 带有编号的行间公式 \env{equation}。
% \begin{latexexample}[emph={[1]equation}]
%   \begin{equation}\label{eq:myeqlabel}
%       \pi
%   \end{equation}
% \end{latexexample}
%
% 如不需要编号，可以用 \env{equation*} 或者 |\[|\meta{公式}|\]|，
% 请不要使用可能引发问题的 |$$|\meta{公式}|$$|\footnote{\url{https://tex.stackexchange.com/questions/503/why-is-preferable-to}}。
%
%
% \paragraph{符号和单位}
%
% 模板使用 \pkg{unicode-math} 配置数学字体，可以替代传统方案下的 \pkg{bm}、
% \pkg{mathrsfs} 等宏包\footnote{\url{https://tex.stackexchange.com/questions/528831/why-doesnt-the-bm-package-work-with-the-unicode-math-package}}。
% 相应地，也需要使用新方案提供的命令。例如，加粗数学符号的命令可以使用
% \tn{symbf}。更多细节请查阅 \pkg{unicode-math} 手册。
%
% 符号表可以参考 \url{https://www.caam.rice.edu/~heinken/latex/symbols.pdf}。
%
% 单位请参考相关国家标准\footnote{GB 3100-1993, GB/T 3101-1993, GB/T 3102-1993}，使用 \pkg{siunitx} 宏包。\pkg{siunitx} 是一个更新频繁的包，可能会引发兼容性问题。
%
%
% \paragraph{定理环境}
%
% 本模板也提供了一系列的数学定理环境。
% 全部预定义的数学定理环境如表~\ref{tab:mathenv} 所示。其中证明环境较为特殊，会在结尾添加证毕符号（\mdwhtsquare）。用户也可以选择使用 \tn{newtheorem} 定义新的定理环境。
%
% \begin{table}[htbp]
%   \centering
%   \caption{数学定理环境}
%   \label{tab:mathenv}
%   \begin{tabular}{cc|cc}
%     \toprule
%     \bf 标签   & \bf 名称 & \bf 标签   & \bf 名称 \\
%     \midrule
%     axiom      & 公理     & lemma      & 引理     \\
%     corollary  & 推论     & proof      & 证明     \\
%     definition & 定义     & theorem    & 定理     \\
%     example    & 例       &            &          \\
%     \bottomrule
%   \end{tabular}
% \end{table}
%
% 使用示例如下。
% \begin{latexexample}[emph={[1]proof,definition}]
%   \begin{proof}
%       证明我是我
%   \end{proof}
%
%   \begin{definition}[他人]
%       定义他人即地狱
%   \end{definition}
% \end{latexexample}
%
%
% \subsubsection{代码}
% \changes{v0.13}{2021/12/13}{提供简化的行内代码环境。}
% \changes{v0.13}{2021/12/16}{默认不加载 \pkg{listings} 宏包。}
%
% 如需展示代码，可以使用抄录环境 \tn{verb}，格式如 |\verb!<code>!|。其中包裹代码的两个感叹号并不是绝对的，可以替换成任何两个相同的、没有在这段代码中出现过的符号。
%
% 抄录环境仅会用等宽字体如实呈现代码本身，并无任何附加功能。若需格式更为多样的代码环境，可以使用 \pkg{listings} 宏包。v0.14.0 版以后，本模板默认不会调用该宏包，使用代码环境前请在导言区自行导入。
% \begin{latexexample}
%   \usepackage{listings}
% \end{latexexample}
%
% \pkg{listings} 宏包\cite{listings}提供了 \env{lstlisting} 环境，可以生成代码块，提供语法高亮功能，会如实输出缩进空格。且值得注意的是这个环境中的代码不会在草稿模式下显示。
% 如需指定语言，可以使用 |language| 选项。如需自定义关键字，可以使用 |morekeywords| 选项。这一宏包也提供了为某种样式单独一种环境的方法，详见其手册，此处仅展示一个最简化的例子：
% \begin{latexexample}[emph={[1]lstlisting},emph={[2]language},morekeywords={print}]
%   \begin{lstlisting}[language=python]
%   print("Hello World")
%   \end{lstlisting}
% \end{latexexample}
%
% 当然，默认提供的代码样式在本模板中并不和谐。可以参照以下代码在导言区设置代码环境通用样式。
% \begin{latexexample}[moretexcs={\lstdefinestyle,\lstset},emph={[2]basewidth,lineskip,basicstyle,keywordstyle,commentstyle,numbers,captionpos,breaklines,xleftmargin,xrightmargin,style,flexiblecolumns}]
%   \lstdefinestyle { njulisting }
%     {
%       basewidth    = 0.5 em,               % 单个字体宽度
%       lineskip     = 3 pt,                 % 在代码行间添加额外行距
%       basicstyle   = \tiny\ttfamily,       % 基本字体样式，小号等宽
%       keywordstyle = \bfseries,            % 关键词样式，粗体
%       commentstyle = \itshape\color{gray}, % 注释样式，灰色斜体
%       numbers      = left,                 % 行号位置，左侧
%       captionpos   = t,                    % 题注位置，顶部
%       breaklines   = true,                 % 是否允许自动折行
%       xleftmargin  = 2 em,                 % 左侧边距
%       xrightmargin = 2 em                  % 右侧边距
%     }
%   \lstset{
%       style        = njulisting,           % 调用上述样式
%       flexiblecolumns                      % 允许调整字符宽度
%     }
% \end{latexexample}
%
% \pkg{listings} 同时提供了用于展示行内代码的 \tn{lstinline} 命令，用法同 \tn{verb}。但这一命令会被全局的代码字号设置污染。请参考如下使用方法：
% \begin{latexexample}[moretexcs={\lstinline,\tt},deletetexcs={\usepackage},emph={[2]language,basicstyle}]
%   \lstinline[language=[LaTeX]TeX, basicstyle=\tt]!\usepackage{njuvisual}!
% \end{latexexample}
%
% 简便起见，不妨单独创建使用简写的行内代码环境，指定某个符号后用其包裹代码即可。这个符号不可以出现在正文及其他命令中，请谨慎设置。
% \begin{latexexample}[moretexcs={\lstMakeShortInline},emph={[2]style,basicstyle,columns}]
%   \lstMakeShortInline[
%     style = njulisting,
%     basicstyle = \normalsize\tt,
%     columns = fixed]|
% \end{latexexample}
%
%
% \subsubsection{引用}
%
% \begin{function}{\cref}
%   \begin{syntax}
%     \tn{cref}\Arg{标签}
%   \end{syntax}
% 使用 \pkg{cleveref} 宏包实现了带图、表等项目名称的智能引用。
% \end{function}
%
% \begin{function}{\href,\url}
%   \begin{syntax}
%     \tn{href}\Arg{链接}\Arg{名称}
%     \tn{url}\Arg{链接}
%   \end{syntax}
% 超链接。\tn{href} 会将特定字符显示为可点击的超链接，\tn{url} 会输出可点击的链接原文。
% \end{function}
%
%
% \subsection{参考文献}
%
% 本模板默认载入 \pkg{biblatex} 宏包，使用 \hologo{biber} 作为后端\footnote{出于简化命令的考虑，现阶段并不计划支持 \hologo{BibTeX}。}，通过 \pkg{biblatex-gb7714-2015}\cite{biblatex-gb7714-2015} 实现 GB/T 7714--2015\cite{gb-t-7714-2015} 规定的参考文献著录规则国家标准。
%
% 需要使用 |biber| 命令编译才会显示正确的条目序号，详情请参照 \ref{subsubsec:compileseq}。
%
%
% \subsubsection{选项}
%
% \begin{function}[added=2021-12-19]{bib/style}
%   \begin{syntax}
%     style = <(numeric)|author-year|\meta{自定义样式}>
%   \end{syntax}
% 参考文献样式。可选顺序编码制 \opt{numeric} 和著者-出版年制 \opt{author-year}，
% 或自行填入任意其他 \pkg{biblatex} 样式。默认为顺序编码制。
% \end{function}
%
% 参考文献样式是一个整体的设置，会对正文中引用的文献的标注方法和参考文献表的输出格式产生影响。根据国家规定\cite{gb-t-7714-2015}，可以按照参考文献表的组织方式分为以下两种样式：
% \begin{description}
%   \item[顺序编码制] 顺序编码制是按正文中引用的文献出现的先后顺序连续编码，将序号置于方括号中。参考文献表采用顺序编码制组织时，各篇文献应按正文部分标注的序号依次列出。
%   \item[著者-出版年制] 正文引用的文献采用著者-出版年制时，各篇文献的标注内容由著者姓氏与出版年构成，并置于"()"内。参考文献表采用著者-出版年制组织时，各篇文献首先按文种集中，然后按著者字顺和出版年排列。
% \end{description}
%
% 对于本科生而言，学校规定文件表明参考文献表应当“用数字加方括号
% 表示”\cite{nju2021}，符合顺序编码制的格式，保持默认设置即可。
%
% \begin{function}[added=2022-02-15]{bib/option}
%   \begin{syntax}
%     option = \meta{选项列表}
%   \end{syntax}
% 待传入 \pkg{biblatex} 宏包的额外选项列表。
% \end{function}
%
% 本模板中 \pkg{biblatex} 并不是显式载入的。
% 如需在其基础上进行一些定制，可使用本设置项载入宏包选项\cite{biblatex}。
%
% \begin{function}[added=2021-12-19]{bib/resource}
%   \begin{syntax}
%     resource = \Arg{文件}
%   \end{syntax}
% 参考文献数据源。类似于 \tn{addbibresource} 命令，但可以使用逗号分隔的
% 列表形式。必须使用带扩展名（\file{.bib}）的完整文件名。
% \end{function}
%
% \begin{function}{\addbibresource}
%   \begin{syntax}
%     \tn{addbibresource}\Arg{文件}
%   \end{syntax}
% 添加参考文献源文件。为了与 \pkg{biblatex} 进行兼容，也可使用本命令
% 添加数据源。本命令不支持逗号分隔多个文件的形式，如果希望额外添加参
% 考文献列表，需要在导言区中多次调用。
% \end{function}
%
% 可以参考如下范例进行参考文献设置。
% 其中 \opt{bib/option} 的内容旨在关闭部分不需显示的文献信息，
% 并采取仅首字母大写的作者姓名格式，可根据需要使用。
% \begin{latexexample}[moretexcs={\njusetup},emph={[2]bib}]
%   \njusetup {
%       bib = {
%           style    = author-year,
%           resource = {njuthesis-sample.bib}，
%           option   = {
%               doi    = false,
%               isbn   = false,
%               url    = false,
%               eprint = false,
%               gbnamefmt = lowercase
%             }
%         }
%     }
% \end{latexexample}
%
%
% \subsubsection{参考文献表}
%
% \begin{function}{\printbibliography}
% 生成参考文献表。
% \end{function}
%
% 显然只有被引用过的条目才会被输出至参考文献表。
%
% 假如需要在每章末尾附上单独的参考文献表，导言区添加以下设置，
% 并在每章后使用 \cs{printbibliography} 即可。
% \begin{latexexample}[moretexcs={\njusetup},emph={[2]bib}]
%   \njusetup {
%       bib = { option = { refsection = chapter } }
%     }
% \end{latexexample}
%
% 如果开启了草稿模式，您可能会注意到部分条目存在超宽的问题，这时就要果断假装没有看到。
% 该问题的产生是由于 \hologo{LaTeX} 中只有固定的字母组合中间可以断行。使条目右侧平齐的方法有如下两种
% \footnote{详见 \url{https://github.com/nju-lug/NJUThesis/issues/57}。很不幸，\pkg{microtype} 与 \pkg{babel} 没能在我们的模板中解决问题。}：
% \begin{itemize}
%   \item 自行在 \file{.bib} 文件中设置断行点，例如可以将 graphene 一词修改为 graph|\-|ene。缺点是需要逐条手动排查，建议在定稿时进行修改。
%   \item 在 |\printbibliography| 前添加 |\sloppy| 命令拉伸词间距，缺点是可能降低美观度。
% \end{itemize}
%
%
% \subsubsection{正文引用}
%
% \begin{function}{\cite}
%   \begin{syntax}
%     \tn{cite}\marg{文献}
%     \tn{cite}\oarg{页码}\marg{文献}
%   \end{syntax}
% 在正文中引用参考文献。
% \end{function}
%
% 引用命令 \tn{cite} 含有多个变体，以便使用文献条目中不同的信息域。在两种参考文献样式下，这些命令的行为具体存在一些差异，详见表 \ref{tab:numeric-style} 和表 \ref{tab:author-year-style}。
%
% \begin{table}[ht]
%   \centering
%   \begin{talltblr} [
%       caption = {顺序编码制下的引用样式},
%       label   = {tab:numeric-style} ]
%     { row{1} = {font=\bfseries}, colspec = {cll} }
%     \toprule
%       引用方式 & 命令               &  排版效果                  \\
%     \midrule
%       单篇文献 & \tn{cite}          & 上标可设置页码             \\
%       单篇文献 & \tn{parencite}     & 非上标可设置页码           \\
%       多篇文献 & \tn{cite}          & 上标，逗号隔开或短横线连接 \\
%       标注页码 & \tn{pagescite}     & 上标加自动页码             \\
%       标注作者 & \tn{textcite}      & 作者为主语加非上标编号     \\
%       标注作者 & \tn{authornumcite} & 作者为主语加上标编号       \\
%       完整脚注 & \tn{footfullcite}  & 脚注方式                   \\
%     \bottomrule
%   \end{talltblr}
% \end{table}
%
% \begin{table}[ht]
%   \centering
%   \begin{talltblr} [
%       caption = {著者-出版年制下的引用样式},
%       label   = {tab:author-year-style},
%       note{a} = {在此样式下 \tn{parencite} 效果等同于 \tn{cite}。} ]
%     { row{1} = {font=\bfseries}, colspec = {cll} }
%     \toprule
%       引用方式       & 命令                  & 排版效果                     \\
%     \midrule
%       单篇文献       & \tn{cite}\TblrNote{a} &
%                                              作者加年份用括号包围可设置页码 \\
%       多篇文献       & \tn{cite}             & 分号隔开                     \\
%       标注页码       & \tn{pagescite}        & 作者加年份用括号包围自动页码 \\
%       标注年份       & \tn{yearcite}         & 用括号包围的年份             \\
%       标注年份、页码 & \tn{yearpagescite}    & 提供年份用括号包围自动页码   \\
%       标注作者       & \tn{textcite}         & 作者为主语加加括号包围年份   \\
%       完整脚注       & \tn{footfullcite}     & 脚注方式                     \\
%     \bottomrule
%   \end{talltblr}
% \end{table}
%
%
% \subsubsection{文献管理}
%
% 参考文献数据源理应是通过文献管理软件导出的，而不是逐条手动填写的。
%
% \subparagraph{使用 EndNote}
%
% 南京大学信息化建设管理服务中心已购买 \href{https://itsc.nju.edu.cn/EndNote/list.htm}{EndNote} 供全校师生免费使用，最新版为 EndNote 20。
%
% \subparagraph{使用 JabRef}
%
% \href{https://www.jabref.org/}{JabRef} 是一款开源、跨平台的文献管理软件。
% JabRef 提供了对 \hologo{BibTeX} 和 \pkg{biblatex} 的原生支持，
% 能够直接管理 \file{.bib} 文件， 还可以向 TeXstudio 等外部软件推送引用命令。
%
% \subparagraph{使用 Zotero}
%
% \href{https://www.zotero.org/}{Zotero} 也是一款开源、跨平台的文献管理软件。
% Zotero 更为通用，其功能可以通过 \href{https://github.com/l0o0/jasminum}{Jasminum}、\href{https://github.com/retorquere/zotero-better-bibtex}{Better BibTeX}、\href{https://github.com/bwiernik/zotero-shortdoi}{DOI Manager} 等第三方插件，以及 Zotero Connector 浏览器插件进行增强。
%
%
% \subsection{特殊页面}
%
% 本模板也预定义了一系列用于生成所需的特殊页面的命令与环境。
%
%
% \subsubsection{封面}
%
% \begin{function}{\maketitle}
% 生成封面。
% \end{function}
%
% 本科生模板仅会生成中文封面；研究生模板会生成中英文封面。
% 如果选择了 \opt{nlcover}，\emph{仅仅}会生成研究生的国家图书馆封面。
% 如果选择了 \opt{decl-page}，会在封面后生成本科生的诚信承诺书或研究生的
% 原创性声明。在启用草稿模式后封面绘制将被禁用。
%
% \paragraph{封面图片}
%
% \begin{function}[added=2021-12-23,updated=2022-02-22]{
%   style/emblem-img,style/name-img}
%   \begin{syntax}
%     emblem-img = \Arg{文件}
%     name-img = \Arg{文件}
%   \end{syntax}
% 校名、校徽图片文件路径。
% \end{function}
%
% 通过以上选项可以使用外置的校徽和校名图片，两个选项\emph{任一留空}则不会生效。
% 本模板封面中校徽及校名的绘制默认依赖 \pkg{njuvisual} 宏包提供的 \tikzlogo
% 矢量曲线，耗时较长，在替换为外置图片后可节省约1秒的编译时长。
%
%
% \subsubsection{摘要页}
% \changes{v0.11}{2021/10/01}{简化了摘要的编写方式。}
%
% \begin{function}{abstract,abstract*}
% 摘要。带星号的会生成英文摘要。
% \end{function}
%
% \begin{latexexample}[emph={[1]abstract,abstract*}]
%   \begin{abstract}
%       我的中文摘要
%   \end{abstract}
%
%   \begin{abstract*}
%       Abstract in English
%   \end{abstract*}
% \end{latexexample}
%
% \begin{function}[added=2022-02-04]{style/abstract-in-toc}
%   \begin{syntax}
%     abstract-in-toc = <\TTF>
%   \end{syntax}
% 是否将摘要条目插入目录，默认开启。
% 关闭此选项后摘要页将不会出现在目录中，仅保留其 PDF 书签。
% \end{function}
%
% \begin{function}[added=2022-03-26]{style/abstract-title}
%   \begin{syntax}
%     abstract-title = <(strict)|centered|natural>
%   \end{syntax}
% 选择研究生摘要标题样式。
% 默认为严格模式（\opt{strict}），即完全模仿材料包要求。
% \end{function}
%
% 材料包中的 Word 空白模板仅有两行空白下划线。
% 根据填写习惯的不同，模板预置了三种样式：
% \begin{itemize}
%   \item \opt{strict}，在两行空白下划线上左对齐填写标题。
%         如果该标题不足一行，则第二行下划线留空；
%         如果长度超出两行，则向后延伸并抛出一个警告信息。
%   \item \opt{centered}，将严格模式的左对齐改为居中。
%   \item \opt{natural}，仅居中标题，不做行数检查。
%         本模式更适合较短的题目。
% \end{itemize}
%
% \subsubsection{前言页}
%
% \begin{function}{preface}
% 使用 \env{preface} 环境定义。
% \end{function}
%
% \begin{latexexample}[emph={[1]preface,flushright}]
%   \begin{preface}
%       我的前言
%       \vspace{1cm}
%       \begin{flushright}
%       我的名字\\
%       时间地点
%       \end{flushright}
%   \end{preface}
% \end{latexexample}
%
%
% \subsubsection{目录页}
%
% \begin{function}{\tableofcontents,\listoffigures,\listoftables}
% 分别生成目录、图片目录和表格目录。
% \end{function}
%
% 目录页的标题名称一般无需修改。用户可以选择使用 \pkg{ctex} 宏集提供的 \tn{ctexset} 命令进行自定义。
% \begin{latexexample}[moretexcs={\ctexset},emph={[1]contentsname,listfigurename,listtablename}]
%   \ctexset{
%     contentsname   = { 目\hspace{2em}次 },
%     listfigurename = { 插图清单 },
%     listtablename  = { 表格清单 }
%   }
% \end{latexexample}
% 实际上，根据《学位论文编写规则》国家标准\cite{gb-t-7713.1-2006}，
% 尽管“目录”这一说法已流传甚广，但学位论文中理应使用“目次”这一名称
% 来指代篇目的列表。
%
% \begin{function}[added=2022-02-04]{style/toc-in-toc}
%   \begin{syntax}
%     toc-in-toc = <\TTF>
%   \end{syntax}
% 是否在目录中显示目录自身的条目，默认开启。关闭此选项后目录、
% 插图目录和表格目录将不会出现在目录中，仅保留其 PDF 书签。
% \end{function}
%
%
% \subsubsection{符号表}
%
% \begin{function}{notation,notation*}
%   \begin{syntax}
%     \tn{begin}\{notation\}\oarg{说明宽度}\oarg{符号宽度}
%     \quad\tn{item}\oarg{符号} \meta{说明}
%     \tn{end}\{notation\}
%   \end{syntax}
% 符号表，或者称为术语表、缩略词对照表。带有星号的符号表环境不会插入目录。
% \end{function}
%
%
% \subsubsection{致谢页}
%
% \begin{function}{acknowledgement}
% 同前言，使用 \env{acknowledgement} 环境。
% \end{function}
%
% \begin{latexexample}[emph={[1]acknowledgement}]
%   \begin{acknowledgement}
%       感谢NJU LUG
%   \end{acknowledgement}
% \end{latexexample}
%
%
% \subsubsection{附录页}
%
% \begin{function}{\appendix}
% 附录放在本命令后，以英文字母进行编号，编写方式同正文。
% \end{function}
%
%
% \subsubsection{成果列表}
%
% \begin{function}[added=2021-09-29,updated=2021-12-20]{\njupaperlist}
%   \begin{syntax}
%     \tn{njupaperlist}\oarg{标题}\marg{文献}
%   \end{syntax}
% 成果列表，生成一个列举文献条目的无编号节。可选参数为标题，
% 默认为“发表文章目录”。\Arg{文献} 的填写方式同 \tn{cite}，
% 多个文献需要使用英文半角逗号隔开。
% \end{function}
%
% 一个简单的例子如下所示：
% \begin{latexexample}[moretexcs={\njuchapter,\njupaperlist}]
%   \njuchapter{攻读博士学位期间研究成果}
%   \njupaperlist[攻读博士学位期间发表的学术论文]{
%     Nemec1997-209-214,Chiani1998-2998-3008,Chiani1998a}
% \end{latexexample}
%
% 为了便于识别，成果列表中默认对发表年份进行加粗处理。而对作者姓名的处理较为复杂。利用 \pkg{biblatex} 的数据注解机制可以实现对特定文献信息的样式修改\footnote{\url{https://blog.csdn.net/xenonhu/article/details/120853247}}，在此可以用来实现指定作者姓名的突出。经过注解后的一则参考文献条目如下所示：
% \begin{latexexample}[emph={[1]@inproceedings},emph={[2]author}]
%   @inproceedings{Nemec1997-209-214,
%     title = {Force control of redundant robots},
%     author = {B Nemec and Zhao, Mou Mou},
%     author+an = {2=thesisauthor},
%     booktitle = {Processings of Symposium on Robot Control},
%     shortbooktitle = {(PSRC)},
%     pages = {209-214},
%     country = {Nantes France},
%     year = {1997}
%   }
% \end{latexexample}
% 其中 |author+an| 提供了注解的标记，格式为 \meta{序号}|=|\meta{标签}，以上条目中即是将第二名作者加入了指定论文作者的注解。\tn{njupaperlist} 会识别 |thesisauthor| 标签，为其指代的作者姓名进行加粗下划线处理。
%
% 除手动进行标记以外，以下也提供一种自动化处理办法。下载 \href{https://github.com/hushidong/biblatex-map}{bibmap} 全部文件后，修改主目录下的 \file{bibmapaddauthoran.py} 中 |fieldsource| 为需要匹配的姓名，将需要进行标记的 \file{.bib} 文件拷贝至本目录（此处使用 \file{test.bib} 进行示范），运行以下命令生成的参考文献数据源即可被成果列表识别加粗。
%
% \begin{shellexample}[morekeywords={python},deletekeywords={test}]
%   python bibmap.py test.bib -m bibmapaddauthoran.py
% \end{shellexample}
%
%
% \subsection{额外定制}
%
% 在研究生院松散的规定下，本模板仅能提供一个大体适用的框架，
% 势必需要为用户修改留出空间。这一节将提供一些定制方法。
%
% \subsubsection{固定文本}
%
% \begin{function}{\njusetname,\njusetname*,\njusettext,\njusettext*}
%   \begin{syntax}
%     \tn{njusetname}  = \marg{名称}\oarg{变体}\marg{内容}
%     \tn{njusetname*} = \marg{名称}\oarg{变体}\marg{内容}
%     \tn{njusettext}  = \marg{名称}\oarg{变体}\marg{内容}
%     \tn{njusettext*} = \marg{名称}\oarg{变体}\marg{内容}
%   \end{syntax}
% 修改固定文本内容，带星号的命令表示修改对应的英文字段。
% 名称对应的默认内容可以参见 \ref{subsubsec:constant-name} 与
% \ref{subsubsec:constant-text} 节。
% \end{function}
%
% 譬如，将英文摘要页的小标题修改为仅首字母大写的样式，示例如下：
%
% \begin{latexexample}[moretexcs={\njusetname*}]
%   \njusetname*{abstract}[b]{Abstract}
% \end{latexexample}
%
% \subsubsection{长度值}
%
% \begin{function}{\njusetlength,\njusetlength*}
%   \begin{syntax}
%     \tn{njusetlength}  = \marg{名称}\marg{长度}
%     \tn{njusetlength*} = \marg{名称}\marg{长度}
%   \end{syntax}
% 修改长度值，默认为修改固定长度（|dim| 类型），
% 带星号的命令表示修改弹性长度（|skip| 类型，目前未涉及）。
% 默认长度值可以参见 \ref{subsubsec:constant-length} 节。
% \end{function}
%
% 譬如，将封面页的横线加长，示例如下：
%
% \begin{latexexample}[moretexcs={\njusetlength}]
%   \njusetlength{coveruline}{330pt}
% \end{latexexample}
%
%
% \subsection{视觉识别系统}
%
% 视觉识别系统 \pkg{njuvisual} 现已被分离为独立宏包\cite{njuvisual}，
% 基本使用方法举例如下：
% \begin{latexexample}[moretexcs={\njuemblem,\njuname,\njuname*}]
%   \njuemblem{!}{3cm}                           % 生成高 3cm 的紫色校徽
%   \njuname{4cm}{!}                             % 生成宽 4cm 的紫色中文校名
%   \njuname*{4cm}{!}                            % 生成宽 4cm 的紫色英文校名
%   \njuemblem[black]{!}{3cm}                    % 黑色的校徽
%   \njuemblem[department=dii]{!}{4cm}           % 紫色匡院徽标
%   \njuemblem[department=cs,color=blue]{!}{3cm} % 纯蓝色计科徽标
% \end{latexexample}
%
% 本宏包的详细使用方法请参考其使用手册。
%
%
% \section{宏包依赖}
%
% 在任何情况下，本模板都会\emph{显式}调用以下宏包（或文档类）：
% \begin{itemize}
%   \item \pkg{xtemplate} 和 \pkg{l3keys2e}，用于扩展 \hologo{LaTeX3} 编程环境。
%         它们属于 \pkg{l3packages} 宏集。
%   \item \cls{ctexbook}，提供中文排版的通用框架。属于 C\hologo{TeX}
%         宏集 \cite{CTeX}。
%   \item \pkg{mathtools}，增强数学功能。
%   \item \pkg{unicode-math}，负责处理 Unicode 编码的 OpenType 数学字体。
%   \item \pkg{geometry}，用于调整页面尺寸。
%   \item \pkg{setspace}，调整行距。
%   \item \pkg{fancyhdr}，处理页眉页脚。
%   \item \pkg{footmisc}，处理脚注。
%   \item \pkg{ntheorem}，提供增强版的定理类环境。
%   \item \pkg{enumitem}，调整列表环境。
%   \item \pkg{graphicx}，提供图形插入的接口。
%   \item \pkg{booktabs}，绘制三线表。
%   \item \pkg{caption}，用于设置题注。
%   \item \pkg{hyperref}，提供交叉引用、超链接、电子书签等功能。
%   \item \pkg{cleveref}，用于自动生成引用标签。
%   \item \pkg{biblatex}，提供参考文献解决方案。
% \end{itemize}
%
% 以下宏包可能被隐式载入：
% \begin{itemize}
%   \item \pkg{xcolor}，提供色彩支持。
%   \item \pkg{amsmath}，对 \LaTeX{} 的数学排版功能进行了
%         全面扩展。属于 \hologo{AmSLaTeX} 套件。
%   \item \pkg{biblatex-gb7714-2015}，用于生成国标下的参考文献样式。
%   \item \pkg{xits}，提供数学字体。
% \end{itemize}
%
% 在开启某些选项时，本模板也会调用以下宏包：
% \begin{itemize}
%   \item \pkg{fandol}、\pkg{tex-gyre} 和 \pkg{tex-gyre-math}，提供自由字体。
%   \item \pkg{emptypage}，在双面模式下清空空白页的页眉、页脚和页码。
%   \item \pkg{njuvisual}，用于绘制封面的校名校徽。
%   \item \pkg{tabularray}，用于绘制研究生的出版授权书信息表格。
%   \item \pkg{xeCJKfntef} 或 \pkg{lua-ul}，用于在对应引擎下绘制下划线。
% \end{itemize}
%
% 下列宏包会与本模板产生冲突，或者不能发挥预期作用：
% \begin{itemize}
%   \item \pkg{natbib} 和 \pkg{gbt7714} 等 \hologo{BibTeX} 相关的参考文献宏包。
%   \item \pkg{bm} 等使用传统数学字体配置方案的宏包。
%   \item \pkg{babel} 在直接使用时会覆盖默认的中文名称设置。
%   \item \pkg{microtype} 在 \hologo{XeTeX} 和 \hologo{LuaTeX} 下支持有限。
% \end{itemize}
%
%
% \begin{thebibliography}{99}
%
% \newcommand\urlprefix{\newline\hspace*{\fill}}
% \let\OldUrl=\url
% \renewcommand\url[2][]{{\small\textit{#1}~\OldUrl{#2}}}
% \newcommand\CTANurl[2][]{{^^A
%   \small\textit{#1}~\href{http://mirror.ctan.org/#2}{\texttt{CTAN://#2}}}}
%
% \subsection*{书籍}
%
% \bibitem{lshort}
% \textsc{Oetiker T}, \textsc{Partl H}, \textsc{Hyna I}, et al.
% \newblock \textit{The Not So Short Introduction to \hologo{LaTeXe}: Or \hologo{LaTeXe} in 139 minutes} [EB/OL].
% \newblock version 6.4,
% \newblock (2021-03-09)
% \urlprefix\url{https://ctan.org/pkg/lshort-english}
% \urlprefix\CTANurl[文档：]{info/lshort/english/lshort.pdf}
%
% \bibitem{lshort-zh-cn}
% \textsc{Oetiker T}, \textsc{Partl H}, \textsc{Hyna I}, et al.
% \newblock \textit{一份（不太）简短的 \hologo{LaTeXe} 介绍: 或 111 分钟了解 \hologo{LaTeXe}} [EB/OL].