Skip to content
Snippets Groups Projects
njuthesis.dtx 204 KiB
Newer Older
% \iffalse meta-comment
% !TeX program  = XeLaTeX
% !TeX encoding = UTF-8
Yu Xiong's avatar
Yu Xiong committed
% Copyright (C) 2021 - 2022
% by Nanjing University Linux User Group
% <git+nju-lug-email-3104-issue-@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
Yu Xiong's avatar
Yu Xiong committed
% 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
% This work has the LPPL maintenance status `maintained'.
%
% The Current Maintainer of this work is Yu Xiong.
%
% This work consists of the files njuthesis.dtx,
%           and the derived files njuthesis.ins,
%                                 njuthesis.cls,
%                                 njuthesis-undergraduate.def,
%                                 njuthesis-graduate.def,
%                                 njuthesis.pdf,
%                             and README.md.
%
% -----------------------------------------------------------------------
% 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 docstrip.tex
\keepsilent
\askforoverwritefalse

\preamble

Yu Xiong's avatar
Yu Xiong committed
Copyright (C) 2021 - 2022
by Nanjing University Linux User Group
<git+nju-lug-email-3104-issue-@yaoge123.cn>

This file may be distributed and/or modified under the conditions of
the LaTeX Project Public License, either version 1.3c 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.

Yu Xiong's avatar
Yu Xiong committed
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{\jobname-undergraduate.def} {\from{\jobname.dtx}{definition-ug}}
    \file{\jobname-graduate.def}      {\from{\jobname.dtx}{definition-g}}
%<*internal>
  \usedir{source/latex/njuthesis}
    \file{\jobname.ins}               {\from{\jobname.dtx}{install}}
%</internal>
}

\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-graduate.def                                *}
\Msg{*     njuthesis-undergraduate.def                           *}
\Msg{*     njuthesis.ins                                         *}
\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>\NeedsTeXFormat{LaTeX2e}
%<*!(driver|install)>
Yu Xiong's avatar
Yu Xiong committed
%<+!driver>\GetIdInfo $Id: njuthesis.dtx 0.16.1 2022-03-27 13:00:00 +0800 NJU LUG <git+nju-lug-email-3104-issue-@yaoge123.cn>$
%<class>  {Thesis template for Nanjing University}
%<class>\ProvidesExplClass{njuthesis}
%<definition-ug>  {Undergraduate definition file for njuthesis}
%<definition-ug>\ProvidesExplFile{njuthesis-undergraduate.def}
%<definition-g>  {Graduate definition file for njuthesis}
%<definition-g>\ProvidesExplFile{njuthesis-graduate.def}
%<!driver>  {\ExplFileDate}{\ExplFileVersion}{\ExplFileDescription}
%</!(driver|install)>
\ProvidesFile{njuthesis.dtx}
\documentclass[fontset=fandol]{ctxdoc}
\usepackage{listings,njuvisual,tabularray}
\usepackage[firstpage=true]{background}
\backgroundsetup{contents={\njuemblem[white!85!gray]{22cm}{!}},scale=1,angle=0,hshift=-4cm}
Yu Xiong's avatar
Yu Xiong committed
\colorlet{at@guard}{njuviolet}
Yu Xiong's avatar
Yu Xiong committed
\definecolor{olgreen}{HTML}{138a07}
\definecolor{agrd}{HTML}{2E3191}
Yu Xiong's avatar
Yu Xiong committed
\newcommand\olbutton[1]{\textcolor{olgreen}{\bfseries #1}}
\newcommand\agrd[1]{\textcolor{agrd}{\sffamily 〈#1〉}}
\newcommand\bgrd[1]{\textcolor{at@guard}{\sffamily #1}}
\newcommand\tikzlogo{Ti\emph{k}Z}
\hypersetup{%
  pdftitle  = {The njuthesis class - LaTeX thesis template for Nanjing University},
  citecolor = njublue,
  linkcolor = njuviolet,
  urlcolor  = njumagenta}
\UseTblrLibrary{booktabs,diagbox,siunitx}
\DefTblrTemplate{caption-tag}{default}{表\hspace{0.25em}\thetable}
\SetTblrStyle{caption-tag}{font=\bfseries}
Yu Xiong's avatar
Yu Xiong committed
\SetTblrInner{row{1}={font=\bfseries}}
\DefTblrTemplate{caption-sep}{default}{\quad}
\lstdefinestyle{style@base}
  {
    basewidth       = 0.5 em,
    gobble          = 3,
    lineskip        = 3 pt,
    frame           = l,
    framerule       = 1 pt,
    framesep        = 0 pt,
    xleftmargin     = 2 em,
    xrightmargin    = 3 em,
    escapeinside    = {(*}{*)},
    basicstyle      = \small\ttfamily,
    keywordstyle    = \bfseries\color{njuviolet},
    commentstyle    = \itshape\color{white!50!gray},
    stringstyle     = \color{nju-chem-red},
    backgroundcolor = \color{white!95!gray}
  }
\lstdefinestyle{style@shell}
  {
    style      = style@base,
    rulecolor  = \color{njumagenta},
    language   = bash,
    alsoletter = {-},
    emphstyle  = \color{nju-cs-green}
  }
\lstdefinestyle{style@latex}
  {
    style      = style@base,
    rulecolor  = \color{njublue},
    language   = [LaTeX]TeX,
    alsoletter = {*, -},
    texcsstyle = *\color{njuviolet},
    emphstyle  = [1]\color{nju-ai-orange},
    emphstyle  = [2]\color{nju-cs-green}
  }
\lstnewenvironment{shellexample}[1][]{%
  \lstset{style=style@shell, #1}}{}
\lstnewenvironment{latexexample}[1][]{%
  \lstset{style=style@latex, #1}}{}
\begin{document}
  \DocInput{njuthesis.dtx}
Yu Xiong's avatar
Yu Xiong committed
  \PrintChanges
\end{document}
%</driver>
% \fi
%
Yu Xiong's avatar
Yu Xiong committed
% \title{\color{njuviolet}{The \cls{njuthesis} class\\
%   \textbf{南京大学学位论文模板}}}
Yu Xiong's avatar
Yu Xiong committed
% \author{^^A
Yu Xiong's avatar
Yu Xiong committed
% 南京大学 Linux 用户组
Yu Xiong's avatar
Yu Xiong committed
% \thanks{E-mail: \href{mailto:git+nju-lug-email-3104-issue-@yaoge123.cn}
Yu Xiong's avatar
Yu Xiong committed
%   {git+nju-lug-email-3104-issue-@yaoge123.cn}}}
Yu Xiong's avatar
Yu Xiong committed
% \date{v0.16.1 \quad 2022-03-27}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \changes{v0.1}{2021/09/04}{开始开发。}
% \changes{v0.2}{2021/09/07}{初步搭建了可用的模板。}
% \changes{v0.3}{2021/09/09}{使用自动构建工具进行测试。}
% \changes{v0.4}{2021/09/09}{将个人信息使用内置命令输入。}
% \changes{v0.5}{2021/09/10}{新增了对第二导师的支持。}
% \changes{v0.6}{2021/09/10}{封装个人信息}
% \changes{v0.6}{2021/09/10}{实现自动打包发布。}
Yu Xiong's avatar
Yu Xiong committed
% \changes{v0.7}{2021/09/11}{增加对研究生模板的支持}
Yu Xiong's avatar
Yu Xiong committed
% \changes{v0.7}{2021/09/12}{将 \cls{njuthesis} 发布在 CTAN。}
Yu Xiong's avatar
Yu Xiong committed
% \changes{v0.8}{2021/09/12}{修复已知问题,进行公开宣传。}
% \changes{v0.9}{2021/09/15}{使用 DocStrip 合并模板文件。}
% \changes{v0.9}{2021/09/15}{大幅度修改宏名称以符合 \hologo{LaTeX3} 规范。}
% \changes{v0.9}{2021/09/15}{进一步完善文档。}
Yu Xiong's avatar
Yu Xiong committed
% \changes{v0.10}{2021/09/24}{删除了生成自述文件的代码。}
% \changes{v0.12}{2021/11/28}{删除内置的 \pkg{njuvisual} 代码。}
% \changes{v0.12}{2021/11/29}{更新了说明文档封面设计。}
% \changes{v0.12}{2021/11/30}{区分测试文件和空白模板。}
% \changes{v0.12}{2021/12/06}{修改了说明文档的代码呈现样式。}
% \changes{v0.13}{2021/12/12}{优化了编译速度。}
% \changes{v0.13}{2021/12/15}{适配2022届本科生毕业毕业论文(设计)规范。}
% \changes{v0.14}{2022/01/13}{将本模板内嵌入南大 \hologo{TeX} 网站。}
% \changes{v0.16}{2022/03/01}{分离本科生和研究生模板配置。}
Yu Xiong's avatar
Yu Xiong committed
%
% \begin{abstract}
Yu Xiong's avatar
Yu Xiong committed
% 南京大学学位论文 \hologo{LaTeX} 模板 \cls{njuthesis} 基于本科生院的论文撰写
% 规范制作,同时参考研究生院提供的硕士、博士学位材料包,用于生成符合南京大学学
% 位论文排版要求和相应的国家规范、行业标准的学位论文,旨在为同学提供毕业论文书
% 写的方便。
Yu Xiong's avatar
Yu Xiong committed
% \end{abstract}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \def\abstractname{Abstract}
% \begin{abstract}
Yu Xiong's avatar
Yu Xiong committed
% The \cls{njuthesis} class is intended for typesetting Nanjing University
% dissertations with \hologo{LaTeX}, providing support for bachelor, master,
% and doctoral thesis.
Yu Xiong's avatar
Yu Xiong committed
% \end{abstract}
%
Yu Xiong's avatar
Yu Xiong committed
% \vspace{2cm}
Yu Xiong's avatar
Yu Xiong committed
% \def\abstractname{特别声明}
% \begin{abstract}
% 在使用本模板时,我们默认您同意以下内容:
% \begin{enumerate}
%   \item 本模板通过 LPPL 1.3c 协议开放源代码,您可以随意使用编译出的 PDF 文件。
Yu Xiong's avatar
Yu Xiong committed
%   \item 本模板与学校官方部门并不存在合作关系,
%         作者不对使用本模板产生的格式审查问题负责。
%   \item 遇到本文档没有覆盖的问题属于正常情况,欢迎提交反馈意见。
% \end{enumerate}
Yu Xiong's avatar
Yu Xiong committed
% 我们的 \href{https://git.nju.edu.cn/nju-lug/lug-introduction}
%   {Linux 用户组}始终欢迎您的加入!
Yu Xiong's avatar
Yu Xiong committed
% \end{abstract}
%
Yu Xiong's avatar
Yu Xiong committed
% \clearpage
Yu Xiong's avatar
Yu Xiong committed
%
% \setcounter{tocdepth}{4}
Yu Xiong's avatar
Yu Xiong committed
% \tableofcontents
% \begin{documentation}
Yu Xiong's avatar
Yu Xiong committed
% \section{模板介绍}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \cls{njuthesis},即南京大学学位论文模板,是一个由南京大学 Linux
% 用户组维护的,用于处理本校学生毕业论文排版需求的 \hologo{LaTeX} 模板。
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% 本模板使用的本科生毕业论文模板格式依据
% 《关于启动南京大学2022届本科毕业论文(设计)工作的通知》\cite{nju2021},
% 研究生学位论文格式依据研究生院提供的材料包。
Yu Xiong's avatar
Yu Xiong committed
%
% \subsection{开始之前}
% \label{subsec:first-things-first}
% 在本文正式介绍 \cls{njuthesis} 论文模板前,您也许并不熟悉 \hologo{TeX} 排版系统。话不多说,请先完整体验一遍下述的工作流程:
%
% \bigskip
% \fcolorbox{olgreen}{gray!5}{\parbox{\textwidth-5em}{%
% \hspace{2em}\begin{minipage}[c]{10cm}
% \begin{enumerate}
Yu Xiong's avatar
Yu Xiong committed
%   \item 访问 \url{https://tex.nju.edu.cn}
%   \item 点击右上角~\olbutton{注册}~按钮,
%        用\href{https://itsc.nju.edu.cn/1b/ce/c21586a334798/page.htm}
%        {南大邮箱}注册账号
%   \item 登录您的账号
%   \item 点击左上角~\olbutton{创建新项目}~按钮,选择~\olbutton{论文模板}
%   \item 随意取名,点击~\olbutton{创建}~按钮
% \end{enumerate}
% \end{minipage}}}
%
% \bigskip
Yu Xiong's avatar
Yu Xiong committed
% 稍等片刻,您会在浏览器右侧发现一份新生成的空白论文。
% 如果它的效果令您满意,不妨以此为基础开始写作。
%
% \subparagraph{我一定要体验上述流程吗?}
Yu Xiong's avatar
Yu Xiong committed
% 是,但也不一定。有人坚持认为应该做一些\emph{直观、清晰、有手就行、一
% 条路走到底}的教程,而不是\emph{长篇累牍的精细介绍},其核心论据在于:
% 现代人类总体上需要快速取得成就感,而且大部分可能用到本模板的同学不
% 会具备必要的基础知识。反驳的观点在于过分简单的实验总是浪费时间的,
% 尤其是在您可能早已掌握基本用法的情况下。但,不论如何,这番操作总会
% 使您预览到 \cls{njuthesis} 论文模板的实际样式。
%
% \subparagraph{我并没有见到理想的结果。}
Yu Xiong's avatar
Yu Xiong committed
% 具体是哪里不满意?如果是\emph{样式存在偏差},请联系模板的作者;如果
% \emph{不能访问前文提到的在线编译网站},请考虑检查网络连接,依次咨询
% 本校\href{https://itsc.nju.edu.cn}{信息化管理建设服务中心}和该网站
% 的维护者\href{mailto:my@yaoge123.cn}{姚舸老师};如果\emph{报错},请
% 点击左上角的菜单按钮,查看编译器是否显示为 |XeLaTeX|;
% 再如果\emph{还有其他原因},通过这几分钟的实验我们也可以得到一个相当
% 有益的结论:\emph{也许 Word 模板更加适合您}。这可以节省下熟悉
% \hologo{TeX} 排版软件使用方法所需的可观时间。
%
% \subparagraph{但我依然对 \hologo{LaTeX} 一无所知!}
Yu Xiong's avatar
Yu Xiong committed
% 这意味着您也许得花些时间在\emph{长篇累牍的精细介绍}上。
% 请接着向后阅读,有需要时善用搜索。
% \subsection{历史沿革}
% 十几年来,多位热心校友发布过自己编写的模板,在 GitHub 网站上可考的包括:
% \begin{enumerate}
Yu Xiong's avatar
Yu Xiong committed
%   \item 杨文博(\href{http://yangwenbo.com/}{@solrex})的
%        njuthesis(2010 - 2018) \cite{wenboyang2013}
%   \item \href{https://github.com/fireblue}{@fireblue} 基于杨文博模板的
%        NJUThesis(2013)\cite{fireblue2013}
%   \item \href{https://github.com/wenhai-zheng}{@wenhai-zheng} 的
%        NJUThesis(2013)\cite{wenhai-zheng2013}
%   \item 曹增乐(\href{https://github.com/ZLCao}{@ZLCao})的
%        NJUBachelor(2013 - 2016)\cite{zenglecao2013}
%   \item 胡海星(\href{http://haixing-hu.github.io/}{@Haixing-Hu})的
%        NJU-Thesis(2013 - 2018)\cite{haixinghu2013}
%   \item 张楚珩(\href{https://github.com/zhangchuheng123}{@zhangchuheng123})
%        基于胡海星模板的 NJUThesis(2016)\cite{chuhengzhang2016}
%   \item 蒋炎岩(\href{http://ics.nju.edu.cn/~jyy/}{@jiangyy})的
%        njuthesis(2017 - 2019)\cite{yanyanjiang2017}
%   \item \href{https://github.com/njuHan}{@njuHan} 基于胡海星模板的
%        NJU-Thesis(2018 - 2021)
%   \item 饶安逸(\href{https://anyirao.com/}{@AnyiRao})基于张楚珩模板的
%        NJU Thesis 2018(2018)\cite{anyirao2018}
%   \item 赵懿晨(\href{https://fengchendian.github.io/about.html}
%        {@FengChendian})基于饶安逸模板的
%        NJU Thesis 2021(2021)\cite{yichenzhao2021}
% \end{enumerate}
% 至于不幸而未进行代码版本管理的,甚至于说以压缩包形式流传于各人硬盘中的,就更不可计数了。
%
Yu Xiong's avatar
Yu Xiong committed
% 与其让一千个学生做一千种不同的模板,不如有人牵起头来,集中力量办大事。因此,南
% 京大学 Linux User Group 的有志之士在2021年暑期联合起来,参考以上的现成模板,兼
% 顾友校 \cls{fduthesis}\cite{fduthesis}、\textsc{THuThesis}\cite{thuthesis} 等
% 优秀项目,构建了这一全新模板,力求通过 \hologo{LaTeX3} 语法和清晰的接口实现良
% 好的易用性和可维护性。
% 目前,本模板的主要维护者包括:
% \begin{itemize}
Yu Xiong's avatar
Yu Xiong committed
%   \item 赵懿晨
%   \item 熊煜
%   \item 马畅
Yu Xiong's avatar
Yu Xiong committed
%
% \subsection{快速上手}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \hologo{LaTeX} 并不是一种零门槛的语言,亦不是南京大学学生的必备技能。有同学听
% 到“\emph{给毕业论文交差也得写代码}”这种事情就头疼,实在是我们不愿意见到而必须
% 要面对的情况。目前,中文互联网上的 \hologo{LaTeX} 写作教程可谓汗牛充栋,然而
% 如何快速准确找到所需要的用法,尤其是 \hologo{LaTeX3} 的新接口,需要一定的时间
% 或者良好的英文阅读能力。在本文档的写作中,我们无力从盘古开天辟地开始从头构建您
% 的相关知识体系,只能\emph{尽力做到有求必应},在需要的地方顺带提一嘴,以期使您
% 少走点弯路。
Yu Xiong's avatar
Yu Xiong committed
%
% 如果您希望在使用本模板前了解一些关于这个排版软件的基础知识,在此尝试列举一些有
% 所帮助的资料:
Yu Xiong's avatar
Yu Xiong committed
% \begin{description}
%   \item[\textit{lshort}] 著名的介绍文档,已被译为多种语言,可以参考英文版\cite{lshort}及其中文翻译版\cite{lshort-zh-cn}。
Yu Xiong's avatar
Yu Xiong committed
%   \item[《\hologo{LaTeX} 入门》] 刘海洋著\cite{刘海洋2013latex入门}。
Yu Xiong's avatar
Yu Xiong committed
% \end{description}
%
%
% \subsection{关于本说明手册}
%
Yu Xiong's avatar
Yu Xiong committed
% 本模板通过 \textsc{DocStrip} 进行维护,实际上是一种\emph{文学编程}。文学编程的
% 本体是那些用来说明的文字,按写书写文章的方式组织。\file{njuthesis.dtx} 包含
% \cls{njuthesis} 文档类的所有信息。前半部分为模板说明,即各种常用命令与必要的使
% 用方法;后半部分为代码实现,为带有详细注释的 \hologo{TeX} 源代码。后者配合附
% 录,为有意了解本模板实现细节的同学提供必要指引。
Yu Xiong's avatar
Yu Xiong committed
% 下文中将出现若干特殊格式,用来指示代码组件。譬如,无衬线字体的
% \pkg{pkg-example} 为宏包名,等宽字体的 \file{file-example.xxx} 为文件名,等宽
Yu Xiong's avatar
Yu Xiong committed
% 字体的 \opt{opt-example} 为选项名,等宽字体的 \env{env-example} 为需要
Yu Xiong's avatar
Yu Xiong committed
%  |\begin{}|和|\end{}|的环境名,等。本手册提供的代码示例中,左侧边线呈现南大标
% 准洋红色 {\color{njumagenta}$\blacksquare$} 的属于终端命令,呈南大标准蓝色
% {\color{njublue}$\blacksquare$} 的属于 \hologo{LaTeX} 源代码。
Yu Xiong's avatar
Yu Xiong committed
%
%
% \subsection{许可说明}
%
% \file{njuthesis.dtx} 文件以及由其直接产生的所有文件被称为 \cls{njuthesis} 文档类,或者在本文中简称为本模板。
%
% \subparagraph{版权信息}
Yu Xiong's avatar
Yu Xiong committed
%   本模板之版权隶属于 © 2021 - 2022 南京大学 Linux 用户组。
%
% \subparagraph{发布和修改}
%   本模板的发布和(或)修改遵守 LaTeX Project Public License(版本 1.3c 或更高)的条款。该许可证的最新版本位于 \url{http://www.latex-project.org/lppl.txt},1.3c 及更新的版本随附于 2003/12/01 版本以后的所有 \hologo{LaTeX} 发行版。
%
% \subparagraph{联系作者}
%   如果您在使用最新版模板时发现了任何问题,抑或有意向参与本模板的维护,请通过 \href{https://github.com/nju-lug/NJUThesis/issues}{GitHub Issue} 或者 QQ 群聊\footnote{群号是 991559926。}联系 NJU LUG。
Yu Xiong's avatar
Yu Xiong committed
%
% \section{安装}
Yu Xiong's avatar
Yu Xiong committed
% \label{sec:setup}
Yu Xiong's avatar
Yu Xiong committed
% 本节主要介绍本宏包的获取、安装以及编译方式。
Yu Xiong's avatar
Yu Xiong committed
% \subsection{获取模板}
% \cls{njuthesis} 目前处于积极的维护中,主要可通过以下三种途径获取模板文件:
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \subparagraph{CTAN}
% \href{https://ctan.org/}{CTAN}\footnote{The Comprehensive \hologo{TeX}
% Archive Network} 是所有 \hologo{TeX} 相关材料的中枢。
% 本模板的 CTAN 页面
% \footnote{\href{https://ctan.org/pkg/njuthesis}{\cls{njuthesis}} 已经于2021年9
% 月12日发布在 CTAN,用于绘制南大图标的
% \href{https://ctan.org/pkg/njuvisual}{\pkg{njuvisual}} 也已于同年11月28日发
% 布,两者已被 \hologo{TeX}\,Live 和 \hologo{MiKTeX} 收录,将进入 \hologo{TeX}\,
% Live 2022 发行版。}上提供基本的介绍信息,可以下载说明文档(本文档)和宏包源代
% 码。当然,使用这一来源时并不需要接触后者,请参考
% \ref{subsubsec:standard-installation} 的标准安装方法。
%
% \subparagraph{GitHub 仓库}
% 最新开发进度会提交在本项目的
% \href{https://github.com/nju-lug/NJUThesis}{Github仓库}。仓库内仅包含源代码、
% 空白模板及测试文件,不可直接用于写作。这些文件对应的使用方法请参考
% \ref{subsubsec:on-the-fly-installation}。如果由于网络原因不便访问主仓库,也可
Yu Xiong's avatar
Yu Xiong committed
% 以从 \href{https://git.nju.edu.cn/nju-lug/nju-latex-templates/njuthesis}
% {NJU Git 同步镜像}获取项目工程文件。
Yu Xiong's avatar
Yu Xiong committed
%
% \subparagraph{GitHub Releases}
Yu Xiong's avatar
Yu Xiong committed
% 本模板不定期将已有的新功能和问题修复打包为新的正式发行版,赋以更改后的版本号,
% 发布在 \href{https://github.com/nju-lug/NJUThesis/releases/latest}{Github
% Releases 页面}。如果由于网络原因不便访问主仓库,也可以从\ignorespaces
% \href{https://mirror.nju.edu.cn/github-release/nju-lug/NJUThesis/LatestRelease/}
% {南京大学镜像站下载页面}获取。可供下载的文件包括下列三种:
Yu Xiong's avatar
Yu Xiong committed
%   \begin{description}
%     \item[\file{njuthesis-v*.pdf}] 模板说明文档(本文档)。
Yu Xiong's avatar
Yu Xiong committed
%     \item[\file{njuthesis-user-v*.zip}] 交付给用户的完整模板包,
%          包括格式文件和范本文档,可在解压后用于本地编译,
%          也可直接上传至在线编译网站。
%     \item[\file{njuthesis-ctan-v*.zip}] 交付给 CTAN 的源代码包,
%          普通用户请忽略。
Yu Xiong's avatar
Yu Xiong committed
%   \end{description}
%
%
% \subsubsection{文件构成}
%
Yu Xiong's avatar
Yu Xiong committed
% 本模板由数量众多的文件组成,\emph{所有可能遇到的}文件如表
% \ref{tab:njuthesis-files} 所示。
%
% \begin{table}[ht]
%   \centering
%   \begin{talltblr}[
Yu Xiong's avatar
Yu Xiong committed
%       caption = {\cls{njuthesis}文件构成},
%       label = {tab:njuthesis-files},
%       note{a} = {仅供开发使用,并不会在发布版本中出现。}
%     ] { row{1} = {font=\bfseries}, colspec = {ll} }
%     名称                               & 说明                             \\
%     \file{.vscode}                     & Visual Studio Code 配置文件      \\
%     \file{CHANGELOG.md}                & 修订记录                         \\
%     \file{latexmkrc}                   & \pkg{latexmk} 配置文件           \\
%     \file{LICENSE}                     & 许可证                           \\
%     \file{njuthesis.cls}               & 模板文档类                       \\
%     \file{njuthesis.dtx}\TblrNote{a}   & 文档类源代码                     \\
%     \file{njuthesis.ins}\TblrNote{a}   & 文档类安装脚本                   \\
%     \file{njuthesis.pdf}               & 用户手册(本文档)               \\
%     \file{njuthesis-sample.bib}        & 示例参考文献列表                 \\
%     \file{njuthesis-sample.tex}        & 示例文档,不妨以此为基础撰写论文 \\
%     \file{njuthesis-graduate.def}      & 研究生参数配置文件               \\
%     \file{njuthesis-undergraduate.def} & 本科生参数配置文件               \\
%     \file{README.md}                   & 自述文件                         \\
%   \end{talltblr}
Yu Xiong's avatar
Yu Xiong committed
% \subsection{本地安装}
%
% \subsubsection{标准安装}
% \label{subsubsec:standard-installation}
%
Yu Xiong's avatar
Yu Xiong committed
% 我们\emph{始终建议}使用宏包管理器将 \cls{njuthesis} 安装到您的 \hologo{TeX} 系
% 统。您可以通过 \hologo{TeX}\,Live Manager 或者 \hologo{MiKTeX} Console 等图形
% 化包管理器直接搜索并安装 \cls{njuthesis} (及其依赖的 \pkg{njuvisual})最新的
% 稳定版。同时,您也可以使用终端命令。例如,假设您使用的是 \hologo{TeX}\,Live,
% 键入下述 \pkg{tlmgr} 的命令(很可能需要管理员权限):
% \begin{shellexample}[morekeywords={tlmgr},emph={install}]
Yu Xiong's avatar
Yu Xiong committed
%   tlmgr install njuthesis njuvisual
% \end{shellexample}
Yu Xiong's avatar
Yu Xiong committed
% 即可完成安装,无需额外准备 \file{.cls} 文件。
Yu Xiong's avatar
Yu Xiong committed
% 另一方面,CTAN 依赖开发者手动上传更新,版本更新具有滞后性。如果使用时遇到了问
% 题,不妨使用下一小节的\emph{即时安装方法}优先载入较新的格式文件。
% {\color{red}|[!]|} 如果您具备相关经验\footnote{譬如熟悉命令行操作、使用的是 \hologo{TeX}\,Live 发行版等},可以在下载仓库内全部文件后,于该目录下运行
% \begin{shellexample}[morekeywords={l3build},emph={install}]
Yu Xiong's avatar
Yu Xiong committed
%   l3build install
% \end{shellexample}
% 来安装本模板的最新版。
Yu Xiong's avatar
Yu Xiong committed
% \subsubsection{即时安装}
% \label{subsubsec:on-the-fly-installation}
Yu Xiong's avatar
Yu Xiong committed
% 在某些情况下(例如需要上传至在线编译平台、新版本提供了急需的错误修复),您可能
% 需要独立的 \file{.cls} 格式文件。此时请前往前述的 Releases 页面下载
% \emph{完整模板包}。
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% 对于希望使用主仓库中版本的用户,本模板也提供了扁平化安装脚本,用于释放供编译的
% 空白模板和格式文件。Windows 用户请直接双击打开 \file{install-win.bat};其他平
% 台(包括 macOS 和 Linux)用户请在此目录下运行
Yu Xiong's avatar
Yu Xiong committed
% \begin{shellexample}[morekeywords={bash}]
%   bash install-unix.sh
% \end{shellexample}
Yu Xiong's avatar
Yu Xiong committed
% 该脚本会生成一个 \file{mythesis/} 目录以便从头写作,仓库内除此文件夹以外的内容
% 都可以尽情删除。
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% {\color{red}|[!]|} 请注意,如果仅仅是希望使用这个模板撰写论文,请无论如何都不
% 要从手动编译 \file{source} 文件夹下的源代码开始,这样做只会浪费生命中宝贵的数
Yu Xiong's avatar
Yu Xiong committed
% 分钟时间。如果遇到了问题,请前往 GitHub 仓库提出 issue。我们只推荐希望参与开发
% 的同学接触 \file{.dtx} 文件。
% \subsection{本地编译}
Yu Xiong's avatar
Yu Xiong committed
% \label{subsec:localcompile}
Yu Xiong's avatar
Yu Xiong committed
% 本地编译的安装过程分为两个阶段:安装 \hologo{TeX} 发行版以及配置编辑器。前者提供了可以被命
% 令行终端调用的编译程序,后者则提供了语法高亮、自动编译等人性化功能。
% \subsubsection{安装\hologo{TeX}发行版}
%
Yu Xiong's avatar
Yu Xiong committed
% 首先需要下载并安装 \hologo{TeX} 软件发行版,其中包括引擎、宏包、字体、
% 文档等。各操作系统适用情况请参考表~\ref {tab:texdistribution}。第一次
% 编译前请务必通过 MiKTeX Console、TeX LiveManager 等图形化程序或
% \pkg{tlmgr} \emph{手动更新全部宏包}以避免潜在的兼容性问题。
% \begin{table}[ht]
%   \centering
%   \caption{\hologo{TeX} 软件发行版一览}
%   \label{tab:texdistribution}
%   \begin{tabular}{cccc}
%     \toprule
%     \hologo{TeX}        & Windows   & macOS     & Linux     \\
%     \midrule
Yu Xiong's avatar
Yu Xiong committed
%     \hologo{TeX}\,Live  & $\bullet$ &           & $\bullet$ \\
%     Mac\hologo{TeX}     &           & $\bullet$ &           \\
Yu Xiong's avatar
Yu Xiong committed
%     \hologo{MiKTeX}     & $\bullet$ & $\bullet$ & $\bullet$ \\
%     \bottomrule
%   \end{tabular}
% \end{table}
% 以下是一些值得注意的要点:
% \begin{itemize}
Yu Xiong's avatar
Yu Xiong committed
%   \item 可以参照这份\emph{手把手的教程}\cite{install-latex-guide-zh-cn}。
Yu Xiong's avatar
Yu Xiong committed
%   \item 校园网环境中访问\ignorespaces
%         \href{https://mirror.nju.edu.cn/download/TeX%20排版系统}
%         {南京大学开源软件镜像站}可以获得最佳的下载体验。
%   \item 使用最新的发行版,即版本号为2021或者21。
%   \item 对于 Windows 和 macOS 用户,更推荐轻量化的 \hologo{MiKTeX} 套件。
Yu Xiong's avatar
Yu Xiong committed
% ^^A   \item Linux 用户请尽可能下载 full 版本,如 |texlive-full|。
% ^^A         换言之,下载最大的软件包。
%   \item 对于一部分用到新版本特性的宏包,\cls{njuthesis} 内置了版本检查
%         \footnote{譬如遇到 l3 过时问题请运行 |tlmgr update l3packages|。}
%         ,请确认各宏包已升级至最新版。
% \end{itemize}
Yu Xiong's avatar
Yu Xiong committed
%
% \subsubsection{配置编辑器}
% \changes{v0.11}{2021/11/23}{提供 TeXstudio 配置文件。}
Yu Xiong's avatar
Yu Xiong committed
%
% 配置完编译器后,还需要一个\emph{文本编辑器}来完成 \file{.tex} 文件内容的写作。
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% 关于具体使用哪一种,至今仍有相当一部分人认为Windows自带的\emph{记事本}是
% 最好的文本编辑器。但对于本项目而言,在此诚心诚意地推荐您使用\emph{更现代
% 更美观更多功能}的编辑器,譬如\emph{安装了 \hologo{LaTeX} Workshop 插件的
% \href{https://code.visualstudio.com/}{Visual Studio Code}}。您也可以根据
% 个人的喜好随意使用 TeXworks、TeXstudio 等编辑器,顺手就行。
Yu Xiong's avatar
Yu Xiong committed
%
% \cls{njuthesis} 为一些常见编辑器提供了配置文件,如
% \begin{description}
Yu Xiong's avatar
Yu Xiong committed
%   \item[Visual Studio Code] 本模板在 \file{.vscode/} 中提供一份
%        \hologo{LaTeX} Workshop 插件的简易配置,在打开文件夹后将自动导入,
%        可以省略初始配置步骤直接使用。
%   \item[TeXstudio] 本模板提供 \file{conf.txsprofile},可以使用快捷键
%        |alt+O+P| 导入配置文件。为了简化流程\footnote{当然,也可以设置
%        为使用 \hologo{XeLaTeX} 编译,然后按照 \ref{subsubsec:compileseq}
%        内容使用快捷键 |F8| 手动编译参考文献。},该配置文件使用
%        \pkg{latexmk},第一次编译前请参考下一节内容安装 Perl。
% \end{description}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \subsubsection{编译顺序}
% \label{subsubsec:compileseq}
Yu Xiong's avatar
Yu Xiong committed
% \hologo{TeX} 本身是命令行程序,通过不同的命令调用所需的编译引擎,
% 编辑器提供的快捷按钮实际只是做了包装。为了便于排查运行错误,
% 以下通过具体终端命令简要描述编译过程。
% 编译本模板的过程可以概括为下述步骤:
% \begin{enumerate}
%   \item 生成初始文档
%   \item 生成参考文献信息
%   \item 生成页码、编号、目录
%   \item 将参考文献列表页插入目录
% \end{enumerate}
Yu Xiong's avatar
Yu Xiong committed
% 总计需要编译四次。\emph{假设即将使用的主文件名为
% \file{njuthesis-sample.tex}},应采用以下命令顺序进行编译,
% 以生成内容正确的 \file{njuthesis-sample.pdf}。输出的 PDF
Yu Xiong's avatar
Yu Xiong committed
% 文档位于同一目录下。该目录下同时会生成若干中间文件。
% 编译命令具体为引擎名称加主文件名,在编译 \file{.tex} 文件时,
% 文件扩展名可以省略不写。现阶段 \cls{njuthesis} 仅支持 \hologo{XeTeX}
% 与 \hologo{LuaTeX} 引擎,以及 \hologo{biber} 文献工具。请注意,
% 几种命令的输出文件基本相同,可以任取一种;但如果您不清楚这两种编译引擎的
Yu Xiong's avatar
Yu Xiong committed
% 区别,或者对多步编译感到困惑,我们建议优先使用 |latexmk -xelatex|。
% \subparagraph{使用 \hologo{XeLaTeX}}
% 标准的 \hologo{XeTeX} 引擎四步编译方法。
% \begin{shellexample}[morekeywords={xelatex,biber}]
Yu Xiong's avatar
Yu Xiong committed
%   xelatex njuthesis-sample
%   biber njuthesis-sample
%   xelatex njuthesis-sample
%   xelatex njuthesis-sample
% \end{shellexample}
% \subparagraph{使用 \hologo{LuaLaTeX}}
% 标准的 \hologo{LuaTeX} 引擎四步编译方法。
%
% \begin{shellexample}[morekeywords={lualatex,biber}]
Yu Xiong's avatar
Yu Xiong committed
%   lualatex njuthesis-sample
%   biber njuthesis-sample
%   lualatex njuthesis-sample
%   lualatex njuthesis-sample
% \end{shellexample}
% \subparagraph{使用 \pkg{latexmk}}
Yu Xiong's avatar
Yu Xiong committed
% \pkg{latexmk}\cite{latexmk} 是一个基于 Perl 脚本的自动编译工具,
% 宗旨是通过单一命令简化上述的多次编译流程。
% 在使用该命令前,请确保安装了以下软件:
% \begin{description}
Yu Xiong's avatar
Yu Xiong committed
%   \item[Perl] 一般预装于 macOS 和 Linux,而 Windows 用户需要单独安装
%        \href{https://strawberryperl.com/}{Strawberry Perl}。
%   \item[\pkg{latexmk}] 如果终端找不到 |latexmk| 命令,需使用包管理器单独安装。
% \end{description}
%
% 该命令的使用方法为
% \begin{shellexample}[morekeywords={latexmk}]
Yu Xiong's avatar
Yu Xiong committed
%   latexmk njuthesis-sample
% \end{shellexample}
% 直接运行会调用 \hologo{pdfLaTeX} 引擎导致报错。
% 如需指定编译引擎,可以加入 |-xelatex| 或 |-lualatex| 参数。
% 例如,指定 \hologo{XeLaTeX} 的命令为
% \begin{shellexample}[morekeywords={latexmk},emph={-xelatex}]
Yu Xiong's avatar
Yu Xiong committed
%   latexmk -xelatex njuthesis-sample
% \end{shellexample}
% 此外,可以选择使用以下命令清理编译生成的临时文件。
% \begin{shellexample}[morekeywords={latexmk},emph={-c}]
%   latexmk -c
% \end{shellexample}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \subsection{在线编译}
Yu Xiong's avatar
Yu Xiong committed
% \label{subsec:onlinecompile}
Yu Xiong's avatar
Yu Xiong committed
%
% 相信您在接触了本地编译以后,很快就会意识到一些十分显然的事实,譬如 \hologo{TeX} 编译器安装过程较为漫长\footnote{因此对于 Windows 推荐 \hologo{MiKTeX}。},占用空间过大\footnote{事实上,可以通过 |scheme-infraonly| 模式安装 \hologo{TeX}\,Live,随后利用 \pkg{tlmgr} 安装依赖宏包,这份宏包列表可以在 Git 仓库的 \file{.github/workflows/build.yml} 找到。},而且在一部分处理器性能不佳的电脑上需要较长编译时间\footnote{出于文件 IO 速度的差异,同一个模板在 Linux 编译可以相对 Windows 节省约一半耗时。}。拒绝接受这些麻烦的同学不妨尝试本节介绍的在线编译方法。
Yu Xiong's avatar
Yu Xiong committed
%
% \subsubsection{南大\hologo{TeX}平台简介}
% \changes{v0.2}{2021/09/07}{添加对南大 \hologo{TeX} 的支持。}
Yu Xiong's avatar
Yu Xiong committed
%
% \href{https://tex.nju.edu.cn}{南大 \hologo{TeX}} 基于开源的 ShareLaTeX 平台构建\footnote{理论上在\href{https://doc.nju.edu.cn/books/latex}{这个网站}能找到一段平台简介,实际上大家都有意无意地鸽了,下次一定补上。},于2021年3月4日正式上线,是 \href{https://sci.nju.edu.cn/}{eScience 中心}为南大在校师生提供的 \hologo{LaTeX} 在线编辑器,首次使用需凭学校邮箱自助注册账号。
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \subsubsection{操作步骤}
%
% 本说明手册开头的 \ref{subsec:first-things-first} 即呈现了网站内嵌的 \cls{njuthesis} 模板的使用方法。由于南大 \hologo{TeX} 网站已预装 \cls{njuthesis},可以直接编写正文,无需 \file{.cls} 等格式文件。如果有其他要求,也可以按如下步骤手动上传包含模板的压缩包。
%
Yu Xiong's avatar
Yu Xiong committed
% \begin{enumerate}
%   \item 访问\href{https://tex.nju.edu.cn}{南大 \hologo{TeX} 网站},点击界面右上方“注册”按钮,使用\emph{南京大学邮箱}注册账号并登录
%   \item 新建空白项目,或者上传 \ref{subsubsec:on-the-fly-installation} 得到的压缩文件。
%   \item 在项目页面左上角的“菜单”中,确认编译器为 |XeLaTeX| 或者 |LuaLaTeX|
%   \item 仿照 \file{njuthesis-sample.tex} 编写论文
%   \item 点击“重新编译”按钮进行编译和预览
Yu Xiong's avatar
Yu Xiong committed
% \end{enumerate}
%
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \subsubsection{其他平台}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \subparagraph{Overleaf}
% \changes{v0.12}{2021/12/07}{更新了对 Overleaf 的支持情况。}
% \pkg{njuthesis} 现已支持 \href{https://www.overleaf.com/}{Overleaf} 平台。
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \subparagraph{TeXPage}
% \href{https://www.texpage.com/}{TeXPage} 是国人研发的 \hologo{LaTeX} 在线编辑器,当前版本已具备较为完善的编辑编译功能,而且免费版相对 Overleaf 增加了公式识别、编辑历史等实用工具,也可以作为一个备选项。
%
%
% \subsection{版本升级}
%
% 考虑到本模板仍在开发中,将不断发布新版本,您可能需要不定期进行更新以得到对于已知问题的修复补丁。每个版本的更新内容记录于 Git 仓库中的 \file{CHANGELOG.md}。考虑到安装和编译方式的差异,不妨直接将论文内容迁移至新版的 \file{njuthesis-sample.tex}\footnote{请赞美 \hologo{TeX} 系统“样式与内容分离”的原则!},然后按照当前工作文件夹内是否有 \file{.cls} 文件分别进行更新操作。
%
% \subparagraph{有}
% 迁移至 \file{njuthesis-user-v*.zip} 提供的新内容。
%
% \subparagraph{没有}
% 如果使用的是南大 \hologo{TeX},更新内置模板时会进行公告,一般为上传 CTAN 后一周。如果是本地安装,请直接使用包管理器进行更新:
% \begin{shellexample}[morekeywords={tlmgr},emph={update}]
%   tlmgr update all
% \end{shellexample}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
%
% \section{使用方法}
Yu Xiong's avatar
Yu Xiong committed
% \subsection{标准结构}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% 典型的 \cls{njuthesis} 主文件结构应该如下所示:
Yu Xiong's avatar
Yu Xiong committed
%
% \begin{latexexample}[moretexcs={\njusetup,\graphicspath,\tableofcontents,\maketitle,\mainmatter,\chapter,\printbibliography},emph={[1]document}]
%   \documentclass{njuthesis}
%   \njusetup{}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{document}
%   \maketitle
%   \tableofcontents
%   \mainmatter
%   \chapter{欢迎}
%   使用 \LaTeX{}!
%   \printbibliography
Yu Xiong's avatar
Yu Xiong committed
%   \end{document}
% \end{latexexample}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% 如果您尝试编译上面的代码,会发现自己得到了一个5页的 PDF 文档,是一份空白的本科生论文。
% 当然,这个文档实际上没有任何内容,接下来将会介绍具体填写内容的方法。
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \subsection{模板选项}
Yu Xiong's avatar
Yu Xiong committed
%
% 模板选项位于 \tn{documentclass} 后的方括号内,用于指定模板的行为。
Yu Xiong's avatar
Yu Xiong committed
% 下文中尖括号内列出了若干个允许的选项,其中加粗的为默认选项。
% \subsubsection{学位信息}
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[added=2021-09-07]{degree}
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%     degree = <(ug)|mg|mf|phd>
%   \end{syntax}
Yu Xiong's avatar
Yu Xiong committed
% 选择学位,分别为学士、学术型硕士、专业硕士、博士,默认为学士(即本科生)。
% \end{function}
%
% \begin{function}[added=2021-09-07]{type}
%   \begin{syntax}
%     type = <(thesis)|design>
%   \end{syntax}
% 用于选择文档类型并将相关字段输出在封面和摘要页,可选值分别为毕业论文和毕业设计,默认为毕业论文。
% \end{function}
%
% \subsubsection{特殊页面}
%
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[added=2021-09-07]{nlcover}
%   \begin{syntax}
%     nlcover = <\TFF>
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
% 是否使用国家图书馆封面,默认关闭。
% 通过此项可用国家图书馆封面\emph{替换}普通封面。
Yu Xiong's avatar
Yu Xiong committed
% 由于本科生院文件中并未提及相关规定,故本选项仅对于研究生有效。
%
% \begin{function}[updated=2022-01-06]{decl-page}
%   \begin{syntax}
%     decl-page = <\TFF>
%   \end{syntax}
% 是否需要诚信承诺书或原创性声明页面,默认关闭。
%
% 通过此项可在封面后添加本科生的诚信承诺书或研究生的原创性声明。
%
Yu Xiong's avatar
Yu Xiong committed
%
% \subsubsection{单双面模式}
%
% \begin{function}[added=2022-01-14]{oneside,twoside}
%   \begin{syntax}
%     <oneside|(twoside)>
%   \end{syntax}
% 开启单面或双面模式,默认为双面模式。
% \end{function}
%
% 本选项继承自 \hologo{LaTeX2e} \cls{book} 标准文档类。单双面选项为全局选项,开启后会改变页码编号,以及部分宏包的行为。在单面模式下,页面是连续的,不会产生空白页;在双面模式下,封面、摘要、参考文献列表等特殊页面以及新的章节都会从奇数页开始,更适合印刷输出。
%
%
Yu Xiong's avatar
Yu Xiong committed
% \subsubsection{草稿模式}
% \begin{function}[added=2021-12-15]{draft}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%     draft = <\TFF>
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
Yu Xiong's avatar
Yu Xiong committed
% 选择是否开启草稿模式,默认关闭。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
%
% 本选项继承自 \hologo{LaTeX2e} \cls{book} 标准文档类。草稿模式为全局选项,启用这一选项将产生以下整体影响:
Yu Xiong's avatar
Yu Xiong committed
% \begin{itemize}
%   \item 禁用封面的绘制(包括承诺和声明)
Yu Xiong's avatar
Yu Xiong committed
%   \item 显示页面文字范围边框以及页眉页脚线
%   \item 在超出宽度的内容右侧添加黑色方块标记
Yu Xiong's avatar
Yu Xiong committed
%   \item 不再渲染图片,使用含有图片路径的空白盒子占位
%   \item 不再渲染超链接及生成 PDF 书签
% \end{itemize}
% 草稿模式有助于提升编译速度以及检查格式问题,建议在定稿前始终开启。
Yu Xiong's avatar
Yu Xiong committed
%
% 启用这一选项也会改变特定宏包的行为,譬如在草稿模式下 \pkg{listings}
% 宏包的代码环境不会显示内容,具体效果需要参照各个宏包的说明文档。
% 如需抵消草稿模式的影响,请使用 \opt{final} 选项载入相关宏包。
% \subsubsection{配置文件}
%
% \begin{function}[added=2022-02-23]{config}
%   \begin{syntax}
%     config = \Arg{文件}
%   \end{syntax}
% 配置文件路径。
% \end{function}
% 本选项可用于载入额外的用户配置文件。该文件支持 \hologo{LaTeX3} 语法。
Yu Xiong's avatar
Yu Xiong committed
%
%
% \subsubsection{指定字体}
%
% 学校论文格式要求使用的字体一般已经预装在各个操作系统,
% 本模板针对不同平台进行了自动检测适配,可以开箱即用。
% 如果希望更改本模板使用的字体,请填写以下两个选项以覆盖默认设置。
% \begin{function}[added=2021-09-07,updated=2021-12-18]{cjk-font,latin-font}
mc's avatar
mc committed
%   \begin{syntax}
%     cjk-font = <win|mac|fandol|founder|noto|source|none>
%     latin-font = <win|mac|gyre|none>
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
Yu Xiong's avatar
Yu Xiong committed
% 手动指定字体。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
%
mc's avatar
mc committed
% 根据学校论文格式的要求,本模板使用的中文字体主要有{\songti 宋体}、{\heiti 黑体}、{\kaishu 楷体}、{\fangsong 仿宋}四种;
% 西文字体主要有衬线体(\textup{serif})、无衬线体(\textsf{sans-serif})和等宽字体(\texttt{monospace})三种。
% 在生成论文时,需要将每一种字体(宋体、楷体)与一种字库(操作系统中的 ttf 文件)相对应。
% 由于不同操作系统自带的字库不同,在不同的操作系统上使用同一套配置会导致缺字、编译出错等后果。
% 因此,本模板对于中文字体和西文字体都提供了多种字体配置。
% 本模板提供的中文字体配置如表 \ref{tab:cjk-fontset} 所示。
Yu Xiong's avatar
Yu Xiong committed
% 在不指定字体配置的情况下,本模板默认使用与操作系统相对应的字体配置
% (见表中前三行,Windows 和 macOS 以外的系统采用 Fandol 配置)。
% 此外,我们也单独提供了方正和思源两套中文字体配置。
Yu Xiong's avatar
Yu Xiong committed
%
% \begin{table}[htbp]
%   \centering
mc's avatar
mc committed
%   \begin{talltblr}[
Yu Xiong's avatar
Yu Xiong committed
%       caption = {中文字体配置列表},
%       label = {tab:cjk-fontset},
%       note{a} = {请下载简繁扩展(即 GBK 编码)版本},
%       note{b} = {使用\ignorespaces
%         \href{http://www.foundertype.com/index.php/FontInfo/index/id/164}
%           {方正小标宋}作为方正书宋的粗体},
%     note{c} = {使用\ignorespaces
%       \href{http://www.foundertype.com/index.php/FontInfo/index/id/131}
%         {方正黑体}作为方正细黑一的粗体},
%     note{d} = {在部分操作系统中可能已经预装 Google Noto 字体。
%       考虑到获取字体的难易程度,单独安装时请采用
%       \href{https://mirrors.nju.edu.cn/download/Adobe%20Source%20Han}{Adobe Source Han}
%       字体表示思源字体,请下载 Simplified Chinese(即后缀名为 SC)的版本},
%     note{e} = {思源字体并不包含楷书和仿宋,而 Adobe 楷体和仿宋难以直接下载,
Yu Xiong's avatar
Yu Xiong committed
%       因此使用方正字体代替} ]
%     { cell{2}{2,4} = {white!70!njuyellow},
%       cell{4}{4} = {white!70!njuyellow},
%       row{1} = {font=\bfseries}, colspec = {ccccc} }
Yu Xiong's avatar
Yu Xiong committed
%   \toprule
Yu Xiong's avatar
Yu Xiong committed
%     配置名称     & 宋体        & 黑体        & 楷书        & 仿宋                 \\
Yu Xiong's avatar
Yu Xiong committed
%   \midrule
%     Windows      & 中易宋体    & 中易黑体    & 中易楷体    & 中易仿宋                 \\
%     macOS        & 华文宋体    & 华文黑体    & 华文楷体    & 华文仿宋                 \\
%     \href{https://www.ctan.org/pkg/fandol} {Fandol}
%                  & Fandol宋体  & Fandol黑体  & Fandol楷体  & Fandol仿宋               \\
%     \href{https://www.foundertype.com}{方正}\TblrNote{a}
%       & \href{http://www.foundertype.com/index.php/FontInfo/index/id/151}{方正书宋}\TblrNote{b}
%       & \href{http://www.foundertype.com/index.php/FontInfo/index/id/161}{方正细黑一}\TblrNote{c}
%       & \href{http://www.foundertype.com/index.php/FontInfo/index/id/137}{方正楷体}
%       & \href{http://www.foundertype.com/index.php/FontInfo/index/id/128}{方正仿宋}   \\
%     \href{https://github.com/adobe-fonts}{思源}\TblrNote{d}
%       & \href{https://mirrors.nju.edu.cn/adobe-fonts/source-han-serif/OTF/SimplifiedChinese/}{思源宋体}
%       & \href{https://mirrors.nju.edu.cn/adobe-fonts/source-han-sans/OTF/SimplifiedChinese/}{思源黑体}
Yu Xiong's avatar
Yu Xiong committed
%                                              & 方正楷体\TblrNote{e}  & 方正仿宋      \\
Yu Xiong's avatar
Yu Xiong committed
%   \bottomrule
mc's avatar
mc committed
%   \end{talltblr}
% \end{table}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% 由于各操作系统对自带字体的支持程度不同,本模板对不同字体加粗的方式有所差别,
% 表 \ref{tab:cjk-fontset} 中,黄色底色的字体采用算法加粗。
mc's avatar
mc committed
% 除此以外,各种字体在设计上也存在差异,因此本模板在不同操作系统下编译的结果可能存在细微不同,使用时请注意。
Yu Xiong's avatar
Yu Xiong committed
% 若想要获得与 Word 版本模板最为贴近的体验,
% 可以通过手动安装 Windows 自带的中易宋体、中易黑体、中易楷体和中易仿宋,并设置使用 Windows 字体来实现。
mc's avatar
mc committed
% 本模板提供的西文字体配置如表 \ref{tab:latinfontset} 所示。
Yu Xiong's avatar
Yu Xiong committed
% 在不指定字体配置的情况下,本模板默认使用与操作系统相对应的字体配置
% (见表中前三行,Windows 和 macOS 以外的系统采用 \opt{gyre} 配置)。
%
% \begin{table}[htbp]
%   \centering
mc's avatar
mc committed
%   \caption{西文字体清单}
%   \label{tab:latinfontset}
%   \begin{tabular}{cccc}
%     \toprule
%       \bf 配置名称 & \bf 衬线体                & \bf 无衬线体            & \bf 等宽字体             \\
%     \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}
Yu Xiong's avatar
Yu Xiong committed
%
% 若要手动选择字体,则需将字体设置为 \opt{none},再通过 \pkg{fontspec} 宏包或 \pkg{ctex} 宏包中给出的命令来实现。
Yu Xiong's avatar
Yu Xiong committed
% 最后,出于统一格式的需要,本模板还选取了与正文字体相似度最高的数学字体(\href{https://github.com/aliftype/xits}{XITS 字体})用于公式排版。
Yu Xiong's avatar
Yu Xiong committed
%
% 本节提及的字库中,中文字库只有方正书宋、方正黑体、方正楷体、方正仿宋、两种思源字体和四种Fandol字体能够\emph{免费商用};
Yu Xiong's avatar
Yu Xiong committed
% 英文字库中只有 Times New Roman、XITS 和三种 \Hologo{TeX} Gyre字体能够\emph{免费商用}。
% 因此,若需要将本模板用于商业相关的活动,请咨询专业人士。
%
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \subsection{个人信息}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[added=2021-09-10]{\njusetup}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%     \tn{njusetup} \Arg{键值列表}
Yu Xiong's avatar
Yu Xiong committed
% 是 \cls{njuthesis} 文档类的通用设置命令,用来设置各项功能。\tn{njusetup} 的参数是一个使用英文半角逗号分隔的键值列表,通常形如 \meta{key}|=|\meta{value}。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
%
Yu Xiong's avatar
Yu Xiong committed
% 目前,\tn{njusetup} 仅包含用于设置个人信息的 |info| 类。以下为全部的个人信息参数,其中带有星号的为对应的英文字段。请注意,部分参数已被弃置,列于后方。
%
% \begin{function}[updated=2022-01-14]{info/title,info/title*}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%     title  = \Arg{标题}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
% 题目。由于封面上提供给中文题目的横线长度有限\footnote{单行最长为15个汉字,建议总长度不超过45字},本模板默认会自动对标题进行换行。如果需要手动指定换行位点,请使用换行控制符( |\\| ),最多两处。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
%
% 绘制封面及摘要中的标题涉及断行处理,无法对空字符串产生正确结果。
% 因而在手动将标题设置为空时,本模板将抛出如下错误:
% \begin{shellexample}[deletekeywords={in}]
%   ! Package njuthesis Error: The title should not be left blank.
%   (njuthesis)                Please check whether you have fill in both
%   (njuthesis)                Chinese and English titles.
% \end{shellexample}
%
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[updated=2021-10-01]{info/keywords,info/keywords*}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%     keywords  = \Arg{关键词}
%     keywords* = \Arg{英文关键词}
%   \end{syntax}
% 关键词列表。关键词之间需要使用英文半角逗号隔开,含有空格的关键字需要使用花括号包裹以避免歧义。可以参照下方的填写示例。
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[updated=2021-10-01]{info/grade}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
% 年级,推荐格式为“20XX”。
% \end{function}
%
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[updated=2021-10-01]{info/student-id}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
% 学号。南京大学本科生为9位数字学号,研究生为两位大写字母标识加上八位数字组成的学号。
% \end{function}
%
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[updated=2021-10-01]{info/author,info/author*}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%     author  = \Arg{你的名字}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
% 姓名。
% \end{function}
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[updated=2021-10-01]{info/department,info/department*}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%     department  = \Arg{院系}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
% 院系。
% \end{function}
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[updated=2021-10-01]{info/major,info/major*}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%     major  = \Arg{专业}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
% 专业。
% \end{function}
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[updated=2021-10-01]{info/field,info/field*}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
% 研究领域。只有研究生存在研究领域的说法,本科生无需填写。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
Yu Xiong's avatar
Yu Xiong committed
%
% \begin{function}[updated=2022-01-12]{info/supervisor,info/supervisor*}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
%     supervisor = \Arg{导师姓名,职称}
%     supervisor* = \Arg{导师英文全称}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
Yu Xiong's avatar
Yu Xiong committed
% 导师全称。请使用逗号( |,| )分隔导师的中文姓名与职称,英文名则不需添加逗号。
% \end{function}
%
% \begin{function}[updated=2021-01-12]{info/supervisor-ii,info/supervisor-ii*}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
%     supervisor-ii = \Arg{第二导师姓名,职称}
%     supervisor-ii* = \Arg{第二导师英文全称}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
% 第二导师全称。无第二导师时不填即可。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[updated=2022-01-14]{info/submit-date}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%     submit-date = \Arg{yyyy-mm-dd}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
Yu Xiong's avatar
Yu Xiong committed
% 提交日期。中英文日期现在可以由 ISO 日期格式\cite{gb-t-7408-2005}的字符串统一生成。如果留空,则自动使用编译当天日期。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
%
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[updated=2021-01-14]{info/defend-date}
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%     defend-date = \Arg{yyyy-mm-dd}
%   \end{syntax}
% 答辩日期,只对研究生有效,要求同提交日期。
% \end{function}
%
% \begin{function}[updated=2021-10-01]{info/chairman,info/reviewer}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
%     chairman = \Arg{答辩主席}
%     reviewer = \Arg{评委姓名职称}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
Yu Xiong's avatar
Yu Xiong committed
% 答辩委员会信息,分别为评审委员会主席及四位成员的姓名加职称,只对研究生有效。四位评审成员是以列表的形式存储的,填写方法同关键词。如果是盲审,填入“盲审”二字即可。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
%
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}[updated=2021-10-01]{info/clc,info/secret-level,info/udc,info/supervisor-contact}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
%     clc = \Arg{中图分类号}
%     secret-level = <不涉密|秘密|机密|绝密>
%     udc = \Arg{udc}
%     supervisor-contact = \Arg{导师联系方式}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
Yu Xiong's avatar
Yu Xiong committed
% 国家图书馆封面相关,包括中图分类号、密级、UDC 分类号和导师联系方式。
Yu Xiong's avatar
Yu Xiong committed
% \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*}
Yu Xiong's avatar
Yu Xiong committed
% 这些选项已在 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}
%
Yu Xiong's avatar
Yu Xiong committed
% \subsubsection{输入示范}
Yu Xiong's avatar
Yu Xiong committed
% 本科生可以参考如下范例输入个人信息。注意不能有空行。
% \begin{latexexample}[moretexcs={\njusetup},emph={[2]info}]
Yu Xiong's avatar
Yu Xiong committed
%   \njusetup {
%       info = {
%           title = {第一行标题\\第二行标题},
%           title* = {My title in English},
%           keywords = {我,就是,充数的,关键词},
%           keywords* = {Dummy,Keywords,Here,{it is}},
Yu Xiong's avatar
Yu Xiong committed
%           grade = {2018},
%           student-id = {189114514},
%           author = {周煜华},
%           author* = {Zhou Yuhua},
Yu Xiong's avatar
Yu Xiong committed
%           department = {化学化工学院},
%           department* = {School of Chemistry and Chemical Engineering},
%           major = {化学},
%           major* = {Chemistry},
%           supervisor = {李成殿,教授},
%           supervisor*= {Professor Li Chengdian},
Yu Xiong's avatar
Yu Xiong committed
%           submit-date = {2021-09-12}
% \end{latexexample}
Yu Xiong's avatar
Yu Xiong committed
%
% 研究生可以参考如下列表输入个人信息
Yu Xiong's avatar
Yu Xiong committed
%
% \begin{latexexample}[moretexcs={\njusetup},emph={[2]info}]
Yu Xiong's avatar
Yu Xiong committed
%   \njusetup {
%       info = {
%           title = {第一行标题\\第二行标题\\第三行标题},
%           title* = {My title in English},
%           keywords = {我,就是,充数的,关键词},
%           keywords* = {Dummy,Keywords,Here,{it is}},
Yu Xiong's avatar
Yu Xiong committed
%           grade = {2018},
Yu Xiong's avatar
Yu Xiong committed
%           student-id = {DZ18114514},
Yu Xiong's avatar
Yu Xiong committed
%           author = {周煜华},
%           author* = {Zhou Yuhua},
Yu Xiong's avatar
Yu Xiong committed
%           department = {化学化工学院},
%           department* = {School of Chemistry and Chemical Engineering},
%           major = {化学},
%           major* = {Chemistry},
%           field = {物理化学},
%           field* = {Physical Chemistry},
%           supervisor = {李成殿,教授},
%           supervisor*= {Professor Li Chengdian},
Yu Xiong's avatar
Yu Xiong committed
%           submit-date = {2021-09-12},
%           defend-date = {2022-01-15},
Yu Xiong's avatar
Yu Xiong committed
%           chairman = {张晓山~教授},
%           reviewer = {王瑞希~教授,郭德纲~副教授,华芈库~教授,戴菲菲~教授},
Yu Xiong's avatar
Yu Xiong committed
%           clc = {0175.2},
%           secret-level = {限制},
%           udc = {004.72},
%           supervisor-contact = {拉太赫科学与技术学院 枝江市结丘路 19 号 114514}
%         }
%     }
% \end{latexexample}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \subsection{编写正文}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% 与导言区相对的是正文,位于 \env{document} 环境内。
% \begin{function}{\mainmatter}
Yu Xiong's avatar
Yu Xiong committed
%   \cs{mainmatter} 标志着正文的开始,使用阿拉伯数字重新进行页码编号,并设置页眉格式。
% \end{function}
%
% \begin{function}{\chapter,\section,\subsection,\subsubsection}
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%     \tn{chapter}\oarg{短描述}\marg{完整的章标题}
%     \tn{section}\oarg{短描述}\marg{完整的节标题}
%     \tn{subsection}\oarg{短描述}\marg{完整的节标题}
%     \tn{subsection}\oarg{短描述}\marg{完整的节标题}
%   \end{syntax}
% 对于过长的标题,目录和页眉中会使用其短描述。
% \end{function}
Yu Xiong's avatar
Yu Xiong committed
%
% \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 反馈},否则无需动用这些命令处理样式问题。
%
Yu Xiong's avatar
Yu Xiong committed
% \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} 包中的下划线命令进行了包装。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}{\footnote}
%   \begin{syntax}
%     \tn{footnote}\Arg{脚注}
%   \end{syntax}
% 添加脚注。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
%
% \subsubsection{图片}
Yu Xiong's avatar
Yu Xiong committed
%
% \begin{function}{\graphicspath}
%   \begin{syntax}
%     \tn{graphicspath}\{\marg{路径1}\marg{路径2}\}
%   \end{syntax}
% 添加图像路径。
Yu Xiong's avatar
Yu Xiong committed
% \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}]
Yu Xiong's avatar
Yu Xiong committed
%   \begin{figure}[h]
Yu Xiong's avatar
Yu Xiong committed
%       \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}]
Yu Xiong's avatar
Yu Xiong committed
%   \begin{wrapfigure}{r}{0cm}
Yu Xiong's avatar
Yu Xiong committed
%       \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}]
Yu Xiong's avatar
Yu Xiong committed
%   \begin{figure}
%       \begin{subfigure}{.32\textwidth}
%          \centering
%          \includegraphics[width=\textwidth]{fig1}
Yu Xiong's avatar
Yu Xiong committed
%          \caption{fig1}
%       \end{subfigure}
%       \begin{subfigure}{.32\textwidth}
%          \centering
%           \includegraphics[width=\textwidth]{fig2}
Yu Xiong's avatar
Yu Xiong committed
%           \caption{fig2}
%       \end{subfigure}
%       \begin{subfigure}{.32\textwidth}
%           \centering
%           \includegraphics[width=\textwidth]{fig3}
Yu Xiong's avatar
Yu Xiong committed
%           \caption{fig3}
%       \end{subfigure}
%       \caption{subfigures}
%   \end{figure}
% \end{latexexample}
% 请尽量避免使用较为老旧的 \pkg{subfig} 宏包,完全不要使用过时的 \pkg{subfigure} 宏包。两者的 CTAN 页面上均建议转移至更新的 \pkg{subcaption} 宏包。
%
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \subsubsection{表格}
%
% 下面这个例子展示了如何插入一张表格。通过 \pkg{booktabs} 宏包提供的 \tn{toprule}、\tn{midrule} 和 \tn{bottomrule} 命令,我们可以很轻松地绘制出一张漂亮规范的三线表。
% \begin{latexexample}[moretexcs={\toprule,\midrule,\bottomrule},emph={[1]table,tabular}]
Yu Xiong's avatar
Yu Xiong committed
%   \begin{table}[htbp]
Yu Xiong's avatar
Yu Xiong committed
%       \caption{我的表}
%       \label{tab:testtab}
%       \begin{tabular}{ccc}
%           \toprule
%           OS & TeX & 测试情况 \\
%           \midrule
%           南大TeX & Overleaf & √ \\
%           \bottomrule
%       \end{tabular}
%   \end{table}
% \end{latexexample}
% \emph{以下表格功能的实现均需要手动载入相关宏包。}
%
%
% \paragraph{合并单元格}
%
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}{\multirow,\multicolumn}
%   \begin{syntax}
Yu Xiong's avatar
Yu Xiong committed
%     \tn{multirow}\Arg{nrows}\oarg{bigstructs}\Arg{width}\oarg{fixup}\Arg{text}
Yu Xiong's avatar
Yu Xiong committed
%     \tn{multicolumn}\Arg{nrows}\Arg{width}\Arg{text}
%   \end{syntax}
Yu Xiong's avatar
Yu Xiong committed
% 合并单元格。
% TODO:\pkg{multirow} 宏包的使用方法,命令较为复杂。
Yu Xiong's avatar
Yu Xiong committed
% \url{http://www.ctex.org/documents/packages/table/multirow.htm}
%
% \paragraph{更多样式}
%
Yu Xiong's avatar
Yu Xiong committed
% \pkg{tabularray} 宏包\cite{tabularray}运用 \hologo{LaTeX3} 语法重新实现了表格的绘制,提供了简明的用户接口与丰富的单元格样式,详见其使用手册。
% 行内公式形如 |$\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}
Yu Xiong's avatar
Yu Xiong committed
% \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}]
Yu Xiong's avatar
Yu Xiong committed
%   \begin{lstlisting}[language=python]
%   print("Hello World")
Yu Xiong's avatar
Yu Xiong committed
%   \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}。但这一命令会被全局的代码字号设置污染。请参考如下使用方法:
Yu Xiong's avatar
Yu Xiong committed
% \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}
%
Yu Xiong's avatar
Yu Xiong committed
% \subsubsection{引用}
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}{\cref}
%   \begin{syntax}
%     \tn{cref}\Arg{标签}
%   \end{syntax}
Yu Xiong's avatar
Yu Xiong committed
% 使用 \pkg{cleveref} 宏包实现了带图、表等项目名称的智能引用。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
%
% \begin{function}{\href,\url}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
%     \tn{href}\Arg{链接}\Arg{名称}
%     \tn{url}\Arg{链接}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
Yu Xiong's avatar
Yu Xiong committed
% 超链接。\tn{href} 会将特定字符显示为可点击的超链接,\tn{url} 会输出可点击的链接原文。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
Yu Xiong's avatar
Yu Xiong committed
% \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}。
%
% \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},可以按照参考文献表的组织方式分为以下两种样式:
Yu Xiong's avatar
Yu Xiong committed
% \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} 并不是显式载入的。
Yu Xiong's avatar
Yu Xiong committed
% 如需在其基础上进行一些定制,可使用本设置项载入宏包选项\cite{biblatex}。
% \begin{function}[added=2021-12-19]{bib/resource}
%   \begin{syntax}
%   \end{syntax}
% 参考文献数据源。类似于 \tn{addbibresource} 命令,但可以使用逗号分隔的
% 列表形式。必须使用带扩展名(\file{.bib})的完整文件名。
% \end{function}
Yu Xiong's avatar
Yu Xiong committed
% \begin{function}{\addbibresource}
%   \begin{syntax}
%     \tn{addbibresource}\Arg{文件}
%   \end{syntax}
% 添加参考文献源文件。为了与 \pkg{biblatex} 进行兼容,也可使用本命令
% 添加数据源。本命令不支持逗号分隔多个文件的形式,如果希望额外添加参
% 考文献列表,需要在导言区中多次调用。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
% 可以参考如下范例进行参考文献设置。
% 其中 \opt{bib/option} 的内容旨在关闭部分不需显示的文献信息,
% 并采取仅首字母大写的作者姓名格式,可根据需要使用。
% \begin{latexexample}[moretexcs={\njusetup},emph={[2]bib}]
%   \njusetup {
%       bib = {
%           style    = author-year,
%           resource = {njuthesis-sample.bib},
%               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}
%
% 如果开启了草稿模式,您可能会注意到部分条目存在超宽的问题,这时就要果断假装没有看到。
Yu Xiong's avatar
Yu Xiong committed
% 该问题的产生是由于 \hologo{LaTeX} 中只有固定的字母组合中间可以断行。使条目右侧平齐的方法有如下两种
% \footnote{详见 \url{https://github.com/nju-lug/NJUThesis/issues/57}。很不幸,\pkg{microtype} 与 \pkg{babel} 没能在我们的模板中解决问题。}:
% \begin{itemize}
%   \item 自行在 \file{.bib} 文件中设置断行点,例如可以将 graphene 一词修改为 graph|\-|ene。缺点是需要逐条手动排查,建议在定稿时进行修改。
Yu Xiong's avatar
Yu Xiong committed
%   \item 在 |\printbibliography| 前添加 |\sloppy| 命令拉伸词间距,缺点是可能降低美观度。
% \subsubsection{正文引用}
Yu Xiong's avatar
Yu Xiong committed
%   \begin{syntax}
%     \tn{cite}\marg{文献}
%     \tn{cite}\oarg{页码}\marg{文献}
Yu Xiong's avatar
Yu Xiong committed
%   \end{syntax}
% 在正文中引用参考文献。
Yu Xiong's avatar
Yu Xiong committed
% \end{function}
%
% 引用命令 \tn{cite} 含有多个变体,以便使用文献条目中不同的信息域。在两种参考文献样式下,这些命令的行为具体存在一些差异,详见表 \ref{tab:numeric-style} 和表 \ref{tab:author-year-style}。
Yu Xiong's avatar
Yu Xiong committed
%   \begin{talltblr} [
%       caption = {顺序编码制下的引用样式},
%       label   = {tab:numeric-style} ]
%     { row{1} = {font=\bfseries}, colspec = {cll} }
Yu Xiong's avatar
Yu Xiong committed
%       引用方式 & 命令               &  排版效果                  \\
Yu Xiong's avatar
Yu Xiong committed
%       单篇文献 & \tn{cite}          & 上标可设置页码             \\
%       单篇文献 & \tn{parencite}     & 非上标可设置页码           \\
%       多篇文献 & \tn{cite}          & 上标,逗号隔开或短横线连接 \\
%       标注页码 & \tn{pagescite}     & 上标加自动页码             \\
%       标注作者 & \tn{textcite}      & 作者为主语加非上标编号     \\
%       标注作者 & \tn{authornumcite} & 作者为主语加上标编号       \\
%       完整脚注 & \tn{footfullcite}  & 脚注方式                   \\
Yu Xiong's avatar
Yu Xiong committed
%   \end{talltblr}
% \end{table}
%
% \begin{table}[ht]
%   \centering
Yu Xiong's avatar
Yu Xiong committed
%   \begin{talltblr} [
%       caption = {著者-出版年制下的引用样式},
%       label   = {tab:author-year-style},
%       note{a} = {在此样式下 \tn{parencite} 效果等同于 \tn{cite}。} ]
%     { row{1} = {font=\bfseries}, colspec = {cll} }
Yu Xiong's avatar
Yu Xiong committed
%       引用方式       & 命令                  & 排版效果                     \\
Yu Xiong's avatar
Yu Xiong committed
%       单篇文献       & \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}
% 本科生模板仅会生成中文封面;研究生模板会生成中英文封面。
Yu Xiong's avatar
Yu Xiong committed
% 如果选择了 \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}
% 校名、校徽图片文件路径。
% 通过以上选项可以使用外置的校徽和校名图片,两个选项\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}
Yu Xiong's avatar
Yu Xiong committed
% 是否将摘要条目插入目录,默认开启。
% 关闭此选项后摘要页将不会出现在目录中,仅保留其 PDF 书签。
% \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}
Yu Xiong's avatar
Yu Xiong committed
% 实际上,根据《学位论文编写规则》国家标准\cite{gb-t-7713.1-2006},
% 尽管“目录”这一说法已流传甚广,但学位论文中理应使用“目次”这一名称
% 来指代篇目的列表。
% \begin{function}[added=2022-02-04]{style/toc-in-toc}
%   \begin{syntax}
%     toc-in-toc = <\TTF>
%   \end{syntax}
Yu Xiong's avatar
Yu Xiong committed
% 是否在目录中显示目录自身的条目,默认开启。关闭此选项后目录、
% 插图目录和表格目录将不会出现在目录中,仅保留其 PDF 书签。
Yu Xiong's avatar
Yu Xiong committed
% \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}
Yu Xiong's avatar
Yu Xiong committed
% 附录放在本命令后,以英文字母进行编号,编写方式同正文。
% \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}
%
% 为了便于识别,成果列表中默认对发表年份进行加粗处理。而对作者姓名的处理较为复杂。利用 \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}]
%   python bibmap.py test.bib -m bibmapaddauthoran.py
% \end{shellexample}
Yu Xiong's avatar
Yu Xiong committed
% \subsection{视觉识别系统}
%
Yu Xiong's avatar
Yu Xiong committed
% 视觉识别系统 \pkg{njuvisual} 现已被分离为独立宏包\cite{njuvisual},基本使用方法举例如下:
% \begin{latexexample}[moretexcs={\njuemblem,\njuname,\njuname*}]
Yu Xiong's avatar
Yu Xiong committed
%   \njuemblem{!}{3cm}                           % 生成高 3cm 的紫色校徽
%   \njuname{4cm}{!}                             % 生成宽 4cm 的紫色中文校名
%   \njuname*{4cm}{!}                            % 生成宽 4cm 的紫色英文校名
%   \njuemblem[black]{!}{3cm}                    % 黑色的校徽
%   \njuemblem[department=dii]{!}{4cm}           % 紫色匡院徽标
%   \njuemblem[department=cs,color=blue]{!}{3cm} % 纯蓝色计科徽标
% \end{latexexample}
Yu Xiong's avatar
Yu Xiong committed
% 本宏包的详细使用方法请参考其使用手册。
Yu Xiong's avatar
Yu Xiong committed
%
% \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{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} 下支持有限。
Yu Xiong's avatar
Yu Xiong committed
% \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*{书籍}
Yu Xiong's avatar
Yu Xiong committed
%
% \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].
% \newblock \CTeX{} 开发小组, 译.
% \newblock 原版版本 version 6.4, 中文版本 version 6.03,
% \newblock (2021-11-21)
% \urlprefix\url{https://ctan.org/pkg/lshort-zh-cn}
% \urlprefix\CTANurl[文档:]{info/lshort/chinese/lshort-zh-cn.pdf}
%
Yu Xiong's avatar
Yu Xiong committed
% \bibitem{install-latex-guide-zh-cn}
% 王然.
% \newblock \textit{一份简短的关于 \hologo{LaTeX} 安装的介绍} [EB/OL].
% \newblock version 2021.12.1,
% \newblock (2021-12-01)
% \urlprefix\url{https://ctan.org/pkg/install-latex-guide-zh-cn}
% \urlprefix\CTANurl[文档:]{info/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf}
%
% \bibitem{刘海洋2013latex入门}
% 刘海洋.
% \newblock \textit{\hologo{LaTeX} 入门} [M].
% \newblock 北京: 电子工业出版社, 2013
%
Yu Xiong's avatar
Yu Xiong committed
%
% \subsection*{标准、规范}
Yu Xiong's avatar
Yu Xiong committed
% \bibitem{gb-t-7408-2005}
% 全国信息与文献标准化技术委员会.
% \newblock \textit{数据元和交换格式\quad 信息交换~ 日期和时间表示法: GB/T 7408--2005} [S].
% \newblock 北京: 中国标准出版社, 2005
%
% \bibitem{gb-t-7713.1-2006}
% 全国信息与文献标准化技术委员会.
% \newblock \textit{学位论文编写规则: GB/T 7713.1--2006} [S].
% \newblock 北京: 中国标准出版社, 2006
%
% \bibitem{gb-t-7714-2015}
% 全国信息与文献标准化技术委员会.
% \newblock \textit{信息与文献\quad 参考文献著录规则: GB/T 7714--2015} [S].
% \newblock 北京: 中国标准出版社, 2015
%
% \bibitem{nju2021}
% 南京大学本科生院.
% \newblock \textit{关于启动南京大学2022届本科毕业论文(设计)工作的通知} [EB/OL].
% \newblock (2021-12-14)
% \urlprefix\url{https://jw.nju.edu.cn/7c/86/c26263a556166/page.htm}
%
%
% \subsection*{宏包}
Yu Xiong's avatar
Yu Xiong committed
%
Yu Xiong's avatar
Yu Xiong committed
% \bibitem{biblatex}
% \textsc{Lehman P}, \textsc{Wright J}, \textsc{Boruvka A}, \textsc{Kime P}.
% \newblock \textit{Sophisticated Bibliographies in \hologo{LaTeX}} [EB/OL].
% \newblock version 3.17,
% \newblock (2022-02-02)
% \urlprefix\url{https://ctan.org/pkg/biblatex}
% \urlprefix\CTANurl[文档:]{macros/latex/contrib/biblatex/doc/biblatex.pdf}
%
% \bibitem{biblatex-gb7714-2015}
% 胡振震.
% \newblock \textit{符合 GB/T 7714-2015 标准的 biblatex 参考文献样式} [EB/OL].
% \newblock version 1.1b,
% \newblock (2021-12-11)
% \urlprefix\url{https://ctan.org/pkg/biblatex-gb7714-2015}
% \urlprefix\CTANurl[文档:]{biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015.pdf}
%
% \bibitem{CTeX}
% \textsc{CTEX.ORG}.
% \newblock \textit{\CTeX{} 宏集手册} [EB/OL].
% \newblock version 2.5.8,
% \newblock (2021-12-12)
% \urlprefix\url{https://ctan.org/pkg/ctex}
% \urlprefix\CTANurl[文档及源代码:]{language/chinese/ctex/ctex.pdf}
%
Yu Xiong's avatar
Yu Xiong committed
% \bibitem{latexmk}
% \textsc{Collins J}.
% \newblock \textit{Fully automated \hologo{LaTeX} document generation} [EB/OL].
% \newblock version 4.76,
% \newblock (2021-11-20)
% \urlprefix\url{https://www.ctan.org/pkg/latexmk}
% \urlprefix\CTANurl[文档:]{support/latexmk/latexmk.pdf}
%
% \bibitem{listings}
% \textsc{Heinz C}, \textsc{Moses B}, \textsc{Hoffmann J}.
% \newblock \textit{Typeset source code listings using \hologo{LaTeX}} [EB/OL].
% \newblock version 1.8d,
% \newblock (2020-03-24)
% \urlprefix\url{https://www.ctan.org/pkg/listings}
% \urlprefix\CTANurl[文档:]{macros/latex/contrib/listings/listings.pdf}
%
Yu Xiong's avatar
Yu Xiong committed
% \bibitem{njuvisual}
% \textsc{Yu Xiong}.
% \newblock \textit{Display logos related to Nanjing University} [EB/OL].
% \newblock version 0.2.1,
% \newblock (2022-01-09)
% \urlprefix\url{https://ctan.org/pkg/njuvisual}
% \urlprefix\CTANurl[文档:]{macros/latex/contrib/njuvisual/njuvisual.pdf}
Yu Xiong's avatar
Yu Xiong committed
% \bibitem{tabularray}
% \textsc{Jianrui Lyu}.
% \newblock \textit{Typeset tabulars and arrays with \hologo{LaTeX3}} [EB/OL].
% \newblock version 2021Q,
% \newblock (2021-12-01)
% \urlprefix\url{https://ctan.org/pkg/tabularray}
% \urlprefix\CTANurl[文档:]{macros/latex/contrib/tabularray/tabularray.pdf}
%
%
% \subsection*{模板}
%
% \bibitem{fduthesis}
% 曾祥东.
% \newblock \textit{fduthesis: 复旦大学论文模板} [EB/OL].
% \newblock version 0.7e,
% \newblock (2020-08-30)
% \urlprefix\url{https://ctan.org/pkg/fduthesis}
% \urlprefix\CTANurl[文档及源代码:]{macros/latex/contrib/fduthesis/fduthesis.pdf}
%
% \bibitem{thuthesis}
% 清华大学 TUNA 协会.
% \newblock \textit{\textsc{ThuThesis}:清华大学学位论文模板} [EB/OL].
% \newblock version 7.2.3,
% \newblock (2021-05-31)
% \urlprefix\url{https://ctan.org/pkg/thuthesis}
% \urlprefix\CTANurl[文档及源代码:]{macros/latex/contrib/thuthesis/thuthesis.pdf}
%
%
% \emph{以下模版现已停止更新。}
%
Loading
Loading full blame...