% \iffalse meta-comment % !TeX program = XeLaTeX % !TeX encoding = UTF-8 % % Copyright (C) 2021 - 2022 % by Nanjing University Linux User Group % % % 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 % % 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> \fi \begingroup \def\NameOfLaTeXe{LaTeX2e} \expandafter\endgroup\ifx\NameOfLaTeXe\fmtname\else \csname fi\endcsname % % %<*install> \input docstrip.tex \keepsilent \askforoverwritefalse \preamble Copyright (C) 2021 - 2022 by Nanjing University Linux User Group 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. 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}} % } \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 % % %<*internal> \fi % % % ^^A 故意留白 % ^^A 故意留白 % ^^A 故意留白 % ^^A 故意留白 % %\NeedsTeXFormat{LaTeX2e} %<*!(driver|install)> % ^^A 诚耀百廿,雄创一流 % ^^A 南京大学一百二十周年华诞邀您共襄盛举! %<+!driver>\GetIdInfo $Id: njuthesis.dtx 0.19.0 2022-05-23 11:33:00 +0800 NJU LUG $ % {Thesis template for Nanjing University} %\ProvidesExplClass{njuthesis} % {Undergraduate definition file for njuthesis} %\ProvidesExplFile{njuthesis-undergraduate.def} % {Graduate definition file for njuthesis} %\ProvidesExplFile{njuthesis-graduate.def} % {\ExplFileDate}{\ExplFileVersion}{\ExplFileDescription} % % %<*driver> \ProvidesFile{njuthesis.dtx} \documentclass[fontset=fandol]{ctxdoc} \usepackage{listings,njuvisual,tabularray,unicode-math} \usepackage[firstpage=true]{background} \backgroundsetup{contents={\njuemblem[white!85!gray]{22cm}{!}},scale=1,angle=0,hshift=-4cm} \colorlet{at@guard}{njuviolet} \definecolor{olgreen}{HTML}{138a07} \definecolor{agrd}{HTML}{2E3191} \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} \SetTblrInner{row{1}={font=\bfseries}} \DefTblrTemplate{caption-sep}{default}{\quad} \setmathfont{XITSMath-Regular}[ BoldFont = XITSMath-Bold, Extension = .otf] \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 = {(*}{*)}, breaklines = true, 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} \PrintChanges \PrintIndex \end{document} % % \fi % % \title{\color{njuviolet}{The \cls{njuthesis} class\\ % \textbf{南京大学学位论文模板}}} % % \author{^^A % 南京大学 Linux 用户组 % \thanks{E-mail: \href{mailto:git+nju-lug-email-3104-issue-@yaoge123.cn} % {git+nju-lug-email-3104-issue-@yaoge123.cn}}} % % \date{v0.19.0 \quad 2022-05-23} % % \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}{实现自动打包发布。} % \changes{v0.7}{2021/09/11}{增加对研究生模板的支持} % \changes{v0.7}{2021/09/12}{将 \cls{njuthesis} 发布在 CTAN。} % \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}{进一步完善文档。} % \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}{分离本科生和研究生模板配置。} % \changes{v0.19}{2022/05/23}{对研究生普通封面进行若干细节修改。} % \changes{v0.19}{2022/05/23}{对国家图书馆封面进行若干细节修改。} % % % \maketitle % % \begin{abstract} % 南京大学学位论文 \hologo{LaTeX} 模板 \cls{njuthesis} 基于本科生院的论文撰写 % 规范制作,同时参考研究生院提供的硕士、博士学位材料包,用于生成符合南京大学学 % 位论文排版要求和相应的国家规范、行业标准的学位论文,旨在为同学提供毕业论文书 % 写的方便。 % \end{abstract} % % \def\abstractname{Abstract} % \begin{abstract} % The \cls{njuthesis} class is intended for typesetting Nanjing University % dissertations with \hologo{LaTeX}, providing support for bachelor, master, % and doctoral thesis. % \end{abstract} % % \vspace{2cm} % \def\abstractname{特别声明} % \begin{abstract} % 在使用本模板时,我们默认您同意以下内容: % \begin{enumerate} % \item 本模板通过 LPPL 1.3c 协议开放源代码,您可以随意使用编译出的 PDF 文件。 % \item 本模板与学校官方部门并不存在合作关系, % 作者不对使用本模板产生的格式审查问题负责。 % \item 遇到本文档没有覆盖的问题属于正常情况,欢迎提交反馈意见。 % \end{enumerate} % % 我们的 \href{https://git.nju.edu.cn/nju-lug/lug-introduction} % {Linux 用户组}始终欢迎您的加入! % \end{abstract} % % \clearpage % % % \setcounter{tocdepth}{4} % \tableofcontents % % \clearpage % % % \begin{documentation} % % \section{模板介绍} % % \cls{njuthesis},即南京大学学位论文模板,是一个由南京大学 Linux % 用户组维护的,用于处理本校学生毕业论文排版需求的 \hologo{LaTeX} 模板。 % % 本模板使用的本科生毕业论文模板格式依据 % 《关于启动南京大学2022届本科毕业论文(设计)工作的通知》\cite{nju2021}, % 研究生学位论文格式依据研究生院提供的材料包。 % % % \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} % \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 % 稍等片刻,您会在浏览器右侧发现一份新生成的空白论文。 % 如果它的效果令您满意,不妨以本模板为基础开始写作。 % % \subparagraph{我一定要体验上述流程吗?} % 是,但也不一定。有人坚持认为应该做一些\emph{直观、清晰、有手就行、一 % 条路走到底}的教程,而不是\emph{长篇累牍的精细介绍},其核心论据在于: % 现代人类总体上需要快速取得成就感,而且大部分可能用到本模板的同学不 % 会具备必要的基础知识。反驳的观点在于过分简单的实验总是浪费时间的, % 尤其是在您可能早已掌握基本用法的情况下。但,不论如何,这番操作总会 % 使您预览到 \cls{njuthesis} 论文模板的实际样式。 % % \subparagraph{我并没有见到理想的结果。} % 具体是哪里不满意?如果是\emph{样式存在偏差},请联系模板的作者;如果 % \emph{不能访问前文提到的在线编译网站},请考虑检查网络连接,依次咨询 % 本校\href{https://itsc.nju.edu.cn}{信息化管理建设服务中心}和该网站 % 的维护者\href{mailto:my@yaoge123.cn}{姚舸老师};如果\emph{报错},请 % 点击左上角的菜单按钮,查看编译器是否显示为 |XeLaTeX|; % 再如果\emph{还有其他原因},通过这几分钟的实验我们也可以得到一个极其 % 有益的结论:\emph{也许 Word 模板更加适合您}。这可以节省下熟悉 % \hologo{TeX} 排版软件使用方法所需的可观时间。 % % \subparagraph{但我依然对 \hologo{LaTeX} 一无所知!} % 这意味着您真的得花些时间在\emph{长篇累牍的精细介绍}上。 % 如果您已经下定决心,请接着向后阅读,有需要时善用搜索引擎。 % % % \subsection{历史沿革} % % 十几年来,多位热心校友发布过自己编写的模板,在 GitHub 网站上可考的包括: % \begin{enumerate} % \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} % 至于不幸而未进行代码版本管理的,甚至于说以压缩包形式流传于各人硬盘中的,就更不可计数了。 % % 与其让一千个学生做一千种不同的模板,不如有人牵起头来,集中力量办大事。因此,南 % 京大学 Linux User Group 的有志之士在2021年暑期联合起来,参考以上的现成模板,兼 % 顾友校 \cls{fduthesis}\cite{fduthesis}、\textsc{THuThesis}\cite{thuthesis} 等 % 优秀项目,构建了这一全新模板,力求通过 \hologo{LaTeX3} 语法和清晰的接口实现良 % 好的易用性和可维护性。 % % 目前,本模板的主要维护者包括: % \begin{itemize} % \item 赵懿晨 % \item 熊煜 % \item 马畅 % \end{itemize} % % % \subsection{快速上手} % % \hologo{LaTeX} 并不是一种零门槛的语言,亦不是南京大学学生的必备技能。有同学听 % 到“\emph{给毕业论文交差也得写代码}”这种事情就头疼,实在是我们不愿意见到而必须 % 要面对的情况。目前,中文互联网上的 \hologo{LaTeX} 写作教程可谓汗牛充栋,然而 % 如何快速准确找到所需要的用法,尤其是 \hologo{LaTeX3} 的新接口,需要一定的时间 % 或者良好的英文阅读能力。在本文档的写作中,我们无力从盘古开天辟地开始从头构建您 % 的相关知识体系,只能\emph{尽力做到有求必应},在需要的地方顺带提一嘴,以期使您 % 少走点弯路。 % % 如果您希望在使用本模板前了解一些关于这个排版软件的基础知识,在此尝试列举一些有 % 所帮助的资料: % \begin{description} % \item[\textit{lshort}] 著名的介绍文档,已被译为多种语言,可以参考英文版\cite{lshort}及其中文翻译版\cite{lshort-zh-cn}。 % \item[《\hologo{LaTeX} 入门》] 刘海洋著\cite{刘海洋2013latex入门}。 % \end{description} % % % \subsection{关于本说明手册} % % 本模板通过 \textsc{DocStrip} 进行维护,实际上是一种\emph{文学编程}。文学编程的 % 本体是那些用来说明的文字,按写书写文章的方式组织。\file{njuthesis.dtx} 包含 % \cls{njuthesis} 文档类的所有信息。前半部分为模板说明,即各种常用命令与必要的使 % 用方法;后半部分为代码实现,为带有详细注释的 \hologo{TeX} 源代码。后者配合附 % 录,为有意了解本模板实现细节的同学提供必要指引。 % % 下文中将出现若干特殊格式,用来指示代码组件。譬如,无衬线字体的 % \pkg{pkg-example} 为宏包名,等宽字体的 \file{file-example.xxx} 为文件名,等宽 % 字体的 \opt{opt-example} 为选项名,等宽字体的 \env{env-example} 为需要 % |\begin{}|和|\end{}|的环境名,等。本手册提供的代码示例中,左侧边线呈现南大标 % 准洋红色 {\color{njumagenta}$\blacksquare$} 的属于终端命令,呈南大标准蓝色 % {\color{njublue}$\blacksquare$} 的属于 \hologo{LaTeX} 源代码。 % % % \subsection{许可说明} % % \file{njuthesis.dtx} 文件以及由其直接产生的所有文件被称为 % \cls{njuthesis} 文档类,或者在本文中简称为本模板。 % % \subparagraph{版权信息} % 本模板之版权隶属于 © 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。 % % % \section{安装} % \label{sec:setup} % 本节主要介绍本宏包的获取、安装以及编译方式。 % % \subsection{获取模板} % % \cls{njuthesis} 目前处于积极的维护中,主要可通过以下三种途径获取模板文件: % % \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} 收录。}上提供基本的介绍信息,可以下载说明文档(本文档)和宏包源代 % 码。当然,使用这一来源时并不需要接触后者,请参考 % \ref{subsubsec:standard-installation} 的标准安装方法。 % % \subparagraph{GitHub 仓库} % 最新开发进度会提交在本项目的 % \href{https://github.com/nju-lug/NJUThesis}{Github仓库}。仓库内仅包含源代码、 % 空白模板及测试文件,不可直接用于写作。这些文件对应的使用方法请参考 % \ref{subsubsec:on-the-fly-installation}。如果由于网络原因不便访问主仓库,也可 % 以从 \href{https://git.nju.edu.cn/nju-lug/nju-latex-templates/njuthesis} % {NJU Git 同步镜像}获取项目工程文件。 % % \subparagraph{GitHub Releases} % 本模板不定期将已有的新功能和问题修复打包为新的正式发行版,赋以更改后的版本号, % 发布在 \href{https://github.com/nju-lug/NJUThesis/releases/latest}{Github % Releases 页面}。如果由于网络原因不便访问主仓库,也可以从\ignorespaces % \href{https://mirror.nju.edu.cn/github-release/nju-lug/NJUThesis/LatestRelease/} % {南京大学镜像站下载页面}获取。可供下载的文件包括下列三种: % \begin{description} % \item[\file{njuthesis-v*.pdf}] 模板说明文档(本文档)。 % \item[\file{njuthesis-user-v*.zip}] 交付给用户的完整模板包, % 包括格式文件和范本文档,可在解压后用于本地编译, % 也可直接上传至在线编译网站。 % \item[\file{njuthesis-ctan-v*.zip}] 交付给 CTAN 的源代码包, % 普通用户请忽略。 % \end{description} % % % \subsubsection{文件构成} % % 本模板由数量众多的文件组成,\emph{所有可能遇到的}文件如表 % \ref{tab:njuthesis-files} 所示。 % % \begin{table}[ht] % \centering % \begin{talltblr}[ % caption = {\cls{njuthesis}文件构成}, % label = {tab:njuthesis-files}, % note{a} = {仅供开发使用,并不会在发布版本中出现。} % ] { row{1} = {font=\bfseries}, colspec = {ll} } % \toprule % 名称 & 说明 \\ % \midrule % \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} & 自述文件 \\ % \bottomrule % \end{talltblr} % \end{table} % % % \subsection{本地安装} % % \subsubsection{标准安装} % \label{subsubsec:standard-installation} % % 我们\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}] % tlmgr install njuthesis njuvisual % \end{shellexample} % 即可完成安装,无需额外准备 \file{.cls} 文件。 % % 另一方面,CTAN 依赖开发者手动上传更新,版本更新具有滞后性。如果使用时遇到了问 % 题,不妨使用下一小节的\emph{即时安装方法}优先载入较新的格式文件。 % % {\color{red}|[!]|} 如果您具备相关经验\footnote{譬如熟悉命令行操作、使用的是 \hologo{TeX}\,Live 发行版等},可以在下载仓库内全部文件后,于该目录下运行 % \begin{shellexample}[morekeywords={l3build},emph={install}] % l3build install % \end{shellexample} % 来安装本模板的最新版。 % % % \subsubsection{即时安装} % \label{subsubsec:on-the-fly-installation} % % 在某些情况下(例如需要上传至在线编译平台、新版本提供了急需的错误修复),您可能 % 需要独立的 \file{.cls} 格式文件。此时请前往前述的 Releases 页面下载 % \emph{完整模板包}。 % % 对于希望使用主仓库中版本的用户,本模板也提供了扁平化安装脚本,用于释放供编译的 % 空白模板和格式文件。Windows 用户请直接双击打开 \file{install-win.bat};其他平 % 台(包括 macOS 和 Linux)用户请在此目录下运行 % \begin{shellexample}[morekeywords={bash}] % bash install-unix.sh % \end{shellexample} % 该脚本会生成一个 \file{mythesis/} 目录以便从头写作,仓库内除此文件夹以外的内容 % 都可以尽情删除。 % % {\color{red}|[!]|} 请注意,如果仅仅是希望使用这个模板撰写论文,请无论如何都不 % 要从手动编译 \file{source} 文件夹下的源代码开始,这样做只会浪费生命中宝贵的数 % 分钟时间。如果遇到了问题,请前往 GitHub 仓库提出 issue。我们只推荐希望参与开发 % 的同学接触 \file{.dtx} 文件。 % % % \subsection{本地编译} % \label{subsec:localcompile} % % 本地编译的安装过程分为两个阶段:安装 \hologo{TeX} 发行版以及配置编辑器。前者提供了可以被命 % 令行终端调用的编译程序,后者则提供了语法高亮、自动编译等人性化功能。 % % \subsubsection{安装\hologo{TeX}发行版} % % 首先需要下载并安装 \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 % \hologo{TeX}\,Live & $\bullet$ & & $\bullet$ \\ % Mac\hologo{TeX} & & $\bullet$ & \\ % \hologo{MiKTeX} & $\bullet$ & $\bullet$ & $\bullet$ \\ % \bottomrule % \end{tabular} % \end{table} % % 以下是一些值得注意的要点: % \begin{itemize} % \item 可以参照这份\emph{手把手的教程}\cite{install-latex-guide-zh-cn}。 % \item 校园网环境中访问\ignorespaces % \href{https://mirror.nju.edu.cn/download/TeX%20排版系统} % {南京大学开源软件镜像站}可以获得最佳的下载体验。 % \item 使用最新的发行版,即版本号为2022或者22。 % \item 对于 Windows 和 macOS 用户,更推荐轻量化的 \hologo{MiKTeX} 套件。 % ^^A \item Linux 用户请尽可能下载 full 版本,如 |texlive-full|。 % ^^A 换言之,下载最大的软件包。 % \item 对于一部分用到新版本特性的宏包,\cls{njuthesis} 内置了版本检查 % \footnote{譬如遇到 l3 过时问题请运行 |tlmgr update l3packages|。} % ,请确认各宏包已升级至最新版。 % \end{itemize} % % % \subsubsection{配置编辑器} % \changes{v0.11}{2021/11/23}{提供 TeXstudio 配置文件。} % % 配置完编译器后,还需要一个\emph{文本编辑器}来完成 \file{.tex} 文件内容的写作。 % % 关于具体使用哪一种,至今仍有相当一部分人认为Windows自带的\emph{记事本}是 % 最好的文本编辑器。但对于本项目而言,在此诚心诚意地推荐您使用\emph{更现代 % 更美观更多功能}的编辑器,譬如\emph{安装了 \hologo{LaTeX} Workshop 插件的 % \href{https://code.visualstudio.com/}{Visual Studio Code}}。您也可以根据 % 个人的喜好随意使用 TeXworks、TeXstudio 等编辑器,顺手就行。 % % \cls{njuthesis} 为一些常见编辑器提供了配置文件,如 % \begin{description} % \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} % % % \subsubsection{编译顺序} % \label{subsubsec:compileseq} % \hologo{TeX} 本身是命令行程序,通过不同的命令调用所需的编译引擎, % 编辑器提供的快捷按钮实际只是做了包装。为了便于排查运行错误, % 以下通过具体终端命令简要描述编译过程。 % % 编译本模板的过程可以概括为下述步骤: % \begin{enumerate} % \item 生成初始文档 % \item 生成参考文献信息 % \item 生成页码、编号、目录 % \item 将参考文献列表页插入目录 % \end{enumerate} % 总计需要编译四次。\emph{假设即将使用的主文件名为 % \file{njuthesis-sample.tex}},应采用以下命令顺序进行编译, % 以生成内容正确的 \file{njuthesis-sample.pdf}。输出的 PDF % 文档位于同一目录下。该目录下同时会生成若干中间文件。 % % 编译命令具体为引擎名称加主文件名,在编译 \file{.tex} 文件时, % 文件扩展名可以省略不写。现阶段 \cls{njuthesis} 仅支持 \hologo{XeTeX} % 与 \hologo{LuaTeX} 引擎,以及 \hologo{biber} 文献工具。请注意, % 几种命令的输出文件基本相同,可以任取一种;但如果您不清楚这两种编译引擎的 % 区别,或者对多步编译感到困惑,我们建议优先使用 |latexmk -xelatex|。 % % % \subparagraph{使用 \hologo{XeLaTeX}} % 标准的 \hologo{XeTeX} 引擎四步编译方法。 % % \begin{shellexample}[morekeywords={xelatex,biber}] % xelatex njuthesis-sample % biber njuthesis-sample % xelatex njuthesis-sample % xelatex njuthesis-sample % \end{shellexample} % % % \subparagraph{使用 \hologo{LuaLaTeX}} % 标准的 \hologo{LuaTeX} 引擎四步编译方法。 % % \begin{shellexample}[morekeywords={lualatex,biber}] % lualatex njuthesis-sample % biber njuthesis-sample % lualatex njuthesis-sample % lualatex njuthesis-sample % \end{shellexample} % % % \subparagraph{使用 \pkg{latexmk}} % \pkg{latexmk}\cite{latexmk} 是一个基于 Perl 脚本的自动编译工具, % 宗旨是通过单一命令简化上述的多次编译流程。 % 在使用该命令前,请确保安装了以下软件: % \begin{description} % \item[Perl] 一般预装于 macOS 和 Linux,而 Windows 用户需要单独安装 % \href{https://strawberryperl.com/}{Strawberry Perl}。 % \item[\pkg{latexmk}] 如果终端找不到 |latexmk| 命令,需使用包管理器单独安装。 % \end{description} % % 该命令的使用方法为 % \begin{shellexample}[morekeywords={latexmk}] % latexmk njuthesis-sample % \end{shellexample} % 直接运行会调用 \hologo{pdfLaTeX} 引擎导致报错。 % 如需指定编译引擎,可以加入 |-xelatex| 或 |-lualatex| 参数。 % 例如,指定 \hologo{XeLaTeX} 的命令为 % \begin{shellexample}[morekeywords={latexmk},emph={-xelatex}] % latexmk -xelatex njuthesis-sample % \end{shellexample} % % 此外,可以选择使用以下命令清理编译生成的临时文件。 % \begin{shellexample}[morekeywords={latexmk},emph={-c}] % latexmk -c % \end{shellexample} % % % \subsection{在线编译} % \label{subsec:onlinecompile} % % 相信您在接触了本地编译以后,很快就会意识到一些十分显然的事实,譬如 \hologo{TeX} 编译器安装过程较为漫长\footnote{因此对于 Windows 推荐 \hologo{MiKTeX}。},占用空间过大\footnote{事实上,可以通过 |scheme-infraonly| 模式安装 \hologo{TeX}\,Live,随后利用 \pkg{tlmgr} 安装依赖宏包,这份宏包列表可以在 Git 仓库的 \file{.github/workflows/build.yml} 找到。},而且在一部分处理器性能不佳的电脑上需要较长编译时间\footnote{出于文件 IO 速度的差异,同一个模板在 Linux 编译可以相对 Windows 节省约一半耗时。}。拒绝接受这些麻烦的同学可以尝试本节介绍的在线编译方法。 % % {\color{red}|[!]|} 请注意,在线编辑器不一定提供良好的文件恢复和版本管理机制。 % 请谨慎备份您的心血结晶。 % % \subsubsection{南大\hologo{TeX}平台简介} % \changes{v0.2}{2021/09/07}{添加对南大 \hologo{TeX} 的支持。} % % \href{https://tex.nju.edu.cn}{南大 \hologo{TeX}} 基于开源的 Overleaf 社区版平台构建\footnote{理论上在\href{https://doc.nju.edu.cn/books/latex}{这个网站}能找到一段平台简介,实际上大家都有意无意地鸽了,下次一定补上。},于2021年3月4日正式上线,是 \href{https://sci.nju.edu.cn/}{eScience 中心}为南大在校师生提供的 \hologo{LaTeX} 在线编辑器,首次使用需凭学校邮箱自助注册账号。 % % {\color{red}|[!]|} 在 2022 年 5 月的运行中,该网站出现了多次崩溃事件,初步判断原因是由社区版并没有为高并发数做优化引发的。高峰时期,仍然建议在本地部署 \hologo{TeX} 发行版。 % % \subsubsection{操作步骤} % % 本说明手册开头的 \ref{subsec:first-things-first} 即呈现了网站内嵌的 \cls{njuthesis} 模板的使用方法。由于南大 \hologo{TeX} 网站已预装 \cls{njuthesis},可以直接编写正文,无需 \file{.cls} 等格式文件。如果有其他要求,也可以按如下步骤手动上传包含模板的压缩包。 % % \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 点击“重新编译”按钮进行编译和预览 % \end{enumerate} % % % \subsubsection{其他平台} % % \subparagraph{Overleaf} % \changes{v0.12}{2021/12/07}{更新了对 Overleaf 的支持情况。} % \pkg{njuthesis} 现已支持 \href{https://www.overleaf.com/}{Overleaf} 平台。 % % \subparagraph{TeXPage} % \href{https://www.texpage.com/}{TeXPage} 是国人研发的 \hologo{LaTeX} 在线编辑器,当前版本已具备较为完善的编辑编译功能,而且免费版相对 Overleaf 增加了公式识别、编辑历史等实用工具,也可以作为一个备选项。 % % % \subsection{版本升级} % % 本模板仍在开发中,将不断发布新版本,您可能需要不定期进行更新以得到 % 对于已知问题的修复补丁。每个版本的更新内容记录于 Git 仓库中的 % \file{CHANGELOG.md}。除非特别提到选项变化,升级时一般无需更改 \file{.tex} % 文件内容\footnote{在确实发生了接口变动,例如选项名称发生了更改, % 一种稳妥做法是将论文内容迁移至新版的 \file{njuthesis-sample.tex}}。 % 基于安装和编译方式的差异,可以按照当前工作文件夹内是否有 \file{.cls} % 文件分别进行更新操作。 % % \subparagraph{有} % 下载 \file{njuthesis-user-v*.zip},使用其中新版的 \file{.cls}、\file{.def} % 文件覆盖旧版本。 % % \subparagraph{没有} % 如果使用的是南大 \hologo{TeX},更新内置模板时会进行公告,一般为上传 CTAN % 后一周内。如果是本地安装,请直接使用包管理器进行更新: % \begin{shellexample}[morekeywords={tlmgr},emph={update}] % tlmgr update --all % \end{shellexample} % % % \section{使用方法} % % \subsection{标准结构} % % 典型的 \cls{njuthesis} 主文件结构应该如下所示: % % \begin{latexexample}[moretexcs={\njusetup,\graphicspath,\tableofcontents, % \maketitle,\mainmatter,\chapter,\printbibliography},emph={[1]document}] % \documentclass{njuthesis} % \njusetup{} % \begin{document} % \maketitle % \tableofcontents % \mainmatter % \chapter{欢迎} % 使用 \LaTeX{}! % \printbibliography % \end{document} % \end{latexexample} % % 如果您尝试编译上面的代码,会发现自己得到了一个5页的 PDF 文档, % 是一份空白的本科生论文。当然,这个文档实际上没有任何内容, % 接下来的部分会介绍具体填写内容的方法。 % % % \subsection{模板选项} % % 模板选项位于 \tn{documentclass} 后的方括号内,用于指定模板的行为。 % 下文中尖括号内列出了若干个允许的选项,其中加粗的为默认选项(缺省值)。 % % \subsubsection{学位信息} % \begin{function}[added=2021-09-07]{degree} % \begin{syntax} % degree = <(ug)|mg|mf|phd> % \end{syntax} % 选择学位,分别为学士、学术型硕士、专业硕士、博士,默认为学士(即本科生)。 % \end{function} % % \begin{function}[added=2021-09-07]{type} % \begin{syntax} % type = <(thesis)|design> % \end{syntax} % 用于选择文档类型并将相关字段输出在封面和摘要页, % 可选值分别为毕业论文和毕业设计,默认为毕业论文。 % \end{function} % % % \subsubsection{特殊页面} % % \begin{function}[added=2021-09-07]{nlcover} % \begin{syntax} % nlcover = <\TFF> % \end{syntax} % 是否使用国家图书馆封面,默认关闭。 % \end{function} % % 通过此项可用国家图书馆封面\emph{替换}普通封面。 % 由于本科生院文件中并未提及相关规定,故本选项仅对于研究生有效。 % % \begin{function}[updated=2022-01-06]{decl-page} % \begin{syntax} % decl-page = <\TFF> % \end{syntax} % 是否需要自动生成声明页面,默认关闭。 % \end{function} % % 通过此项,对于本科生模板可在封面后添加的诚信承诺书, % 对于研究生模板可在封面后添加原创性声明,并且在最后一页添加学位论文出版授权书。 % % 对于需要手动插入承诺书扫描页的情况,可以在导言区载入 \pkg{pdfpages} 宏包, % 并在所需位置使用该宏包提供的 \cs{includepdf} 命令。 % 例如,可以用如下所示的命令插入扫描件的第一页,并插入紧随的一个空白页。 % \begin{latexexample}[moretexcs={\includepdf},emph={[2]pages}] % \includepdf[pages={1,{}}]{scanned.pdf} % \end{latexexample} % % % \subsubsection{页面模式} % % \begin{function}[added=2022-01-14]{oneside,twoside} % \begin{syntax} % % \end{syntax} % 开启单面或双面模式,默认为双面模式。 % \end{function} % % 本选项继承自 \hologo{LaTeX2e} \cls{book} 标准文档类。 % 单双面选项为全局选项,开启后会改变页码编号,以及部分宏包的行为。 % 在单面模式下,页面是连续的,不会产生空白页;在双面模式下, % 新的一章以及封面、摘要、参考文献表等特殊页面都会从奇数页开始, % 在奇数页结束的内容后会补上一页空页,更适合印刷输出。 % % \begin{function}[added=2021-12-15]{draft} % \begin{syntax} % draft = <\TFF> % \end{syntax} % 是否开启草稿模式,默认关闭。 % \end{function} % % 本选项继承自 \hologo{LaTeX2e} \cls{book} 标准文档类。 % 草稿模式为全局选项,启用这一选项将产生以下整体影响: % \begin{itemize} % \item 禁用封面的绘制(包括承诺和声明) % \item 显示页面文字范围边框以及页眉页脚线 % \item 在超出宽度的内容右侧添加黑色方块标记 % \item 不再渲染图片,使用含有图片路径的空白盒子占位 % \item 不再渲染超链接及生成 PDF 书签 % \end{itemize} % 草稿模式有助于提升编译速度以及检查格式问题,建议在定稿前始终开启。 % % 启用这一选项也会改变特定宏包的行为,譬如在草稿模式下 \pkg{listings} % 宏包的代码环境不会显示内容,具体效果需要参照各个宏包的说明文档。 % 如需抵消草稿模式的影响,请使用 \opt{final} 选项载入相关宏包。 % % \begin{function}[added=2022-04-19]{blind} % \begin{syntax} % % \end{syntax} % 是否开启盲审模式。这个选项并不包含 |=| 号。 % \end{function} % % 盲审模式会抹除论文中的学校和个人信息,效果包括: % \begin{itemize} % \item 不显示校名校徽图片 % \item 不显示“南京大学”字样 % \item 不显示作者、导师等基本信息 % \end{itemize} % % % \subsubsection{配置文件} % % \begin{function}[added=2022-02-23]{config} % \begin{syntax} % config = \Arg{文件} % \end{syntax} % 配置文件路径。 % \end{function} % % 本选项可用于载入额外的用户配置文件。该文件支持 \hologo{LaTeX3} 语法。 % % % \subsubsection{指定字体} % % 学校论文格式要求使用的字体一般已经预装在各个操作系统, % 本模板针对不同平台进行了自动检测适配,可以开箱即用。 % 如果希望更改本模板使用的字体,请填写以下两个选项以覆盖默认设置。 % % \begin{function}[added=2021-09-07,updated=2021-12-18]{cjk-font,latin-font} % \begin{syntax} % cjk-font = % latin-font = % \end{syntax} % 手动指定字体。 % \end{function} % % 根据学校论文格式的要求,本模板使用的中文字体主要有{\songti 宋体}、 % {\heiti 黑体}、{\kaishu 楷体}、{\fangsong 仿宋}四种; % 西文字体主要有衬线体(\textup{serif})、无衬线体(\textsf{sans-serif}) % 和等宽字体(\texttt{monospace})三种。 % 在生成论文时,需要将每一种字体(宋体、楷体)与一种字库(操作系统中的 % \file{.ttf} 文件)相对应。由于不同操作系统自带的字库不同, % 在不同的操作系统上使用同一套配置会导致缺字、编译出错等后果。 % 因此,本模板对于中文字体和西文字体都提供了多种字体配置。 % % 本模板提供的中文字体配置如表 \ref{tab:cjk-fontset} 所示。 % 在不指定字体配置的情况下,本模板默认使用与操作系统相对应的字体配置 % (见表中前三行,Windows 和 macOS 以外的系统采用 Fandol 配置)。 % 此外,我们也单独提供了方正和思源两套中文字体配置。 % % \begin{table}[htbp] % \centering % \begin{talltblr}[ % 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 楷体和仿宋难以直接下载, % 因此使用方正字体代替} ] % { cell{2}{2,4} = {white!70!njuyellow}, % cell{4}{4} = {white!70!njuyellow}, % row{1} = {font=\bfseries}, 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{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/}{思源黑体} % & 方正楷体\TblrNote{e} & 方正仿宋 \\ % \bottomrule % \end{talltblr} % \end{table} % % 由于各操作系统对自带字体的支持程度不同,本模板对不同字体加粗的方式有所差别, % 表 \ref{tab:cjk-fontset} 中,黄色底色的字体采用算法加粗。 % 除此以外,各种字体在设计上也存在差异,因此本模板在不同操作系统下编译的结果可能存在细微不同,使用时请注意。 % 若想要获得与 Word 版本模板最为贴近的体验, % 可以通过手动安装 Windows 自带的中易宋体、中易黑体、中易楷体和中易仿宋,并设置使用 Windows 字体来实现。 % % 本模板提供的西文字体配置如表 \ref{tab:latinfontset} 所示。 % 在不指定字体配置的情况下,本模板默认使用与操作系统相对应的字体配置 % (见表中前三行,Windows 和 macOS 以外的系统采用 \opt{gyre} 配置)。 % % \begin{table}[htbp] % \centering % \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} % % 若要手动选择字体,则需将字体设置为 \opt{none},再通过 \pkg{fontspec} 宏包或 \pkg{ctex} 宏包中给出的命令来实现。 % % 最后,出于统一格式的需要,本模板还选取了与正文字体相似度最高的数学字体(\href{https://github.com/aliftype/xits}{XITS 字体})用于公式排版。 % % 本节提及的字库中,中文字库只有方正书宋、方正黑体、方正楷体、方正仿宋、两种思源字体和四种Fandol字体能够\emph{免费商用}; % 英文字库中只有 Times New Roman、XITS 和三种 \Hologo{TeX} Gyre字体能够\emph{免费商用}。 % 因此,若需要将本模板用于商业相关的活动,请咨询专业人士。 % % % \subsection{个人信息} % % \begin{function}[added=2021-09-10]{\njusetup} % \begin{syntax} % \tn{njusetup} \Arg{键值列表} % \end{syntax} % 是 \cls{njuthesis} 文档类的通用设置命令,用来设置各项功能。 % \tn{njusetup} 的参数是一个使用英文半角逗号分隔的键值列表, % 通常形如 \meta{key}|=|\meta{value}。 % \end{function} % % 目前,\tn{njusetup} 仅包含用于设置个人信息的 |info| 类。 % 以下为全部的个人信息参数,其中带有星号的为对应的英文字段。 % 请注意,部分参数已被弃置,列于后方。 % % \begin{function}[updated=2022-01-14]{info/title,info/title*} % \begin{syntax} % title = \Arg{标题} % title* = \Arg{英文标题} % \end{syntax} % 题目。由于封面上提供给中文题目的横线长度有限\footnote{单行最长约为15 % 个汉字,建议总长度不超过45字,当然你也可以对照 \ref{subsubsec:modify-length} % 节修改横线长度},本模板默认会自动对标题进行换行。 % 如果需要手动指定换行位点,请使用换行控制符( |\\| )。 % \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} % % \begin{function}[updated=2021-10-01]{info/keywords,info/keywords*} % \begin{syntax} % keywords = \Arg{关键词} % keywords* = \Arg{英文关键词} % \end{syntax} % 关键词列表。关键词之间需要使用英文半角逗号隔开, % 含有空格的关键字需要使用花括号包裹以避免歧义。可以参照下方的填写示例。 % \end{function} % % \begin{function}[updated=2021-10-01]{info/grade} % \begin{syntax} % grade = \Arg{20XX} % \end{syntax} % 年级,推荐格式为“20XX”。 % \end{function} % % \begin{function}[updated=2021-10-01]{info/student-id} % \begin{syntax} % student-id = \Arg{学号} % \end{syntax} % 学号。南京大学本科生为9位数字学号, % 研究生为两位大写字母标识加上数字组成的学号。 % \end{function} % % \begin{function}[updated=2021-10-01]{info/author,info/author*} % \begin{syntax} % author = \Arg{你的名字} % author* = \Arg{姓名拼音} % \end{syntax} % 姓名。 % \end{function} % % \begin{function}[updated=2021-10-01]{info/department,info/department*} % \begin{syntax} % department = \Arg{院系} % department* = \Arg{院系} % \end{syntax} % 院系。 % \end{function} % % \begin{function}[updated=2021-10-01]{info/major,info/major*} % \begin{syntax} % major = \Arg{专业} % major* = \Arg{专业} % \end{syntax} % 专业。 % \end{function} % % \begin{function}[updated=2021-10-01]{info/field,info/field*} % \begin{syntax} % field = \Arg{方向} % field* = \Arg{方向} % \end{syntax} % 研究领域。只有研究生存在研究领域的说法,本科生无需填写。 % \end{function} % % \begin{function}[updated=2022-01-12]{info/supervisor,info/supervisor*} % \begin{syntax} % supervisor = \Arg{导师姓名,职称} % supervisor* = \Arg{导师英文全称} % \end{syntax} % 导师全称。请使用逗号( |,| )分隔导师的中文姓名与职称,英文名则不需添加逗号。 % \end{function} % % \begin{function}[updated=2021-01-12]{info/supervisor-ii,info/supervisor-ii*} % \begin{syntax} % supervisor-ii = \Arg{第二导师姓名,职称} % supervisor-ii* = \Arg{第二导师英文全称} % \end{syntax} % 第二导师全称。无第二导师时不填即可。 % \end{function} % % \begin{function}[updated=2022-01-14]{info/submit-date} % \begin{syntax} % submit-date = \Arg{yyyy-mm-dd} % \end{syntax} % 提交日期。中英文日期现在可以由 ISO 日期格式\cite{gb-t-7408-2005}的字符串统一生成。如果留空,则自动使用编译当天日期。 % \end{function} % % \begin{function}[updated=2022-01-14]{info/defend-date} % \begin{syntax} % defend-date = \Arg{yyyy-mm-dd} % \end{syntax} % 答辩日期,只对研究生有效,要求同提交日期。 % \end{function} % % \begin{function}[updated=2022-05-23]{info/confer-date} % \begin{syntax} % confer-date = \Arg{yyyy-mm-dd} % \end{syntax} % 学位授予日期,只用于国家图书馆封面,要求同提交日期。 % \end{function} % % \begin{function}[updated=2021-05-23]{info/bottom-date} % \begin{syntax} % bottom-date = \Arg{yyyy-mm-dd} % \end{syntax} % 底部日期,只用于国家图书馆封面,要求同提交日期。 % \end{function} % % \begin{function}[updated=2021-10-01]{info/chairman,info/reviewer} % \begin{syntax} % chairman = \Arg{答辩主席} % reviewer = \Arg{评委姓名职称} % \end{syntax} % 答辩委员会信息,分别为评审委员会主席及四位成员的姓名加职称,只对研究生有效。 % 四位评审成员是以列表的形式存储的,填写方法同关键词。 % 如果是盲审,填入“盲审”二字即可。 % \end{function} % % \begin{function}[updated=2021-10-01]{info/clc,info/secret-level, % info/udc,info/supervisor-contact} % \begin{syntax} % clc = \Arg{中图分类号} % secret-level = <不涉密|秘密|机密|绝密> % udc = \Arg{udc} % supervisor-contact = \Arg{导师联系方式} % \end{syntax} % 国家图书馆封面相关,包括中图分类号、密级、UDC 分类号和导师联系方式。 % \end{function} % % \begin{function}{info/titlea,info/titleb,info/titlec,info/supervisora,info/supervisora*,info/supervisora-title,info/supervisora-title*,info/supervisorb,info/supervisorb*,info/supervisorb-title,info/supervisorb-title*} % 这些选项已在 v0.13 弃置,请不要使用。 % \end{function} % % \begin{function}{info/supervisor-title,info/supervisor-title*,info/supervisor-ii-title,info/supervisor-ii-title*,info/submit-date*} % 这些选项已在 v0.14 弃置,请不要使用。 % \end{function} % % % \subsubsection{输入示范} % % 本科生可以参考如下范例输入个人信息。注意不能有空行。 % % \begin{latexexample}[moretexcs={\njusetup},emph={[2]info}] % \njusetup { % info = { % title = {第一行标题\\第二行标题}, % title* = {My title in English}, % keywords = {我,就是,充数的,关键词}, % keywords* = {Dummy, Keywords, Here, {it is}}, % grade = {2018}, % student-id = {189114514}, % author = {周煜华}, % author* = {Zhou Yuhua}, % department = {化学化工学院}, % department* = {School of Chemistry and Chemical Engineering}, % major = {化学}, % major* = {Chemistry}, % supervisor = {李成殿,教授}, % supervisor* = {Professor Li Chengdian}, % submit-date = {2021-09-12} % } % } % \end{latexexample} % % 研究生可以参考如下列表输入个人信息 % % \begin{latexexample}[moretexcs={\njusetup},emph={[2]info}] % \njusetup { % info = { % title = {第一行标题\\第二行标题\\第三行标题}, % title* = {My title in English}, % keywords = {我,就是,充数的,关键词}, % keywords* = {Dummy,Keywords,Here,{it is}}, % grade = {2018}, % student-id = {DZ18114514}, % author = {周煜华}, % author* = {Zhou Yuhua}, % department = {化学化工学院}, % department* = {School of Chemistry and Chemical Engineering}, % major = {化学}, % major* = {Chemistry}, % field = {物理化学}, % field* = {Physical Chemistry}, % supervisor = {李成殿,教授}, % supervisor* = {Professor Li Chengdian}, % submit-date = {2021-09-12}, % defend-date = {2022-01-15}, % email = {git+nju-lug-email-3104-issue-@yaoge123.cn} % } % } % \end{latexexample} % % 如果需要国家图书馆封面,还需要加入如下信息 % % \begin{latexexample}[moretexcs={\njusetup},emph={[2]info}] % \njusetup { % info = { % confer-date = {2022-05-20}, % bottom-date = {2022-05-21}, % chairman = {张晓山~教授}, % reviewer = {王瑞希~教授,郭德纲~副教授,华芈库~教授,戴菲菲~教授}, % clc = {0175.2}, % secret-level = {限制}, % udc = {004.72}, % supervisor-contact = {拉太赫科学与技术学院 枝江市结丘路 19 号 114514} % } % } % \end{latexexample} % % % \subsection{编写正文} % % 与导言区相对的是正文,位于 \env{document} 环境内。 % % \begin{function}{\mainmatter} % \cs{mainmatter} 标志着正文的开始,使用阿拉伯数字重新进行页码编号,并设置页眉格式。 % \end{function} % % \begin{function}{\chapter,\section,\subsection,\subsubsection} % \begin{syntax} % \tn{chapter}\oarg{短描述}\marg{完整的章标题} % \tn{section}\oarg{短描述}\marg{完整的节标题} % \tn{subsection}\oarg{短描述}\marg{完整的节标题} % \tn{subsection}\oarg{短描述}\marg{完整的节标题} % \end{syntax} % 对于过长的标题,目录和页眉中会使用其短描述。 % \end{function} % % \begin{function}{\chaptermark,\sectionmark} % \begin{syntax} % \tn{chapter}\oarg{用在页眉的章标题}\marg{完整的章标题} % \tn{sectionmark}\marg{用在目录的章标题} % \tn{section}\oarg{用在页眉的章标题}\marg{完整的节标题} % \tn{sectionmark}\marg{用在目录节标题} % \end{syntax} % 如果页眉内容发生了冲突,可使用这两个命令细化定制。 % \end{function} % % % \subsubsection{页面} % % 在本模板预定义的页面样式中:本科生使用 \opt{plain} 样式,无页眉, % 页面编号使用五号罗马体,居中位于页脚;研究生使用 \opt{headings} 样式, % 页眉使用五号楷体,包括章名(奇数页右侧)和节名(偶数页左侧), % 页面编号使用五号罗马体,居中位于页脚。在单面模式下,页眉会同时显示章节名。 % % 考虑到各个院系对于页眉内容的规定并不一致,本模板提供了若干个自定义选项。 % % \begin{function}{style/header/format,style/footer/format, % style/header,style/header*,style/footer,style/footer*} % \begin{syntax} % header/format = \Arg{格式} % footer/format = \Arg{格式} % header = \{\Arg{位置}\Arg{内容},\Arg{位置}\Arg{内容},...\} % header* = \{\Arg{位置}\Arg{内容},\Arg{位置}\Arg{内容},...\} % footer = \{\Arg{位置}\Arg{内容},\Arg{位置}\Arg{内容},...\} % footer* = \{\Arg{位置}\Arg{内容},\Arg{位置}\Arg{内容},...\} % \end{syntax} % 页眉页脚的格式与内容设置。带有星号的设置项供单面模式下使用。 % \end{function} % % 页眉页脚的内容设置是一个逗号分隔的列表,实际上是 \cs{fancyhead} 和 % \cs{fancyfoot} 命令的选项。前一个花括号内为大写字母指定的位置选项, % 可使用左(\opt{L})、中(\opt{C})、右(\opt{R})。 % 双面模式下可额外指定出现在奇数页(\opt{O})还是偶数页(\opt{E})。 % 详细说明请参考 \pkg{fancyhdr} 的手册。 % % 接下来展示了一个手动设置页眉内容的例子。这里我们清空了页脚, % 并将页眉格式设置成五号黑体,奇数页左侧为节名,右侧为页码, % 偶数页左侧为页码,右侧为章名。 % \begin{latexexample}[moretexcs={\njusetup,\sffamily},emph={[2]style}] % \njusetup { % style = { % header/format = \small \sffamily, % header = { % { OR } { \thepage }, { OL } { \rightmark }, % { EL } { \thepage }, { ER } { \leftmark } % }, % footer = {}, % } % } % \end{latexexample} % % % \subsubsection{字形} % % \begin{function}{\songti,\heiti,\kaishu,\fangsong,\zihao} % \begin{syntax} % \tn{zihao}\Arg{字号} % \end{syntax} % 字形与字号设置。 % \end{function} % % 本模板继承 \pkg{ctex} 宏集提供的字形字号设置,以备不时之需。换句话说, % 除非你有十足的把握,认为某处字体产生了偏差\footnote{在此情况下也应当直接到 % GitHub 反馈},否则无需动用这些命令处理样式问题。 % % \begin{function}[added=2021-09-22]{\njuline} % \begin{syntax} % \tn{njuline}\Arg{文字} % \end{syntax} % 为了避免原生 \tn{uline} 命令在中文环境下不能正常换行的问题, % 本模板使用 \tn{njuline} 作为替代方案,分别对 \hologo{XeLaTeX} 的 % \pkg{xeCJKfntef} 包和 \hologo{LuaLaTeX} 的 \pkg{lua-ul} % 包中的下划线命令进行了包装。 % \end{function} % % \subsubsection{列表} % % \begin{function}{itemize,enumerate,description} % \begin{syntax} % \tn{begin}\marg{列表环境} % \tn{item}\oarg{标签1} \meta{条目1} % \tn{item}\oarg{标签2} \meta{条目2} % ... % \tn{end}\marg{列表环境} % \end{syntax} % 添加列表环境。 % \end{function} % % 模板默认载入 \pkg{enumitem} 宏包,对三个常用列表环境内的条目间距进行压缩。 % % \subsubsection{脚注} % % \begin{function}{\footnote} % \begin{syntax} % \tn{footnote}\Arg{脚注} % \end{syntax} % 添加脚注。 % \end{function} % % \begin{function}[added=2022-05-01]{style/footnote-style} % \begin{syntax} % footnote-style = <(plain)|pifont> % \end{syntax} % 设置脚注编号样式。默认为普通数字,使用 |pifont| % 选项可修改为带圈数字。单一页面内请尽量避免超过 10 条脚注。 % \end{function} % % \subsubsection{图片} % % \begin{function}{\graphicspath} % \begin{syntax} % \tn{graphicspath}\{\marg{路径1}\marg{路径2}\} % \end{syntax} % 添加图像路径。 % \end{function} % % \pkg{graphicx} 宏包会对一些常见路径进行搜索。使用自己的图片时,如果提示不能找到文件,需要在导言区通过本命令添加图片存放路径。 % % 在使用特定类型的图片文件时,可以省略其扩展名,包括 \file{*.jpg}, \file{*.png}, \file{*.pdf}, \file{*.eps}。 % % \paragraph{单张图片} % % 下面这个例子展示了如何插入一张名称为 \file{myfig.jpg},宽度占页面文字宽度一半的图片。注意标签命令 \tn{label} 必须放在图注命令 \tn{caption} 之后。 % \begin{latexexample}[moretexcs={\includegraphics},emph={[1]figure}] % \begin{figure}[h] % \centering % \includegraphics[width=0.5\textwidth]{myfig} % \caption{我的图} % \label{fig:myfig} % \end{figure} % \end{latexexample} % % \emph{以下图片相关功能的实现均需要手动载入相关宏包}。 % % \paragraph{文字环绕} % % 对于较为瘦长,或者仅起到辅助作用的图像,可以使用 \pkg{wrapfig} 宏包提供的 \env{wrapfigure} 实现文字环绕效果。注意这个环境后紧跟的一行不能为空。 % \begin{latexexample}[moretexcs={\includegraphics},emph={[1]wrapfigure}] % \begin{wrapfigure}{r}{0cm} % \centering % \includegraphics[width=0.15\textwidth]{myfig} % \caption{我的图} % \label{fig:myfig} % \end{wrapfigure} % % \end{latexexample} % % \paragraph{多张嵌套} % % 使用 \pkg{subcaption} 宏包提供的 \env{subfigure} 环境可以实现多张图片嵌套的效果。 % \begin{latexexample}[moretexcs={\includegraphics},emph={[1]figure,subfigure}] % \begin{figure} % \begin{subfigure}{.32\textwidth} % \centering % \includegraphics[width=\textwidth]{fig1} % \caption{fig1} % \end{subfigure} % \begin{subfigure}{.32\textwidth} % \centering % \includegraphics[width=\textwidth]{fig2} % \caption{fig2} % \end{subfigure} % \begin{subfigure}{.32\textwidth} % \centering % \includegraphics[width=\textwidth]{fig3} % \caption{fig3} % \end{subfigure} % \caption{subfigures} % \end{figure} % \end{latexexample} % % 请尽量避免使用较为老旧的 \pkg{subfig} 宏包,完全不要使用过时的 \pkg{subfigure} 宏包。两者的 CTAN 页面上均建议转移至更新的 \pkg{subcaption} 宏包。 % % \subsubsection{表格} % % 下面这个例子展示了如何插入一张表格。通过 \pkg{booktabs} 宏包提供的 \tn{toprule}、\tn{midrule} 和 \tn{bottomrule} 命令,我们可以很轻松地绘制出一张漂亮规范的三线表。 % \begin{latexexample}[moretexcs={\toprule,\midrule,\bottomrule},emph={[1]table,tabular}] % \begin{table}[htbp] % \centering % \caption{我的表} % \label{tab:testtab} % \begin{tabular}{ccc} % \toprule % OS & TeX & 测试情况 \\ % \midrule % 南大TeX & Overleaf & √ \\ % \bottomrule % \end{tabular} % \end{table} % \end{latexexample} % % \emph{以下表格功能的实现均需要手动载入相关宏包。} % % \paragraph{合并单元格} % % \begin{function}{\multirow,\multicolumn} % \begin{syntax} % \tn{multirow}\Arg{nrows}\oarg{bigstructs}\Arg{width}\oarg{fixup}\Arg{text} % \tn{multicolumn}\Arg{nrows}\Arg{width}\Arg{text} % \end{syntax} % 合并单元格。 % \end{function} % % TODO:\pkg{multirow} 宏包的使用方法,命令较为复杂。 % \url{http://www.ctex.org/documents/packages/table/multirow.htm} % % \paragraph{更多样式} % % \pkg{tabularray} 宏包\cite{tabularray}运用 \hologo{LaTeX3} 语法重新实现了表格的绘制,提供了简明的用户接口与丰富的单元格样式,详见其使用手册。 % % % \subsubsection{数学} % % 行内公式形如 |$\mathrm{e}^{(a+2b)x}$|。 % % 带有编号的行间公式 \env{equation}。 % \begin{latexexample}[emph={[1]equation}] % \begin{equation}\label{eq:myeqlabel} % \pi % \end{equation} % \end{latexexample} % % 如不需要编号,可以用 \env{equation*} 或者 |\[|\meta{公式}|\]|, % 请不要使用可能引发问题的 |$$|\meta{公式}|$$| % \footnote{\url{https://tex.stackexchange.com/q/503/}}。 % % % \paragraph{符号和单位} % % ^^A \url{https://www.caam.rice.edu/~heinken/latex/symbols.pdf} % 模板使用 \pkg{unicode-math} 宏包配置数学字体,完整符号表可以参考 % \href{http://mirrors.ctan.org/macros/unicodetex/latex/unicode-math/unimath-symbols.pdf}{\file{unimath-symbols.pdf}}。 % 该方案目前不兼容传统的 \pkg{amsfonts}、\pkg{amssymb}、\pkg{bm} % \footnote{\url{https://tex.stackexchange.com/q/528831/}} % 、\pkg{upgreek} 等宏包。需要使用新方案提供的相应命令。 % 例如,加粗数学符号的命令为 \tn{symbf}。 % 更多细节请查阅 \pkg{unicode-math} 手册。 % % ^^A 本段说明来自 THuThesis,待补充相应配置 % 中文论文的数学符号默认遵循 GB/T 3102--93《物理科学和技术中 % 使用的数学符号》\cite{gb-3102-93},该标准参照采纳 ISO 31-11:1992, % 但是与 \TeX{} 默认的美国数学学会(AMS)的习惯有许多差异。 % 本模板尚未完成自动样式适配,一些需要写作时手动处理的要点包括: % \begin{itemize} % ^^A \item 小于等于号和大于等于号使用斜线($\leqslant$、$\geqslant$) % \item 数学常数和特殊函数名用正体,如 % \begin{itemize} % \item $\uppi$ 使用 |$\uppi$| % \item $\symup{i}$ 使用 |$\symup{i}$| % \item $\symup{e}$ 使用 |$\symup{e}$| % \end{itemize} % \item 微分号使用正体,如 % \begin{itemize} % \item $\mathrm{d} \varphi / \mathrm{d} t$ % 使用 |$\mathrm{d} \varphi / \mathrm{d} t$| % \end{itemize} % ^^A 可以提供一个设置项,|\renewcommand{\vec}[1]{\symbf{#1}}| % \item 向量、矩阵和张量用粗斜体(\cs{symbf}),如 % \begin{itemize} % \item $\symbf{\Sigma}$ 使用 |$\symbf{\Sigma}$| % \item $\symbfsf{T}$ 使用 |$\symbfsf{T}$| % \end{itemize} % \end{itemize} % % 单位默认遵循 GB 3100--93《国际单位制及其应用》\cite{gb-3100-93}和 % GB 3101--93《有关量、单位和符号的一般原则》\cite{gb-3101-93}, % SI 单位可通过载入 \pkg{siunitx} 宏包\cite{siunitx}进行输入。 % ^^A \pkg{siunitx} 是一个更新频繁的包,可能会引发兼容性问题。 % % \paragraph{定理环境} % % 本模板也提供了一系列的数学定理环境。 % % \begin{function}[added=2022-04-21]{theorem/predefine} % \begin{syntax} % predefine = <\TTF> % \end{syntax} % 是否使用模板默认配置的定理环境。默认会载入 \pkg{ntheorem} 并进行相关设置。 % \end{function} % % 全部预定义的数学定理环境如表~\ref{tab:mathenv} 所示。 % 其中证明环境较为特殊,会在结尾添加证毕符号(\mdwhtsquare)。 % 当然,你也可以创建属于自己的定理环境,其样式继承自前部的设定。 % % \begin{function}{\newtheorem,\newtheorem*,\renewtheorem} % \begin{syntax} % \cs{newtheorem}\marg{环境名称}\marg{标题名称}\oarg{计数器范围} % \end{syntax} % 定义新的定理环境或者修改已有的定理环境。带星号的命令不包含计数器。 % 本模板中请在 |\begin{document}| 后进行定制。 % \end{function} % % \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} % % 对于预置的定理环境样式,本模板也提供了一系列选项进行修改。 % 这些选项目前只对模板预定义的若干种环境有效。 % % \begin{function}[added=2022-04-21]{theorem/style} % \begin{syntax} % style = <(plain)|break|change|margin|empty|...> % \end{syntax} % 定理基本样式。等效于 \cs{theoremstyle}\marg{样式名称}。 % \end{function} % % \begin{function}[added=2022-04-21]{theorem/header-font} % \begin{syntax} % header-font = \meta{头部字体格式} % \end{syntax} % 定理头部字体格式。等效于 \cs{theoremheaderfont}\marg{格式}。 % \end{function} % % \begin{function}[added=2022-04-21]{theorem/body-font} % \begin{syntax} % body-font = \meta{内部字体格式} % \end{syntax} % 定理内部字体格式。等效于 \cs{theorembodyfont}\marg{格式}。 % \end{function} % % \begin{function}[added=2022-04-21]{theorem/counter} % \begin{syntax} % counter = % \end{syntax} % 定理计数器范围。 % \end{function} % % 模板的默认设置等效于 % % \begin{latexexample}[moretexcs={\njusetup,\bfseries,\itshape,\mdwhtsquare}, % emph={[2]theorem}] % \njusetup { % theorem = { % predefine = true, % style = plain, % header=font = \normalfont \bfseries, % body-font = \itshape, % qed-symbol = \ensuremath { \mdwhtsquare }, % counter = chapter % } % } % \end{latexexample} % % % \subsubsection{代码} % \changes{v0.13}{2021/12/13}{提供简化的行内代码环境。} % \changes{v0.13}{2021/12/16}{默认不加载 \pkg{listings} 宏包。} % % 如需展示代码,可以使用抄录环境 \tn{verb},格式如 |\verb!!|。其中包裹代码的两个感叹号并不是绝对的,可以替换成任何两个相同的、没有在这段代码中出现过的符号。 % % 抄录环境仅会用等宽字体如实呈现代码本身,并无任何附加功能。若需格式更为多样的代码环境,可以使用 \pkg{listings} 宏包。v0.14.0 版以后,本模板默认不会调用该宏包,使用代码环境前请在导言区自行导入。 % \begin{latexexample} % \usepackage{listings} % \end{latexexample} % % \pkg{listings} 宏包\cite{listings}提供了 \env{lstlisting} 环境,可以生成代码块,提供语法高亮功能,会如实输出缩进空格。且值得注意的是这个环境中的代码不会在草稿模式下显示。 % 如需指定语言,可以使用 |language| 选项。如需自定义关键字,可以使用 |morekeywords| 选项。这一宏包也提供了为某种样式单独一种环境的方法,详见其手册,此处仅展示一个最简化的例子: % \begin{latexexample}[emph={[1]lstlisting},emph={[2]language},morekeywords={print}] % \begin{lstlisting}[language=python] % print("Hello World") % \end{lstlisting} % \end{latexexample} % % 当然,默认提供的代码样式在本模板中并不和谐。可以参照以下代码在导言区设置代码环境通用样式。 % \begin{latexexample}[moretexcs={\lstdefinestyle,\lstset},emph={[2]basewidth,lineskip,basicstyle,keywordstyle,commentstyle,numbers,captionpos,breaklines,xleftmargin,xrightmargin,style,flexiblecolumns}] % \lstdefinestyle { njulisting } % { % basewidth = 0.5 em, % 单个字体宽度 % lineskip = 3 pt, % 在代码行间添加额外行距 % basicstyle = \tiny\ttfamily, % 基本字体样式,小号等宽 % keywordstyle = \bfseries, % 关键词样式,粗体 % commentstyle = \itshape\color{gray}, % 注释样式,灰色斜体 % numbers = left, % 行号位置,左侧 % captionpos = t, % 题注位置,顶部 % breaklines = true, % 是否允许自动折行 % xleftmargin = 2 em, % 左侧边距 % xrightmargin = 2 em % 右侧边距 % } % \lstset{ % style = njulisting, % 调用上述样式 % flexiblecolumns % 允许调整字符宽度 % } % \end{latexexample} % % \pkg{listings} 同时提供了用于展示行内代码的 \tn{lstinline} 命令,用法同 \tn{verb}。但这一命令会被全局的代码字号设置污染。请参考如下使用方法: % \begin{latexexample}[moretexcs={\lstinline,\tt},deletetexcs={\usepackage},emph={[2]language,basicstyle}] % \lstinline[language=[LaTeX]TeX, basicstyle=\tt]!\usepackage{njuvisual}! % \end{latexexample} % % 简便起见,不妨单独创建使用简写的行内代码环境,指定某个符号后用其包裹代码即可。这个符号不可以出现在正文及其他命令中,请谨慎设置。 % \begin{latexexample}[moretexcs={\lstMakeShortInline},emph={[2]style,basicstyle,columns}] % \lstMakeShortInline[ % style = njulisting, % basicstyle = \normalsize\tt, % columns = fixed]| % \end{latexexample} % % % \subsubsection{引用} % % \begin{function}{\cref} % \begin{syntax} % \tn{cref}\Arg{标签} % \end{syntax} % 使用 \pkg{cleveref} 宏包实现了带图、表等项目名称的智能引用。 % \end{function} % % \begin{function}{\href,\url} % \begin{syntax} % \tn{href}\Arg{链接}\Arg{名称} % \tn{url}\Arg{链接} % \end{syntax} % 超链接。\tn{href} 会将特定字符显示为可点击的超链接,\tn{url} 会输出可点击的链接原文。 % \end{function} % % % \subsection{参考文献} % % 本模板默认载入 \pkg{biblatex} 宏包,使用 \hologo{biber} 作为后端\footnote{出于简化命令的考虑,现阶段并不计划支持 \hologo{BibTeX}。},通过 \pkg{biblatex-gb7714-2015}\cite{biblatex-gb7714-2015} 实现 GB/T 7714--2015\cite{gb-t-7714-2015} 规定的参考文献著录规则国家标准。 % % 需要使用 |biber| 命令编译才会显示正确的条目序号,详情请参照 \ref{subsubsec:compileseq}。 % % % \subsubsection{选项} % % \begin{function}[added=2021-12-19]{bib/style} % \begin{syntax} % style = <(numeric)|author-year|\meta{自定义样式}> % \end{syntax} % 参考文献样式。可选顺序编码制 \opt{numeric} 和著者-出版年制 \opt{author-year}, % 或自行填入任意其他 \pkg{biblatex} 样式。默认为顺序编码制。 % \end{function} % % 参考文献样式是一个整体的设置,会对正文中引用的文献的标注方法和参考文献表的输出格式产生影响。根据国家规定\cite{gb-t-7714-2015},可以按照参考文献表的组织方式分为以下两种样式: % \begin{description} % \item[顺序编码制] 顺序编码制是按正文中引用的文献出现的先后顺序连续编码,将序号置于方括号中。参考文献表采用顺序编码制组织时,各篇文献应按正文部分标注的序号依次列出。 % \item[著者-出版年制] 正文引用的文献采用著者-出版年制时,各篇文献的标注内容由著者姓氏与出版年构成,并置于"()"内。参考文献表采用著者-出版年制组织时,各篇文献首先按文种集中,然后按著者字顺和出版年排列。 % \end{description} % % 对于本科生而言,学校规定文件表明参考文献表应当“用数字加方括号 % 表示”\cite{nju2021},符合顺序编码制的格式,保持默认设置即可。 % % \begin{function}[added=2022-02-15]{bib/option} % \begin{syntax} % option = \meta{选项列表} % \end{syntax} % 待传入 \pkg{biblatex} 宏包的额外选项列表。 % \end{function} % % 本模板中 \pkg{biblatex} 并不是显式载入的。 % 如需在其基础上进行一些定制,可使用本设置项载入宏包选项\cite{biblatex}。 % % \begin{function}[added=2021-12-19]{bib/resource} % \begin{syntax} % resource = \Arg{文件} % \end{syntax} % 参考文献数据源。类似于 \tn{addbibresource} 命令,但可以使用逗号分隔的 % 列表形式。必须使用带扩展名(\file{.bib})的完整文件名。 % \end{function} % % \begin{function}{\addbibresource} % \begin{syntax} % \tn{addbibresource}\Arg{文件} % \end{syntax} % 添加参考文献源文件。为了与 \pkg{biblatex} 进行兼容,也可使用本命令 % 添加数据源。本命令不支持逗号分隔多个文件的形式,如果希望额外添加参 % 考文献列表,需要在导言区中多次调用。 % \end{function} % % 可以参考如下范例进行参考文献设置。 % 其中 \opt{bib/option} 的内容旨在关闭部分不需显示的文献信息, % 并采取仅首字母大写的作者姓名格式,可根据需要使用。 % \begin{latexexample}[moretexcs={\njusetup},emph={[2]bib}] % \njusetup { % bib = { % style = author-year, % resource = {njuthesis-sample.bib}, % option = { % doi = false, % isbn = false, % url = false, % eprint = false, % gbnamefmt = lowercase % } % } % } % \end{latexexample} % % % \subsubsection{参考文献表} % % \begin{function}{\printbibliography} % 生成参考文献表。 % \end{function} % % 显然只有被引用过的条目才会被输出至参考文献表。 % % 假如需要在每章末尾附上单独的参考文献表,导言区添加以下设置, % 并在每章后使用 \cs{printbibliography} 即可。 % \begin{latexexample}[moretexcs={\njusetup},emph={[2]bib}] % \njusetup { % bib = { option = { refsection = chapter } } % } % \end{latexexample} % % 如果开启了草稿模式,您可能会注意到部分条目存在超宽的问题。 % 对此,需要将 \pkg{biblatex-gb7714-2015} 宏包手动更新至 2022-04-16 以后的版本。 % 此外,由于 \TeX{} 预置的断词位置是有限的,不能覆盖学术上使用的复杂词汇, % 您也可以自行在 \file{.bib} 文件中设置断行点,例如可以将 graphene 一词修改为 graph|\-|ene。 % % \subsubsection{正文引用} % % \begin{function}{\cite} % \begin{syntax} % \tn{cite}\marg{文献} % \tn{cite}\oarg{页码}\marg{文献} % \end{syntax} % 在正文中引用参考文献。 % \end{function} % % 引用命令 \tn{cite} 含有多个变体,以便使用文献条目中不同的信息域。在两种参考文献样式下,这些命令的行为具体存在一些差异,详见表 \ref{tab:numeric-style} 和表 \ref{tab:author-year-style}。 % % \begin{table}[ht] % \centering % \begin{talltblr} [ % caption = {顺序编码制下的引用样式}, % label = {tab:numeric-style} ] % { row{1} = {font=\bfseries}, colspec = {cll} } % \toprule % 引用方式 & 命令 & 排版效果 \\ % \midrule % 单篇文献 & \tn{cite} & 上标可设置页码 \\ % 单篇文献 & \tn{parencite} & 非上标可设置页码 \\ % 多篇文献 & \tn{cite} & 上标,逗号隔开或短横线连接 \\ % 标注页码 & \tn{pagescite} & 上标加自动页码 \\ % 标注作者 & \tn{textcite} & 作者为主语加非上标编号 \\ % 标注作者 & \tn{authornumcite} & 作者为主语加上标编号 \\ % 完整脚注 & \tn{footfullcite} & 脚注方式 \\ % \bottomrule % \end{talltblr} % \end{table} % % \begin{table}[ht] % \centering % \begin{talltblr} [ % caption = {著者-出版年制下的引用样式}, % label = {tab:author-year-style}, % note{a} = {在此样式下 \tn{parencite} 效果等同于 \tn{cite}。} ] % { row{1} = {font=\bfseries}, colspec = {cll} } % \toprule % 引用方式 & 命令 & 排版效果 \\ % \midrule % 单篇文献 & \tn{cite}\TblrNote{a} & % 作者加年份用括号包围可设置页码 \\ % 多篇文献 & \tn{cite} & 分号隔开 \\ % 标注页码 & \tn{pagescite} & 作者加年份用括号包围自动页码 \\ % 标注年份 & \tn{yearcite} & 用括号包围的年份 \\ % 标注年份、页码 & \tn{yearpagescite} & 提供年份用括号包围自动页码 \\ % 标注作者 & \tn{textcite} & 作者为主语加加括号包围年份 \\ % 完整脚注 & \tn{footfullcite} & 脚注方式 \\ % \bottomrule % \end{talltblr} % \end{table} % % % \subsubsection{文献管理} % % 参考文献数据源理应是通过文献管理软件导出的,而不是逐条手动填写的。 % % \subparagraph{使用 EndNote} % % 南京大学信息化建设管理服务中心已购买 \href{https://itsc.nju.edu.cn/EndNote/list.htm}{EndNote} 供全校师生免费使用,最新版为 EndNote 20。 % % \subparagraph{使用 JabRef} % % \href{https://www.jabref.org/}{JabRef} 是一款开源、跨平台的文献管理软件。 % JabRef 提供了对 \hologo{BibTeX} 和 \pkg{biblatex} 的原生支持, % 能够直接管理 \file{.bib} 文件, 还可以向 TeXstudio 等外部软件推送引用命令。 % % \subparagraph{使用 Zotero} % % \href{https://www.zotero.org/}{Zotero} 也是一款开源、跨平台的文献管理软件。 % Zotero 更为通用,其功能可以通过 \href{https://github.com/l0o0/jasminum}{Jasminum}、\href{https://github.com/retorquere/zotero-better-bibtex}{Better BibTeX}、\href{https://github.com/bwiernik/zotero-shortdoi}{DOI Manager} 等第三方插件,以及 Zotero Connector 浏览器插件进行增强。 % % % \subsection{特殊页面} % % 本模板也预定义了一系列用于生成所需的特殊页面的命令与环境。 % % % \subsubsection{封面} % % \begin{function}{\maketitle} % 生成封面。 % \end{function} % % 本科生模板仅会生成中文封面;研究生模板会生成中英文封面。 % 如果选择了 \opt{nlcover},\emph{仅仅}会生成研究生的国家图书馆封面。 % 如果选择了 \opt{decl-page},会在封面后生成本科生的诚信承诺书或研究生的 % 原创性声明。在启用草稿模式后封面绘制将被禁用。 % % \paragraph{封面图片} % % \begin{function}[added=2021-12-23,updated=2022-02-22]{ % style/emblem-img,style/name-img} % \begin{syntax} % emblem-img = \Arg{文件} % name-img = \Arg{文件} % \end{syntax} % 校名、校徽图片文件路径。 % \end{function} % % 通过以上选项可以使用外置的校徽和校名图片,两个选项\emph{任一留空}则不会生效。 % 本模板封面中校徽及校名的绘制默认依赖 \pkg{njuvisual} 宏包提供的 \tikzlogo % 矢量曲线,耗时较长,在替换为外置图片后可节省约1秒的编译时长。 % % % \subsubsection{摘要页} % \changes{v0.11}{2021/10/01}{简化了摘要的编写方式。} % % \begin{function}{abstract,abstract*} % 摘要。带星号的会生成英文摘要。 % \end{function} % % \begin{latexexample}[emph={[1]abstract,abstract*}] % \begin{abstract} % 我的中文摘要 % \end{abstract} % % \begin{abstract*} % Abstract in English % \end{abstract*} % \end{latexexample} % % \begin{function}[added=2022-02-04]{style/abstract-in-toc} % \begin{syntax} % abstract-in-toc = <\TTF> % \end{syntax} % 是否将摘要条目插入目录,默认开启。 % 关闭此选项后摘要页将不会出现在目录中,仅保留其 PDF 书签。 % \end{function} % % \begin{function}[added=2022-03-26]{style/abstract-title} % \begin{syntax} % abstract-title = <(strict)|centered|natural> % \end{syntax} % 选择研究生摘要标题样式。 % 默认为严格模式(\opt{strict}),即完全模仿材料包要求。 % \end{function} % % 材料包中的 Word 空白模板仅有两行空白下划线。 % 根据填写习惯的不同,模板预置了三种样式: % \begin{itemize} % \item \opt{strict},在两行空白下划线上左对齐填写标题。 % 如果该标题不足一行,则第二行下划线留空; % 如果长度超出两行,则向后延伸并抛出一个警告信息。 % \item \opt{centered},将严格模式的左对齐改为居中。 % \item \opt{natural},仅居中标题,不做行数检查。 % 本模式更适合较短的题目。 % \end{itemize} % % \subsubsection{前言页} % % \begin{function}{preface} % 使用 \env{preface} 环境定义。 % \end{function} % % \begin{latexexample}[emph={[1]preface,flushright}] % \begin{preface} % 我的前言 % \vspace{1cm} % \begin{flushright} % 我的名字\\ % 时间地点 % \end{flushright} % \end{preface} % \end{latexexample} % % % \subsubsection{目录页} % % \begin{function}{\tableofcontents,\listoffigures,\listoftables} % 分别生成目录、图片目录和表格目录。 % \end{function} % % 目录页的标题名称一般无需修改。用户可以选择使用 \pkg{ctex} 宏集提供的 \tn{ctexset} 命令进行自定义。 % \begin{latexexample}[moretexcs={\ctexset},emph={[1]contentsname,listfigurename,listtablename}] % \ctexset{ % contentsname = { 目\hspace{2em}次 }, % listfigurename = { 插图清单 }, % listtablename = { 表格清单 } % } % \end{latexexample} % 实际上,根据《学位论文编写规则》国家标准\cite{gb-t-7713.1-2006}, % 尽管“目录”这一说法已流传甚广,但学位论文中理应使用“目次”这一名称 % 来指代篇目的列表。 % % \begin{function}[added=2022-02-04]{style/toc-in-toc} % \begin{syntax} % toc-in-toc = <\TTF> % \end{syntax} % 是否在目录中显示目录自身的条目,默认开启。关闭此选项后目录、 % 插图目录和表格目录将不会出现在目录中,仅保留其 PDF 书签。 % \end{function} % % % \subsubsection{符号表} % % \begin{function}{notation,notation*} % \begin{syntax} % \tn{begin}\{notation\}\oarg{说明宽度}\oarg{符号宽度} % \quad\tn{item}\oarg{符号} \meta{说明} % \tn{end}\{notation\} % \end{syntax} % 符号表,或者称为术语表、缩略词对照表。带有星号的符号表环境不会插入目录。 % \end{function} % % % \subsubsection{致谢页} % % \begin{function}{acknowledgement} % 同前言,使用 \env{acknowledgement} 环境。 % \end{function} % % \begin{latexexample}[emph={[1]acknowledgement}] % \begin{acknowledgement} % 感谢NJU LUG % \end{acknowledgement} % \end{latexexample} % % % \subsubsection{附录页} % % \begin{function}{\appendix} % 附录放在本命令后,以英文字母进行编号,编写方式同正文。 % \end{function} % % % \subsubsection{成果列表} % % \begin{function}[added=2021-09-29,updated=2021-12-20]{\njupaperlist} % \begin{syntax} % \tn{njupaperlist}\oarg{标题}\marg{文献} % \end{syntax} % 成果列表,生成一个列举文献条目的无编号节。可选参数为标题, % 默认为“发表文章目录”。\Arg{文献} 的填写方式同 \tn{cite}, % 多个文献需要使用英文半角逗号隔开。 % \end{function} % % 一个简单的例子如下所示: % \begin{latexexample}[moretexcs={\njuchapter,\njupaperlist}] % \njuchapter{攻读博士学位期间研究成果} % \njupaperlist[攻读博士学位期间发表的学术论文]{ % Nemec1997-209-214,Chiani1998-2998-3008,Chiani1998a} % \end{latexexample} % % 为了便于识别,成果列表中默认对发表年份进行加粗处理。而对作者姓名的处理较为复杂。利用 \pkg{biblatex} 的数据注解机制可以实现对特定文献信息的样式修改\footnote{\url{https://blog.csdn.net/xenonhu/article/details/120853247}},在此可以用来实现指定作者姓名的突出。经过注解后的一则参考文献条目如下所示: % \begin{latexexample}[emph={[1]@inproceedings},emph={[2]author}] % @inproceedings{Nemec1997-209-214, % title = {Force control of redundant robots}, % author = {B Nemec and Zhao, Mou Mou}, % author+an = {2=thesisauthor}, % booktitle = {Processings of Symposium on Robot Control}, % shortbooktitle = {(PSRC)}, % pages = {209-214}, % country = {Nantes France}, % year = {1997} % } % \end{latexexample} % 其中 |author+an| 提供了注解的标记,格式为 \meta{序号}|=|\meta{标签},以上条目中即是将第二名作者加入了指定论文作者的注解。\tn{njupaperlist} 会识别 |thesisauthor| 标签,为其指代的作者姓名进行加粗下划线处理。 % % 除手动进行标记以外,以下也提供一种自动化处理办法。下载 \href{https://github.com/hushidong/biblatex-map}{bibmap} 全部文件后,修改主目录下的 \file{bibmapaddauthoran.py} 中 |fieldsource| 为需要匹配的姓名,将需要进行标记的 \file{.bib} 文件拷贝至本目录(此处使用 \file{test.bib} 进行示范),运行以下命令生成的参考文献数据源即可被成果列表识别加粗。 % % \begin{shellexample}[morekeywords={python},deletekeywords={test}] % python bibmap.py test.bib -m bibmapaddauthoran.py % \end{shellexample} % % % \subsection{额外定制} % % 在研究生院松散的规定下,本模板仅能提供一个大体适用的框架, % 势必需要为用户修改留出空间。这一节将提供一些定制方法。 % % \subsubsection{固定文本} % % \begin{function}{\njusetname,\njusetname*,\njusettext,\njusettext*} % \begin{syntax} % \tn{njusetname}\marg{名称}\oarg{变体}\marg{内容} % \tn{njusetname*}\marg{名称}\oarg{变体}\marg{内容} % \tn{njusettext}\marg{名称}\oarg{变体}\marg{内容} % \tn{njusettext*}\marg{名称}\oarg{变体}\marg{内容} % \end{syntax} % 修改固定文本内容,带星号的命令表示修改对应的英文字段。 % 名称对应的默认内容可以参见 \ref{subsubsec:constant-name} 与 % \ref{subsubsec:constant-text} 节。 % \end{function} % % 譬如,将英文摘要页的小标题修改为仅首字母大写的样式,示例如下: % % \begin{latexexample}[moretexcs={\njusetname*}] % \njusetname*{abstract}[b]{Abstract} % \end{latexexample} % % \subsubsection{长度值} % \label{subsubsec:modify-length} % % \begin{function}{\njusetlength,\njusetlength*} % \begin{syntax} % \tn{njusetlength}\marg{名称}\marg{长度} % \tn{njusetlength*}\marg{名称}\marg{长度} % \end{syntax} % 修改长度值,默认为修改固定长度(|dim| 类型), % 带星号的命令表示修改弹性长度(|skip| 类型,目前未涉及)。 % 默认长度值可以参见 \ref{subsubsec:constant-length} 节。 % \end{function} % % 譬如,将封面页填写个人信息的横线加长,示例如下: % % \begin{latexexample}[moretexcs={\njusetlength}] % \njusetlength{coveruline}{330pt} % \end{latexexample} % % \subsubsection{样式} % \label{subsubsec:modify-format} % % \begin{function}{\njusetformat} % \begin{syntax} % \tn{njusetformat}\marg{名称}\marg{样式} % \end{syntax} % 修改样式。默认样式可以参见 \ref{subsubsec:constant-format} 节。 % \end{function} % % 譬如,将章标题字号加大到小二号,示例如下: % % \begin{latexexample}[moretexcs={\njusetformat,\zihao}] % \njusetformat{chapter}{\zihao{-2}\sffamily\centering} % \end{latexexample} % % % \subsection{视觉识别系统} % % 视觉识别系统 \pkg{njuvisual} 现已被分离为独立宏包\cite{njuvisual}, % 基本使用方法举例如下: % \begin{latexexample}[moretexcs={\njuemblem,\njuname,\njuname*}] % \njuemblem{!}{3cm} % 生成高 3cm 的紫色校徽 % \njuname{4cm}{!} % 生成宽 4cm 的紫色中文校名 % \njuname*{4cm}{!} % 生成宽 4cm 的紫色英文校名 % \njuemblem[black]{!}{3cm} % 黑色的校徽 % \njuemblem[department=dii]{!}{4cm} % 紫色匡院徽标 % \njuemblem[department=cs,color=blue]{!}{3cm} % 纯蓝色计科徽标 % \end{latexexample} % % 本宏包的详细使用方法请参考其使用手册。 % % % \section{宏包依赖} % % 在任何情况下,本模板都会\emph{显式}调用以下宏包(或文档类): % \begin{itemize} % \item \pkg{xtemplate} 和 \pkg{l3keys2e},用于扩展 \hologo{LaTeX3} 编程环境。 % 它们属于 \pkg{l3packages} 宏集。 % \item \cls{ctexbook},提供中文排版的通用框架。属于 C\hologo{TeX} % 宏集 \cite{CTeX}。 % \item \pkg{mathtools},增强数学功能。 % \item \pkg{unicode-math},负责处理 Unicode 编码的 OpenType 数学字体。 % \item \pkg{geometry},用于调整页面尺寸。 % \item \pkg{setspace},调整行距。 % \item \pkg{fancyhdr},处理页眉页脚。 % \item \pkg{footmisc},处理脚注。 % \item \pkg{ntheorem},提供增强版的定理类环境。 % \item \pkg{enumitem},调整列表环境。 % \item \pkg{graphicx},提供图形插入的接口。 % \item \pkg{booktabs},绘制三线表。 % \item \pkg{caption},用于设置题注。 % \item \pkg{hyperref},提供交叉引用、超链接、电子书签等功能。 % \item \pkg{cleveref},用于自动生成引用标签。 % \item \pkg{biblatex},提供参考文献解决方案。 % \end{itemize} % % 以下宏包可能被隐式载入: % \begin{itemize} % \item \pkg{xcolor},提供色彩支持。 % \item \pkg{amsmath},对 \LaTeX{} 的数学排版功能进行了 % 全面扩展。属于 \hologo{AmSLaTeX} 套件。 % \item \pkg{biblatex-gb7714-2015},用于生成国标下的参考文献样式。 % \item \pkg{xits},提供数学字体。 % \end{itemize} % % 在开启某些选项时,本模板也会调用以下宏包: % \begin{itemize} % \item \pkg{fandol}、\pkg{tex-gyre} 和 \pkg{tex-gyre-math},提供自由字体。 % \item \pkg{emptypage},在双面模式下清空空白页的页眉、页脚和页码。 % \item \pkg{njuvisual},用于绘制封面的校名校徽。 % \item \pkg{tabularray},用于绘制研究生的出版授权书信息表格。 % \item \pkg{xeCJKfntef} 或 \pkg{lua-ul},用于在对应引擎下绘制下划线。 % \end{itemize} % % 下列宏包会与本模板产生冲突,或者不能发挥预期作用: % \begin{itemize} % \item \pkg{natbib} 和 \pkg{gbt7714} 等 \hologo{BibTeX} 相关的参考文献宏包。 % \item \pkg{bm} 等使用传统数学字体配置方案的宏包。 % \item \pkg{babel} 在直接使用时会覆盖默认的中文名称设置。 % \item \pkg{microtype} 在 \hologo{XeTeX} 和 \hologo{LuaTeX} 下支持有限。 % \end{itemize} % % % \begin{thebibliography}{99} % % \newcommand\urlprefix{\newline\hspace*{\fill}} % \let\OldUrl=\url % \renewcommand\url[2][]{{\small\textit{#1}~\OldUrl{#2}}} % \newcommand\CTANurl[2][]{{^^A % \small\textit{#1}~\href{http://mirror.ctan.org/#2}{\texttt{CTAN://#2}}}} % % \subsection*{书籍} % % \bibitem{lshort} % \textsc{Oetiker T}, \textsc{Partl H}, \textsc{Hyna I}, et al. % \newblock \textit{The Not So Short Introduction to \hologo{LaTeXe}: Or \hologo{LaTeXe} in 139 minutes} [EB/OL]. % \newblock version 6.4, % \newblock (2021-03-09) % \urlprefix\url{https://ctan.org/pkg/lshort-english} % \urlprefix\CTANurl[文档:]{info/lshort/english/lshort.pdf} % % \bibitem{lshort-zh-cn} % \textsc{Oetiker T}, \textsc{Partl H}, \textsc{Hyna I}, et al. % \newblock \textit{一份(不太)简短的 \hologo{LaTeXe} 介绍: 或 111 分钟了解 \hologo{LaTeXe}} [EB/OL]. % \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} % % \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 % % % \subsection*{标准、规范} % % \bibitem{gb-3100-93} % 全国信息与文献标准化技术委员会. % \newblock \textit{国际单位制及其应用: GB 3100--93} [S]. % \newblock 北京: 中国标准出版社, 1993 % % \bibitem{gb-3101-93} % 全国信息与文献标准化技术委员会. % \newblock \textit{有关量、单位和符号的一般原则: GB 3101--93} [S]. % \newblock 北京: 中国标准出版社, 1993 % % \bibitem{gb-3102-93} % 全国信息与文献标准化技术委员会. % \newblock \textit{物理科学和技术中使用的数学符号: GB/T 3102--93} [S]. % \newblock 北京: 中国标准出版社, 1993 % % \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*{宏包} % % \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} % % \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} % % \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} % % \bibitem{siunitx} % \textsc{Wright J}. % \newblock \textit{A comprehensive (SI) units package} [EB/OL]. % \newblock version 3.1.0, % \newblock (2022-04-25) % \urlprefix\url{https://www.ctan.org/pkg/siunitx} % \urlprefix\CTANurl[文档:]{macros/latex/contrib/siunitx/siunitx.pdf} % % \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{以下模版现已停止更新。} % % \bibitem{wenboyang2013} % 杨文博. % \newblock \textit{南京大学学位论文 \hologo{LaTeX} 模板} [EB/OL]. % \newblock (2018-06-23) % \urlprefix\url{https://github.com/solrex/njuthesis} % % \bibitem{fireblue2013} % \textsc{fireblue}. % \newblock \textit{南京大学学位论文 \hologo{LaTeX} 模板} [EB/OL]. % \newblock (2013-04-13) % \urlprefix\url{https://github.com/fireblue/NJUThesis} % % \bibitem{wenhai-zheng2013} % \textsc{wenhai-zheng}. % \newblock \textit{南京大学本科毕业论文 \hologo{LaTeX} 模板} [EB/OL]. % \newblock (2013-08-12) % \urlprefix\url{https://github.com/wenhai-zheng/NJUThesis} % % \bibitem{zenglecao2013} % 曹增乐. % \newblock \textit{南京大学本科毕业论文(设计) \hologo{LaTeX} 模板} [EB/OL]. % \newblock (2019-06-26) % \urlprefix\url{https://github.com/ZLCao/NJUBachelor} % % \bibitem{haixinghu2013} % 胡海星. % \newblock \textit{南京大学学位论文 \hologo{XeLaTeX} 模板} [EB/OL]. % \newblock (2018-08-08) % \urlprefix\url{https://github.com/Haixing-Hu/nju-thesis} % % \bibitem{chuhengzhang2016} % 张楚珩. % \newblock \textit{南京大学本科生毕业论文 \hologo{LaTeX} 模板} [EB/OL]. % \newblock (2016-06-01) % \urlprefix\url{https://github.com/zhangchuheng123/NJUThesis} % % \bibitem{yanyanjiang2017} % 蒋炎岩. % \newblock \textit{南京大学山寨 \hologo{LyX} 研究生毕业论文模板} [EB/OL]. % \newblock (2019-01-16) % \urlprefix\url{https://github.com/jiangyy/njuthesis} % % \bibitem{njuHan2018} % \textsc{njuHan}. % \newblock \textit{南京大学学位论文(本科/硕士/博士),毕业论文 \hologo{LaTeX} 模板} [EB/OL]. % \newblock (2021-06-15) % \urlprefix\url{https://github.com/njuHan/njuthesis-nju-thesis-template} % % \bibitem{anyirao2018} % 饶安逸. % \newblock \textit{南京大学本科生毕业论文 \hologo{LaTeX} 模板 2018 新版} [EB/OL]. % \newblock (2018-06-24) % \urlprefix\url{https://github.com/AnyiRao/NJUThesis2018} % % \bibitem{yichenzhao2021} % 赵懿晨. % \newblock \textit{南京大学本科生毕业论文 \hologo{LaTeX} 模板(2021版)} [EB/OL]. % \newblock (2021-09-23) % \urlprefix\url{https://github.com/FengChendian/NJUThesis2021} % % % \end{thebibliography} % % % \end{documentation} % \clearpage % % \begin{implementation} % % \section{代码实现} % \changes{v0.10}{2021/09/26}{对代码实现部分进行了整理。} % % 本模板使用 \hologo{LaTeX3} 语法编写,依赖 \pkg{expl3} 环境, % 并需调用 \pkg{l3packages} 中的相关宏包。 % % 以下代码中有一些形如 \agrd{*class} 的标记, % 这是 \pkg{DocStrip} 中的“guard”,用来选择性地提取文件。 % “|*|”和“|/|”分别表示该部分的开始和结束。不含 % “|*|”和“|/|”的 guard 出现在行号右侧,它们用来确定 % 单独一行代码的归属。这些 guard 的颜色深浅不一,用以明确嵌套关系。 % % 另有若干包含 \bgrd{@@} 的 guard,用以表示名空间(模块)。 % 在删除注释生成格式文件时,源代码变量名称中的 |@@| 会被等号后的字段替换, % 譬如在本模板主体部分中 \bgrd{〈@@=nju〉}。 % % % \subsection{准备} % % \begin{macrocode} %<*class> %<@@=nju> % \end{macrocode} % % \changes{v0.11}{2021/10/23}{添加了若干环境检查与警告信息。} % \changes{v0.12}{2021/12/03}{放宽对于 \pkg{l3packages} 的版本要求。} % 检查 \hologo{LaTeX3} 编程环境。 % \begin{macrocode} \RequirePackage { xtemplate, l3keys2e } \msg_new:nnn { njuthesis } { l3-too-old } { Package~ "#1"~ is~ too~ old. \\ Please~ update~ an~ up-to-date~ version~ of~ the~ bundles~ "l3kernel"~ and~ "l3packages"~ using~ your~ TeX~ package~ manager~ or~ from~ CTAN. } \clist_map_inline:nn { xtemplate, l3keys2e } { \@ifpackagelater {#1} { 2020/10/01 } { } { \msg_error:nnn { njuthesis } { l3-too-old } {#1} } } % \end{macrocode} % % 目前 \cls{njuthesis} 仅支持 \hologo{XeTeX} 和 \hologo{LuaTeX}。 % \begin{macrocode} \msg_new:nnn { njuthesis } { unsupported-engine } { The~ njuthesis~ class~ requires~ either~ XeTeX~ or~ LuaTeX. \\ "#1"~ is~ not~ supported~ at~ present.~ You~ must~ change~ your~ typesetting~ engine~ to~ "xelatex"~ or~ "lualatex". } \bool_lazy_or:nnF { \sys_if_engine_xetex_p: } { \sys_if_engine_luatex_p: } { \msg_fatal:nnx { njuthesis } { unsupported-engine } { \c_sys_engine_str } } % \end{macrocode} % % % \subsection{定义变量} % % 在变量名称中,|l| 代表局部变量,|g| 代表全局变量,|c| 代表常量,最后一个下划线后的内容指示其类型。 % % \begin{variable}{\l_@@_tmp_box,\l_@@_tmp_clist, % \l_@@_tmpa_dim,\l_@@_tmpb_dim,\l_@@_tmp_int, % \l_@@_tmp_seq,\l_@@_tmpa_tl,\l_@@_tmpb_tl} % 临时变量。 % \begin{macrocode} \box_new:N \l_@@_tmp_box \clist_new:N \l_@@_tmp_clist \dim_new:N \l_@@_tmpa_dim \dim_new:N \l_@@_tmpb_dim \int_new:N \l_@@_tmp_int \seq_new:N \l_@@_tmp_seq \tl_new:N \l_@@_tmpa_tl \tl_new:N \l_@@_tmpb_tl % \end{macrocode} % \end{variable} % % \begin{variable}{\g_@@_info_degree_int, % \g_@@_info_diploma_int,\g_@@_info_type_int} % 用于存储学位类型的变量。 % \begin{macrocode} \int_new:N \g_@@_info_degree_int \int_new:N \g_@@_info_diploma_int \int_new:N \g_@@_info_type_int % \end{macrocode} % \end{variable} % % \begin{variable}{\g_@@_info_degree_tl,\g_@@_info_diploma_tl, % \g_@@_info_type_tl,\g_@@_info_type_en_tl} % 用于存储学位名称的变量。 % \begin{macrocode} \tl_new:N \g_@@_info_degree_tl \tl_new:N \g_@@_info_diploma_tl \tl_new:N \g_@@_info_type_tl \tl_new:N \g_@@_info_type_en_tl % \end{macrocode} % \end{variable} % % \begin{variable}{\g_@@_twoside_bool} % 定义用于判断是否使用双面模式的变量,初始值为使用双面模式。 % \begin{macrocode} \bool_new:N \g_@@_twoside_bool \bool_set_true:N \g_@@_twoside_bool % \end{macrocode} % \end{variable} % % \begin{variable}{\l_@@_second_supv_bool} % 定义用于判断是否有第二导师的变量。 % \begin{macrocode} \bool_new:N \l_@@_second_supv_bool % \end{macrocode} % \end{variable} % % \begin{variable}{\g_@@_info_supvfull_tl,\g_@@_info_supvfull_en_tl} % 用于存储导师姓名加职称的变量。 % \begin{macrocode} \tl_new:N \g_@@_info_supvfull_tl \tl_new:N \g_@@_info_supvfull_en_tl % \end{macrocode} % \end{variable} % % \begin{variable}{\g_@@_latin_font_tl,\g_@@_cjk_font_tl} % 用于存储所使用字体名称的全局变量。 % \begin{macrocode} \tl_new:N \g_@@_latin_font_tl \tl_new:N \g_@@_cjk_font_tl % \end{macrocode} % \end{variable} % % \begin{variable}{\g_@@_config_tl} % 保存配置文件名称。默认为空。 % \begin{macrocode} \tl_new:N \g_@@_config_tl % \end{macrocode} % \end{variable} % % \begin{variable}{\g_@@_theorem_type_clist} % 定理类型。 % \begin{macrocode} \clist_new:N \g_@@_theorem_type_clist % \end{macrocode} % \end{variable} % % \begin{variable}{\c_@@_today_tl} % 编译当天日期,格式为 |yyyy-mm-dd|。 % \begin{macrocode} \tl_const:Nx \c_@@_today_tl { \int_to_arabic:n { \c_sys_year_int } - \int_to_arabic:n { \c_sys_month_int } - \int_to_arabic:n { \c_sys_day_int } } % \end{macrocode} % \end{variable} % % \begin{variable}{\c_@@_name_type_clist,\c_@@_name_type_en_clist, % \c_@@_name_degree_clist,\c_@@_name_degree_en_clist} % 论文类型与学位类型。 % \begin{macrocode} \clist_const:Nn \c_@@_name_type_clist { 毕业论文, 毕业设计 } \clist_const:Nn \c_@@_name_type_en_clist { THESIS, DESIGN } \clist_const:Nn \c_@@_name_degree_clist { 学士, 硕士, 硕士专业, 博士 } \clist_const:Nn \c_@@_name_degree_en_clist { Bachelor, Master, Master, Doctor~of~Philosophy } % \end{macrocode} % \end{variable} % % \begin{variable}{\c_@@_month_en_clist} % 英文月份名称。 % \begin{macrocode} \clist_const:Nn \c_@@_month_en_clist { January, February, March, April, May, June, July, August, September, October, November, December } % \end{macrocode} % \end{variable} % % \begin{variable}{\c_@@_blind_info_clist,\c_@@_blind_info_en_clist, % \c_@@_blind_infolist_clist} % 盲审模式下不显示的个人信息项。 % \begin{macrocode} \clist_const:Nn \c_@@_blind_info_clist { author, chairman, clc, dept, email, field, grade, id, major, secretlv, supvcont, udc } \clist_const:Nn \c_@@_blind_info_en_clist { author, dept, field, major, supv, supv_ii } \clist_const:Nn \c_@@_blind_infolist_clist { reviewer, supv, supv_ii } % \end{macrocode} % \end{variable} % % % \subsection{内部函数} % % \begin{macro}{\@@_quad:,\@@_qquad:} % 等价于 \LaTeXe{} 中的 \tn{quad} 和 \tn{qquad}。 % \begin{macrocode} \cs_new:Nn \@@_quad: { \skip_horizontal:n { 1 em } } \cs_new:Nn \@@_qquad: { \skip_horizontal:n { 2 em } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_vskip:,\@@_hskip:} % 生成一个较小的 skip。 % \begin{macrocode} \cs_new:Nn \@@_vskip: { \skip_vertical:N \c_@@_smallvskip_dim } \cs_new:Nn \@@_hskip: { \skip_horizontal:N \c_@@_smallhskip_dim } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_vskip:N} % 类似于 \hologo{LaTeX2e} 中的 \tn{vspace*}, % 从上一个页面元素底部开始生成 |skip|。 % \begin{macrocode} \cs_new_protected:Npn \@@_vskip:N #1 { \hrule height \c_zero_dim \nobreak \skip_vertical:n { - \baselineskip - \lineskip } \skip_vertical:N #1 } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_define_name:nn,\@@_define_name:nnn} % 用来定义默认名称的辅助函数。 % \begin{macrocode} \cs_new_protected:Npn \@@_define_name:nn #1#2 { \tl_const:cn { c_@@_name_ #1 _tl } { #2 } } \cs_new_protected:Npn \@@_define_name:nnn #1#2#3 { \tl_const:cn { c_@@_name_ #1 _tl } { #2 } \tl_const:cn { c_@@_name_ #1 _en_tl } { #3 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_define_fmt:nn} % 用来定义默认样式的辅助函数。 % \begin{macrocode} \cs_new_protected:Npn \@@_define_fmt:nn #1#2 { \tl_const:cn { c_@@_fmt_ #1 _tl } { #2 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_define_dim:nn,\@@_define_skip:nn} % 用来定义默认间距的辅助函数。 % \begin{macrocode} \cs_new_protected:Npn \@@_define_dim:nn #1#2 { \dim_const:cn { c_@@_ #1 _dim } { #2 } } \cs_new_protected:Npn \@@_define_skip:nn #1#2 { \skip_const:cn { c_@@_ #1 _skip } { #2 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_add_theorem_type:nnn} % 添加已知的定理环境类型。 % \begin{macrocode} \cs_new_protected:Npn \@@_add_theorem_type:nnn #1#2#3 { \clist_gput_right:Nn \g_@@_theorem_type_clist { #1 } \@@_define_name:nnn { #1 } { #2 } { #3 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_name:n,\@@_info:n} % 根据变量名调用名称和内容信息。 % \begin{macrocode} \cs_new:Npn \@@_name:n #1 { \tl_use:c { c_@@_name_ #1 _tl } } \cs_new:Npn \@@_info:n #1 { \tl_use:c { g_@@_info_ #1 _tl } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_ulined_center_box:nn} % 带有下划线的水平盒子。 % \begin{arguments} % \item 宽度,|dim| 型变量 % \item 内容,可带有格式 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_ulined_center_box:nn #1#2 { \mode_leave_vertical: \rule [ -0.55 ex ] { #1 } { 0.4 pt } \skip_horizontal:n { -#1 } \hbox_to_wd:nn { #1 } { \hfil #2 \hfil } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_spread_box:nnn,\@@_spread_box:nnV,\@@_spread_box:nnx} % \changes{v0.19}{2022/05/16}{对超出盒子宽度的文字进行水平压缩。} % 分散对齐的水平盒子,拉伸算法来自 \cls{fduthesis}。 % 在文字宽度小于给定宽度时,在字符中间填补 \tn{hfil} 以增大字距。 % 在文字宽度超出限制时,进行整体水平压缩。 % \begin{arguments} % \item 宽度,|dim| 型变量 % \item 格式 % \item 内容,不可带有格式 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_spread_box:nnn #1#2#3 { \mode_leave_vertical: \@@_get_text_width:Nn \l_@@_tmpa_dim { #2 #3 } \hbox_to_wd:nn { #1 } { \dim_compare:nTF { \l_@@_tmpa_dim > #1 } { \hfil \scalebox { \dim_to_decimal_in_unit:nn { #1 } { \l_@@_tmpa_dim } } [ 1.0 ] { #2 #3 } \hfil } { \hbox_to_wd:nn { #1 } { #2 \tl_map_inline:nn { #3 } { ##1 \hfil } \unskip } } } } \cs_generate_variant:Nn \@@_spread_box:nnn { nnV } \cs_generate_variant:Nn \@@_spread_box:nnn { nnx } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_multiline_box:NNnn} % 多行固定长度的下划线内容,用于国家图书馆封面。 % \begin{arguments} % \item 用于循环的 |int| 型变量 % \item 内容,|clist| 型变量 % \item 行数 % \item 宽度,|dim| 型变量 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_multiline_box:NNnn #1#2#3#4 { \int_set:Nn #1 { 1 } \int_do_until:nn { #1 > #3 } { \@@_ulined_center_box:nn { #4 } { \clist_item:Nn #2 { #1 } } \\ \int_incr:N #1 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_uline:n} % 指定宽度的下划线。 % \begin{arguments} % \item 宽度,|dim| 型变量 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_uline:n #1 { \mode_leave_vertical: \rule [ -0.55 ex ] { #1 } { 0.4 pt } \skip_horizontal:n { -#1 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_uuline:n} % 指定宽度的双层下划线。 % \begin{arguments} % \item 宽度,|dim| 型变量 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_uuline:n #1 { \mode_leave_vertical: \rule [ -0.5 ex ] { #1 } { 0.4 pt } \skip_horizontal:n { -#1 } \rule [ -0.6 ex ] { #1 } { 0.4 pt } \skip_horizontal:n { -#1 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_get_text_width:Nn,\@@_get_text_width:NV} % 获取文本宽度。 % \begin{arguments} % \item 存储宽度的 |dim| 型变量 % \item 文本 % \end{arguments} % 将内容放入 \tn{hbox} 后读取其宽度,存入 |dim| 型变量。 % \begin{macrocode} \cs_new:Npn \@@_get_text_width:Nn #1#2 { \hbox_set:Nn \l_@@_tmp_box {#2} \dim_set:Nn #1 { \box_wd:N \l_@@_tmp_box } } \cs_generate_variant:Nn \@@_get_text_width:Nn { NV } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_full_uline:Nn,\@@_full_uline:NV} % 横跨整页的下划线。 % \begin{arguments} % \item 宽度,|dim| 型变量 % \item 文本 % \end{arguments} % 先使用 \cs{@@_get_text_width:Nn} 获取文本内容宽度,该宽度存储在调用的 |dim| 型变量中。随后输出文本内容。 % \begin{macrocode} \cs_new_protected:Npn \@@_full_uline:Nn #1#2 { \@@_get_text_width:Nn #1 { #2 } \dim_set:Nn #1 { \textwidth - #1 } #2 } \cs_generate_variant:Nn \@@_full_uline:Nn { NV } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_uline_entry:Nnnn} % 生成占整页宽度的下划线条目。 % \begin{arguments} % \item 宽度,|dim| 型变量 % \item 文本 % \item 文本 % \item 分隔符 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_uline_entry:Nnnn #1#2#3#4 { \@@_full_uline:NV #1 { \@@_name:n { #2 } #4 } \@@_ulined_center_box:nn { #1 } { \@@_info:n { #3 } } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_uline_bientry:Nnnn} % 生成占半页宽度的下划线条目。 % \begin{arguments} % \item 宽度,|dim| 型变量 % \item 文本 % \item 文本 % \item 分隔符 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_uline_bientry:Nnnn #1#2#3#4 { \@@_full_uline:NV #1 { \@@_name:n { #2 } #4 } \dim_sub:Nn #1 { \textwidth / 2 } \@@_ulined_center_box:nn { #1 } { \@@_info:n { #3 } } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_date:www,\@@_date_en:www} % 将形如 |yyyy-mm-dd| 的 ISO 日期格式字符串转化为日期表示。该格式符合国际标准 ISO 8601 以及国内标准 GB/T 7408--2005《数据元和交换格式 信息交换 日期和时间表示法》。 % \begin{arguments} % \item 年份 % \item 月份 % \item 日期 % \end{arguments} % 中文日期表示通过封装 \pkg{zhnumber} 的内部函数实现;英文日期表示通过用于研究生英文封面。其中,变量类型 |w| 表明参数符合特定语法格式。 % \begin{macrocode} \cs_new:Npn \@@_date:www #1-#2-#3 \q_stop { \__zhnum_date_aux:nnn { #1 } { #2 } { #3 } } \cs_new:Npn \@@_date_en:www #1-#2-#3 \q_stop { \clist_item:Nn \c_@@_month_en_clist { #2 } ~#3 , ~#1 } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_date:n,\@@_date_en:n} % 封装 ISO 日期格式字符串的转化命令,该字符串需要进行展开。 % \begin{macrocode} \cs_new_protected:Npn \@@_date:n #1 { \tl_new:c { g_@@_info_ #1 date_tl } \tl_set:cn { g_@@_info_ #1 date_tl } { \exp_last_unbraced:Nv \@@_date:www { g_@@_info_ #1 date_raw_tl } \q_stop } } \cs_new_protected:Npn \@@_date_en:n #1 { \tl_new:c { g_@@_info_ #1 date_en_tl } \tl_set:cn { g_@@_info_ #1 date_en_tl } { \exp_last_unbraced:Nv \@@_date:www { g_@@_info_ #1 date_raw_tl } \q_stop } } % \end{macrocode} % \end{macro} % % \subsubsection{封面相关} % \changes{v0.16}{2022/03/10}{将封面和摘要内部函数定义移动到前部。} % % 定义关于标题的报错信息。 % \begin{macrocode} \msg_new:nnn { njuthesis } { missing-title } { The~ title~ should~ not~ be~ left~ blank.\\ Please~ check~ whether~ you~ have~ fill~ in~ both~ Chinese~ and~ English~ titles. } % \end{macrocode} % % \begin{macro}{\@@_uline_title:} % \changes{v0.17}{2022/04/09}{优化封面标题的断行方式。} % 多行带下划线标题。使用 \hologo{TeX} 原生断行算法实现。 % \begin{macrocode} \cs_new_protected:Npn \@@_uline_title: { \setbox0 = \vbox{ \leftskip=0.5em plus 1 fill \rightskip=\leftskip \parskip=1cm \parindent=\z@ \g_@@_info_title_tl \par \global\setbox2=\hbox{} \loop \setbox1=\lastbox \unskip\unpenalty \unless\ifvoid1 \global\setbox2=\hbox{\@@_uline_box:\penalty0\unhbox2} \repeat } { \noindent \unhbox2 \par } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_cover_entry_title:nnn} % 生成普通封面页的标题条目,包括标签和标题本身。 % \begin{arguments} % \item 内容格式 % \item 名称盒子宽度,|dim| 型变量 % \item 内容盒子宽度,|dim| 型变量 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_cover_entry_title:nnn #1#2#3 { \tl_if_empty:NT \g_@@_info_title_tl { \msg_error:nn { njuthesis } { missing-title } } \@@_spread_box:nnV { #2 } { \kaishu } \c_@@_name_title_tl \mode_leave_vertical: \@@_hskip: % \end{macrocode} % 这里需要存储 \tn{baselineskip} 的值,以使 \tn{parbox} 后行距正确。 % \footnote{\url{https://tex.stackexchange.com/q/34971/}} % \begin{macrocode} \parbox [ t ] { #3 } { \dim_set_eq:NN \baselineskip \c_@@_coverlineskip_dim #1 \@@_uline_title: \dim_gset_eq:NN \l_@@_tmpa_dim \prevdepth } \par \prevdepth \l_@@_tmpa_dim } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_cover_entry:nnn} % 生成单项信息条目。 % \begin{arguments} % \item 条目名称 % \item 名称盒子宽度,|dim| 型变量 % \item 内容盒子宽度,|dim| 型变量 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_cover_entry:nnn #1#2#3 { \@@_spread_box:nnx { #2 } { \kaishu } { \@@_name:n { #1 } } \@@_hskip: \@@_ulined_center_box:nn { #3 } { \@@_info:n { #1 } } \par } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_cover_bientry:nnnn} % 生成两项信息条目,仅用于本科生封面。 % \begin{arguments} % \item 左侧条目名称 % \item 右侧条目名称 % \item 名称盒子宽度,|dim| 型变量 % \item 内容盒子宽度,|dim| 型变量 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_cover_bientry:nnnn #1#2#3#4 { \@@_spread_box:nnx { #3 } { \kaishu } { \@@_name:n { #1 } } \@@_hskip: \@@_ulined_center_box:nn { #4 } { \@@_info:n { #1 } } \@@_hskip: \@@_spread_box:nnx { #3 } { \kaishu } { \@@_name:n { #2 } } \@@_hskip: \@@_ulined_center_box:nn { #4 } { \@@_info:n { #2 } } \par } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_cover_entry_supv:nnn} % 生成两项导师信息条目,仅用于本科生封面。 % \begin{arguments} % \item 条目名称 % \item 长内容盒子宽度,|dim| 型变量 % \item 短内容盒子宽度,|dim| 型变量 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_cover_entry_supv:nnn #1#2#3 { \@@_spread_box:nnx { #2 } { \kaishu } { \@@_name:n { #1 } } \@@_hskip: \@@_ulined_center_box:nn { #3 } { \clist_item:cn { g_@@_info_ #1 _clist } { 1 } } \@@_hskip: \@@_spread_box:nnV { #2 } { \kaishu } \c_@@_name_supv_ttl_tl \@@_hskip: \@@_ulined_center_box:nn { #3 } { \clist_item:cn { g_@@_info_ #1 _clist } { 2 } } \par } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_emblem:N,\@@_name:N} % 封装图片绘制命令,参数为图片宽度。 % 此时 \cs{njuemblem}、\cs{njuname} 和相关长度都是没有定义的。 % \begin{macrocode} \cs_new_protected:Npn \@@_emblem:N #1 { \njuemblem [ black ] { #1 } { ! } } \cs_new_protected:Npn \@@_name:N #1 { \njuname [ black ] { #1 } { ! } } % \end{macrocode} % \end{macro} % % \subsubsection{摘要相关} % % \begin{macro}{\@@_abs_bookmark:nn,\@@_abs_bookmark:Vn} % \changes{v0.14}{2021/12/21}{将摘要插入目录。} % 生成摘要的目录条目。 % \begin{macrocode} \cs_new_protected:Npn \@@_abs_bookmark:nn #1#2 { \phantomsection \bool_if:NTF \g_@@_abs_in_toc_bool { \@@_add_tocline:n { #1 } } { \pdfbookmark [0] { #1 } { #2 } } \@@_chapter_header:n { #1 } } \cs_generate_variant:Nn \@@_abs_bookmark:nn { Vn } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_abs_title:n,\@@_abs_title:V} % 摘要标题双层下划线格式。 % \begin{arguments} % \item 宽度,|dim| 型变量 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_abs_title:n #1 { \@@_get_text_width:Nn \l_@@_tmpa_dim {#1} \@@_uuline:n { \l_@@_tmpa_dim } #1 } \cs_generate_variant:Nn \@@_abs_title:n { V } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_uline_box:} % 用于摘要标题的下划线盒子。 % \begin{macrocode} \cs_new_protected:Npn \@@_uline_box: { \vtop{\box1\kern-\prevdepth\kern0.5ex\hrule} } % \end{macrocode} % \end{macro} % % 定义关于标题的报错信息。 % \begin{macrocode} \msg_new:nnn { njuthesis } { abs-title-too-long } { Your~ title~ is~ too~ long~ to~ fit~ in~ two~ lines.\\ I~ have~ drawn~ additional~ lines~ to~ contain~ it,~ which~ will~ probably~ make~ your~ abstract~ page~ look~ slightly~ different~ from~ the~ standard.\\ You~ can~ use~ the~ "style/abstract-title"~ key~ to~ disable~ this~ message. } % \end{macrocode} % % \begin{macro}{\@@_uline_list:nnn,\@@_uline_list:xnn} % \changes{v0.16}{2022/03/25}{使用原生断行算法处理摘要页标题。} % 用于研究生摘要页面的多行标题。 % \begin{arguments} % \item 标签名 % \item 内容 % \item 左边距 % \end{arguments} % 这里使用了 Primitive \TeX{} 语法以利用原生的断行算法 % \footnote{\url{https://tex.stackexchange.com/q/637861/}}。 % 对其语法的简要介绍可以参考 % \href{http://petr.olsak.net/ftp/olsak/optex/tex-nutshell.pdf}{\file{tex-nutshell.pdf}}。 % \begin{macrocode} \cs_new_protected:Npn \@@_uline_list:nnn #1#2#3 { \hbox_set:Nn \l_@@_tmp_box {#1} \setbox0 = \vbox{\hangindent=\wd\l_@@_tmp_box \hangafter=-1 \leftskip=#3 \rightskip=\leftskip \parindent=\z@ #2\par \global\setbox2=\hbox{} \int_gzero:N \l_@@_tmp_int \loop \setbox1=\lastbox \unskip\unpenalty \unless\ifvoid1 \global\setbox2=\hbox{\@@_uline_box:\penalty0\unhbox2} \int_gincr:N \l_@@_tmp_int \repeat } { \noindent\copy\l_@@_tmp_box\unhbox2 % \end{macrocode} % 在使用自然断行算法后,研究生的摘要标题可选择 \opt{strict} % 或者 \opt{natural} 模式。前者会为少于两行的标题补齐下划线, % 并对多于三行的标题生成警告信息。这里通过行数处理边界条件, % 包括标题未填写、标题只有一行,以及标题过长的情况。 % \begin{macrocode} \bool_if:NT \g_@@_strict_abs_title_bool { \int_case:nnF { \l_@@_tmp_int } { { 0 } { \msg_error:nn { njuthesis } { missing-title } } { 1 } { \@@_uline:n { \textwidth } } { 2 } { \prg_do_nothing: } } { \msg_warning:nn { njuthesis } { abs-title-too-long } } \par } } } \cs_generate_variant:Nn \@@_uline_list:nnn { xnn } % \end{macrocode} % \end{macro} % % % \subsection{页面对象} % \changes{v0.15}{2022/01/24}{使用 \pkg{xtemplate} 重构封面。} % % 本模板使用 \pkg{xtemplate} 提供的面向对象方法简化封面和摘要的绘制过程。 % % 以下分别从页面元素(element)和页面整体(page)的层次进行了抽象。 % 当我们把页面部件考虑为一个对象时,它天然地只具备有限数量的属性: % 内容、格式、边距、对齐方式等。而具体的页面是这些对象的实例的集合, % 附加边距、行距等属性,创建页面只需传入一个列表调用各个 Instance % 即可。通过 \pkg{xtemplate} 提供的功能,我们可以根据这些属性创建模板 % (template),进而能大量构建具有\emph{相似行为}的实例(instance)。 % 这种做法能充分分离内容和样式,极大优化代码的可读性。 % % 声明对象类型。此类对象不需要参数。 % \begin{macrocode} \DeclareObjectType { nju } { \c_zero_int } % \end{macrocode} % % 定义元素模板。 % \begin{macrocode} %<@@=njuelem> % \end{macrocode} % % 声明页面元素模板接口。 % 元素是一个页面的基本组成单位,包括文段、图片等等。 % 一个抽象的元素应当具备以下属性: % \begin{description} % \item[\opt{content}] 内容,即剥离样式的元素本身 % \item[\opt{format}] 格式,例如字号、字体 % \item[\opt{bottom-skip}] 下间距,即与下一个元素的距离 % \item[\opt{align}] 对齐方式,包括左对齐、右对齐、居中、正常段落 % \end{description} % \begin{macrocode} \DeclareTemplateInterface { nju } { element } { \c_zero_int } { content : tokenlist = \c_empty_tl, format : tokenlist = \c_empty_tl, bottom-skip : skip = \c_zero_skip, align : choice { l, r, c, n } = c } % \end{macrocode} % % 声明页面元素模板代码。涉及的变量将被自动创建。 % \begin{macrocode} \DeclareTemplateCode { nju } { element } { \c_zero_int } { content = \l_@@_content_tl, format = \l_@@_format_tl, bottom-skip = \l_@@_bottom_skip, align = { l = { \tl_set_eq:NN \l_@@_begin_align_tl \flushleft \tl_set_eq:NN \l_@@_end_align_tl \endflushleft }, r = { \tl_set_eq:NN \l_@@_begin_align_tl \flushright \tl_set_eq:NN \l_@@_end_align_tl \endflushright }, c = { \tl_set_eq:NN \l_@@_begin_align_tl \center \tl_set_eq:NN \l_@@_end_align_tl \endcenter }, n = { \tl_clear:N \l_@@_begin_align_tl \tl_clear:N \l_@@_end_align_tl } } } { \AssignTemplateKeys \group_begin: \l_@@_begin_align_tl \l_@@_format_tl \l_@@_content_tl \par \l_@@_end_align_tl \group_end: \__nju_vskip:N \l_@@_bottom_skip } % \end{macrocode} % % 定义页面模板。 % \begin{macrocode} %<@@=njupage> % \end{macrocode} % % 声明页面模板接口。 % 页面是元素的集合。一个抽象的页面应当具备以下属性: % \begin{description} % \item[\opt{element}] 包含的元素,这里使用的是名称列表 % \item[\opt{prefix}] 元素名称前缀 % \item[\opt{format}] 格式,例如行距 % \item[\opt{top-skip}] 上间距,即与页面顶部的距离 % \item[\opt{bottom-skip}] 下间距,即与页面底部的距离 % \end{description} % \begin{macrocode} \DeclareTemplateInterface { nju } { page } { \c_zero_int } { element : commalist = \c_empty_clist, prefix : tokenlist = \c_empty_tl, format : tokenlist = \c_empty_tl, top-skip : skip = \c_zero_skip, bottom-skip : skip = \c_zero_skip } % \end{macrocode} % % 声明页面模板代码。 % \begin{macrocode} \DeclareTemplateCode { nju } { page } { \c_zero_int } { element = \l_@@_element_clist, prefix = \l_@@_prefix_tl, format = \l_@@_format_tl, top-skip = \l_@@_top_skip, bottom-skip = \l_@@_bottom_skip } { \AssignTemplateKeys \clearpage \thispagestyle { empty } \__nju_vskip:N \l_@@_top_skip \group_begin: \l_@@_format_tl \clist_map_inline:Nn \l_@@_element_clist { \UseInstance { nju } { \l_@@_prefix_tl ##1 } } \group_end: \__nju_vskip:N \l_@@_bottom_skip } %<@@=nju> % \end{macrocode} % % \begin{macro}{\@@_declare_element:nn,\@@_declare_page:nn} % 封装 \pkg{xtemplate} 提供的函数,简化创建实例的过程。 % \begin{arguments} % \item 实例名称 % \item 参数列表 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_declare_element:nn #1#2 { \DeclareInstance { nju } {#1} { element } {#2} } \cs_new_protected:Npn \@@_declare_page:nn #1#2 { \DeclareInstance { nju } {#1} { page } {#2} } % \end{macrocode} % \end{macro} % % % \subsection{模板选项} % \changes{v0.11}{2021/11/15}{进行了效率优化。} % % \begin{macrocode} \keys_define:nn { nju } { % \end{macrocode} % % \begin{macro}{degree} % 学位类型,默认为本科。 % \begin{macrocode} degree .choices:nn = { ug, mg, mf, phd } { \int_gset_eq:NN \g_@@_info_degree_int \l_keys_choice_int }, degree .initial:n = ug, % \end{macrocode} % \end{macro} % % \begin{macro}{type} % 论文类型,默认为毕业论文。 % \begin{macrocode} type .choices:nn = { thesis, design } { \int_gset_eq:NN \g_@@_info_type_int \l_keys_choice_int }, type .initial:n = thesis, % \end{macrocode} % \end{macro} % % \begin{macro}{nlcover} % 是否需要国家图书馆封面(仅对研究生有效,默认关闭)。 % \footnote{nl 代表 National Library。} % \begin{macrocode} nlcover .bool_set:N = \g_@@_nlcover_bool, nlcover .initial:n = false, % \end{macrocode} % \end{macro} % % \begin{macro}{decl-page} % \changes{v0.13}{2021/12/15}{新增诚信承诺书选项。} % \changes{v0.14}{2022/01/06}{修改选项名称。} % 是否需要诚信承诺书或原创性声明(默认关闭)。 % \footnote{原创性声明的英文翻译为 Declaration of Originality, % 为了使选项表义更清晰同时缩减名称长度,将其修改为“声明页”这一名称。} % \begin{macrocode} decl-page .bool_set:N = \g_@@_decl_bool, decl-page .initial:n = false, % \end{macrocode} % \end{macro} % % \begin{macro}{draft} % \changes{v0.13}{2021/12/15}{新增草稿模式选项。} % 是否开启草稿模式(默认关闭)。 % \begin{macrocode} draft .bool_gset:N = \g_@@_draft_bool, draft .initial:n = false, % \end{macrocode} % \end{macro} % % \begin{macro}{oneside,twoside} % \changes{v0.14}{2022/01/14}{新增单双面模式选项。} % 单双面模式(默认为双面)。 % \begin{macrocode} oneside .value_forbidden:n = true, twoside .value_forbidden:n = true, oneside .bool_gset_inverse:N = \g_@@_twoside_bool, % \end{macrocode} % \end{macro} % % \begin{macro}{blind} % \changes{v0.18}{2022/04/19}{新增盲审模式选项。} % 盲审模式。 % \begin{macrocode} blind .value_forbidden:n = true, blind .bool_set:N = \g_@@_blind_bool, % \end{macrocode} % \end{macro} % % \begin{macro}{latin-font,cjk-font} % \changes{v0.14}{2021/12/12}{简化字体选项名称。} % 字体选项。 % \begin{macrocode} latin-font .choices:nn = { gyre, mac, win, none } { \tl_set_eq:NN \g_@@_latin_font_tl \l_keys_choice_tl }, cjk-font .choices:nn = { fandol, founder, mac, noto, source, win, none } { \tl_set_eq:NN \g_@@_cjk_font_tl \l_keys_choice_tl }, % \end{macrocode} % \end{macro} % % \begin{macro}{config} % \changes{v0.16}{2022/02/23}{新增 \opt{config} 选项。} % 配置文件路径。 % \begin{macrocode} config .tl_set:N = \g_@@_config_clist } % \end{macrocode} % \end{macro} % % 在定义完全部设置以后从导言区输入参数。 % \begin{macrocode} \ProcessKeysOptions { nju } % \end{macrocode} % % % \subsection{用户接口} % % \begin{macro}{bib,info,style,theorem} % 定义元(meta)键值对。为 v1.0 升级预留了新的接口。 % \begin{macrocode} \keys_define:nn { nju } { % abstract .meta:nn = { nju / abstract } { #1 }, bib .meta:nn = { nju / bib } { #1 }, % cover .meta:nn = { nju / cover } { #1 }, % font .meta:nn = { nju / font } { #1 }, % footer .meta:nn = { nju / footer } { #1 }, % footnote .meta:nn = { nju / footnote } { #1 }, % header .meta:nn = { nju / header } { #1 }, info .meta:nn = { nju / info } { #1 }, style .meta:nn = { nju / style } { #1 }, theorem .meta:nn = { nju / theorem } { #1 } % toc .meta:nn = { nju / toc } { #1 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\njusetup} % \changes{v0.6}{2021/09/10}{改用键值对输入信息。} % 定义用于设置信息的命令。 % \begin{macrocode} \NewDocumentCommand \njusetup { m } { \keys_set:nn { nju } { #1 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\njusetformat} % \changes{v0.17}{2022/04/09}{提供修改默认样式的接口。} % 定义修改固定文本的接口。 % \begin{macrocode} \NewDocumentCommand \njusetformat { m m } { \tl_gset:cn { c_@@_fmt_ #1 _tl } { #2 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\njusetlength,\njusetlength*} % \changes{v0.17}{2022/04/09}{提供修改长度值的接口。} % 定义修改长度值的接口。可选星号表示修改弹性长度。 % \begin{macrocode} \NewDocumentCommand \njusetlength { s m m } { \bool_if:nTF { #1 } { \skip_gset:cn { c_@@_ #2 _skip } { #3 } } { \dim_gset:cn { c_@@_ #2 _dim } { #3 } } } % \end{macrocode} % \end{macro} % % \begin{macro}{\njusetname,\njusetname*,\njusettext,\njusettext*} % \changes{v0.17}{2022/04/01}{提供修改固定文本的接口。} % 定义修改固定文本的接口。 % \begin{macrocode} \NewDocumentCommand \njusetname { s m o m } { \@@_set_tokenlist:nnnnn {#1} {#2} {#3} {#4} { name } } \NewDocumentCommand \njusettext { s m o m } { \@@_set_tokenlist:nnnnn {#1} {#2} {#3} {#4} { text } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_set_tokenlist:nnnnn} % 用于修改名称、文字常量的辅助函数。 % \begin{arguments} % \item 是否含有可选星号,传入 |bool| 型变量 % \item 被修改变量名称 % \item 可选的变体,用字母标记 % \item 修改后的内容 % \item 类别,name 或者 text % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_set_tokenlist:nnnnn #1#2#3#4#5 { \tl_if_novalue:nTF { #3 } { \tl_clear:N \l_@@_tmpa_tl } { \tl_set:Nn \l_@@_tmpa_tl { _ #3 } } \bool_if:nTF { #1 } { \tl_set:Nn \l_@@_tmpb_tl { _en } } { \tl_clear:N \l_@@_tmpb_tl } \tl_gset:cn { c_@@_ #5 _ #2 \l_@@_tmpa_tl \l_@@_tmpb_tl _tl } {#4} } % \end{macrocode} % \end{macro} % % % \subsection{载入宏包} % % \changes{v0.12}{2021/12/07}{重新组织宏包载入顺序。} % 将选项传入 \cls{ctexbook} 文档类。 % \begin{macrocode} \PassOptionsToClass { a4paper, UTF8, scheme = chinese, % \end{macrocode} % 传入单双面模式选项。 % \begin{macrocode} \bool_if:NTF \g_@@_twoside_bool { twoside, } { oneside, } % \end{macrocode} % 开启草稿模式后传入 |draft| 选项。 % \begin{macrocode} \bool_if:NT \g_@@_draft_bool { draft, } % \end{macrocode} % 关于行距,\hologo{LaTeX} 默认1.2行距,MS 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, % \end{macrocode} % 正文字体设置为小四号。 % \begin{macrocode} zihao = -4 } { ctexbook } % \end{macrocode} % % 传入各宏包选项。 % \begin{macrocode} \clist_map_inline:nn { { no-math } { fontspec }, { perpage } { footmisc }, { hyphens } { url }, { warnings-off={ mathtools-colon, mathtools-overbracket } } { unicode-math }, { capitalise, nameinlink, noabbrev } { cleveref } } { \PassOptionsToPackage #1 } % \end{macrocode} % % 使用\pkg{ctexbook}作为基础文档类。 % \begin{macrocode} \LoadClass { ctexbook } [ 2018/04/01 ] % \end{macrocode} % % \changes{v0.14}{2021/12/21}{移除内置的 \pkg{hologo}。} % \changes{v0.15}{2022/01/17}{移除内置的 \pkg{url}。} % 载入各种宏包。 % \begin{macrocode} \RequirePackage { geometry, fancyhdr, footmisc, setspace, % \end{macrocode} % \changes{v0.13}{2021/12/13}{使用 \pkg{ntheorem} 创建定理环境,删除 % \pkg{amsthm} 和 \pkg{thmtools}。} % \changes{v0.16}{2022/03/19}{不显式载入 \pkg{amsmath}。} % \changes{v0.18}{2022/04/20}{不强制载入 \pkg{ntheorem}。} % 数学相关的宏包。其中,\pkg{amsmath} 会被 \pkg{unicode-math} 自动载入。 % \pkg{unicode-math} 指定了 \hologo{XeTeX} 和 \hologo{LuaTeX} 下所使用的 % 数学字体。用于配置数学环境的 \pkg{mathtools} 会与 \pkg{unicode-math} % 发生冲突,需要手动消除其警告。 % \begin{macrocode} mathtools, unicode-math, % \end{macrocode} % \changes{v0.14}{2021/12/21}{移除内置的 \pkg{multirow}、\pkg{subcaption} % 和 \pkg{wrapfig}。} % 图片与表格。 % \begin{macrocode} booktabs, caption, graphicx, % \end{macrocode} % 列表环境。 % \begin{macrocode} enumitem, % \end{macrocode} % 按以下顺序加载两个关于引用的包。 % \pkg{hyperref} 覆写了大量命令,因此需要在其他包最后载入。 % 仅有 \pkg{cleveref} 需要在 \pkg{hyperref} 后载入,否则会报错。 % \begin{macrocode} hyperref, cleveref } % \end{macrocode} % % 在双面模式下,使用 \pkg{emptypage} 清除空白页的页眉、页脚和页码。 % \begin{macrocode} \bool_if:NT \g_@@_twoside_bool { \RequirePackage{ emptypage } } % \end{macrocode} % % \changes{v0.13}{2021/12/13}{删除会与 \pkg{ntheorem} 冲突的 \pkg{microtype}。} % \begin{macro}{\njuline} % 针对编译引擎,使用不同的宏包构建可以对中文正常换行的下划线命令。 % \begin{macrocode} \sys_if_engine_xetex:T { \RequirePackage{xeCJKfntef} \NewDocumentCommand \njuline { m } { \CJKunderline{#1} } } % \end{macrocode} % \pkg{lua-ul} 中需要在结尾使用 \tn{null} 保护尾部空白。 % \begin{macrocode} \sys_if_engine_luatex:T { \RequirePackage{lua-ul} \NewDocumentCommand \njuline { m } { \underLine{#1} \null } } % \end{macrocode} % \end{macro} % % 使用 \pkg{tabularray} 绘制研究生的出版授权书。 % \begin{macrocode} \bool_lazy_and:nnT { \g_@@_decl_bool } { !\int_compare_p:n { \g_@@_info_degree_int == 1 } } { \RequirePackage { tabularray } } % \end{macrocode} % % \begin{macro}{\@@_check_pkg_version:nnn} % 检查宏包版本是否过时。 % \begin{macrocode} \msg_new:nnn { njuthesis } { package-too-old } { Package~ "#1"~ is~ too~ old.\\ The~ njuthesis~ class~ only~ supports~ "#1"~ with~ a~ version higher~ than~ v#2.\\ Please~ update~ an~ up-to-date~ version~ of~ it~ using~ your TeX~ package~ manager~ or~ from~ CTAN. } \cs_new_protected:Npn \@@_check_pkg_version:nnn #1#2#3 { \@ifpackagelater {#1} {#2} { } { \msg_error:nnnn { njuthesis } { package-too-old } {#1} {#3} } } % \end{macrocode} % \end{macro} % % 检查绘制下划线所需的 \pkg{luatexja} 包版本。该宏包在 2021-09-18 的更新 % 解决了下划线中断问题,然而在 2021-10-24 的更新才提供了正确的内嵌日期。 % \begin{macrocode} \sys_if_engine_luatex:T { \@@_check_pkg_version:nnn { luatexja } { 2021/10/24 } { 20211024.0 } } % \end{macrocode} % % \changes{v0.18}{2022/04/28}{增加宏包冲突检查。} % \begin{macrocode} \RequirePackage { filehook } % \end{macrocode} % % \begin{macro}{\@@_check_pkg_conflict:nn} % 检查用户载入的宏包是否会与预置宏包发生冲突。 % \begin{arguments} % \item 模板载入的宏包 % \item 产生冲突的宏包 % \item 替代的解决办法 % \end{arguments} % \begin{macrocode} \msg_new:nnn { njuthesis } { package-conflict } { The~ "#2"~ package~ is~ incompatible~ with~ "#1".\\ I~ have~ loaded~ "#1"~ by~ default.~ Maybe~ You~ should~ refer~ to~ section~ 4~ of~ the~ "njuthesis"~ manual. } \cs_new_protected:Npn \@@_check_pkg_conflict:nn #1#2 { \AtEndOfPackageFile * { #1 } { \AtBeginOfPackageFile * { #2 } { \msg_error:nnnn { njuthesis } { package-conflict } {#1} {#2} } } } % \end{macrocode} % \end{macro} % % 检查数学宏包冲突。 % \begin{macrocode} \clist_map_inline:nn { amscd, amsfonts, amssymb, bbm, bm, eucal, eufrak, mathrsfs, newtxmath, upgreek } { \@@_check_pkg_conflict:nn { unicode-math } { #1 } } % \end{macrocode} % % \subsection{配置文件} % % \cls{njuthesis} 包含\emph{本科生}和\emph{研究生}两套区别较大的模板配置。 % 出于定义的简洁起见,本模板将其拆分为两个单独的参数配置文件, % 编译过程中将会根据设置的学位信息,载入相应默认配置。 % 注意,尽管在手册的实现细节部分封面、摘要、常量等位于靠后部分, % 拆分后实际上是在此处载入运行的,务必要注意逻辑顺序。 % % 下文中,本科生模板配置对应 \agrd{definition-ug},用于生成 % \file{njuthesis-undergraduate.def};研究生模板配置对应 % \agrd{definition-g},用于生成 \file{njuthesis-graduate.def}。 % \begin{macrocode} \int_compare:nTF { \g_@@_info_degree_int == 1 } { \file_input:n { njuthesis-undergraduate.def } } { \file_input:n { njuthesis- graduate.def } } % \end{macrocode} % % 载入用户设置,可用于对模板做额外修改。 % \begin{macrocode} \msg_new:nnn { njuthesis } { load-config } { I~ am~ loading~ config~ file~ "#1". } \clist_map_inline:Nn \g_@@_config_clist { \msg_info:nnn { njuthesis } { load-config } { #1 } \file_input:n { #1 } } % \end{macrocode} % % % \subsection{个人信息} % \changes{v0.11}{2021/10/01}{将个人信息变量名改为小写字母加连字符的形式。} % \changes{v0.15}{2022/01/22}{将个人信息设置移到载入宏包后。} % % \begin{macrocode} \keys_define:nn { nju / info } { % \end{macrocode} % % \begin{macro}{info/title,info/title*} % \changes{v0.13}{2021/12/12}{简化多行标题的输入方式。} % \changes{v0.14}{2022/01/14}{将标题断行控制符修改为 |\\|。} % 题目。中文题目可使用 |\\| 手动断行。以下标注星号(|*|)的皆为对应的英文字段。 % \begin{macrocode} title .tl_set:N = \g_@@_info_title_tl, title .initial:n = { 空 }, title* .tl_set:N = \g_@@_info_title_en_tl, title* .initial:n = { Empty }, % \end{macrocode} % \end{macro} % % \begin{macro}{info/keywords,info/keywords*} % \changes{v0.11}{2021/10/01}{修改了添加关键词的方式。} % 关键词列表。 % \begin{macrocode} keywords .clist_set:N = \g_@@_info_keywords_clist, keywords* .clist_set:N = \g_@@_info_keywords_en_clist, % \end{macrocode} % \end{macro} % % \begin{macro}{info/grade,info/student-id,info/author,info/author*} % 年级、学号、姓名。 % \begin{macrocode} grade .tl_set:N = \g_@@_info_grade_tl, student-id .tl_set:N = \g_@@_info_id_tl, author .tl_set:N = \g_@@_info_author_tl, author* .tl_set:N = \g_@@_info_author_en_tl, % \end{macrocode} % \end{macro} % % \begin{macro}{info/department,info/department*,info/major,info/major*,info/field,info/field*} % 院系、专业、方向。 % \begin{macrocode} department .tl_set:N = \g_@@_info_dept_tl, department* .tl_set:N = \g_@@_info_dept_en_tl, major .tl_set:N = \g_@@_info_major_tl, major* .tl_set:N = \g_@@_info_major_en_tl, field .tl_set:N = \g_@@_info_field_tl, field* .tl_set:N = \g_@@_info_field_en_tl, % \end{macrocode} % \end{macro} % % \begin{macro}{info/supervisor,info/supervisor*} % \changes{v0.13}{2021/12/11}{修改了导师选项的变量名称。} % \changes{v0.14}{2022/01/12}{精简导师信息选项。} % 导师信息。中文导师全称使用 |clist| 存储,便于在本科生封面中进行分割。 % \begin{macrocode} supervisor .clist_set:N = \g_@@_info_supv_clist, supervisor* .tl_set:N = \g_@@_info_supv_en_tl, % \end{macrocode} % \end{macro} % % \begin{macro}{info/supervisor-ii,info/supervisor-ii*} % 第二导师信息。 % \begin{macrocode} supervisor-ii .clist_set:N = \g_@@_info_supv_ii_clist, supervisor-ii* .tl_set:N = \g_@@_info_supv_ii_en_tl, % \end{macrocode} % \end{macro} % % \begin{macro}{info/submit-date} % \changes{v0.14}{2022/01/14}{精简提交日期选项。} % 提交日期,初始值为编译当天日期。 % \begin{macrocode} submit-date .tl_set:N = \g_@@_info_submitdate_raw_tl, submit-date .initial:V = \c_@@_today_tl, % \end{macrocode} % \end{macro} % % \begin{macro}{info/defend-date} % \changes{v0.14}{2022/01/14}{精简答辩日期选项。} % 答辩日期。 % \begin{macrocode} defend-date .tl_set:N = \g_@@_info_defenddate_raw_tl, defend-date .initial:V = \c_@@_today_tl, % \end{macrocode} % \end{macro} % % \begin{macro}{info/defend-date} % \changes{v0.19}{2022/05/23}{新增国家图书馆封面的学位授予日期设置项。} % 学位授予日期。 % \begin{macrocode} confer-date .tl_set:N = \g_@@_info_conferdate_raw_tl, confer-date .initial:V = \c_@@_today_tl, % \end{macrocode} % \end{macro} % % \begin{macro}{info/bottom-date} % \changes{v0.19}{2022/05/23}{新增国家图书馆封面的底部日期设置项。} % 底部日期。 % \begin{macrocode} bottom-date .tl_set:N = \g_@@_info_bottomdate_raw_tl, bottom-date .initial:V = \c_@@_today_tl, % \end{macrocode} % \end{macro} % % \begin{macro}{info/defend-date,info/chairman,info/reviewer} % 答辩委员会信息。 % \begin{macrocode} chairman .tl_set:N = \g_@@_info_chairman_tl, reviewer .clist_set:N = \g_@@_info_reviewer_clist, % \end{macrocode} % \end{macro} % % \begin{macro}{info/clc,info/secret-level,info/udc,info/supervisor-contact} % 国家图书馆封面相关信息。 % \begin{macrocode} clc .tl_set:N = \g_@@_info_clc_tl, secret-level .tl_set:N = \g_@@_info_secretlv_tl, udc .tl_set:N = \g_@@_info_udc_tl, supervisor-contact .tl_set:N = \g_@@_info_supvcont_tl, % \end{macrocode} % \end{macro} % % \begin{macro}{info/email} % \changes{v0.14}{2022/01/12}{新增电邮地址信息项。} % 用于学位论文出版授权书的电子邮件地址。 % \begin{macrocode} email .tl_set:N = \g_@@_info_email_tl } % \end{macrocode} % \end{macro} % % \changes{v0.16}{2022/03/06}{正确处理学位和类型信息。} % 设置学位信息。该设置需要放在 \cs{ProcessKeysOptions} % 命令以及载入配置文件中的常量信息后进行。 % \begin{macrocode} \tl_set:Nx \g_@@_info_degree_tl { \clist_item:Nn \c_@@_name_degree_clist { \g_@@_info_degree_int } } \int_compare:nTF { \g_@@_info_degree_int == 1 } { \tl_set:Nn \g_@@_info_diploma_tl { ug } } { \tl_set:Nn \g_@@_info_diploma_tl { g } } % \end{macrocode} % % 设置类型信息。 % \begin{macrocode} \tl_set:Nx \g_@@_info_type_tl { \clist_item:Nn \c_@@_name_type_clist { \g_@@_info_type_int } } \tl_set:Nx \g_@@_info_type_en_tl { \clist_item:Nn \c_@@_name_type_en_clist { \g_@@_info_type_int } } \tl_put_left:Nx \g_@@_info_type_tl { \tl_use:c { c_@@_name_ \g_@@_info_diploma_tl _tl } } % \end{macrocode} % % 盲审模式下抹去个人信息和学校名称。 % \begin{macrocode} \bool_if:NT \g_@@_blind_bool { \ctex_at_end_preamble:n { \clist_map_inline:Nn \c_@@_blind_info_clist { \tl_gclear:c { g_@@_info_ #1 _tl } } \clist_map_inline:Nn \c_@@_blind_info_en_clist { \tl_gclear:c { g_@@_info_ #1 _en_tl } } \clist_map_inline:Nn \c_@@_blind_infolist_clist { \clist_gclear:c { g_@@_info_ #1 _clist } } \tl_gclear:N \c_@@_name_nju_tl \tl_gclear:N \c_@@_name_nju_en_tl } } % \end{macrocode} % % \changes{v0.15}{2022/01/22}{正确处理双导师信息。} % 在导言区录入用户信息后进行变量设置。此处使用到了 \pkg{ctex} 提供的命令, % 应当位于载入文档类之后。 % \begin{macrocode} \ctex_at_end_preamble:n { % \end{macrocode} % 拼合双导师的姓名和职称。 % \begin{macrocode} \bool_set:Nn \l_@@_second_supv_bool { ! \clist_if_empty_p:N \g_@@_info_supv_ii_clist } \tl_set:Nx \g_@@_info_supvfull_tl { \clist_use:Nn \g_@@_info_supv_clist { \@@_hskip: } \bool_if:NT \l_@@_second_supv_bool { \@@_quad: \clist_use:Nn \g_@@_info_supv_ii_clist { \@@_hskip: } } } \tl_set:Nx \g_@@_info_supvfull_en_tl { \g_@@_info_supv_en_tl \bool_if:NT \l_@@_second_supv_bool { \@@_quad: \g_@@_info_supv_ii_en_tl } } % \end{macrocode} % \begin{variable}{\g_@@_info_submitdate_tl} % 将 ISO 格式的原始日期字符串格式化为中文日期表示。 % \begin{macrocode} \@@_date:n { submit } % \end{macrocode} % \end{variable} % % \begin{variable}{\g_@@_info_submitdate_en_tl,\g_@@_info_defenddate_tl} % 英文提交日期以及答辩日期仅用于研究生封面。 % \begin{macrocode} \int_compare:nF { \g_@@_info_degree_int == 1 } { \@@_date_en:n { submit } \@@_date:n { defend } % \end{macrocode} % \end{variable} % % \begin{variable}{\g_@@_info_bottomdate_tl, % \g_@@_info_conferdate_tl,\g_@@_info_confer_tl} % 底部日期以及学位授予日期仅用于国家图书馆封面。 % \begin{macrocode} \bool_if:NT \g_@@_nlcover_bool { \@@_date:n { bottom } \@@_date:n { confer } \tl_new:N \g_@@_info_confer_tl \tl_set:Nn \g_@@_info_confer_tl { \textbf { \c_@@_name_nju_tl } \hfil \g_@@_info_conferdate_tl } } } } % \end{macrocode} % \end{variable} % % % \subsection{字体设置} % % \pkg{fontspec} 包含于 \pkg{ctex} 宏集,无需另行载入。 % % \subsubsection{操作系统检测} % % 判断用户是否自定义了中英文字体。如果其中任意一种未被定义, % 则使用系统预装字体覆盖字体选项。 % \begin{macrocode} \bool_lazy_or:nnT { \tl_if_empty_p:N \g_@@_latin_font_tl } { \tl_if_empty_p:N \g_@@_cjk_font_tl } % \end{macrocode} % 进行操作系统检测。 % 检测 Windows 的命令由 \pkg{l3kernel} 提供, % 检测 macOS 的命令由 \pkg{ctex} 提供, % 这两种情况外的系统被判断为 Linux,一律使用自由字体。 % \begin{macrocode} { \sys_if_platform_windows:TF { \tl_set:Nn \g_@@_latin_font_tl { win } \tl_set:Nn \g_@@_cjk_font_tl { win } } { \ctex_if_platform_macos:TF { \tl_set:Nn \g_@@_latin_font_tl { mac } \tl_set:Nn \g_@@_cjk_font_tl { mac } } { \tl_set:Nn \g_@@_latin_font_tl { gyre } \tl_set:Nn \g_@@_cjk_font_tl { fandol } } } } % \end{macrocode} % % % \subsubsection{定义英文字库} % % 接下来逐个定义所需要使用的字库。 % % \begin{macro}{\@@_load_latin_font_win:} % Windows 西文字体 % \begin{macrocode} \cs_new_protected:Npn \@@_load_latin_font_win: { \setmainfont { Times~New~Roman } \setsansfont { Arial } \setmonofont { Courier~New } [ Scale = MatchLowercase ] } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_load_latin_font_mac:} % macOS 西文字体。 % \begin{macrocode} \cs_new_protected:Npn \@@_load_latin_font_mac: { \setmainfont { Times~New~Roman } \setsansfont { Arial } \setmonofont { Menlo } [ Scale = MatchLowercase ] } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_load_latin_font_gyre:} % 开源的 gyre 西文字体。 % \begin{macrocode} \cs_new_protected:Npn \@@_load_latin_font_gyre: { \setmainfont { texgyretermes } [ Extension = .otf, UprightFont = *-regular, BoldFont = *-bold, ItalicFont = *-italic, BoldItalicFont = *-bolditalic ] \setsansfont { texgyreheros } [ Extension = .otf, UprightFont = *-regular, BoldFont = *-bold, ItalicFont = *-italic, BoldItalicFont = *-bolditalic ] \setmonofont { texgyrecursor } [ Extension = .otf, UprightFont = *-regular, BoldFont = *-bold, ItalicFont = *-italic, BoldItalicFont = *-bolditalic, Scale = MatchLowercase, Ligatures = CommonOff ] } % \end{macrocode} % \end{macro} % % % \subsubsection{定义中文字库} % % \begin{macro}{\@@_hide_no_script_msg:} % 隐藏 |does not contain script "CJK"| 警告。 % \begin{macrocode} \cs_new_protected:Npn \@@_hide_no_script_msg: { \msg_redirect_name:nnn { fontspec } { no-script } { info } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_load_cjk_font_win:} % Windows 中文字体。 % \begin{macrocode} \cs_new_protected:Npn \@@_load_cjk_font_win: { \setCJKmainfont { SimSun } [ AutoFakeBold = 2.17, ItalicFont = KaiTi ] \setCJKsansfont { SimHei } [ AutoFakeBold = 2.17 ] \setCJKmonofont { FangSong } [ AutoFakeBold = 2.17 ] \setCJKfamilyfont { zhsong } { SimSun } [ AutoFakeBold = 2.17 ] \setCJKfamilyfont { zhhei } { SimHei } [ AutoFakeBold = 2.17 ] \setCJKfamilyfont { zhfs } { FangSong } [ AutoFakeBold = 2.17 ] \setCJKfamilyfont { zhkai } { KaiTi } [ AutoFakeBold = 2.17 ] } % \end{macrocode} % \end{macro} % % % \begin{macro}{\@@_load_cjk_font_mac:} % macOS 字体。 % TODO: 修复 macOS 字体支持,实现开箱即用。 % \begin{macrocode} \cs_new_protected:Npn \@@_load_cjk_font_mac: { \@@_hide_no_script_msg: \setCJKmainfont{Songti~SC~Light}[ BoldFont=Songti~SC~Bold, ItalicFont=Kaiti~SC, BoldItalicFont=Kaiti~SC~Bold] \setCJKsansfont{Heiti~SC~Light}[BoldFont=Heiti~SC~Medium] \setCJKmonofont{STFangsong} \setCJKfamilyfont{zhsong}{Songti~SC~Light}[BoldFont=Songti~SC~Bold] \setCJKfamilyfont{zhhei}{Heiti~SC~Light}[BoldFont=Heiti~SC~Medium] \setCJKfamilyfont{zhfs}{STFangsong} \setCJKfamilyfont{zhkai}{Kaiti~SC}[BoldFont=Kaiti~SC~Bold] \setCJKfamilyfont{zhnewhei}{PingFang~SC} } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_load_cjk_font_fandol:} % Fandol 字体 % \begin{macrocode} \cs_new_protected:Npn \@@_load_cjk_font_fandol: { \@@_hide_no_script_msg: \setCJKmainfont { FandolSong-Regular } [ Extension = .otf, BoldFont = FandolSong-Bold, ItalicFont = FandolKai-Regular ] \setCJKsansfont { FandolHei-Regular } [ Extension = .otf, BoldFont = FandolHei-Bold ] \setCJKmonofont { FandolFang-Regular } [ Extension = .otf ] \setCJKfamilyfont { zhsong } { FandolSong-Regular } [ Extension = .otf, BoldFont = FandolSong-Bold ] \setCJKfamilyfont { zhhei } { FandolHei-Regular } [ Extension = .otf, BoldFont = FandolHei-Bold ] \setCJKfamilyfont { zhfs } { FandolFang-Regular } [ Extension = .otf ] \setCJKfamilyfont { zhkai } { FandolKai-Regular } [ Extension = .otf, AutoFakeBold = 2.17 ] } % \end{macrocode} % \end{macro} % % % \begin{macro}{\@@_load_cjk_font_founder:} % 方正字库(简繁扩展) % \begin{macrocode} \cs_new_protected:Npn \@@_load_cjk_font_founder: { % \end{macrocode} % 调整方正字体括号位置。\footnote{\hologo{XeTeX} 的调整方法来自 \url{https://www.zhihu.com/question/46241367/answer/101660183}。} % \begin{macrocode} \sys_if_engine_xetex:T { \xeCJKEditPunctStyle {quanjiao} { optimize-kerning = true } } \sys_if_engine_luatex:T { \defaultCJKfontfeatures { JFM = { zh_CN/{quanjiao,fzpr} } } } \setCJKmainfont { FZShuSong-Z01 } [ BoldFont = FZXiaoBiaoSong-B05, ItalicFont = FZKai-Z03 ] \setCJKsansfont { FZXiHeiI-Z08 } [ BoldFont = FZHei-B01 ] \setCJKmonofont { FZFangSong-Z02 } \setCJKfamilyfont { zhsong } { FZShuSong-Z01 } [ BoldFont = FZXiaoBiaoSong-B05 ] \setCJKfamilyfont { zhhei } { FZHei-B01 } [ AutoFakeBold = 2.17 ] \setCJKfamilyfont { zhkai } { FZKai-Z03 } [ AutoFakeBold = 2.17 ] \setCJKfamilyfont { zhfs } { FZFangSong-Z02 } \defaultCJKfontfeatures{} } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_load_cjk_font_noto:} % Noto 思源字体。 % \begin{macrocode} \cs_new_protected:Npn \@@_load_cjk_font_noto: { \setCJKmainfont [ UprightFont = NotoSerifCJKsc-Regular, BoldFont = NotoSerifCJKsc-Bold, ItalicFont = NotoSerifCJKsc-Regular, BoldItalicFont = NotoSerifCJKsc-Bold, ItalicFeatures = FakeSlant, BoldItalicFeatures = FakeSlant ] { Noto~Serif~CJK~SC } \setCJKsansfont [ UprightFont = NotoSansCJKsc-Regular, BoldFont = NotoSansCJKsc-Bold, ItalicFont = NotoSansCJKsc-Regular, BoldItalicFont = NotoSansCJKsc-Bold, ItalicFeatures = FakeSlant, BoldItalicFeatures = FakeSlant ] { Noto~Sans~CJK~SC } \setCJKmonofont { Noto~Sans~Mono~CJK~SC } \setCJKfamilyfont { zhsong } { Noto~Serif~CJK~SC } \setCJKfamilyfont { zhhei } { Noto~Sans~CJK~SC } \setCJKfamilyfont { zhfs } { FZFangSong-Z02 } \setCJKfamilyfont { zhkai } { FZKai-Z03 } [AutoFakeBold=2.17] } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_load_cjk_font_source:} % \changes{v0.14}{2021/12/20}{增加 Adobe Source Han 作为思源字体。} % Source Han 思源字体。 % \begin{macrocode} \cs_new_protected:Npn \@@_load_cjk_font_source: { \setCJKmainfont [ UprightFont = SourceHanSerifSC-Regular, BoldFont = SourceHanSerifSC-Bold, ItalicFont = SourceHanSerifSC-Regular, BoldItalicFont = SourceHanSerifSC-Bold, ItalicFeatures = FakeSlant, BoldItalicFeatures = FakeSlant ] { Source~Han~Serif~SC } \setCJKsansfont [ UprightFont = SourceHanSansSC-Regular, BoldFont = SourceHanSansSC-Bold, ItalicFont = SourceHanSansSC-Regular, BoldItalicFont = SourceHanSansSC-Bold, ItalicFeatures = FakeSlant, BoldItalicFeatures = FakeSlant ] { Source~Han~Sans~SC } \setCJKmonofont { FZFangSong-Z02 } \setCJKfamilyfont { zhsong } { Source~Han~Serif~SC } \setCJKfamilyfont { zhhei } { Source~Han~Sans~SC } \setCJKfamilyfont { zhfs } { FZFangSong-Z02 } \setCJKfamilyfont { zhkai } { FZKai-Z03 } [AutoFakeBold=2.17] } % \end{macrocode} % \end{macro} % % % \subsubsection{定义数学字库} % % \begin{macro}{\@@_load_math_font:} % 设置数学字体 (XITS, 或者 \href{https://www.stixfonts.org}{STIX}, 与 Times New Roman 最为相近) % 通用数学字体。 % \begin{macrocode} \cs_new_protected:Npn \@@_load_math_font: { % \setmathfont{STIXTwoMath-Regular}[Extension = .otf] \setmathfont{XITSMath-Regular}[ BoldFont = XITSMath-Bold, Extension = .otf] \setmathfont{NewCMMath-Regular.otf}[range={cal,bb,frak}] \setmathfont{NewCMMath-Regular.otf}[version=bold,range={bfcal}] } % \end{macrocode} % \end{macro} % % % \subsubsection{载入指定字库} % % 载入字体命令。 % \begin{macrocode} \cs_new_protected:Npn \@@_load_font: { \use:c { @@_load_latin_font_ \g_@@_latin_font_tl : } \use:c { @@_load_cjk_font_ \g_@@_cjk_font_tl : } % \end{macrocode} % \changes{v0.10}{2021/09/28}{修正了数学字体。} % \begin{macrocode} \@@_load_math_font: % \end{macrocode} % 自行定义 \pkg{ctex} 中的四类字体命令。 % \begin{macrocode} \NewDocumentCommand \songti { } { \CJKfamily { zhsong } } \NewDocumentCommand \heiti { } { \CJKfamily { zhhei } } \NewDocumentCommand \fangsong { } { \CJKfamily { zhfs } } \NewDocumentCommand \kaishu { } { \CJKfamily { zhkai } } % \end{macrocode} % 重定义字号命令。 % \begin{macrocode} \RenewDocumentCommand \large { } { \zihao { 4 } } } % \end{macrocode} % % 载入设置的字体。此处设置与文档类一同载入,否则在导言区后载入字体可能导致一部分覆盖字体的命令失效。 % \begin{macrocode} % \BeforeBeginEnvironment { document } { \@@_load_font: } \@@_load_font: % \end{macrocode} % % % \subsection{页面布局} % % \subsubsection{页边距} % % 使用\pkg{geometry}设置页边距。 % \begin{macrocode} \geometry { vmargin = 2.5 cm, hmargin = 3.2 cm, headheight = 15 pt } % \end{macrocode} % % 草稿模式下显示页面文字范围边界以及页眉、页脚线。 % \begin{macrocode} \bool_if:NT \g_@@_draft_bool { \geometry { showframe } } % \end{macrocode} % % % \subsubsection{页眉页脚} % ^^A TODO: 将页眉页脚样式改为使用 \njusetformat 修改 % 提供设置页眉页脚的用户接口。在 \cs{fancyhead} 的可选参数中, % \opt{E} 和 \opt{O} 分别表示在偶数页(even)和奇数页(odd), % 而 \opt{L}、\opt{R} 和 \opt{C} 则分别表示左(left)、右 % (right)和中间(center)。按照通常的排版规则,在双面模式下, % 偶数页的中间页眉文字在左,奇数页则在右。单面模式下,左右页眉都要显示。 % \begin{macrocode} \keys_define:nn { nju / style } { % \end{macrocode} % \begin{macro}{style/header/format} % \changes{v0.16}{2022/03/18}{可手动指定页眉样式。} % 页眉格式。 % \begin{macrocode} header/format .tl_gset:N = \g_@@_header_format_tl, header/format .initial:n = \small \kaishu, % \end{macrocode} % \end{macro} % % \begin{macro}{style/header,style/header*} % \changes{v0.16}{2022/03/18}{可手动指定页眉内容。} % 页眉内容,分别对应双面模式和单面模式。 % 为了便于指定复杂的页眉样式,这里用 |clist| 存储位置和内容信息。 % \begin{macrocode} header .clist_gset:N = \g_@@_header_twoside_clist, header* .clist_gset:N = \g_@@_header_oneside_clist, header .initial:n = { { EL } { \leftmark }, { OR } { \rightmark } }, header* .initial:n = { { L } { \leftmark }, { R } { \rightmark } }, % \end{macrocode} % \end{macro} % % \begin{macro}{style/footer/format} % \changes{v0.16}{2022/03/19}{可手动指定页脚样式。} % 页脚格式。 % \begin{macrocode} footer/format .tl_gset:N = \g_@@_footer_format_tl, footer/format .initial:n = \small \rmfamily, % \end{macrocode} % \end{macro} % % % \begin{macro}{style/footer,style/footer*} % \changes{v0.16}{2022/03/18}{可手动指定页脚内容。} % 页脚内容,同页眉。 % \begin{macrocode} footer .clist_gset:N = \g_@@_footer_twoside_clist, footer* .clist_gset:N = \g_@@_footer_oneside_clist, footer .initial:n = { { C } { \thepage } }, footer* .initial:n = { { C } { \thepage } } } % \end{macrocode} % \end{macro} % % \begin{macro}{\g_@@_header_clist,\g_@@_footer_clist} % 设置页眉页脚。 % \begin{macrocode} \clist_new:N \g_@@_header_clist \clist_new:N \g_@@_footer_clist % \end{macrocode} % \end{macro} % % 在导言区末尾确定页眉页脚内容。 % \begin{macrocode} \ctex_at_end_preamble:n { \bool_if:NTF \g_@@_twoside_bool { \clist_set_eq:NN \g_@@_header_clist \g_@@_header_twoside_clist \clist_set_eq:NN \g_@@_footer_clist \g_@@_footer_twoside_clist } { \clist_set_eq:NN \g_@@_header_clist \g_@@_header_oneside_clist \clist_set_eq:NN \g_@@_footer_clist \g_@@_footer_oneside_clist } } % \end{macrocode} % % \begin{macro}{\@@_header:nn,\@@_footer:nn} % 对 \pkg{fancyhdr} 的命令进行包装,便于设置页眉页脚。 % \begin{macrocode} \cs_new_protected:Npn \@@_header:nn #1#2 { \fancyhead [#1] { \g_@@_header_format_tl \nouppercase {#2} } } \cs_new_protected:Npn \@@_footer:nn #1#2 { \fancyfoot [#1] { \g_@@_footer_format_tl \nouppercase {#2} } } % \end{macrocode} % \end{macro} % % 重定义 \pkg{fancyhdr} 的 \opt{plain} 样式,即本科生正文和部分特殊页面使用的的 % 页眉页脚样式。页眉无内容;页脚为居中的页码,使用五号新罗马体数字。注意标记页眉 % 页脚横线宽度的变量并不是 |dim| 类型的,但是采取了该类型的格式。 % \begin{macrocode} \fancypagestyle { plain } { \fancyhf { } \clist_map_inline:Nn \g_@@_footer_clist { \@@_footer:nn ##1 } \tl_set:Nn \headrulewidth { \c_zero_dim } \tl_set:Nn \footrulewidth { \c_zero_dim } } % \end{macrocode} % % \changes{v0.15}{2022/01/17}{修复单页模式的页眉问题。} % 以 \opt{plain} 样式为基础的 \opt{headings} 样式,用于研究生模板。 % \begin{macrocode} \fancypagestyle { headings } { \fancyhf { } \clist_if_empty:NTF \g_@@_header_clist { \tl_set:Nn \headrulewidth { \c_zero_dim } } { \tl_set:Nn \headrulewidth { 0.4 pt } \dim_set:Nn \headheight { 20 pt } \clist_map_inline:Nn \g_@@_header_clist { \@@_header:nn ##1 } } \clist_map_inline:Nn \g_@@_footer_clist { \@@_footer:nn ##1 } \tl_set:Nn \footrulewidth { \c_zero_dim } } % \end{macrocode} % % \begin{macro}{\frontmatter} % 重定义 \cs{frontmatter},设置前言区默认的页眉页脚以及页码样式。 % \begin{macrocode} \RenewDocumentCommand \frontmatter { } { \cleardoublepage \exp_args:NV \pagestyle \c_@@_fmt_pagestyle_tl \pagenumbering { Roman } } % \end{macrocode} % \end{macro} % % \begin{macro}{\mainmatter} % \changes{v0.12}{2021/12/03}{修复了摘要页字体格式泄漏到正文的问题。} % \changes{v0.12}{2021/12/03}{修复了页眉上长标题重叠的问题。} % 重定义 \cs{mainmatter},在论文主体部分载入页面样式设置, % 使用阿拉伯数字重新进行页码编号。 % \begin{macrocode} \RenewDocumentCommand \mainmatter { } { \cleardoublepage \exp_args:NV \pagestyle \c_@@_fmt_pagestyle_tl \pagenumbering { arabic } \normalfont \normalsize } % \end{macrocode} % \end{macro} % % \changes{v0.16}{2022/03/18}{研究生模板的目录、摘要等页面也显示页眉。} % 在文档起始位置设置默认页面样式。 % \begin{macrocode} \AtBeginEnvironment { document } { \exp_args:NV \pagestyle \c_@@_fmt_pagestyle_tl \pagenumbering { Roman } } % \end{macrocode} % % % \subsection{章节标题格式} % % \begin{macro}{\@@_add_tocline:n,\@@_add_tocline:V} % 为无编号章添加目录条目,需手动指定格式为四号、不加粗、黑体。 % \begin{macrocode} \cs_new_protected:Npn \@@_add_tocline:n #1 { \addcontentsline { toc } { chapter } { \c_@@_fmt_chapterintoc_tl #1 } } \cs_generate_variant:Nn \@@_add_tocline:n { V } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_chapter:n,\@@_chapter:V} % 含有目录和 PDF 标签的无编号章。 % \begin{macrocode} \cs_new_protected:Npn \@@_chapter:n #1 { \chapter * { #1 } \@@_add_tocline:n { #1 } \@@_chapter_header:n { #1 } } \cs_generate_variant:Nn \@@_chapter:n { V } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_chapter_header:n} % 单页模式下,目录、摘要、符号表等特殊页面的页眉中间为相应标题,左右为空。这里通 % 过居中的 \tn{leftmark} 实现。 % \begin{macrocode} \cs_new_protected:Npn \@@_chapter_header:n #1 { \bool_if:NTF \g_@@_twoside_bool { \markboth { #1 } { #1 } } { \markboth { \hfill #1 \hfill } { } } } % \end{macrocode} % \end{macro} % % \begin{macro}{\njuchapter} % 封装无编号章环境,供用户在正文中使用。 % \begin{macrocode} \NewDocumentCommand \njuchapter { m } { \@@_chapter:n { #1 } } % \end{macrocode} % \end{macro} % % |\keys_set:nn{ctex}| 实际相当于 \cs{ctexset}。 % \begin{macrocode} \keys_set:nn { ctex } { chapter / beforeskip = 10 pt, chapter / afterskip = 60 pt, chapter / format = \c_@@_fmt_chapter_tl, section / format = \c_@@_fmt_section_tl, subsection / format = \c_@@_fmt_subsection_tl, subsubsection / format = \c_@@_fmt_subsubsection_tl, paragraph / format = \c_@@_fmt_paragraph_tl, subparagraph / format = \c_@@_fmt_subparagraph_tl, % \end{macrocode} % % % \subsection{目录格式} % \changes{v0.13}{2021/12/09}{移除 \pkg{tocloft},用 \pkg{ctex} 修改目录样式。} % % 设置目录标题默认名称。 % \begin{macrocode} contentsname = \c_@@_name_tableofcontents_tl, listfigurename = \c_@@_name_listoffigures_tl, listtablename = \c_@@_name_listoftables_tl, % \end{macrocode} % 设置目录中章标题的样式。 % \begin{macrocode} chapter / tocline = \c_@@_fmt_chapterintoc_tl \CTEXnumberline { #1 } #2 } % \end{macrocode} % % \begin{macrocode} \keys_define:nn { nju / style } { % \end{macrocode} % \begin{macro}{style/toc-in-toc} % \changes{v0.15}{2022/02/04}{可选择目录自身是否出现在目录中。} % 是否在目录中显示目录自身。 % \begin{macrocode} toc-in-toc .bool_gset:N = \g_@@_toc_in_toc_bool, toc-in-toc .initial:n = true } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_make_toc:nn,\@@_make_toc:Vn} % 通过 group 内修改标题设置,将目录页标题格式单独设置为三号粗宋体。 % 目录自身不出现在目录中时需特别处理。参考 % \url{https://tex.stackexchange.com/a/1821}。 % \begin{macrocode} \cs_new_protected:Npn \@@_make_toc:nn #1#2 { \group_begin: \keys_set:nn { ctex } { chapter/format = \c_@@_fmt_toctitle_tl } \bool_if:NTF \g_@@_toc_in_toc_bool { \@@_chapter:n { #1 } } { \chapter * { #1 } \pdfbookmark [0] { #1 } { #2 } \@@_chapter_header:n { #1 } } \group_end: \@starttoc { #2 } } \cs_generate_variant:Nn \@@_make_toc:nn { Vn } % \end{macrocode} % \end{macro} % % \begin{macro}{\tableofcontents,\listoffigures,\listoftables} % 重定义目录命令,修改标题格式并插入书签。 % \begin{macrocode} \RenewDocumentCommand \tableofcontents { } { \@@_make_toc:Vn \contentsname { toc } } \RenewDocumentCommand \listoffigures { } { \@@_make_toc:Vn \listfigurename { lof } } \RenewDocumentCommand \listoftables { } { \@@_make_toc:Vn \listtablename { lot } } % \end{macrocode} % \end{macro} % % % \subsection{参考文献} % % \begin{variable}{\g_@@_biblatex_option_clist} % 存储传入 \pkg{biblatex} 的选项列表。 % \begin{macrocode} \clist_new:N \g_@@_biblatex_option_clist % \end{macrocode} % \end{variable} % % \begin{variable}{\g_@@_bib_resource_clist} % 存储参考文献数据源列表。 % \begin{macrocode} \clist_new:N \g_@@_bib_resource_clist % \end{macrocode} % \end{variable} % % \begin{macrocode} \msg_new:nnn { njuthesis } { extra-bib-style } { Wrongly-placed~ bib~ style.\\ Please~ use~ the~ `bib/style`~ field. } % \end{macrocode} % % \begin{macrocode} \keys_define:nn { nju / bib } { % \end{macrocode} % % \begin{macro}{bib/style} % \changes{v0.14}{2021/12/19}{提供选择参考文献样式的接口。} % \changes{v0.15}{2022/02/11}{可使用国标以外的文献样式。} % 参考文献样式。国家标准为顺序编码制 \opt{numeric} 和著者-出版年制 % \opt{author-year},分别对应 \pkg{biblatex} 的 \opt{gb7714-2015} % 和 \opt{gb7714-2015ay} 样式。其余样式一律视作 \opt{unknown}。用户 % 选取的样式会被加入选项列表中,以待传进 \pkg{biblatex} 宏包。 % \begin{macrocode} style .choice:, style / numeric .code:n = { \clist_gput_right:Nn \g_@@_biblatex_option_clist { style = gb7714-2015 } }, style / author-year .code:n = { \clist_gput_right:Nn \g_@@_biblatex_option_clist { style = gb7714-2015ay } }, style / unknown .code:n = { \clist_gput_right:Nx \g_@@_biblatex_option_clist { style = \l_keys_value_tl } }, style .initial:n = numeric, % \end{macrocode} % \end{macro} % % \begin{macro}{bib/option} % \changes{v0.15}{2022/02/15}{提供传入 \pkg{biblatex} 宏包选项的接口。} % 待传入 \pkg{biblatex} 的额外宏包选项,以列表形式储存。 % 更为常见的参考文献样式设置已由 \opt{bib/style} 提供, % 此处对重复的样式设置进行了检查。本设置项等效于在导言区使用 % |\PassoptionToPackage{|\meta{key}|=|\meta{value}|}{biblatex}| 命令。 % \begin{macrocode} option .code:n = { \tl_if_in:VnTF \l_keys_value_tl { style = } { \msg_error:nn { njuthesis } { extra-bib-style } } { \clist_gput_right:NV \g_@@_biblatex_option_clist \l_keys_value_tl } }, % \end{macrocode} % \end{macro} % % \begin{macro}{bib/resource} % \changes{v0.14}{2021/12/19}{提供批量导入参考文献数据源的接口。} % 参考文献数据源,以列表形式储存。 % \begin{macrocode} resource .code:n = { \clist_gput_right:NV \g_@@_bib_resource_clist \l_keys_value_tl }, } % \end{macrocode} % \end{macro} % % \begin{macro}{\addbibresource} % 为了吸收用户在导言区设置的选项,\pkg{biblatex} 宏包被设置在导言区末尾才会载 % 入。此处单独定义了可以在导言区使用的 \cs{addbibresource} 命令,用于兼容传统的 % 添加参考文献数据源的方法。 % \begin{macrocode} \NewDocumentCommand \addbibresource { m } { \clist_gput_right:Nn \g_@@_bib_resource_clist { #1 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_biblatex_pre_setup:} % 载入 \pkg{biblatex} 宏包前,必须禁用自行定义的 \cs{addbibresource} % 命令,并传入用户设置的选项。 % \begin{macrocode} \cs_new_protected:Npn \@@_biblatex_pre_setup: { \cs_undefine:N \addbibresource \clist_gput_right:Nn \g_@@_biblatex_option_clist { backend = biber } \exp_args:NV \PassOptionsToPackage \g_@@_biblatex_option_clist { biblatex } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_biblatex_post_setup:} % \pkg{biblatex} 宏包载入后的设置。 % \begin{macrocode} \cs_new_protected:Npn \@@_biblatex_post_setup: { % \end{macrocode} % \changes{v0.12}{2021/12/06}{设置输出参考文献的默认选项。} % \changes{v0.15}{2022/02/17}{可在每章后附上参考文献表。} % 修改参考文献的头部样式,自动添加目录条目。默认为 |chapter| 级别。 % 如果需要在每章后附上一个参考文献表,即对 \pkg{biblatex} 传入了 % |refsection = chapter| 选项,则默认为 |section| 级别。 % \begin{macrocode} \defbibheading { njubibintoc } [ \bibname ] { \@@_chapter:n { ##1 } } \tl_if_eq:NnTF \blx@refsecreset@level { 2 } { \DeclarePrintbibliographyDefaults { heading = subbibintoc } } { \DeclarePrintbibliographyDefaults { heading = njubibintoc } } % \end{macrocode} % 传入参考文献源文件,此时可正常使用 \cs{addbibresource} 命令。 % \begin{macrocode} \clist_map_inline:Nn \g_@@_bib_resource_clist { \addbibresource { ##1 } } } % \end{macrocode} % \end{macro} % % 使用 \pkg{etoolbox} 提供的 \tn{BeforeBeginEnvironment},在 \env{document} 环境 % 开始的钩子前载入 \pkg{biblatex} 并进行相关设置。 % \begin{macrocode} \BeforeBeginEnvironment { document } { \@@_biblatex_pre_setup: \RequirePackage { biblatex } \@@_biblatex_post_setup: } % \end{macrocode} % % % \subsection{引用} % % 在导言区末尾进行 \pkg{hyperref} 设置。 % \changes{v0.11}{2021/10/01}{写入 PDF 元数据。} % \changes{v0.17}{2022/04/09}{PDF 书签中不生成额外空格。} % \begin{macrocode} \ctex_at_end_preamble:n { % \end{macrocode} % 忽略 PDF 字符串中的换行符,从而抑制 \pkg{hyperref} 警告。 % \begin{macrocode} \pdfstringdefDisableCommands { \cs_set_eq:NN \\ \prg_do_nothing: \cs_set_eq:NN \quad \prg_do_nothing: \cs_set_eq:NN \qquad \prg_do_nothing: } \hypersetup { bookmarksnumbered = true, psdextra = true, unicode = true, hidelinks, % \end{macrocode} % 填写 PDF 元信息。 % \begin{macrocode} pdftitle = \g_@@_info_title_tl, pdfauthor = \g_@@_info_author_tl, pdfkeywords = \g_@@_info_keywords_clist, pdfcreator = \c_@@_name_pdfcreator_tl } } % \end{macrocode} % % \begin{macro}{\@@_cref_name:n,\@@_cref_name:V} % 用于修改 \pkg{cleverref} 的标签名称的辅助函数。 % \begin{macrocode} \cs_new_protected:Npn \@@_cref_name:n #1 { \clist_map_inline:nn { #1 } { \crefname { ##1 } { \@@_name:n { ##1 } } { \@@_name:n { ##1 _en } } } } \cs_generate_variant:Nn \@@_cref_name:n { V } % \end{macrocode} % \end{macro} % % 修改 \pkg{cleverref} 的标签格式。默认在名称后面添加空格,删除公式编号的括号。 % \begin{macrocode} \crefdefaultlabelformat { #2#1#3\, } \crefformat { equation } { 公式~#2#1#3~ } \crefformat { chapter } { 第#2#1#3章 } \crefformat { section } { 第~#2#1#3~节 } \crefformat { subsection } { 第~#2#1#3~小节 } \crefformat { subsubsection } { 第~#2#1#3~小节 } % \end{macrocode} % % 修改 \pkg{cleverref} 的标签名称。 % \begin{macrocode} \@@_cref_name:n { figure, table, appendix, proof } \@@_cref_name:V \g_@@_theorem_type_clist % \end{macrocode} % % % \subsection{脚注} % \changes{v0.18}{2022/05/01}{提供脚注设置项。} % ^^A 来自 fduthesis % \begin{macrocode} \tl_new:N \l_@@_fn_style_tl \keys_define:nn { nju / style } { % \end{macrocode} % \begin{macro}{style/footnote-style} % \begin{macrocode} footnote-style .choices:nn = { plain, pifont } % \end{macrocode} % 若使用 \opt{pifont} 类型,则需引入 \pkg{pifont} 宏包。 % \begin{macrocode} { \tl_gset_eq:NN \l_@@_fn_style_tl \l_keys_choice_tl \int_compare:nT { \l_keys_choice_int = 2 } { \RequirePackage { pifont } } } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_fn_symbol_pifont:n} % \opt{pifont} 普通版。以下四种都只包含 \numrange{1}{10}。 % \begin{macrocode} \cs_new:Npn \@@_fn_symbol_pifont:n #1 { \ding { \int_eval:n { 171 + #1 } } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_footnote_number:N} % 脚注编号样式。 % \begin{macrocode} \tl_const:Nn \c_@@_fn_style_plain_tl { plain } \tl_const:Nn \c_@@_fn_style_pifont_tl { pifont } \cs_new:Npn \@@_footnote_number:N #1 { \tl_case:NnF \l_@@_fn_style_tl { % \end{macrocode} % \opt{plain} 类型直接使用计数器 |footnote| 的值。 % \begin{macrocode} \c_@@_fn_style_plain_tl { \int_use:N #1 } % \end{macrocode} % \opt{pifont} 类型无需进行额外的操作。 % \begin{macrocode} \c_@@_fn_style_pifont_tl { \@@_fn_symbol_pifont:n {#1} } } % \end{macrocode} % 变量 \cs{l_@@_fn_style_tl} 保存的类型未知时,默认使用 \opt{plain} % 类型。 % \begin{macrocode} { \int_use:N #1 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\thefootnote} % 重定义脚注编号。 % \begin{macrocode} \cs_set:Npn \thefootnote { \@@_footnote_number:N \c@footnote } % \end{macrocode} % \end{macro} % % \subsubsection{整体样式} % % \begin{macro}[int]{\@makefntext} % 重定义内部脚注文字命令,使脚注编号不使用上标,宽度为 \qty{1.5}{em}。 % 见 \url{http://tex.stackexchange.com/q/19844} 和 % \url{https://www.zhihu.com/question/53030087}。 % \begin{macrocode} \cs_set:Npn \@makefntext #1 { \mode_leave_vertical: \hbox_to_wd:nn { 1.5 em } { \@thefnmark \hfil } #1 } % \end{macrocode} % \end{macro} % % % \subsection{图片表格} % % 设置默认图片扩展名,允许在不键入扩展名时自动进行补全。 % \begin{macrocode} \DeclareGraphicsExtensions { .pdf, .eps, .jpg, .png } % \end{macrocode} % % \changes{v0.16}{2022/03/11}{表格内字体设为五号。} % 表格默认居中,字号设置为五号。^^A https://www.zhihu.com/question/366803177/answer/977853129 % \begin{macrocode} \BeforeBeginEnvironment { tabular } { \centering \zihao {5} } % \end{macrocode} % % \changes{v0.12}{2021/12/06}{删除了可能导致冲突的 \pkg{floatrow}。} % \changes{v0.18}{2022/05/08}{图表标题使用粗体。} % 图表标题样式。文字设置为五号宋体,标签设置为粗体,间隔一个全角空格。 % \begin{macrocode} \DeclareCaptionStyle{njucap} { font = small, font += bf, labelsep = quad, justification = centering } \captionsetup [ figure ] { style = njucap } \captionsetup [ table ] { style = njucap } % \end{macrocode} % % % \subsection{列表环境} % \changes{v0.12}{2021/12/07}{删除了 \pkg{enumitem} 的部分列表环境设置。} % % 缩减列表环境的条目间距。 % \begin{macrocode} \setlist { noitemsep } % \end{macrocode} % % % \subsection{定理环境} % % \changes{v0.18}{2022/04/21}{新增定理环境的若干定制项。} % % \begin{macro}{theorem/style,theorem/header-font,theorem/body-font, % theorem/qed-symbol,theorem/counter} % 定义 |nju/theorem| 键值类。 % 目前这套选项只适用于模板预定义的若干种定理环境。 % \begin{macrocode} \keys_define:nn { nju / theorem } { predefine .bool_set:N = \g_@@_thm_predefine_bool, style .tl_set:N = \l_@@_thm_style_tl, header-font .tl_set:N = \l_@@_thm_header_font_tl, body-font .tl_set:N = \l_@@_thm_body_font_tl, qed-symbol .tl_set:N = \l_@@_thm_qed_symbol_tl, counter .tl_set:N = \l_@@_thm_counter_tl, % \end{macrocode} % 定理环境的缺省值。 % \begin{macrocode} predefine .initial:n = true, style .initial:n = plain, header-font .initial:n = \normalfont \bfseries, body-font .initial:n = \itshape, qed-symbol .initial:n = \ensuremath { \mdwhtsquare }, counter .initial:n = chapter } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_new_theorem:Nn,\@@_new_theorem:NV} % 用于定义普通定理环境的辅助函数。 % \begin{arguments} % \item 定理名称列表,|clist| 型变量 % \item 编号范围 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_new_theorem:Nn #1#2 { \clist_map_inline:Nn #1 { \newtheorem { ##1 } { \@@_name:n { ##1 } } [#2] } } \cs_generate_variant:Nn \@@_new_theorem:Nn { NV } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_ntheorem_post_setup:} % 载入 \pkg{ntheorem} 后的相应设置。 % \begin{macrocode} \cs_new_protected:Npn \@@_ntheorem_post_setup: { \exp_args:NV \theoremstyle \l_@@_thm_style_tl \exp_args:NV \theoremheaderfont \l_@@_thm_header_font_tl \exp_args:NV \theorembodyfont \l_@@_thm_body_font_tl \exp_args:NV \theoremsymbol \l_@@_thm_qed_symbol_tl % \end{macrocode} % 定义证明环境。证毕符号使用 \tn{mdlgwhtsquare} 绘制,对应于 |U+25A1| 字符 % \footnote{\url{https://tex.stackexchange.com/q/567135/}}。 % \begin{macrocode} \newtheorem* { proof } { \c_@@_name_proof_tl } % \end{macrocode} % 定义普通定理环境。清除预设的证毕符号,并排除 \env{proof}。 % \begin{macrocode} \theoremsymbol { } \group_begin: \clist_remove_all:Nn \g_@@_theorem_type_clist { proof } \@@_new_theorem:NV \g_@@_theorem_type_clist \l_@@_thm_counter_tl \group_end: } % \end{macrocode} % \end{macro} % % 在导言区末尾,通过吸收的用户设置,选择是否载入并设置 \pkg{ntheorem}。 % \begin{macrocode} \ctex_at_end_preamble:n { \bool_if:NT \g_@@_thm_predefine_bool { \PassOptionsToPackage { amsmath, thmmarks } { ntheorem } \RequirePackage { ntheorem } \@@_ntheorem_post_setup: } } % % \end{macrocode} % % % \subsection{封面} % % % \subsubsection{绘制部件} % % \changes{v0.16}{2022/03/01}{将封面部件分离到 \file{.def} 文件。} % % \paragraph{本科生} % % \begin{macro}{cover/ug/emblem-img} % 本科生封面校徽图片实例。 % \begin{macrocode} %<*definition-ug> \@@_declare_element:nn { cover / ug / emblem-img } { content = \@@_emblem:N \c_@@_emblemwidth_dim, bottom-skip = 1 cm, align = l } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/ug/name-img} % 本科生封面校名图片实例。 % \begin{macrocode} \@@_declare_element:nn { cover / ug / name-img } { content = \@@_name:N \c_@@_namewidth_dim, bottom-skip = 1 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/ug/title} % 本科生封面标题实例。 % \begin{macrocode} \@@_declare_element:nn { cover / ug / title } { content = \@@_spread_box:nnV { 9 em } { \bf } \g_@@_info_type_tl, format = \zihao { -1 }, bottom-skip = 0 pt plus 1.5 fill } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/ug/info} % 本科生封面信息栏实例。 % \begin{macrocode} \@@_declare_element:nn { cover / ug / info } { content = \@@_cover_info_ug:NN \c_@@_coverlabel_dim \c_@@_coveruline_dim, format = \zihao { 3 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_cover_info_ug:NN} % 本科生封面信息栏。 % \begin{arguments} % \item 名称盒子宽度,|dim| 型变量 % \item 长内容盒子宽度,|dim| 型变量 % \end{arguments} % 短内容盒子的长度值是通过计算得到的。 % \begin{macrocode} \cs_new_protected:Npn \@@_cover_info_ug:NN #1#2 { \begin{minipage} { #1 + #2 + \c_@@_smallhskip_dim } \dim_set_eq:NN \baselineskip \c_@@_coverlineskip_dim \dim_set:Nn \l_@@_tmpb_dim { .5 #2 - .5 #1 - \c_@@_smallhskip_dim } \@@_cover_entry:nnn { dept } { #1 } { #2 } \@@_cover_entry:nnn { major } { #1 } { #2 } \@@_cover_entry_title:nnn { \bf } { #1 } { #2 } \@@_cover_bientry:nnnn { grade } { id } { #1 } { \l_@@_tmpb_dim } \@@_cover_entry:nnn { author } { #1 } { #2 } \@@_cover_entry_supv:nnn { supv } { #1 } { \l_@@_tmpb_dim } \bool_if:NT \l_@@_second_supv_bool { \@@_cover_entry_supv:nnn { supv_ii } { #1 } { \l_@@_tmpb_dim } } \@@_cover_entry:nnn { submitdate } { #1 } { #2 } \end{minipage} } % % \end{macrocode} % \end{macro} % % \paragraph{研究生} % % \subparagraph{正面} 包括校名、校徽、标题、信息栏。 % % \begin{macro}{cover/g/emblem-img} % 研究生封面校徽图片实例。 % \begin{macrocode} %<*definition-g> \@@_declare_element:nn { cover / g / emblem-img } { content = \@@_emblem:N \c_@@_emblemwidthi_dim, bottom-skip = 1.5 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/g/name-img} % 研究生封面校名图片实例。 % \begin{macrocode} \@@_declare_element:nn { cover / g / name-img } { content = \@@_name:N \c_@@_namewidth_dim, bottom-skip = 2 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/g/type} % 研究生封面标题实例。 % \begin{macrocode} \@@_declare_element:nn { cover / g / type } { content = \@@_spread_box:nnV { 9 em } { } \g_@@_info_type_tl, format = \zihao { -1 } \bfseries, bottom-skip = 1 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/g/degree} % 研究生封面标题实例。 % \begin{macrocode} \@@_declare_element:nn { cover / g / degree } { content = \c_@@_name_apply_tl, format = \zihao { -1 } \bfseries, bottom-skip = 1 cm plus 1.5 fil } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/g/info} % 研究封面信息栏实例。 % \begin{macrocode} \@@_declare_element:nn { cover / g / info } { content = \@@_cover_info_g:NN \c_@@_coverlabel_dim \c_@@_coveruline_dim, bottom-skip = 0 pt plus 1.5 fil } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/g/date} % 研究封面日期实例。 % \begin{macrocode} \@@_declare_element:nn { cover / g / date } { content = \g_@@_info_submitdate_tl } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_cover_info_g:NN} % 研究生封面信息栏。 % \begin{arguments} % \item 名称盒子宽度,|dim| 型变量 % \item 内容盒子宽度,|dim| 型变量 % \end{arguments} % \begin{macrocode} \cs_new_protected:Npn \@@_cover_info_g:NN #1#2 { \begin{minipage} { #1 + #2 + \c_@@_smallhskip_dim } \dim_set_eq:NN \baselineskip \c_@@_coverlineskip_dim \@@_cover_entry_title:nnn { } { #1 } { #2 } \clist_map_inline:nn { author, major, field, supvfull } { \@@_cover_entry:nnn { ##1 } { #1 } { #2 } } \end{minipage} } % \end{macrocode} % \end{macro} % % \subparagraph{背面} % % \begin{macro}{cover/g/back} % 研究生封面背面信息实例。 % \begin{macrocode} \@@_declare_element:nn { cover / g / back } { content = \@@_cover_back_g:, align = l } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_cover_back_g:} % 研究生封面背面信息。格式存在变化,没有使用循环来简化。 % \begin{macrocode} \cs_new_protected:Npn \@@_cover_back_g: { \@@_spread_box:nnV { 6.2 em } { \kaishu } \c_@@_name_id_tl { : \@@_quad: } \g_@@_info_id_tl \@@_vskip: \@@_spread_box:nnV { 6.2 em } { \kaishu } \c_@@_name_defenddate_tl { : \@@_quad: } \g_@@_info_defenddate_tl \@@_vskip: \@@_spread_box:nnV { 6.2 em } { \kaishu } \c_@@_name_supvfull_tl { : \@@_quad: } \skip_horizontal:n { 8 em } \c_@@_name_sign_tl } % \end{macrocode} % \end{macro} % % \subparagraph{英文封面} 包括标题、顶部、中部、校徽、底部。 % % \begin{macro}{cover/g/en/title} % 研究生英文封面标题实例。 % \begin{macrocode} \@@_declare_element:nn { cover / g / en / title } { content = \g_@@_info_title_en_tl, format = \bf \sffamily \zihao { 2 }, bottom-skip = 2 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/g/en/top} % 研究生英文封面顶部信息实例。 % \begin{macrocode} \@@_declare_element:nn { cover / g / en / top } { content = { by } \skip_vertical:N \c_zero_skip \textbf { \sffamily \g_@@_info_author_en_tl } \skip_vertical:n { .5 cm } { Supervised~ by } \skip_vertical:N \c_zero_skip \textsf { \g_@@_info_supvfull_en_tl }, format = \zihao { 4 }, bottom-skip = 0 pt plus 1.2 fil } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/g/en/middle} % 研究生英文封面中部信息实例。 % \begin{macrocode} \@@_declare_element:nn { cover / g / en / middle } { content = \c_@@_text_cover_en_tl \@@_vskip: \textsc { \clist_item:Nn \c_@@_name_degree_en_clist { \g_@@_info_degree_int } } \@@_vskip: { in } \@@_vskip: \g_@@_info_major_en_tl, bottom-skip = 2 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/g/en/emblem-img} % 研究生英文封面校徽图片实例。 % \begin{macrocode} \@@_declare_element:nn { cover / g / en / emblem-img } { content = \@@_emblem:N \c_@@_emblemwidthii_dim, bottom-skip = 1.5 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/g/en/bottom} % 研究生英文封面底部信息实例。 % \begin{macrocode} \@@_declare_element:nn { cover / g / en / bottom } { content = \g_@@_info_dept_en_tl \skip_vertical:N \c_zero_skip \c_@@_name_nju_en_tl \skip_vertical:n { 1 cm } \g_@@_info_submitdate_en_tl } % \end{macrocode} % \end{macro} % % \subparagraph{国家图书馆封面} 包括顶部、题名、标题、中部、底部、日期。 % % \begin{macro}{cover/nl/top} % 国家图书馆封面顶部信息实例。 % \begin{macrocode} \@@_declare_element:nn { cover / nl / top } { content = \@@_cover_top_nl:, bottom-skip = 2 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/nl/name} % 国家图书馆封面标题名称实例。 % \begin{macrocode} \@@_declare_element:nn { cover / nl / name } { content = \@@_spread_box:nnV { 6 em } { } \c_@@_name_title_b_tl, format = \zihao { -0 }, bottom-skip = 0 pt plus 1 fil } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/nl/title} % 国家图书馆封面标题实例。 % \begin{macrocode} \@@_declare_element:nn { cover / nl / title } { content = \@@_cover_title_nl:, format = \zihao { 1 }, bottom-skip = 0 pt plus 1 fil } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/nl/middle} % 国家图书馆封面中部信息实例。 % \begin{macrocode} \@@_declare_element:nn { cover / nl / middle } { content = \@@_cover_info_nl:, format = \zihao { 4 }, bottom-skip = 0 pt plus 1.2 fil } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/nl/bottom} % 国家图书馆封面底部信息实例。 % \begin{macrocode} \@@_declare_element:nn { cover / nl / bottom } { content = \@@_cover_bottom_nl:n { 4 }, bottom-skip = 1 cm, align = r } % \end{macrocode} % \end{macro} % % \begin{macro}{cover/nl/date} % 国家图书馆封面底部日期实例。 % \begin{macrocode} \@@_declare_element:nn { cover / nl / date } { content = \g_@@_info_bottomdate_tl, format = \kaishu \zihao { 3 } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_cover_top_nl:} % 国家图书馆封面顶部信息。 % \begin{macrocode} \cs_new_protected:Npn \@@_cover_top_nl: { \@@_spread_box:nnV { 3.2 em } { } \c_@@_name_clc_tl \@@_hskip: \@@_ulined_center_box:nn { 9 em } { \g_@@_info_clc_tl } \hfill \@@_spread_box:nnV { 3.2 em } { } \c_@@_name_secretlv_tl \@@_hskip: \@@_ulined_center_box:nn { 9 em } { \g_@@_info_secretlv_tl } \\ \@@_spread_box:nnV { 3.2 em } { } \c_@@_name_udc_tl \@@_hskip: \@@_ulined_center_box:nn { 9 em } { \g_@@_info_udc_tl } \hfill \null } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_cover_title_nl:} % 国家图书馆封面标题。 % \begin{macrocode} \cs_new_protected:Npn \@@_cover_title_nl: { \parbox [ b ] { 15 em } { \@@_uline_title: } \par \skip_vertical:n { - 0.5 cm } { \zihao { 4 } \c_@@_name_subtitle_tl } \skip_vertical:N \c_zero_skip \@@_ulined_center_box:nn { 4.5 em } { \g_@@_info_author_tl } \skip_vertical:n { - 0.5 cm } { \zihao { 4 } { ( } \c_@@_name_author_tl { ) } } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_cover_info_nl:} % \changes{v0.17}{2022/04/09}{优化国家图书馆封面导师联系方式的输出格式。} % \changes{v0.19}{2022/05/23}{补充国家图书馆封面的学位授予单位和日期。} % 国家图书馆封面信息栏。 % \begin{macrocode} \cs_new_protected:Npn \@@_cover_info_nl: { \@@_uline_list:nnn { \c_@@_name_supvinfo_tl } { \clist_use:Nn \g_@@_info_supv_clist { ~ } \clist_use:Nn \g_@@_info_supv_ii_clist { ~ } \@@_hskip: \g_@@_info_supvcont_tl } { 1 em plus 1 fill } \@@_uline_bientry:Nnnn \l_@@_tmpa_dim { degree } { degree } { } \@@_uline_bientry:Nnnn \l_@@_tmpa_dim { major_b } { major } { } \\ \@@_uline_bientry:Nnnn \l_@@_tmpa_dim { submitdate } { submitdate } { } \@@_uline_bientry:Nnnn \l_@@_tmpa_dim { defenddate } { defenddate } { } \\ \@@_uline_entry:Nnnn \l_@@_tmpa_dim { confer } { confer } { } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_cover_bottom_nl:n} % \changes{v0.19}{2022/05/20}{将国家图书馆封面的评审委员会人数分离为单独参数。} % 国家图书馆封面底部信息。 % \begin{macrocode} \cs_new_protected:Npn \@@_cover_bottom_nl:n #1 { \c_@@_name_chairman_tl \@@_hskip: \@@_ulined_center_box:nn { 9 em } { \g_@@_info_chairman_tl } \\ \c_@@_name_reviewer_tl \@@_hskip: \@@_multiline_box:NNnn \l_@@_tmp_int \g_@@_info_reviewer_clist { #1 } { 9 em } } % \end{macrocode} % \end{macro} % % \subparagraph{出版授权书} % % \begin{macro}{authdecl/g/title} % 出版授权书标题实例。 % \begin{macrocode} \@@_declare_element:nn { authdecl / g / title } { content = \c_@@_name_authdecl_tl, format = \c_@@_fmt_chapter_tl, bottom-skip = 3 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{authdecl/g/text} % 出版授权书文本实例。 % \begin{macrocode} \@@_declare_element:nn { authdecl / g / text } { content = \c_@@_text_authdecl_tl, align = n, bottom-skip = 2 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{authdecl/g/sign} % 出版授权书签名区实例。 % \begin{macrocode} \@@_declare_element:nn { authdecl / g / sign } { content = \@@_authdecl_sign_g:, align = r, bottom-skip = 0pt plus 1 fill } % \end{macrocode} % \end{macro} % % \begin{macro}{authdecl/g/info} % 出版授权书信息表格实例。 % \begin{macrocode} \@@_declare_element:nn { authdecl / g / info } { content = \@@_authdecl_info_g:, format = \zihao { 5 } , align = l, bottom-skip = 2 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{authdecl/g/date} % 出版授权书保密信息实例。 % \begin{macrocode} \@@_declare_element:nn { authdecl / g / date } { content = \@@_authdecl_secretlv_g:, format = \zihao { 5 } , align = l } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_degree_checkbox:n} % 信息栏的学位复选框。 % \begin{macrocode} \cs_new_protected:Npn \@@_degree_checkbox:n #1 { \int_compare:nNnTF { #1 } { = } { \g_@@_info_degree_int } { \makebox [ 0 pt ] [l] { \ensuremath { \mdwhtsquare } } \hspace { 0.1 em } \ensuremath { \checkmark } } { \ensuremath { \mdwhtsquare } } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_authdecl_info_g:} % 信息栏内容。 % \begin{macrocode} \cs_new_protected:Npn \@@_authdecl_info_g: { \begin{tblr} { hlines, vlines, hspan=minimal, colspec = {cX[c]cX[c]cX[c]}, cell{1}{2} = {c=5}{m}, cell{3}{2} = {c=5}{m}, cell{4}{2} = {c=5}{m}, cell{5}{2} = {c=5}{m} } \c_@@_name_title_c_tl & \g_@@_info_title_tl \\ \c_@@_name_id_a_tl & \g_@@_info_id_tl & \c_@@_name_dept_a_tl & \g_@@_info_dept_tl & \c_@@_name_year_tl & \tl_range:Nnn \g_@@_info_submitdate_raw_tl {1} {4} \\ \c_@@_name_degree_a_tl & { \@@_degree_checkbox:n { 2 } 学术学位硕士 \qquad{} \@@_degree_checkbox:n { 3 } 专业学位硕士 \\ \@@_degree_checkbox:n { 4 } 学术学位博士 \qquad{} \@@_degree_checkbox:n { 5 } 专业学位博士 } \\ \c_@@_name_email_tl & \g_@@_info_email_tl \\ \c_@@_name_supv_b_tl & \clist_item:Nn \g_@@_info_supv_clist {1} \bool_if:NT \l_@@_second_supv_bool { \@@_quad: \clist_item:Nn \g_@@_info_supv_ii_clist {1} } \\ \end{tblr} } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_authdecl_sign_g:} % 签名区内容。 % \begin{macrocode} \cs_new_protected:Npn \@@_authdecl_sign_g: { \c_@@_name_authsign_tl \par \c_@@_name_blankdate_tl } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_authdecl_secretlv_g:} % 保密信息内容。 % \begin{macrocode} \cs_new_protected:Npn \@@_authdecl_secretlv_g: { \c_@@_name_secretstatus_tl \par \ensuremath { \mdwhtsquare } \c_@@_name_secretfree_tl \par \ensuremath { \mdwhtsquare } \c_@@_name_secretdate_tl } % % \end{macrocode} % \end{macro} % % % \subsubsection{绘制封面} % \changes{v0.13}{2021/12/10}{使用 \hologo{LaTeX3} 语法重构本科生封面。} % \changes{v0.13}{2021/12/11}{使用 \hologo{LaTeX3} 语法重构研究生封面。} % \changes{v0.13}{2021/12/12}{使用 \hologo{LaTeX3} 语法重构国家图书馆封面。} % \changes{v0.15}{2022/01/25}{将封面页面封装为对象。} % % 定义封面页面的具体配置参数。 % % \begin{macro}{cover-ug-default} % 默认本科生封面实例。 % \begin{macrocode} %<*definition-ug> \@@_declare_page:nn { cover-ug-default } { element = { emblem-img, name-img, title, info }, prefix = cover / ug /, bottom-skip = 0.5 cm plus 1.5 fill } % % \end{macrocode} % \end{macro} % % \begin{macro}{cover-g-front-default} % 默认研究生普通封面正面实例。 % \begin{macrocode} %<*definition-g> \@@_declare_page:nn { cover-g-front-default } { element = { emblem-img, name-img, type, degree, info, date }, prefix = cover / g /, format = \zihao { 3 } \kaishu, top-skip = 1.5 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{cover-g-back-default} % 默认研究生普通封面背面实例。 % \begin{macrocode} \@@_declare_page:nn { cover-g-back-default } { element = { back }, prefix = cover / g /, format = \zihao { 3 } \kaishu, top-skip = 20 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{cover-g-en-default} % 默认研究生英文封面实例。 % \begin{macrocode} \@@_declare_page:nn { cover-g-en-default } { element = { title, top, middle, emblem-img, bottom }, prefix = cover / g / en /, top-skip = 0 pt plus 1.2 fil } % \end{macrocode} % \end{macro} % % \begin{macro}{cover-nl-default} % 默认国家图书馆封面实例。 % \begin{macrocode} \@@_declare_page:nn { cover-nl-default } { element = { top, name, title, middle, bottom, date }, prefix = cover / nl /, format = \kaishu } % \end{macrocode} % \end{macro} % % \begin{macro}{authdecl-g-default} % 默认出版授权书实例。 % \begin{macrocode} \@@_declare_page:nn { authdecl-g-default } { element = { title, text, sign, info, date }, prefix = authdecl / g /, top-skip = 1 cm, bottom-skip = 0.5 cm plus 1.5 fill } % % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_make_cover:} % 生成本科生或研究生的普通封面。 % \begin{macrocode} %<*(definition-ug|definition-g)> \cs_new_protected:Npn \@@_make_cover: { % \UseInstance { nju } { cover-ug-default } % \clist_map_inline:nn { front, back, en } % { \UseInstance { nju } { cover-g- ##1 -default } } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_make_cover_nl:} % 生成研究生的国家图书馆封面。 % \begin{macrocode} %\cs_new_protected:Npn \@@_make_cover_nl: % { \UseInstance { nju } { cover-nl-default } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_make_origdecl: } % \changes{v0.13}{2021/12/15}{加入本科生的诚信承诺书。} % \changes{v0.19}{2022/05/22}{跟进新版本科生诚信承诺书样式。} % 生成本科生的诚信承诺书或研究生的学位论文原创性声明。 % \begin{macrocode} \cs_new_protected:Npn \@@_make_origdecl: { % \cleardoublepage % \chapter* { \c_@@_name_origdecl_tl } \thispagestyle { empty } %<*definition-ug> \begin{center} \njuemblem{2cm}{!}\\ {\zihao{-1}\sffamily \c__nju_name_origdecl_tl } \end{center} \zihao{-3} \hspace{2em} % \c_@@_text_origdecl_tl \vfil \begin{flushright} % \clist_map_inline:nn { origsign, id, origdate } % \clist_map_inline:nn { origsign, origdate } { \@@_vskip: \@@_name:n { ##1 } : \@@_uline:n { 7 em } } \end{flushright} \vfil } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_make_authdecl: } % \changes{v0.17}{2022/04/04}{加入研究生的学位论文出版授权书。} % 生成研究生的学位论文出版授权书。 % \begin{macrocode} \cs_new_protected:Npn \@@_make_authdecl: { % \prg_do_nothing: % \UseInstance { nju } { authdecl-g-default } } % % \end{macrocode} % \end{macro} % % % \subsubsection{用户接口} % % \begin{macro}{\@@_new_img_cmd:nn,\@@_new_img_cmd:nV} % 用于定义插入图片命令的辅助函数。 % \begin{macrocode} %<*class> \cs_new_protected:Npn \@@_new_img_cmd:nn #1#2 { \exp_args:Nc \NewDocumentCommand { #1 } { o m m } { \includegraphics [ width = ##2, height = ##3 ] { #2 } } } \cs_generate_variant:Nn \@@_new_img_cmd:nn { nV } % \end{macrocode} % \end{macro} % % \begin{macrocode} \keys_define:nn { nju / style } { % \end{macrocode} % \begin{macro}{style/emblem-img,\njuemblem} % \changes{v0.14}{2021/12/23}{提供选择外置校徽图片的接口。} % 校徽图片路径。 % \begin{macrocode} emblem-img .code:n = { \@@_new_img_cmd:nV { njuemblem } \l_keys_value_tl }, % \end{macrocode} % \end{macro} % % \begin{macro}{style/name-img,\njuname} % \changes{v0.14}{2021/12/23}{提供选择外置校名图片的接口。} % 校名图片路径。 % \begin{macrocode} name-img .code:n = { \@@_new_img_cmd:nV { njuname } \l_keys_value_tl } } % \end{macrocode} % \end{macro} % % \changes{v0.16}{2022/02/22}{不再默认载入 \pkg{njuvisual}。} % 检查 \cs{njuemblem} 和 \cs{njuname} 命令是否有定义。 % \begin{macrocode} \msg_new:nnn { njuthesis } { missing-image } { Local~ images~ not~ designated.\\ It~ seems~ that~ you~ haven't~ fill~ in~ both~ "style/emblem-img"~ and~ "style/name-img",~ therefore~ I~ am~ using~ package~ "njuvisual"~ instead,~ which~ may~ slow~ down~ the~ compilation. } \ctex_at_end_preamble:n { % \end{macrocode} % 如果校名、校徽图片其中之一的路径未被定义, % 则全盘使用 \pkg{njuvisual} 提供的绘制命令。 % \begin{macrocode} \bool_lazy_and:nnF { \cs_if_exist_p:N \njuemblem } { \cs_if_exist_p:N \njuname } { \cs_undefine:N \njuemblem \cs_undefine:N \njuname \msg_warning:nn { njuthesis } { missing-image } \RequirePackage { njuvisual } } \bool_if:NT \g_@@_blind_bool { \RenewDocumentCommand \njuemblem { o m m } { \prg_do_nothing: } \RenewDocumentCommand \njuname { o m m } { \prg_do_nothing: } } } % \end{macrocode} % % \begin{macro}{\maketitle} % \changes{v0.12}{2021/12/01}{仅会生成国家图书馆封面或者普通封面之一。} % \changes{v0.13}{2021/12/12}{重新绘制封面。} % \changes{v0.13}{2021/12/15}{草稿模式下不绘制封面。} % 重定义 \cs{maketitle} 以生成封面。 % 在草稿模式下,封面绘制将被禁用,有助于提升编译速度。 % \begin{macrocode} \RenewDocumentCommand \maketitle { } { \bool_if:NF \g_@@_draft_bool { \pagenumbering { gobble } % \end{macrocode} % 如果在研究生模板中选择了 \opt{nlcover},就生成用于申请学位的国家图书馆封面, % 反之生成普通封面。 % \begin{macrocode} \bool_if:NTF \g_@@_nlcover_bool { \@@_make_cover_nl: } { \@@_make_cover: } } % \end{macrocode} % 生成封面后清除标题中的换行控制符,便于在摘要中输出。 % \begin{macrocode} \tl_remove_all:Nn \g_@@_info_title_tl { \\ } % \end{macrocode} % 如果在选择了 \opt{decl-page},就生成本科生的诚信承诺书, % 或研究生的原创性声明和出版授权书。 % \begin{macrocode} \bool_if:NF \g_@@_draft_bool { \bool_if:NT \g_@@_decl_bool { \@@_make_origdecl: \AtEndEnvironment { document } { \cleardoublepage \@@_make_authdecl: \cleardoublepage } } } % \end{macrocode} % 在标题页后使用大写罗马字母页码,恢复正常字体设置。 % \begin{macrocode} \cleardoublepage \exp_args:NV \pagestyle \c_@@_fmt_pagestyle_tl \pagenumbering { Roman } } % % \end{macrocode} % \end{macro} % % % \subsection{摘要页} % % \subsubsection{绘制部件} % \changes{v0.16}{2022/03/02}{将摘要部件分离到 \file{.def} 文件。} % \changes{v0.16}{2022/03/02}{使用 \pkg{xtemplate} 重构摘要。} % % \begin{macro}{abstract/title} % 中文摘要标题实例。 % \begin{macrocode} %<*(definition-ug|definition-g)> \@@_declare_element:nn { abstract / title } { content = \@@_abs_title:V \c_@@_name_abstracttitle_tl, format = \bfseries \kaishu \zihao { -2 }, bottom-skip = 1.2 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{abstract/info} % 中文摘要信息栏实例。 % \begin{macrocode} \@@_declare_element:nn { abstract / info } { % content = \@@_abs_info_ug:nn { } { : }, % content = \@@_abs_info_g:n { : }, % format = \zihao { -4 } \kaishu, % format = \zihao { 4 } \kaishu, % bottom-skip = 1 cm, % bottom-skip = 2 cm, align = l } % \end{macrocode} % \end{macro} % % \begin{macro}{abstract/en/title} % 英文摘要标题实例。 % \begin{macrocode} \@@_declare_element:nn { abstract / en / title } { content = \@@_abs_title:V \c_@@_name_abstracttitle_en_tl, format = \bfseries \kaishu \zihao { -2 }, bottom-skip = 1.2 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{abstract/en/info} % 英文摘要信息栏实例。 % \begin{macrocode} \@@_declare_element:nn { abstract / en / info } { % content = \@@_abs_info_ug:nn { _en } { :~ }, % content = \@@_abs_info_en_g:n { :~ }, % format = \zihao { -4 }, % format = \zihao { 4 }, % bottom-skip = 1 cm, % bottom-skip = 2 cm, align = l } % % \end{macrocode} % \end{macro} % % \paragraph{本科生} % \changes{v0.13}{2021/12/12}{使用 \hologo{LaTeX3} 语法重构本科生摘要。} % % \begin{macro}{\@@_abs_info_ug:nn} % 绘制本科生摘要信息栏。 % \begin{arguments} % \item 语言,空置为中文,|_en| 为英文 % \item 分隔符 % \end{arguments} % 本科生摘要页面不含下划线,因而不用确定文本宽度,绘制命令较为简单。 % \begin{macrocode} %<*definition-ug> \cs_new_protected:Npn \@@_abs_info_ug:nn #1#2 { % \end{macrocode} % 确定标题类型。 % \begin{macrocode} \tl_if_blank:eTF { #1 } { \c_@@_name_title_tl } { \clist_item:Nn \c_@@_name_type_en_clist { \g_@@_info_type_int } } #2 \tl_use:c { g_@@_info_title #1 _tl } \\ % \end{macrocode} % 由于作者姓名使用的字样发生了变动,这里进行替换以便嵌入循环。 % \begin{macrocode} \tl_set_eq:NN \c_@@_name_author_tl \c_@@_name_author_a_tl % \end{macrocode} % 使用循环输出院系、专业、作者、导师信息。 % \begin{macrocode} \clist_map_inline:nn { dept, major, author, supvfull } { \@@_name:n { ##1 #1 } #2 \@@_info:n { ##1 #1 } \\ } \@@_name:n { abstract #1 } #2 } % % \end{macrocode} % \end{macro} % % \paragraph{研究生} % \changes{v0.13}{2021/12/12}{使用 \hologo{LaTeX3} 语法重构研究生摘要。} % % \begin{macro}{abstract/mark} % 英文摘要标题实例。 % \begin{macrocode} %<*definition-g> \@@_declare_element:nn { abstract / mark } { content = \c_@@_name_abstract_b_tl, format = \sffamily \zihao { -3 }, bottom-skip = 1 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{abstract/en/mark} % 英文摘要标题实例。 % \begin{macrocode} \@@_declare_element:nn { abstract / en / mark } { content = \c_@@_name_abstract_b_en_tl, format = \sffamily \zihao { -3 }, bottom-skip = 1 cm } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_abs_info_g:n} % 绘制研究生中文摘要信息栏。 % \begin{arguments} % \item 分隔符 % \end{arguments} % 研究生中文摘要页包括下划线以及若干特殊的对齐方式,实现方式较为繁琐。使用 \cs{@@_full_uline:NV} 确定内容宽度后,调用 \cs{@@_uline:n} 或 \cs{@@_ulined_center_box:nn} 命令以绘制横穿页面的下划线。前两行为标题。 % \begin{macrocode} \cs_new_protected:Npn \@@_abs_info_g:n #1 { \@@_uline_list:xnn { \clist_item:Nn \c_@@_name_type_clist { \g_@@_info_type_int } \c_@@_name_title_a_tl #1 } { \g_@@_info_title_tl } { \g_@@_abs_title_left_skip } % \end{macrocode} % 专业、年级、姓名。 % \begin{macrocode} \@@_full_uline:NV \l_@@_tmpa_dim { \@@_ulined_center_box:nn { 11 em } { \g_@@_info_major_tl } \c_@@_name_major_a_tl \@@_ulined_center_box:nn { 4 em } { \g_@@_info_grade_tl } \c_@@_name_grade_tl \c_@@_name_author_a_tl #1 } \@@_ulined_center_box:nn { \l_@@_tmpa_dim } { \g_@@_info_author_tl } \\ % \end{macrocode} % 导师姓名、职称。 % \begin{macrocode} \@@_full_uline:NV \l_@@_tmpa_dim { \c_@@_name_supv_a_tl #1 } \@@_ulined_center_box:nn { \l_@@_tmpa_dim } { \g_@@_info_supvfull_tl } } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_abs_info_en_g:n} % 绘制研究生英文摘要信息栏。 % \begin{arguments} % \item 分隔符 % \end{arguments} % 前两行为标题。 % \begin{macrocode} \cs_new_protected:Npn \@@_abs_info_en_g:n #1 { \@@_uline_list:xnn { \g_@@_info_type_en_tl #1 } { \g_@@_info_title_en_tl } { \g_@@_abs_title_left_skip } % \end{macrocode} % 使用循环输出专业、姓名、导师。注意这里将 |\\| 放置在前部, % 以避免末尾生成多余的换行符产生 |Underfull \vbox| 信息。 % \begin{macrocode} \clist_map_inline:nn { major, author, supvfull } { \@@_uline_entry:Nnnn \l_@@_tmpa_dim { ##1 _en } { ##1 _en } { #1 } \par } } % % \end{macrocode} % \end{macro} % % \paragraph{关键词列表} % % \begin{macro}{\@@_print_keywords:nn} % \changes{v0.15}{2022/01/26}{为关键词列表添加悬挂缩进。} % 生成中英文关键词列表。 % \begin{arguments} % \item 语言,空置为中文,|_en| 为英文 % \item 关键词分隔符 % \end{arguments} % \begin{macrocode} %<*class> \cs_new_protected:Npn \@@_print_keywords:nn #1#2 { \tl_set:Nv \l_@@_tmpa_tl { c_@@_name_keywords #1 _tl } \@@_get_text_width:NV \l_@@_tmpa_dim \l_@@_tmpa_tl % \end{macrocode} % 关键词列表的悬挂缩进样式由 \tn{list} 环境产生。 % \begin{macrocode} \list { \l_@@_tmpa_tl } { \labelwidth \l_@@_tmpa_dim \labelsep \c_zero_dim \leftmargin \c_zero_dim \rightmargin \c_zero_dim \advance \leftmargin \l_@@_tmpa_dim % \end{macrocode} % 使用粗体作为标签样式。 % \begin{macrocode} \cs_set_eq:NN \makelabel \textbf } \item \clist_use:cn { g_@@_info_keywords #1 _clist } { #2 } \endlist } % % \end{macrocode} % \end{macro} % % % \subsubsection{绘制摘要} % \changes{v0.16}{2022/03/26}{补上研究生摘要页面的小标题。} % % \begin{macro}{\@@_make_abstract:,\@@_make_abstract_en:} % 绘制摘要页面。 % \begin{macrocode} %<*(definition-ug|definition-g)> \cs_new_protected:Npn \@@_make_abstract: { \UseInstance { nju } { abstract / title } \UseInstance { nju } { abstract / info } % \UseInstance { nju } { abstract / mark } } \cs_new_protected:Npn \@@_make_abstract_en: { \UseInstance { nju } { abstract / en / title } \UseInstance { nju } { abstract / en / info } % \UseInstance { nju } { abstract / en / mark } } % % \end{macrocode} % \end{macro} % % % \subsubsection{用户接口} % % \begin{macro}{\g_@@_abs_title_left_skip} % 研究生摘要标题左边距。 % \begin{macrocode} %<*class> \skip_new:N \g_@@_abs_title_left_skip % \end{macrocode} % \end{macro} % % \begin{macrocode} \keys_define:nn { nju / style } { % \end{macrocode} % \begin{macro}{style/abstract-in-toc} % \changes{v0.15}{2022/02/04}{可选择摘要是否出现在目录中。} % 是否将摘要添加到目录。 % \begin{macrocode} abstract-in-toc .bool_gset:N = \g_@@_abs_in_toc_bool, abstract-in-toc .initial:n = true, % \end{macrocode} % \end{macro} % % \begin{macro}{style/abstract-title} % \changes{v0.16}{2022/03/26}{可选择研究生摘要标题样式。} % 选择摘要样式,默认为 \opt{strict}。 % \begin{macrocode} abstract-title .choice:, abstract-title / strict .code:n = { \bool_gset_true:N \g_@@_strict_abs_title_bool \skip_gset:Nn \g_@@_abs_title_left_skip { 1 em } }, abstract-title / centered .code:n = { \bool_gset_true:N \g_@@_strict_abs_title_bool \skip_gset:Nn \g_@@_abs_title_left_skip { 0 pt plus 1 fill } }, abstract-title / natural .code:n = { \bool_gset_false:N \g_@@_strict_abs_title_bool \skip_gset:Nn \g_@@_abs_title_left_skip { 0 pt plus 1 fill } }, abstract-title .initial:n = strict } % \end{macrocode} % \end{macro} % % \begin{environment}{abstract} % \changes{v0.13}{2021/12/12}{重新绘制摘要。} % 中文摘要环境。 % \begin{macrocode} \NewDocumentEnvironment { abstract } { +b } { \cleardoublepage \thispagestyle { plain } \@@_abs_bookmark:Vn \c_@@_name_abstract_a_tl { abstract } \@@_make_abstract: \group_begin: \kaishu \zihao { -4 } #1 } { \@@_print_keywords:nn { } { ; } \group_end: } % \end{macrocode} % \end{environment} % % \begin{environment}{abstract*} % 英文摘要环境。\pkg{xparse} 目前不支持合并带有星号的环境,因此需要单独定义。 % \begin{macrocode} \NewDocumentEnvironment { abstract* } { +b } { \cleardoublepage \thispagestyle { plain } \@@_abs_bookmark:Vn \c_@@_name_abstract_a_en_tl { abstract-en } \@@_make_abstract_en: \group_begin: \zihao { -4 } #1 } { \@@_print_keywords:nn { _en } { ;~ } \group_end: } % \end{macrocode} % \end{environment} % % % \subsection{前言致谢} % % \begin{environment}{preface} % \begin{environment}{acknowledgement} % 单独制作的前言致谢页。 % \begin{macrocode} \NewDocumentEnvironment { preface } { +b } { \@@_chapter:V \c_@@_name_preface_tl #1 } { \cleardoublepage } \NewDocumentEnvironment { acknowledgement } { +b } { \@@_chapter:V \c_@@_name_acknowledgement_tl #1 } { \cleardoublepage } % \end{macrocode} % \end{environment} % \end{environment} % % % \subsection{成果列表} % % \begin{macro}{\njupaperlist} % \changes{v0.10}{2021/09/29}{新增了成果列表页面。} % \changes{v0.14}{2021/12/20}{成果列表中可突出指定作者姓名及年份。} % \changes{v0.19}{2022/05/22}{修复成果列表与章末参考文献表的冲突。} % 成果列表。 % \begin{macrocode} \NewDocumentCommand \njupaperlist { O { \c_@@_name_paperlist_tl } m } { \group_begin: % \end{macrocode} % 修改姓名的显示方式,使被注解的姓名可被加粗下划线表示。 % \begin{macrocode} \RenewDocumentCommand \mkbibnamegiven { m } { \ifitemannotation { thesisauthor } { \njuline { \bf ##1 } } { ##1 } } \RenewDocumentCommand \mkbibnamefamily { m } { \ifitemannotation { thesisauthor } { \njuline { \bf ##1 } } { ##1 } } % \end{macrocode} % 修改年份的显示方式,默认进行加粗。 % \begin{macrocode} \RenewDocumentCommand \mkbibdateshort { m m m } { \textbf { \thefield { ##1 } } } % \end{macrocode} % 在使用章末参考文献表时,\env{refsection} 的单独一章范围内生效, % 无需额外添加环境。 ^^A TODO: 待修改为更简洁的形式 % \begin{macrocode} \tl_if_eq:NnTF \blx@refsecreset@level { 2 } { \nocite { #2 } \printbibliography [ heading = subbibliography, title = #1 ] } { \begin{refsection} \nocite { #2 } \printbibliography [ heading = subbibliography, title = #1 ] \end{refsection} } \group_end: } % \end{macrocode} % \end{macro} % % % \subsection{符号表} % % \begin{macro}{\@@_notation_label:n} % 左对齐的标签格式,用于符号表。 % \begin{macrocode} \cs_new_protected:Npn \@@_notation_label:n #1 { #1 \hfil } % \end{macrocode} % \end{macro} % % \begin{macro}{\@@_make_notation:nn} % 生成符号表。由于符号表只有符号和说明两列,相比于 \env{longtable} 环境, % \env{description} 环境的语法更为简洁直观,且说明文字可以换行,因而此处使用 % \hologo{LaTeX2e} 的列表环境进行封装,定义和语法参见 \file{source2e.pdf} 中的 % File I \quad ltlists.dtx 一章。 % \begin{macrocode} \cs_new_protected:Npn \@@_make_notation:nn #1#2 { \dim_set:Nn \l_@@_tmpa_dim { \textwidth - #1 - #2 } \list { } { % \end{macrocode} % \tn{list} 环境使用宽度固定的盒子制作标签,通过指定这个盒子的宽度 % \tn{labelwidth} 即可确定左侧标签区域的宽度。 % \begin{macrocode} \labelwidth #2 \labelsep \c_zero_dim \itemsep \c_zero_dim \parsep \c_zero_dim % \end{macrocode} % 右侧说明文字区域的宽度无法直接指定,而是靠计算左右边距 \tn{leftmargin} 和 % \tn{rightmargin} 得到的。 % \begin{macrocode} \leftmargin .5\l_@@_tmpa_dim \rightmargin \leftmargin \advance \leftmargin #2 \cs_set_eq:NN \makelabel \@@_notation_label:n } } % \end{macrocode} % \end{macro} % % \begin{environment}{notation} % \changes{v0.15}{2022/01/17}{提供符号表环境。} % 符号表环境。 % \begin{arguments} % \item 说明区域宽度,初始值为 10 em。说明宽度的调整更为常见,所以放在前面。 % \item 符号区域宽度,初始值为 5 em % \end{arguments} % \begin{macrocode} \NewDocumentEnvironment { notation } { O { 10 em } O { 5 em } } { \@@_chapter:V \c_@@_name_notation_tl \@@_make_notation:nn { #1 } { #2 } } { \endlist \cleardoublepage } % \end{macrocode} % \end{environment} % % \begin{environment}{notation*} % 带有星号的符号表不会插入目录。 % \begin{macrocode} \NewDocumentEnvironment { notation* } { O { 10 em } O { 5 em } } { \chapter * { \c_@@_name_notation_tl } \@@_make_notation:nn { #1 } { #2 } } { \endlist } % % \end{macrocode} % \end{environment} % % % \subsection{配置常量} % \label{subsec:constant-config} % \changes{v0.16}{2022/02/23}{将名称常量分离到 \file{.def} 文件。} % \changes{v0.18}{2022/04/20}{使用 |const| 类型统一定义常量。} % % 本节内容用于生成常量的默认定义,分为本科生和研究生模板两种。 % % \subsubsection{名称} % \label{subsubsec:constant-name} % % 由于同一名称在不同位置具有不同变体,本模板使用字母后缀名进行了区分, % 并在易混淆处添加了注释。 % % 通用默认名称。注意空格是忽略掉的。 % \begin{macrocode} %<*(definition-ug|definition-g)> \clist_map_inline:nn { { acknowledgement } { 致 \qquad{} 谢 }, { tableofcontents } { 目 \qquad{} 录 }, { id } { 学号 }, { listoffigures } { 插图目录 }, { listoftables } { 表格目录 }, { notation } { 符号表 }, { origdate } { 日期 }, { paperlist } { 发表文章目录 }, { pdfcreator } { LaTeX~ with~ njuthesis~ class }, { preface } { 前 \qquad{} 言 }, { supv_ii } { 第二导师 }, { supv_ttl } { 职称 } } { \@@_define_name:nn #1 } % \end{macrocode} % % 定义同时使用到中英文名称的常量。 % \begin{macrocode} \clist_map_inline:nn { { abstract } { 摘要 } { ABSTRACT }, % 用于书签的摘要名称字样 { abstract_a } { 中文摘要 } { ABSTRACT }, % 用于小标题的摘要名称字样 { abstract_b } { 摘\qquad{}要 } { ABSTRACT }, { appendix } { 附录 } { appendix }, { dept } { 院系 } { DEPARTMENT }, { figure } { 图 } { figure }, { keywords } { 关键词: } { Keywords:~ }, { lang } { 中文 } { 英文 }, { nju } { 南京大学 } { Nanjing~ University }, { table } { 表 } { table } } { \@@_define_name:nnn #1 } % \end{macrocode} % % 本科生模板默认名称。 % \begin{macrocode} %<*definition-ug> \clist_map_inline:nn { % 用于摘要的作者名称字样 { author_a } { 本科生姓名 }, { grade } { 年级 }, { origdecl } { \c_@@_name_nju_tl 本科毕业论文(设计) \\ 诚信承诺书 }, { origsign } { 作者签名 }, { submitdate } { 提交日期 }, { supv } { 导师 }, { title } { 题目 }, { type } { 本科生毕业论文(设计、作品) }, { ug } { 本科生 } } { \@@_define_name:nn #1 } \clist_map_inline:nn { { abstracttitle } { \c_@@_name_nju_tl \c_@@_name_type_tl \c_@@_name_lang_tl \c_@@_name_abstract_tl } { \c_@@_name_nju_tl \c_@@_name_type_tl \c_@@_name_lang_en_tl \c_@@_name_abstract_tl }, { author } { 学生姓名 } { UNDERGRADUATE }, { major } { 专业 } { SPECIALIZATION }, { supvfull } { 指导教师(姓名、职称) } { MENTOR } } { \@@_define_name:nnn #1 } % % \end{macrocode} % % \changes{v0.19}{2022/05/22}{更正研究生普通封面专业字样。} % \changes{v0.19}{2022/05/22}{更正国家图书馆封面学位论文字样。} % 研究生模板默认名称。 % \begin{macrocode} %<*definition-g> \clist_map_inline:nn { { apply } {(申请 \g_@@_info_degree_tl 学位)}, { authdecl } { 学位论文出版授权书 }, { author_a } { \tl_item:Nn \g_@@_info_degree_tl { 1 } 士生姓名 }, { authsign } { 作者签名:\njuline{\hspace{6em}} }, { blankdate } { \njuline{\qquad\qquad} 年 \njuline{\qquad} 月 \njuline{\qquad} 日 }, % 用于摘要的作者名称字样 { chairman } { 答辩委员会主席: }, { clc } { 分类号 }, { confer } { 学位授予单位和日期 }, { defenddate } { 论文答辩日期 }, { degree } { 申请学位级别 }, % 用于出版授权书的学位名称字样 { degree_a } { 论文级别 }, % 用于出版授权书的院系名称字样 { dept_a } { 所在院系 }, { email } { 作者 Email }, { field } { 研究方向 }, { g } { 研究生 }, { grade } { 级 }, % 用于出版授权书的学号名称字样 { id_a } { 研究生学号 }, % 用于摘要的专业名称字样 { major_a } { 专业 }, % 用于国家图书馆封面的专业名称字样 { major_b } { 专业名称 }, { origdecl } { \c_@@_name_nju_tl 学位论文原创性声明 }, { origsign } { 研究生签名 }, { reviewer } { 评阅人: }, { secretlv } { 密级 }, { secretstatus } { 论文涉密情况: }, { secretfree } { 不保密 }, { secretdate } { 保密,保密期( \c_@@_name_blankdate_tl 至 \c_@@_name_blankdate_tl ) }, { sign } { (签字) }, { submitdate } { 论文提交日期 }, { subtitle } { (题名和副题名) }, { supv } { 导师 }, % 用于摘要的导师名称字样 { supv_a } { 指导教师(姓名、职称) }, % 用于出版授权书的导师名称字样 { supv_b } { 导师姓名 }, { supvinfo } { 指导教师姓名、职务、职称、学位、单位名称及地址 }, % 用于普通封面的标题名称字样 { title } { 论文题目 }, % 用于摘要的标题名称字样 { title_a } { 题目 }, % 用于国家图书馆封面的标题名称字样 { title_b } { 学位论文 }, % 用于出版授权书的标题名称字样 { title_c } { 论文题名 }, { udc } { U D C }, { year } { 学位年度 } } { \@@_define_name:nn #1 } \clist_map_inline:nn { { abstracttitle } { \c_@@_name_nju_tl \g_@@_info_type_tl 中文摘要首页用纸 } { \c_@@_name_nju_tl \g_@@_info_type_tl 英文摘要首页用纸 }, { author } { 作者姓名 } { POSTGRADUATE }, { major } { 专业名称 } { SPECIALIZATION }, { supvfull } { 指导教师 } { MENTOR } } { \@@_define_name:nnn #1 } % \end{macrocode} % % 对专业硕士的封面条目进行临时修改。 % \begin{macrocode} \int_compare:nT { \g_@@_info_degree_int == 3 } { \njusetname{major}{专业学位类别(领域)} } % % \end{macrocode} % % \subsubsection{文本} % \label{subsubsec:constant-text} % % \begin{variable}{\c_@@_text_origdecl_tl} % 本科生的学位论文诚信承诺书,或研究生的学位论文原创性声明。 % \begin{macrocode} \tl_const:Nn \c_@@_text_origdecl_tl { %<*definition-ug> 本人郑重承诺:所呈交的毕业论文(设计)(题目: \g_@@_info_title_tl ) 是在指导教师的指导下严格按照学校和院系有关规定由本人独立完成的。 本毕业论文(设计)中引用他人观点及参考资源的内容均已标注引用, 如出现侵犯他人知识产权的行为,由本人承担相应法律责任。 本人承诺不存在抄袭、伪造、篡改、代写、买卖毕业论文(设计)等违纪行为。 % %<*definition-g> 本人郑重声明,所提交的学位论文是本人在导师指导下独立进行科学研究工作所 取得的成果。除本论文中已经注明引用的内容外,本论文不包含其他个人或集体 已经发表或撰写过的研究成果,也不包含为获得 \c_@@_name_nju_tl 或其他教 育机构的学位证书而使用过的材料。对本文的研究做出重要贡献的个人和集体, 均已在论文的致谢部分明确标明。本人郑重申明愿承担本声明的法律责任。 % } % \end{macrocode} % \end{variable} % % \begin{variable}{\c_@@_text_authdecl_tl} % 研究生的学位论文出版授权书。 % \begin{macrocode} %<*definition-g> \tl_const:Nn \c_@@_text_authdecl_tl { 本人完全同意《中国优秀博硕士学位论文全文数据库出版章程》 (以下简称“章程”),愿意将本人的学位论文提交“中国学术期刊 (光盘版)电子杂志社”在《中国博士学位论文全文数据库》、 《中国优秀硕士学位论文全文数据库》中全文发表。《中国博士 学位论文全文数据库》、《中国优秀硕士学位论文全文数据库》 可以以电子、网络及其他数字媒体形式公开出版,并同意编入 《中国知识资源总库》,在《中国博硕士学位论文评价数据库》 中使用和在互联网上传播,同意按“章程”规定享受相关权益。 } % \end{macrocode} % \end{variable} % % \begin{variable}{\c_@@_text_cover_en_tl} % 研究生的英文封面字样。 % \begin{macrocode} \tl_const:Nn \c_@@_text_cover_en_tl { A~ dissertation~ submitted~ to \\ the~ graduate~ school~ of~ \c_@@_name_nju_en_tl \\ in~ partial~ fulfilment~ of~ the~ requirements~ for~ the~ degree~ of } % % \end{macrocode} % \end{variable} % % \subsubsection{定理} % % 默认定理类型和头名称。 % \begin{macrocode} \clist_map_inline:nn { { axiom } { 公理 } { Axiom }, { corollary } { 推论 } { Corollary }, { definition } { 定义 } { Definition }, { example } { 例 } { Example }, { lemma } { 引理 } { Lemma }, { proof } { 证明 } { Proof }, { theorem } { 定理 } { Theorem } } { \@@_add_theorem_type:nnn #1 } % \end{macrocode} % % \subsubsection{长度} % \label{subsubsec:constant-length} % % \changes{v0.17}{2022/04/09}{将长度值分离到 \file{.def} 文件。} % \changes{v0.18}{2022/04/20}{统一管理校名校徽尺寸。} % 默认长度值。 % \begin{macrocode} \clist_map_inline:nn { % { coverlabel } { 68 pt }, % { coverlabel } { 100 pt }, { coverlineskip } { 40 pt }, { coveruline } { 270 pt }, % { emblemwidth } { 68 pt }, % { emblemwidthi } { 46 pt }, % { emblemwidthii } { 61 pt }, % { namewidth } { 300 pt }, % { namewidth } { 126 pt }, { smallhskip } { 5 pt }, { smallvskip } { 1 ex } } { \@@_define_dim:nn #1 } % \end{macrocode} % % \subsubsection{样式} % \label{subsubsec:constant-format} % % \changes{v0.17}{2022/04/09}{将样式定义分离到 \file{.def} 文件。} % \changes{v0.19}{2022/05/11}{简化默认页面样式的修改方式。} % 默认样式。 % \begin{macrocode} \clist_map_inline:nn { % { pagestyle } { plain }, % { pagestyle } { headings }, { section } { \large \sffamily }, { chapter } { \c_@@_fmt_section_tl \centering }, { chapterintoc } { \c_@@_fmt_section_tl }, { subsection } { \c_@@_fmt_section_tl }, { subsubsection } { \c_@@_fmt_section_tl }, { paragraph } { \c_@@_fmt_section_tl }, { subparagraph } { \c_@@_fmt_section_tl }, { toctitle } { \centering \zihao { 3 } \bfseries } } { \@@_define_fmt:nn #1 } % % \end{macrocode} % % \end{implementation} %