njuthesis.dtx

% \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}{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}
% 定义元（meta）键值对。
%    \begin{macrocode}
\keys_define:nn { nju }
  {
    bib   .meta:nn = { nju / bib   } { #1 },
    info  .meta:nn = { nju / info  } { #1 },
    style .meta:nn = { nju / style } { #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}{\njusetname,\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 { g_@@_ #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     },
    { amsmath, thmmarks } { ntheorem     },
    { 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,
    setspace,
%    \end{macrocode}
% \changes{v0.13}{2021/12/13}{使用 \pkg{ntheorem} 创建定理环境，删除
%   \pkg{amsthm} 和 \pkg{thmtools}。}
% \changes{v0.16}{2022/03/19}{不显式载入 \pkg{amsmath}。}
% 数学相关的宏包。其中，\pkg{amsmath} 必须在 \pkg{unicode-math} 前加载。
% \pkg{unicode-math} 指定了 \hologo{XeTeX} 和 \hologo{LuaTeX} 下所使用的
% 数学字体。用于配置数学环境的 \pkg{mathtools} 会与 \pkg{unicode-math}
% 发生冲突，需要手动消除其警告。
%    \begin{macrocode}
    mathtools,
    unicode-math,
    ntheorem,
%    \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_package: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_package: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_package:nnn { luatexja } { 2021/10/24 } { 20211024.0 } }
%    \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,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_supv_cont_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 \g_@@_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 \g_@@_name_type_clist    { \g_@@_info_type_int } }
\tl_set:Nx \g_@@_info_type_en_tl
  { \clist_item:Nn \g_@@_name_type_en_clist { \g_@@_info_type_int } }
\tl_put_left:Nx \g_@@_info_type_tl
  { \tl_use:c { g_@@_name_ \g_@@_info_diploma_tl _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}
% 将 ISO 格式的原始日期字符串格式化为中文日期表示，该字符串需要进行展开。
%    \begin{macrocode}
    \tl_set:Nn \g_@@_info_submitdate_tl
      {
        \exp_last_unbraced:NV
          \@@_date:www \g_@@_info_submitdate_raw_tl \q_stop
      }
%    \end{macrocode}
% 英文提交日期以及答辩日期仅用于研究生封面。
%    \begin{macrocode}
    \int_compare:nF { \g_@@_info_degree_int == 1 }
      {
        \tl_set:Nn \g_@@_info_submitdate_en_tl
          {
            \exp_last_unbraced:NV
              \@@_date_en:www \g_@@_info_submitdate_raw_tl \q_stop
          }
        \tl_set:Nn \g_@@_info_defenddate_tl
          {
            \exp_last_unbraced:NV
              \@@_date:www \g_@@_info_defenddate_raw_tl \q_stop
          }
      }
  }
%    \end{macrocode}
%
%
% \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 } }
%</class>
%    \end{macrocode}
%
%
% \subsubsection{页眉页脚}
%
% \begin{variable}{\c_@@_pagestyle_tl}
% 针对不同学位类型的默认页面样式设置。
%    \begin{macrocode}
%<definition-ug>\tl_const:Nn \c_@@_pagestyle_tl { plain    }
%<definition-g>\tl_const:Nn \c_@@_pagestyle_tl { headings }
%    \end{macrocode}
% \end{variable}
%
% 提供设置页眉页脚的用户接口。在 \cs{fancyhead} 的可选参数中，
% \opt{E} 和 \opt{O} 分别表示在偶数页（even）和奇数页（odd），
% 而 \opt{L}、\opt{R} 和 \opt{C} 则分别表示左（left）、右
% （right）和中间（center）。按照通常的排版规则，在双面模式下，
% 偶数页的中间页眉文字在左，奇数页则在右。单面模式下，左右页眉都要显示。
%    \begin{macrocode}
%<*class>
\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}
%