njuthesis.dtx

  }
%</class>
%    \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_abstract_title_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 }
  {
%<definition-ug>    content     = \@@_abs_info_ug:nn { } { ： },
%<definition-g>    content     = \@@_abs_info_g:n       { ： },
%<definition-ug>    format      = \zihao { -4 } \kaishu,
%<definition-g>    format      = \zihao {  4 } \kaishu,
    align       = l,
    bottom-skip = 1 cm
  }
%    \end{macrocode}
% \end{macro}
%
% \begin{macro}{abstract/en/title}
% 英文摘要标题实例。
%    \begin{macrocode}
\@@_declare_element:nn { abstract / en / title }
  {
    content     = \@@_abs_title:V \c_@@_name_abstract_title_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 }
  {
%<definition-ug>    content     = \@@_abs_info_ug:nn { _en } { :~ },
%<definition-g>    content     = \@@_abs_info_en_g:n        { :~ },
%<definition-ug>    format      = \zihao { -4 },
%<definition-g>    format      = \zihao {  4 },
    align       = l,
    bottom-skip = 1 cm
  }
%</(definition-ug|definition-g)>
%    \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 { l_@@_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, supv_full }
      { \@@_name:n { ##1 #1 } #2 \@@_info:n { ##1 #1 } \\ }
    \@@_name:n { abstract #1 } #2
  }
%</definition-ug>
%    \end{macrocode}
% \end{macro}
%
% \paragraph{研究生}
% \changes{v0.13}{2021/12/12}{使用 \hologo{LaTeX3} 语法重构研究生摘要。}
%
% \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}
%<*definition-g>
\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
      }
      { \l_@@_info_title_tl } { \g_@@_abs_title_left_skip }
%    \end{macrocode}
% 专业、年级、姓名。
%    \begin{macrocode}
    \@@_full_uline:NV \l_@@_tmp_dim
      {
        \@@_ulined_center_box:nn { 11 em } { \l_@@_info_major_tl }
        \c_@@_name_major_a_tl
        \@@_ulined_center_box:nn { 4  em } { \l_@@_info_grade_tl }
        \c_@@_name_grade_tl \c_@@_name_author_a_tl #1
      }
    \@@_ulined_center_box:nn { \l_@@_tmp_dim }
      { \l_@@_info_author_tl } \\
%    \end{macrocode}
% 导师姓名、职称。
%    \begin{macrocode}
    \@@_full_uline:NV \l_@@_tmp_dim
      { \c_@@_name_supv_a_tl #1 }
    \@@_ulined_center_box:nn { \l_@@_tmp_dim }
      { \l_@@_info_supv_full_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 { \l_@@_info_type_en_tl #1 }
        { \l_@@_info_title_en_tl } { \g_@@_abs_title_left_skip }
%    \end{macrocode}
% 使用循环输出专业、姓名、导师。注意这里将 |\\| 放置在前部，
% 以避免末尾生成多余的换行符产生 |Underfull \vbox| 信息。
%    \begin{macrocode}
    \clist_map_inline:nn { major, author, supv_full }
      {
        \@@_uline_entry:Nnnn \l_@@_tmp_dim
          { ##1 _en } { ##1 _en } { #1 } \par
      }
  }
%</definition-g>
%    \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_@@_tmp_tl { c_@@_name_keywords #1 _tl }
    \@@_get_text_width:NV \l_@@_tmp_dim \l_@@_tmp_tl
%    \end{macrocode}
% 关键词列表的悬挂缩进样式由 \tn{list} 环境产生。
%    \begin{macrocode}
    \list { \l_@@_tmp_tl }
      {
        \labelwidth  \l_@@_tmp_dim
        \labelsep    \c_zero_dim
        \leftmargin  \c_zero_dim
        \rightmargin \c_zero_dim
        \advance \leftmargin \l_@@_tmp_dim
%    \end{macrocode}
% 使用粗体作为标签样式。
%    \begin{macrocode}
        \cs_set_eq:NN \makelabel \textbf
      }
    \item \clist_use:cn { l_@@_info_keywords #1 _clist } { #2 }
    \endlist
  }
%</class>
%    \end{macrocode}
% \end{macro}
%
%
% \subsubsection{绘制摘要}
%
% \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  }
  }
\cs_new_protected:Npn \@@_make_abstract_en:
  {
    \UseInstance { nju } { abstract / en / title }
    \UseInstance { nju } { abstract / en / info  }
  }
%</(definition-ug|definition-g)>
%    \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 } { }
\NewDocumentEnvironment { acknowledgement } { +b }
  { \@@_chapter:V \c_@@_name_acknowledgement_tl #1 } { }
%    \end{macrocode}
% \end{environment}
% \end{environment}
%
%
% \subsection{成果列表}
%
% \begin{macro}{\njupaperlist}
% \changes{v0.10}{2021/09/29}{新增了成果列表页面。}
% \changes{v0.14}{2021/12/20}{成果列表中可突出指定作者姓名及年份。}
% 成果列表。
%    \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 } } }
    \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_@@_tmp_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_@@_tmp_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 }
%    \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 }
%</class>
%    \end{macrocode}
% \end{environment}
%
%
% \subsection{配置常量}
% \changes{v0.16}{2022/02/23}{将名称常量分离到 \file{.def} 文件。}
%
% 本节内容用于生成名称常量的默认定义，分为本科生和研究生模板两种。
%
% 由于同一名称在不同位置具有不同变体，本模板使用字母后缀名进行了区分，
% 并在易混淆处添加了注释。
%
% 通用默认名称。注意空格是忽略掉的。
%    \begin{macrocode}
%<*(definition-ug|definition-g)>
\clist_map_inline:nn
  {
    { acknowledgement } { 致\hspace{2em}谢              },
    { id              } { 学号                          },
    { notation        } { 符号表                        },
    { orig_date       } { 日期                          },
    { paperlist       } { 发表文章目录                  },
    { pdf_creator     } { LaTeX~ with~ njuthesis~ class },
    { preface         } { 前\hspace{2em}言              },
    { supv_ii         } { 第二导师                      },
    { supv_ttl        } { 职称                          }
  }
  { \@@_define_name:nn #1 }
%    \end{macrocode}
%
% 定义同时使用到中英文名称的常量。
%    \begin{macrocode}
\clist_map_inline:nn
  {
    { abstract   } { 摘要       } { ABSTRACT            },
    % 用于书签的摘要名称字样
    { abstract_a } { 中文摘要   } { ABSTRACT            },
    { appendix   } { 附录       } { appendix            },
    { dept       } { 院系       } { DEPARTMENT          },
    { figure     } { 图         } { figure              },
    { keywords   } { 关键词：   } { Keywords:~          },
    { lang       } { 中文       } { 英文                },
    { nju        } { 南京大学   } { Nanjing~ University },
    { table      } { 表         } { table               }
  }
  { \@@_define_name:nnn #1 }
%</(definition-ug|definition-g)>
%    \end{macrocode}
%
% 本科生模板默认名称。
%    \begin{macrocode}
%<*definition-ug>
\clist_map_inline:nn
  {
    % 用于摘要的作者名称字样
    { author_a    } { 本科生姓名                         },
    { grade       } { 年级                               },
    { orig_decl   }
      { \c_@@_name_nju_tl 本科毕业论文（设计）诚信承诺书 },
    { orig_sign   } { 作者签名                           },
    { sm_date     } { 提交日期                           },
    { supv        } { 导师                               },
    { title       } { 题目                               },
    { type        } { 本科生毕业论文（设计、作品）       },
    { ug          } { 本科生                             }
  }
  { \@@_define_name:nn #1 }
\clist_map_inline:nn
  {
    { abstract_title }
      {
        \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 },
    { supv_full } { 指导教师（姓名、职称） } { MENTOR         }
  }
  { \@@_define_name:nnn #1 }
%    \end{macrocode}
%
% \begin{variable}{\c_@@_orig_decl_text_tl}
% 学位论文诚信承诺书。
%    \begin{macrocode}
\tl_const:Nn \c_@@_orig_decl_text_tl
  {
    本人郑重承诺：所呈交的毕业论文（设计）（题目：）是在指导教师的指导下
    严格按照学校和院系有关规定由本人独立完成的。本毕业论文（设计）中引用
    他人观点及参考资源的内容均已标注引用，如出现侵犯他人知识产权的行为，
    由本人承担相应法律责任。本人承诺不存在抄袭、伪造、篡改、代写、买卖毕
    业论文（设计）等违纪行为。
  }
%</definition-ug>
%    \end{macrocode}
% \end{variable}
%
% 研究生模板默认名称。
%    \begin{macrocode}
%<*definition-g>
\clist_map_inline:nn
  {
    % 用于摘要的作者名称字样
    { author_a     }
      { \tl_item:Nn \l_@@_info_degree_tl { 1 } 士生姓名 },
    { chairman     } { 答辩委员会主席：                 },
    { clc          } { 分类号                           },
    { confer       } { 学位授予单位和日期               },
    { df_date      } { 论文答辩日期                     },
    { degree       } { 申请学位级别                     },
    { apply        }
      { （申请 \l_@@_info_degree_tl 学位）              },
    { field        } { 研究方向                         },
    { g            } { 研究生                           },
    { grade        } { 级                               },
    % 用于摘要的专业名称字样
    { major_a      } { 专业                             },
    % 用于国家图书馆封面的专业名称字样
    { major_b      } { 专业名称                         },
    { orig_decl    }
      { \c_@@_name_nju_tl 学位论文原创性声明            },
    { orig_sign    } { 研究生签名                       },
    { reviewer     } { 评阅人：                         },
    { seclv        } { 密级                             },
    { sign         } { （签字）                         },
    { sm_date      } { 论文提交日期                     },
    { supv         } { 导师                             },
    % 用于摘要的导师名称字样
    { supv_a       } { 指导教师（姓名、职称）           },
    { supv_info    }
      { 指导教师姓名、职务、职称、学位、单位名称及地址  },
    % 用于普通封面的标题名称字样
    { title        } { 论文题目                         },
    % 用于摘要的标题名称字样
    { title_a      } { 题目                             },
    % 用于国家图书馆封面的标题名称字样
    { title_b      } { （题名和副题名）                },
    { udc          } { U D C                           }
  }
  { \@@_define_name:nn #1 }
\clist_map_inline:nn
  {
    { abstract_title }
      { 南京大学 \l_@@_info_type_tl 中文摘要首页用纸 }
      { 南京大学 \l_@@_info_type_tl 英文摘要首页用纸 },
    { author    } { 作者姓名 } { POSTGRADUATE        },
    { major     } { 专业方向 } { SPECIALIZATION      },
    { supv_full } { 指导教师 } { MENTOR              }
  }
  { \@@_define_name:nnn #1 }
%    \end{macrocode}
%
% \begin{variable}{\c_@@_cover_en_text_tl}
% 英文封面字样。
%    \begin{macrocode}
\tl_const:Nn \c_@@_cover_en_text_tl
  {
    A~ dissertation~ submitted~ to \\
    the~ graduate~ school~ of~ Nanjing~ University \\
    in~ partial~ fulfilment~ of~ the~ requirements~ for~ the~ degree~ of
  }
%    \end{macrocode}
% \end{variable}
%
% \begin{variable}{\c_@@_orig_decl_text_tl}
% 学位论文原创性声明。
%    \begin{macrocode}
\tl_const:Nn \c_@@_orig_decl_text_tl
  {
    本人郑重声明，所提交的学位论文是本人在导师指导下独立进行科学研究工作
    所取得的成果。除本论文中已经注明引用的内容外，本论文不包含其他个人或
    集体已经发表或撰写过的研究成果，也不包含为获得南京大学或其他教育机构
    的学位证书而使用过的材料。对本文的研究做出重要贡献的个人和集体，均已
    在论文的致谢部分明确标明。本人郑重申明愿承担本声明的法律责任。
  }
%</definition-g>
%    \end{macrocode}
% \end{variable}
%
% 默认定理类型和头名称。
%    \begin{macrocode}
%<*(definition-ug|definition-g)>
\clist_map_inline:nn
  {
    { axiom      } { 公理 } { Axiom      },
    { corollary  } { 推论 } { Corollary  },
    { definition } { 定义 } { Definition },
    { example    } { 例   } { Example    },
    { lemma      } { 引理 } { Lemma      },
    { proof      } { 证明 } { Proof      },
    { theorem    } { 定理 } { Theorem    }
  }
  { \@@_add_theorem_type:nnn #1 }
%</(definition-ug|definition-g)>
%    \end{macrocode}
%
% \end{implementation}
%