njuthesis.dtx

% \iffalse meta-comment
% !TeX program  = XeLaTeX
% !TeX encoding = UTF-8
%
% Copyright (C) 2021 
% by Nanjing University Linux User Group <nju.lug@yaoge123.cn>
% 
% It may be distributed and/or modified under the conditions of the
% LaTeX Project Public License (LPPL), either version 1.3c of this
% license or (at your option) any later version.  The latest version
% of this license is in the file
%
%    https://www.latex-project.org/lppl.txt
%
% -----------------------------------------------------------------------
%
% The development version of the template can be found at
%
%    https://github.com/nju-lug/NJUThesis
%
% for those people who are interested.
%
%<*internal>
\iffalse
%</internal>
%
%<*internal>
\fi
\begingroup
  \def\NameOfLaTeXe{LaTeX2e}
\expandafter\endgroup\ifx\NameOfLaTeXe\fmtname\else
\csname fi\endcsname
%</internal>
%
%<*install>
\input l3docstrip.tex
\keepsilent
\askforoverwritefalse

\preamble

Copyright (C) 2021 
by Nanjing University Linux User Group <nju.lug@yaoge123.cn>

This file may be distributed and/or modified under the conditions of
the LaTeX Project Public License, either version 1.3 of this license
or (at your option) any later version.  The latest version of this
license is in:

   http://www.latex-project.org/lppl.txt

and version 1.3 or later is part of all distributions of LaTeX version
2005/12/01 or later.

To produce the documentation run the original source files ending with `.dtx'
through XeTeX.
    
\endpreamble

\generate{
  \usedir{tex/latex/njuthesis}
    \file{\jobname.cls}        {\from{\jobname.dtx}{class}}
    \file{njuvisual.sty}
                               {\from{\jobname.dtx}{visual}
                                \from{njuvisual.dtx}{visual}}
%</install>
%<*internal>
  \usedir{source/latex/njuthesis}
    \file{\jobname.ins}        {\from{\jobname.dtx}{install}}
%</internal>
%<*install>
}

\obeyspaces
\Msg{*************************************************************}
\Msg{*                                                           *}
\Msg{* To finish the installation you have to move the following *}
\Msg{* files into a directory searched by TeX:                   *}
\Msg{*                                                           *}
\Msg{* The recommended directory is TDS:tex/latex/njuthesis      *}
\Msg{*                                                           *}
\Msg{*     njuthesis.cls                                         *}
\Msg{*     njuthesis.ins                                         *}
\Msg{*     njuvisual.sty                                         *}
\Msg{*                                                           *}
\Msg{* To produce the documentation, run the file njuthesis.dtx  *}
\Msg{* through XeLaTeX.                                          *}
\Msg{*                                                           *}
\Msg{* Happy TeXing!                                             *}
\Msg{*                                                           *}
\Msg{*************************************************************}

\endbatchfile
%</install>
%
%<*internal>
\fi
%</internal>
%
%<class|visual>\NeedsTeXFormat{LaTeX2e}
%<class|visual>\RequirePackage{expl3}
%<class|visual>\GetIdInfo  $Id: njuthesis.dtx 0.10.0 2021-09-24 12:00:00 +0800  NJU LUG <nju.lug@yaoge123.cn> $
%<class>  { Thesis template for Nanjing University }
%<class>\ProvidesExplClass{njuthesis}
%<visual>  { LaTeX3 Package for NJU Visual Identity }
%<visual>\ProvidesExplPackage{njuvisual}
%<class|visual>{\ExplFileDate}{\ExplFileVersion}{\ExplFileDescription}
%
%<*driver>
\ProvidesFile{njuthesis.dtx}
\documentclass{ctxdoc}
\usepackage{listings,xcolor,tabularray}
\UseTblrLibrary{booktabs,siunitx,diagbox}
\DefTblrTemplate{caption-tag}{default}{表\hspace{0.25em}\thetable}
\SetTblrStyle{caption-tag}{font=\bfseries}
\DefTblrTemplate{caption-sep}{default}{\quad}
\definecolor{njuviolet}{cmyk}{0.5,1,0,0.4}
\definecolor{njumagenta}{cmyk}{0.05,1,0.55,0}
\definecolor{njublue}{cmyk}{0.8,0.5,0,0}
\definecolor{njuyellow}{cmyk}{0,0.3,1,0}
\begin{document}
  \DocInput{njuthesis.dtx}  
  \DocInput{njuvisual.dtx}
  \PrintChanges
  \PrintIndex
\end{document}
%</driver>
% \fi
%
% \title{\color{njuviolet}{The \textsc{NJuThesis} class\\ 南京大学学位论文模板}}
% 
% \author{^^A
% Nanjing University Linux User Group
% \thanks{E-mail: \href{mailto:nju.lug@yaoge123.cn}{nju.lug@yaoge123.cn}}}
%
% \date{v0.10.0 \\ Released 2021-09-24}
%
% \changes{v0.9}{2021/09/15}{使用DocStrip合并模板文件。}
% \changes{v0.10}{2021/09/24}{添加南京大学视觉识别系统。}
%
% \maketitle
%
% \begin{abstract}
% 南京大学学位论文\hologo{LaTeX}模板基于本科生院的论文撰写规范制作，
% 同时参考研究生院提供的硕士、博士学位材料包，
% 用于生成符合南京大学学位论文排版要求和相应的国家规范、行业标准的学位论文，
% 旨在为同学提供毕业论文书写的方便。
% \end{abstract}
%
% \def\abstractname{Abstract}
% \begin{abstract}
% The \textsc{NJuThesis} class is intended for 
% typesetting Nanjing University thesis with \hologo{LaTeX}, 
% providing support for bachelor, master, and doctoral thesis. 
% \end{abstract}
%
% \vspace{2cm}
% \def\abstractname{特别声明}
% \begin{abstract}
% 请注意，本模板仍未完成开发，出现bug或者文档不完善属于正常情况，提issue或Pull Request即可。
% \href{https://git.nju.edu.cn/nju-lug/lug-introduction}{NJU LUG}始终欢迎您的加入与贡献！
% \end{abstract}
%
% \clearpage
%
% \setcounter{tocdepth}{4}
% \tableofcontents
% \clearpage
%
% \EnableDocumentation
%^^A \DisableDocumentation
% 
% \begin{documentation}
%
%
% \section{模板介绍}
% \textsc{NJuThesis}，即南京大学学位论文模板，是一个由南京大学LUG组织维护的，用于处理本校学生毕业论文排版需求的\hologo{LaTeX}模板。
%
% \subsection{历史沿革}
%
% 十几年来，多位热心校友发布过自己编写的模板，在GitHub上可考的包括
% \begin{enumerate}
%  \item 杨文博（\href{http://yangwenbo.com/}{@solrex}）的\href{https://github.com/solrex/njuthesis}{南京大学学位论文\hologo{LaTeX}模板}（2010） 
%  \item \href{https://github.com/fireblue}{@fireblue}基于solrex模板的的\href{https://github.com/fireblue/NJUThesis}{南京大学学位论文\hologo{LaTeX}模板}（2013）
%  \item \href{https://github.com/wenhai-zheng}{@wenhai-zheng}的\href{https://github.com/wenhai-zheng/NJUThesis}{NJUThesis}（2013）  
%  \item 曹增乐（\href{https://github.com/ZLCao}{@ZLCao}）的\href{https://github.com/ZLCao/NJUBachelor}{NJUBachelor}（2013-2016）
%  \item 胡海星（\href{http://haixing-hu.github.io/}{@Haixing-Hu}）的\href{https://github.com/Haixing-Hu/nju-thesis}{NJU-Thesis}（2013 - 2018）
%  \item 张楚珩（\href{https://github.com/zhangchuheng123}{@zhangchuheng123}）基于胡海星模板的\href{https://github.com/zhangchuheng123/NJUThesis}{NJUThesis}（2016）
%  \item 蒋炎岩（\href{http://ics.nju.edu.cn/~jyy/}{@jiangyy}）的\href{https://github.com/jiangyy/njuthesis}{南京大学山寨\hologo{LyX}研究生毕业论文模板}（2017）
%  \item \href{https://github.com/njuHan}{@njuHan}基于胡海星模板的\href{https://github.com/njuHan/njuthesis-nju-thesis-template/}{NJU-Thesis}（2018 - 2021）
%  \item 饶安逸（\href{https://anyirao.com/}{@AnyiRao}）基于张楚珩模板的\href{https://github.com/AnyiRao/NJUThesis2018/}{NJU Thesis 2018}（2018）
%  \item 赵懿晨（\href{https://fengchendian.github.io/about.html}{@FengChendian}）基于饶安逸模板的\href{https://github.com/FengChendian/NJUThesis2021}{NJU Thesis 2021}（2021）
% \end{enumerate}
% 至于不幸而未进行代码版本管理的，甚至于说以压缩包形式流传于各人硬盘中的，就更不可计数了。
%
% 与其让一千个学生做一千种不同的模板，不如有人牵起头来，集中力量办大事。因此，南京大学 Linux User Group 的有志之士在2021年暑期联合起来，参考以上的现成模板，兼顾友校thuthesis、fduthesis等优秀项目，构建了这一全新模板，力求通过\hologo{LaTeX3}语法和清淅的接口实现良好的易用性和可维护性。
%
% 目前，本模板的主要维护者包括：
%
% \begin{itemize}
%     \item 赵懿晨
%     \item 熊煜
% \end{itemize}
%
% \subsection{君\hologo{LaTeX}本当上手}
% \hologo{LaTeX}并不是一种零门槛的语言，亦不是南京大学学生的必备技能。有同学听到“\emph{给毕业论文交差也得写代码}”这种事情就头疼，实在是我们不愿意见到而必须要面对的情况。目前，中文互联网上的\hologo{LaTeX}写作教程不能说屈指可数，起码也是汗牛充栋，比较著名的包括刘海洋的《\hologo{LaTeX}入门》等等都是不错的参考资料。然而如何快速准确找到所需要的用法，尤其是\hologo{LaTeX3}的新接口，需要一定的时间或者良好的英文阅读能力。在本文档的写作中，我们无力从盘古开天辟地开始从头构建您的相关知识体系，只能\textbf{尽力做到有求必应}，在需要的地方顺带提一嘴，保证您少走点弯路。
%
% \subsection{关于本说明手册}
%
% 本模板通过\textsc{DocStrip}进行维护，实际上是一种\emph{文学编程}。文学编程的本体是那些用来说明的文字，按写书写文章的方式组织。
% \file{njuthesis.dtx}包含njuthesis模板的所有信息。前半部分为模板说明，即各种常用命令与必要的使用方法；后半部分为代码实现，为带有详细注释的\hologo{TeX}源代码。后者配合附录，为有意了解本模板细节的同学提供简明的指引。
%
% 下文中将出现若干特殊格式，用来指示代码组件。譬如，\file{file-example.xxx}为文件名，\pkg{pkg-example}为宏包名，\opt{opt-example}为选项名，\env{env-example}为需要|\begin{}|和|\end{}|的环境名，等。
%
% 如果您在使用最新版模板时发现了任何问题，抑或有意向参与本模板的维护，请通过GitHub issue或者QQ群聊联系LUG。
%
% \section{安装}
% \label{sec:setup}
% 本节主要介绍本宏包的获取、安装以及编译方式
% 
% \subsection{获取模板}
%
% \subsubsection{自动安装}
%
% \pkg{njuthesis}已经于2021年9月12日\href{https://ctan.org/pkg/njuthesis}{发布在CTAN}（Comprehensive \hologo{TeX} Archive Network），将在明年进入\hologo{TeX}\,Live 2022。
% 目前，您已经可以通过\pkg{tlmgr}或者\hologo{MiKTeX} Console等
% 包管理器直接安装并使用最新的稳定版，此方法为我们的首要推荐。
% 南大\hologo{TeX}已预置本模板，详见\ref{subsec:onlinecompile}。
% 本地安装方法方法详见第\ref{subsec:localcompile} 节（TODO）。
%
% 然而CTAN版需要开发者手动上传，版本更新具有滞后性。如果使用时遇到了问题，推荐使用以下方式获取最新版本。
% 
% \subsubsection{下载正式版}
% \label{subsubsec:downloadrtm}
%
% 本模板不定期将已有的新功能和问题修复打包为新的正式发行版，下载方式包括：
% \begin{itemize}
%  \item \href{https://github.com/nju-lug/NJUThesis/releases/latest}{Github Releases页面}
%  \item \href{https://mirror.nju.edu.cn/download/app/NJUThesis%20%E8%AE%BA%E6%96%87%E6%A8%A1%E6%9D%BF}{南大镜像下载页}
%\end{itemize}
% 在国内使用时，后者具有显著更快的速度。
%
% \subsubsection{下载开发版}
%
% 开发版具有最新的进度，推荐需要最新补丁或者参与开发的同学下载最新的\file{dtx}文件自行安装
% \begin{itemize}
%  \item \href{https://github.com/nju-lug/NJUThesis/}{Github 仓库}
%  \item \href{https://git.nju.edu.cn/nju-lug/nju-latex-templates/njuthesis}{NJU Git 同步镜像}
%\end{itemize}
%
% \subsection{文件构成}
%
% \cls{njuthesis}由数量众多的文件组成，\emph{所有可能遇到的}文件如表 \ref{tab:njuthesisfiles} 所示。
%
% \begin{table}[ht]
%   \caption{\cls{njuthesis}文件构成}
%   \label{tab:njuthesisfiles}
%   \centering
%   \begin{tabular}{lp{18em}}
%     \toprule
%     名称 & 说明 \\
%     \midrule
%     \file{.vscode}                & Visual Studio Code 配置文件 \\
%     \file{latexmkrc}              & latexmk 配置文件 \\
%     \file{LICENSE}                & 许可证 \\
%     \file{njuthesis.bib}          & 示例参考文献列表 \\
%     \file{njuthesis.cls}          & 模板文档类 \\
%     \file{njuthesis.dtx}          & 文档类源代码 \\
%     \file{njuthesis.ins}          & 文档类安装脚本 \\
%     \file{njuthesis.pdf}          & 用户手册（本文档） \\
%     \file{njuthesis-sample.tex}   & 示例文档，不妨以此为基础撰写论文 \\
%     \file{njuvisual.dtx}          & 视觉识别系统源代码 \\
%     \file{njuvisual.sty}          & 南京大学视觉识别系统 \\
%     \file{README.md}              & 自述文件 \\
%     \bottomrule
%   \end{tabular}
% \end{table}
%
% \subsection{本地编译}
% \label{subsec:localcompile}
%
% \subsubsection{安装\hologo{TeX}发行版}
%
% 首先需要下载\hologo{TeX}软件发行版，校园网环境中使用\href{https://mirror.nju.edu.cn/download/app/TeX%20%E6%8E%92%E7%89%88%E7%B3%BB%E7%BB%9F}{南大镜像站}可以获得最好的体验。\textbf{推荐使用最新的\hologo{TeX}\,Live 2021或者\hologo{MiKTeX} 21以避免潜在的兼容性问题。使用\hologo{LuaLaTeX}编译需要将\pkg{LuaTeX-ja}包更新至2021-09-19或更新的版本}
%
% \begin{itemize}
%     \item 为了避免不必要的麻烦，请尽可能下载 full 版本，如 texlive-full。简而言之，下载大的那个。
%     \item 并且，尽可能使用最新版（截至目前是 2021）。2020 及之前版本使用 PDF 格式的图片可能会出现加粗问题以及l3语法解释错误。
% \end{itemize}
%
% 下表是目前经过测试的环境。如果有其他可用不可用的环境，欢迎补充。
% \begin{table}[ht]
%     \centering
%     \caption{经过测试的环境}
%     \label{tab:1}
%     \begin{tabular}{ccc}
%           \toprule
%           OS & TeX & 测试情况 \\
%           \midrule
%           Windows 10   & \hologo{TeX}\,Live 2020 & cref存在格式问题  \\
%           Windows 10   & \hologo{TeX}\,Live 2021 & 通过 \\
%           Windows 10   & \hologo{MiKTeX}         & 通过 \\
%           macOS 10.15  & mac\hologo{TeX} 2021    & 通过 \\
%           Ubuntu 20.04 & \hologo{TeX}\,Live 2021 & 通过 \\
%           Arch Linux   & \hologo{TeX}\,Live 2021 & 通过 \\
%           \bottomrule
%     \end{tabular}
% \end{table}
%
% \subsubsection{选择编辑器}
%
% 配置完编译器后，还需要一个\textbf{文本编辑器}作为前端来完成\file{.tex}文件内容的写作。
%
% 至今仍有相当一部分人认为Windows自带的\emph{记事本}是最好的文本编辑器，但对于本项目而言，在此诚心诚意地推荐你使用\textbf{更现代更美观更多功能}的编辑器，譬如\emph{安装了 LaTeX Workshop 插件 的 \href{https://code.visualstudio.com/}{Visual Studio Code}}，来完成论文编写。你也可以根据个人的喜好随便使用其他编辑器，如 TeXworks、TeX Studio 等，顺手就行。
%
% 若使用 \hologo{LaTeX} Workshop 插件，本项目在|.vscode/|中提供一份简易配置，可以省略初始配置步骤直接使用。
%
% \subsubsection{编译顺序}
% 假设即将使用的文件名为\file{mynjuthesis.tex}
% 应采用以下命令顺序进行编译，以生成正确的目录、编号和参考文献条目。
% \begin{ctexexam}
%   xelatex mynjuthesis
%   biber mynjuthesis
%   xelatex mynjuthesis
%   xelatex mynjuthesis
% \end{ctexexam}
% 使用 \pkg{latexmk}
% \begin{ctexexam}
%   latexmk -xelatex mynjuthesis
% \end{ctexexam}
%
% \begin{ctexexam}
%   lualatex mynjuthesis
%   biber mynjuthesis
%   lualatex mynjuthesis
%   lualatex mynjuthesis
% \end{ctexexam}
% 使用 \pkg{latexmk}
% \begin{ctexexam}
%   latexmk -lualatex mynjuthesis
% \end{ctexexam}
%
% 编译产物为\file{njuthesis.pdf}，位于主目录下。此外还会生成一系列中间文件，可以选择使用以下命令进行清理。
%
% \begin{ctexexam}
%   latexmk -c
% \end{ctexexam}
%
% \subsection{在线编译}
% \label{subsec:onlinecompile}
%
% 相信你在接触了本地编译以后，很快就会意识到一些十分显然的事实，譬如\hologo{TeX}编译器安装过程较为漫长，占用空间过大，而且在一部分处理器性能不佳的电脑上需要较长编译时间\footnote{其实这三点都是对广大的Windows用户说的，同一个模板在Linux编译可以节省一半耗时}。拒绝接受这些麻烦的同学不妨尝试本节介绍的在线编译方法。
%
% \subsubsection{南大\hologo{TeX}平台简介}
%
% \href{https://tex.nju.edu.cn}{南大\hologo{TeX}}基于开源的ShareLaTeX平台\footnote{理论上在\href{https://doc.nju.edu.cn/books/latex}{这个网站}能找到一段平台简介，实际上大家都有意无意地鸽了，下次一定补上。}，于2021年3月4日正式上线，面向南京大学全体师生开放，首次使用需凭学校邮箱自助注册账号。
%
% \subsubsection{操作步骤}
%
% \begin{enumerate}
%     \item 访问\href{https://tex.nju.edu.cn}{南大\hologo{TeX}}，点击界面右上方Register，使用\emph{南京大学邮箱}注册账号并登录
%     \item 在项目页面左上角的Menu中，将编译器改为\hologo{XeLaTeX}或者\hologo{LuaLaTeX}
%     \item 仿照\file{njuthesis-sample.tex}编写论文
%     \item 点击Compile按钮进行编译和预览
% \end{enumerate}
%
% 注意，由于南大\hologo{TeX}已预装\cls{njuthesis}，可以直接编写正文，无需\file{.cls}等格式文件。如果需要使用新版模板，也可以点击New Project -> Upload Project上传 \ref{subsubsec:downloadrtm} 得到的压缩文件。
%
% \subsubsection{关于Overleaf}
%
% 由于\href{https://www.overleaf.com/}{Overleaf平台}的\hologo{TeX}\,Live版本停留在2020，\texttt{cleveref}包在引用章节时会生成错误的标签，引发格式错误；而南大\hologo{TeX}通过及时更新规避了若干问题。因此\emph{请务必不要使用Overleaf官网进行编译}。
%
%
%
% \section{使用方法}
%
% \subsection{标准结构}
%
% 典型的\cls{njuthesis}主文件结构应该如下所示：
%
% \begin{ctexexam}
%   \documentclass[<options>]{njuthesis}
%   \njusetup { info = {<info>} }
%   \graphicspath{{figure/}}
%   \addbibresource{njuthesis.bib}
%   \begin{document}
%   \maketitle
%   <abstract>
%   <preface>
%   \tableofcontents
%   \listoffigures
%   \listoftables
%   \mainmatter
%   <text>
%   \printbibliography[heading=bibintoc,title=参考文献]
%   <acknowledgement>
%   \appendix
%   <appendix>
%   \end{document}
% \end{ctexexam}
%
% \subsection{模板选项}
%
% 模板选项位于\tn{documentclass}后的方括号内，用于指定模板的行为。
% 下文中尖括号内列出了若干个允许的选项，其中加粗的为默认选项。
%
%
% 
% \subsubsection{学位信息}
% \begin{function}[added=2021-09-07]{degree}
%   \begin{syntax}
%     degree = <(ug)|mg|mf|phd>
%   \end{syntax}
%
% 选择学位，可选：
% \opt{ug}（默认本科），\opt{mg}即学术硕士，\opt{mf}，\opt{phd}。
% \end{function}
% 
% \begin{function}[added=2021-09-07]{nlcover}
%   \begin{syntax}
%     nlcover = <\TTF>
%   \end{syntax}
%
% 通过此项可选择是否添加国家图书馆封面，本选项仅对于研究生有效
% \end{function}  
%
% \begin{function}[added=2021-09-07]{type}
%   \begin{syntax}
%     type = <(thesis)|design>
%   \end{syntax}
%
% 用于选择文档类型并将相关字段输出在封面和摘要页。可选值包括\opt{thesis}（表示毕业论文）和\opt{design}（表示毕业设计），缺省值为thesis。
% 
% \end{function}
%   
%
%
% \subsubsection{指定字体}
%
% 学校论文格式要求使用的字体一般已经预装在各个操作系统，本模板针对不同平台进行了自动检测适配，可以开箱即用。
%
% 如果希望更改本模板使用的字体，请填写以下两个选项以覆盖操作系统检测得到的设置。
% 
% \begin{function}[added=2021-09-07]{customchinesefont}
%   \begin{syntax}
%     customchinesefont = <(windows)|macos|fandol|founder|noto|none>
%   \end{syntax}
%
% 手动指定中文字体，可选：
% \opt{windows}（默认）， \opt{macos}， \opt{fandol}， \opt{founder}，\opt{noto}，\opt{none}。
% \end{function}
%
% \begin{function}[added=2021-09-07]{customlatinfont}
%   \begin{syntax}
%     customlatinfont = <(windows)|macos|gyre|none>
%   \end{syntax}
%
% 手动指定西文字体，可选：
% \opt{windows}（默认）， \opt{macos}， \opt{gyre}， \opt{none}。
% \end{function}
%
% 根据学校论文格式的要求，本模板使用的中文字体主要有{\songti 宋体}、{\heiti 黑体}、{\kaishu 楷体}、{\fangsong 仿宋}四种；
% 西文字体主要有衬线体（\textup{serif}）、无衬线体（\textsf{sans-serif}）和等宽字体（\texttt{monospace}）三种。
% 在生成论文时，需要将每一种字体（宋体、楷体）与一种字库（操作系统中的 ttf 文件）相对应。
% 由于不同操作系统自带的字库不同，在不同的操作系统上使用同一套配置会导致缺字、编译出错等后果。
% 因此，本模板对于中文字体和西文字体都提供了多种字体配置。
%
% 本模板提供的中文字体配置如表 \ref{tab:chinesefontset} 所示。
% 在不指定字体配置的情况下，本模板默认使用与操作系统相对应的字体配置（见表中前三行，Windows 和 macOS 以外的系统采用 Fandol 配置）。
% 此外，我们也单独提供了方正和思源（\href{https://www.google.com/get/noto/#serif-hans}{思源宋体}、\href{https://www.google.com/get/noto/#sans-hans}{思源黑体}）两套中文字体配置。
%
% \begin{table}[htbp]
%   \centering
%   \begin{talltblr}[
%    caption = {中文字体配置列表},
%    label = {tab:chinesefontset},
%    note{a} = {使用方正小标宋作为方正书宋的粗体，使用方正黑体作为方正细黑一的粗体},
%    note{b} = {思源字体并不包含楷书和仿宋，而Adobe楷体和仿宋难以直接下载，因此使用方正字体代替；考虑到获取字体的难易程度，采用 \href{https://www.google.com/get/noto}{noto} 字体表示思源字体},
%   ] { cell{2}{2,4} = {njuyellow}, cell{4}{4} = {njuyellow}, colspec = {ccccc} }
%     \toprule
%     配置名称 & 宋体 & 黑体 & 楷书 & 仿宋 \\
%     \midrule
%     Windows          & 中易宋体    & 中易黑体    & 中易楷体    & 中易仿宋 \\
%     macOS            & 华文宋体    & 华文黑体    & 华文楷体    & 华文仿宋 \\
%     \href{https://www.ctan.org/pkg/fandol} {Fandol}           
%                      & Fandol宋体  & Fandol黑体  & Fandol楷体  & Fandol仿宋 \\
%     \href{https://www.foundertype.com}     {方正}\TblrNote{a} 
%                      & 方正书宋    & 方正细黑一  & 方正楷体    & 方正仿宋 \\
%     \href{https://github.com/adobe-fonts}  {思源}\TblrNote{b} 
%                      & 思源宋体    & 思源黑体    & 方正楷体    & 方正仿宋 \\
%     \bottomrule
%   \end{talltblr}
% \end{table}
%
% 由于各操作系统对自带字体的支持程度不同，本模板对不同字体加粗的方式有所差别，表 \ref{tab:chinesefontset} 中，黄色底色的字体采用算法加粗。
% 除此以外，各种字体在设计上也存在差异，因此本模板在不同操作系统下编译的结果可能存在细微不同，使用时请注意。
% 若想要获得与 Word 版本模板最为贴近的体验，可以通过手动安装 Windows 自带的中易宋体、中易黑体、中易楷体和中易仿宋，并设置使用 Windows 字体来实现。
%
% 本模板提供的西文字体配置如表 \ref{tab:latinfontset} 所示。
% 在不指定字体配置的情况下，本模板默认使用与操作系统相对应的字体配置（见表中前三行，Windows 和 macOS 以外的系统采用 \opt{gyre} 配置）。
%
% \begin{table}[htbp]
%   \centering
%   \caption{西文字体清单}
%   \label{tab:latinfontset}
%   \begin{tabular}{cccc}
%       \toprule
%       配置名称 & 衬线体 & 无衬线体 & 等宽字体 \\
%       \midrule
%       Windows  & Times~New~Roman           & Arial                   & Courier~New \\
%       macOS    & Times~New~Roman           & Arial                   & Menlo \\
%       \href{http://www.gust.org.pl/projects/e-foundry/tex-gyre}{gyre} 
%                & \Hologo{TeX}~Gyre~Termes  & \Hologo{TeX}~Gyre~Heros & \Hologo{TeX}~Gyre~Cursor \\
%       \bottomrule
%   \end{tabular}
% \end{table}
%
% 若要手动选择字体，则需将字体设置为 \opt{none}，再通过 \pkg{fontspec} 宏包或 \pkg{ctex} 宏包中给出的命令来实现。
%
% 最后，出于统一格式的需要，本模板还选取了与正文字体相似度最高的数学字体（\href{https://www.stixfonts.org}{STIX 字体}）用于公式排版。
%
% 本节提及的字库中，中文字库只有方正书宋、方正黑体、方正楷体、方正仿宋、两种思源字体和四种Fandol字体能够\emph{免费商用}；
% 英文字库中只有 Times New Roman、STIX 和三种\Hologo{TeX} Gyre字体能够\emph{免费商用}。
% 因此，若需要将本模板用于商业相关的活动，请咨询专业人士。
%
% \subsection{个人信息}
%
% \begin{function}{\njusetup}
%   \begin{syntax}
%     \tn{njusetup}\marg{键值列表}
%   \end{syntax}
% 
% 定义了用于文档封面的诸多属性参数，
% 写作时修改相应字符串即可。
%
% \end{function}
%
% 本科生可以参考如下列表输入个人信息。注意不能有空行，有空格的内容需要将空格替换为波浪线或者两端加上大括号
%
% 封面标题留空即可自动化换行。
%
% 第二导师不填则留空，目前来说拥有两位指导老师并不是一种普遍状况。
%
% \begin{ctexexam}
%   \njusetup {
%       info = {
%           TitleA = 第一行标题,
%           TitleB = 第二行标题,
%           Title* = {My title in English}, 
%           Grade = 2018,
%           StudentID = 189114514,
%           StudentName = 周煜华,
%           StudentName* = Zhou~Yuhua,
%           Department = 拉太赫科学与技术学院,
%           Department* = School~of~\hologo{LaTeX},
%           Major = 拉太赫语言学,
%           Major* = \hologo{LaTeX}~Linguistics,
%           SupervisorA = 李成殿,
%           SupervisorA*= Li~Chengdian,
%           SupervisorATitle = 教授,
%           SupervisorATitle* = Professor,
%           SupervisorB = 孙赫弥,
%           SupervisorB* = Sun~Hemi,
%           SupervisorBTitle = 副教授,
%           SupervisorBTitle* = Associate professor,
%           SubmitDate = 2021年8月10日,
%       }
%   }
% \end{ctexexam}
%
% 研究生可以参考如下列表输入个人信息
%
% \begin{ctexexam}
%   \njusetup {
%       info = {
%           TitleA = 第一行标题,
%           TitleB = 第二行标题,
%           TitleC = 第三行标题,
%           Title* = {My title in English}, 
%           Grade = 2018,
%           StudentID = dz18114514,
%           StudentName = 周煜华,
%           StudentName* = Zhou~Yuhua,
%           Department = 拉太赫科学与技术学院,
%           Department* = School~of~\hologo{LaTeX},
%           Major = 拉太赫语言学,
%           Major* = \hologo{LaTeX}~Linguistics,
%           Field = 拉太赫语言在现当代的使用, 
%           Field* = Contemporary~Usage~of~the~\hologo{LaTeX}~Language, 
%           SupervisorA = 李成殿,
%           SupervisorA*= Li~Chengdian,
%           SupervisorATitle = 教授,
%           SupervisorATitle* = Professor,
%           SubmitDate = 2021年8月10日,
%           SubmitDate* = {Aug 10, 2021}, 
%           DefendDate = 2021年9月19日,
%           ReviewerChairman = 张晓山~教授,
%           ReviewerA = 王瑞希~教授,
%           ReviewerB = 郭德纲~副教授,
%           ReviewerC = 华芈库~教授,
%           ReviewerD = 戴菲菲~教授,
%           Classification = 0175.2,
%           SecurityLevel = 限制,
%           UDC = 004.72,
%           SupervisorContact = {拉太赫科学与技术学院 枝江市结丘路 19 号 114514},
%       }
%   }
% \end{ctexexam}
%
%
%
% \subsection{编写正文}
%
% 与导言区相对的是正文，位于\env{document}环境内。
% 
% \begin{ctexexam}
%   \begin{document}}
%     text
%   \end{document}
% \end{ctexexam}
%
% 加上空行就可以另起一段。
%
% 
% 在页面布局方面，本科生无页眉，页面编号居中位于页脚；研究生无页脚，页眉包括章节名和页面编号（尚未确定）。
%
% \subsubsection{文字}
%
% \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}
%
% \subsubsection{图片}
%
% 所有图片默认存放在主目录下的\texttt{figure/}文件夹内，允许的文件名包括\file{*.jpg}, \file{*.png}, \file{*.pdf}, \file{*.eps}。使用自己的图片时，需要在导言区通过以下命令添加图片存放路径。
%
% \begin{ctexexam}
%   \graphicspath{{img/}{images/}}
% \end{ctexexam}
%
% 下面这个例子展示了如何插入一张名称为\file{myfig.jpg}，宽度占页面文字宽度一半的图片。注意标签命令\tn{label}必须放在图注命令\tn{caption}之后。
%
% \begin{ctexexam}
%   \begin{figure}[h]
%       \includegraphics[width=0.5\textwidth]{myfig}
%       \caption{我的图}
%       \label{fig:myfig}
%   \end{figure}
% \end{ctexexam}
%
% 
% 文字环绕图像，\env{wrapfigure}后面不能有空行
%
% \begin{ctexexam}
%   \begin{wrapfigure}{r}{0cm}
%       \includegraphics[width=0.15\textwidth]{myfig}
%       \caption{我的图}
%       \label{fig:myfig}
%   \end{wrapfigure}
%   <text>
% \end{ctexexam}
% 
% TODO：使用\pkg{subcaption}的\env{subfigure}实现多张图片并排的效果
%
% \begin{ctexexam}
%   \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{ctexexam}
%
% \subsubsection{表格}
%
% 下面这个例子展示了如何插入一张表格。
%
% 通过\pkg{booktabs}提供的\tn{toprule}、\tn{midrule}和\tn{bottomrule}，我们可以很轻松地绘制出一张漂亮规范的三线表。
% \begin{ctexexam}
%   \begin{table}[htbp]
%       \caption{我的表}
%       \label{tab:testtab}
%       \begin{tabular}{ccc}
%           \toprule
%           OS & TeX & 测试情况 \\
%           \midrule
%           南大TeX & Overleaf & √ \\
%           \bottomrule
%       \end{tabular}
%   \end{table}
% \end{ctexexam}
%
% TODO：\pkg{multirow}\pkg{multicol}合并单元格
%
% \subsubsection{代码}
%
% 由\pkg{listings}提供代码排版。代码块\env{lstlisting}，注意这个环境中的缩进空格会如实输出
% \begin{ctexexam}
%   \begin{lstlisting}
%   <code>
%   \end{lstlisting}
% \end{ctexexam}
%
% 行间代码|\lstinline!<code>!|，其中包裹代码的两个感叹号并不是绝对的，可以替换成任何两个相同的没有在这段代码中出现过的符号。
%
%
% \subsubsection{数学}
%
% 行内公式形如|$\mathrm{e}^{(a+2b)x}$|
%
% 带有编号的行间公式\env{equation}
% \begin{ctexexam}
%   \begin{equation}\label{eq:myeqlabel}
%       \pi
%   \end{equation}
% \end{ctexexam}
%
% 如不需要编号，可以用\env{equation*}或者 |\[<eq>\]|
%
% 本模板也提供了一系列的数学环境。证明环境会在结尾添加证毕符号
% \begin{ctexexam}
%   \begin{proof}
%       证明我是我
%   \end{proof}
% \end{ctexexam}
%
% 普通环境
% \begin{ctexexam}
%   \begin{definition}[他人]
%       定义他人即地狱
%   \end{definition}
% \end{ctexexam}
% 
% 
% \subsubsection{脚注}
% |\footnote{<text>}|
% 
% 
% \subsubsection{引用}
% 
% 使用\pkg{cleveref}宏包实现了带图、表等项目名称的智能引用，仅需使用|\cref{<label>}|命令。
%
% 超链接|\href{<url>}{<name>}|
% 
% 
% \subsection{特殊页面}
% 
% 本模板还提供一系列环境用于生成所需的特殊页面
%
% \subsubsection{封面}
%
% 封面可使用如下命令生成。
% 
% \begin{ctexexam}
%   \maketitle
% \end{ctexexam}
%
% 本科生仅会生成中文封面；研究生会生成中英文封面。如果选择了\opt{nlcover}，也会生成研究生的国家图书馆封面。
%
% \subsubsection{摘要页}
%
% 中文关键词，每个关键词之间用“；”分开，最后一个关键词不打标点符号
% 英文关键词。关键词之间用英文半角逗号隔开，末尾无符号。
% 
% \begin{ctexexam}
%   \begin{abstract}
%       我的中文摘要
%       \keywords{我；就是；充数的；关键词}
%   \end{abstract}
%
%   \begin{englishabstract}
%       My abstract in English
%       \englishkeywords{Dummy; Keywords; Here}
%   \end{englishabstract}
% \end{ctexexam}
%
%
% \subsubsection{前言页}
%        
% 使用\env{preface}环境定义
% 
% \begin{ctexexam}
%   \begin{preface}
%       我的前言
%       \vspace{1cm}
%       \begin{flushright}
%       我的名字\\
%       时间地点
%       \end{flushright}
%   \end{preface}
% \end{ctexexam}
%
% \subsubsection{目录页}
%
% 目录、图片清单和表格清单可使用如下命令生成。
% 
% \begin{ctexexam}
%   \tableofcontents
%   \listoffigures
%   \listoftables
% \end{ctexexam}
%
% \subsubsection{致谢页}
%
% 同前言，使用\env{acknowledgement}环境
% 
% \begin{ctexexam}
%   \begin{acknowledgement}
%       感谢NJU LUG
%   \end{acknowledgement}
% \end{ctexexam}
%
% \subsubsection{参考文献页}
%
% 使用以下命令，\opt{bibintoc}可以将参考文献页插入目录
% 
% \begin{ctexexam}
%   \printbibliography[heading=bibintoc,title=参考文献]
% \end{ctexexam}
% 
% \subsubsection{附录页}
%
% 附录放在|\appendix|命令后，以英文字母进行编号，正常通过|chapter{}|编写
%
% 是否需要索引？
% 
%
% \subsection{参考文献}
%
% 符合GB7714-2015规范。使用\hologo{biber}作为\hologo{BibTeX}后端。需要使用|biber|命令手动编译才会显示
%
% 默认参考文献存储于主目录下的\file{njuthesis.bib}，直接向其中粘贴新的参考文献即可。
%
% 如果希望额外添加参考文献列表，可以在主文件\file{mynjuthesis.tex}的导言区中多次调用\tn{addbibresource}命令：
%
% \begin{ctexexam}
%   \addbibresource{file1.bib}
%   \addbibresource{file2.bib}
% \end{ctexexam}
% 注意本命令与|\bibliography{bibfile1,bibfile2}|不同，不可以用逗号分隔多个输入文件，且必须使用带扩展名的完整文件名。
%
% \subsubsection{使用EndNote}
%
% 南京大学信息化建设管理服务中心已购买\href{https://itsc.nju.edu.cn/EndNote/list.htm}{EndNote}供全校师生免费试用，最新版为EndNote 20。
%
%
%
% 
%
% \subsubsection{使用Zotero}
%
% \href{https://www.zotero.org/}{Zotero}是一款免费的文献管理软件，支持所有桌面平台。
%
% 在保持Zotero程序运行的情况下，点击浏览器工具栏的Zotero Connector插件即可自动从网页抓取参考文件信息。Zotero也有知网插件
%
% \subsubsection{文段内引用}
%
% |\cite{myref}|，|\citeauthor{myref}|
%
% \subsection{视觉识别系统}
% 
% \begin{function}[added=2021-09-24]{\njuemblem}
%   \begin{syntax}
%     \tn{njuemblem}\oarg{颜色}\Arg{宽度}\Arg{高度}
%   \end{syntax}
%
% 生成指定颜色和大小的南京大学校徽
% \end{function}
%
% \begin{function}[added=2021-09-24]{\njuname}
%   \begin{syntax}
%     \tn{njuname}\oarg{颜色}\Arg{宽度}\Arg{高度}
%     \tn{njuname*}\oarg{颜色}\Arg{宽度}\Arg{高度}
%   \end{syntax}
%
% 生成指定颜色和大小的南京大学校名，加星号的为英文校名
% \end{function}
%
% 
% \begin{function}[added=2021-09-24]{\njumotto}
%   \begin{syntax}
%     \tn{njumotto}\oarg{颜色}\Arg{宽度}\Arg{高度}
%   \end{syntax}
%
% 生成指定颜色和大小的南京大学校训
% \end{function}
%
%
% \begin{function}[added=2021-09-24]{\njuspirit}
%   \begin{syntax}
%     \tn{njuspirit}\oarg{颜色}\Arg{宽度}\Arg{高度}
%   \end{syntax}
%
% 生成指定颜色和大小的南京大学校徽
% \end{function}
%
%
%
% \end{documentation}
%
% \begin{implementation}
%
% \section{代码实现}
% @@在l3docstrip中表示名空间，在生成cls时会被相应字段替换，譬如在\pkg{njuthesis}中|@@=nju|。
% 尖括号包裹的|<*class>||</class>|用来指定某段代码属于哪个文件。
%
%    \begin{macrocode}
%<@@=nju>
%<*class>
\LoadClass[
  a4paper,
  twoside,
  UTF8,
  scheme=chinese,
%    \end{macrocode}
%
% 关于行距，\hologo{LaTeX}默认1.2行距，word默认行距是1.3，要求1.5倍word行距，故
% \[ 1.5\times\frac{1.3}{1.2} = 1.625\]
%    \begin{macrocode}
  linespread=1.625,
%    \end{macrocode}
%
% 默认不载入任何字体，供模板自行设置
%    \begin{macrocode}
  fontset=none,
  zihao=-4
  ]{ctexbook}[2018/04/01]
%    \end{macrocode}
%
% 宏包\pkg{l3keys2e}用于配置模板选项。
%    \begin{macrocode}
\RequirePackage{l3keys2e}
%    \end{macrocode}
%
% 是否需要国家图书馆封面的设置
%    \begin{macrocode}
\keys_define:nn { nju }
{
  nlcover           .bool_set:N   =   \g_@@_nlcover_bool,
  nlcover           .initial:n    =   false,
}
%    \end{macrocode}
% 
%
% \begin{variable}{\l_@@_info_degree_tl,\l_@@_info_type_tl}
% 用于存储学位名称的变量，注意宏的命名，l代表局部变量，g代表全局变量
%    \begin{macrocode}
\tl_new:N \l_@@_info_degree_tl
\tl_new:N \l_@@_info_type_tl
%    \end{macrocode}
% \end{variable}
%
% 学位信息的设置
%    \begin{macrocode}
\keys_define:nn { nju }
{
  degree            .choices:nn   =
  { ug, mg, mg, phd }
  { \tl_set_eq:NN \l_@@_info_degree_tl \l_keys_choice_tl },  
  degree            .initial:n    =   ug,
  type              .choices:nn   =
  { thesis, design }
  { \tl_set_eq:NN \l_@@_info_type_tl   \l_keys_choice_tl }, 
  type              .initial:n    =   thesis,
}
%    \end{macrocode}
% 
% \subsection{个人信息}
% 输入个人信息的区域。
%    \begin{macrocode}
\keys_define:nn { nju }
{
  info.meta:nn = { nju / info } { #1 }
}
%    \end{macrocode}
%
% 题目
%    \begin{macrocode}
\keys_define:nn { nju / info }
{
  TitleA            .tl_set:N     =   \l_@@_info_title_a_tl,
  TitleB            .tl_set:N     =   \l_@@_info_title_b_tl,
  TitleC            .tl_set:N     =   \l_@@_info_title_c_tl,
  Title*            .tl_set:N     =   \l_@@_info_title_en_tl,