.editorconfig

@@ -7,5 +7,5 @@ charset = utf-8
 end_of_line = lf
 indent_style = space
 
-[*.{dtx,tex,bib}]
+[*.{dtx,tex,bib,def}]
 indent_size = 2

.github/ISSUE_TEMPLATE/1-bug_report.yaml

@@ -12,17 +12,17 @@ body:
     attributes:
       label: 先决条件
       options:
-        - label: |
+        - label: |-
             我已尝试更新[模板版本](https://github.com/nju-lug/NJUThesis/blob/master/CHANGELOG.md)
           required: true
-        - label: |
+        - label: |-
             我已检索[模板手册](http://mirrors.ctan.org/macros/unicodetex/latex/njuthesis/njuthesis.pdf)
           required: true
-        - label: |
+        - label: |-
             我已检索[项目 wiki](https://github.com/nju-lug/NJUThesis/wiki)
           required: true
-        - label: |
-            我已确认这个问题没有在[其他 issues](https://github.com/tuna/issues/issues) 中提出过。
+        - label: |-
+            我已确认这个问题没有在[其他 issues](https://github.com/nju-lug/NJUThesis/issues) 中提出过。
           required: true
   - type: textarea
     id: expected_behavior
@@ -51,6 +51,23 @@ body:
       render: TeX
     validations:
       required: true
+  - type: input
+    id: njuthesis_version
+    attributes:
+      label: njuthesis 模板版本
+      placeholder: v1.0.0
+      description: 模板版本可以在 `.log` 文件中搜索 `njuthesis` 得到。
+    validations:
+      required: true
+  - type: dropdown
+    id: source
+    attributes:
+      label: 模板获取途径
+      options:
+        - <https://tex.nju.edu.cn>
+        - 使用包管理器从 CTAN 安装
+        - 通过 GitHub Releases 或镜像站下载
+        - 从 Git 仓库下载
   - type: dropdown
     id: operating_system
     attributes:
@@ -59,41 +76,18 @@ body:
         - Windows
         - macOS
         - Linux
-  - type: dropdown
+  - type: input
     id: tex_distribution
     attributes:
       label: TeX 发行版
-      options:
-        - TeX Live 2021
-        - MiKTeX 21
+      placeholder: TeX Live 2022 / MiKTeX 22.1
   - type: dropdown
     id: compiler
     attributes:
-      label: 编译引擎
+      label: 编译程序
       options:
         - XeLaTeX
         - LuaLaTeX
-  - type: dropdown
-    id: njuthesis_version
-    attributes:
-      label: njuthesis 模板版本
-      description: 模版版本可以在 `.log` 文件中搜索 `njuthesis` 得到。
-      options:
-        - 0.14.0
-        - 0.13.0
-        - 0.12.0
-        - 快更新吧
-    validations:
-      required: true
-  - type: dropdown
-    id: source
-    attributes:
-      label: 模板获取途径
-      options:
-        - <https://tex.nju.edu.cn>
-        - 使用包管理器从 CTAN 安装
-        - 通过 GitHub Releases 或镜像站下载
-        - 从 Git 仓库下载
   - type: textarea
     id: more_info
     attributes:

.github/ISSUE_TEMPLATE/2-feat_request.yaml

@@ -8,16 +8,16 @@ body:
     attributes:
       label: 先决条件
       options:
-        - label: |
+        - label: |-
             我已尝试更新模板版本
           required: true
-        - label: |
+        - label: |-
             我已检索[模板手册](http://mirrors.ctan.org/macros/unicodetex/latex/njuthesis/njuthesis.pdf)
           required: true
-        - label: |
+        - label: |-
             我已检索[项目 wiki](https://github.com/nju-lug/NJUThesis/wiki)
           required: true
-        - label: |
+        - label: |-
             我已确认这个请求没有在[其他 issues](https://github.com/tuna/issues/issues)中提出过。
           required: true
   - type: textarea

.github/workflows/build.yml

@@ -11,7 +11,7 @@ on:
 
 env:
   CTAN_URL: https://mirrors.rit.edu/CTAN
-  TL_PACKAGES: alphalph auxhook background biber biblatex biblatex-gb7714-2015 blindtext booktabs caption cleveref cm-unicode csquotes ctex dashundergaps emptypage enumitem fancyhdr fancyvrb fandol footmisc hologo hycolor hypdoc hyperref l3build latexmk libertinus-fonts listings lua-ul lualatex-math luatex85 makecell makeindex mathtools newcomputermodern ninecolors njuvisual ntheorem pict2e preview psnfss setspace siunitx standalone symbol tex-gyre tex-gyre-math threeparttable translator underscore unicode-math xits xstring zhlipsum zref
+  PACKAGES: latexmk cleveref enumitem footmisc tex-gyre xits biblatex-gb7714-2015 biber
 
 jobs:
   build-on-ubuntu:
@@ -22,7 +22,7 @@ jobs:
         export PATH=/tmp/texlive/bin/x86_64-linux:$PATH
     steps:
       - name: Set up Git repository
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Install TeX Live
         run: |
@@ -30,32 +30,34 @@ jobs:
           wget ${{ env.CTAN_URL }}/systems/texlive/tlnet/install-tl-unx.tar.gz
           tar -xzf install-tl-unx.tar.gz
           cd install-tl-20* && ./install-tl --profile ../.github/workflows/texlive.profile
-          tlmgr install ${{ env.TL_PACKAGES }}
-          tlmgr update --self --all --no-auto-install --repository=${{ env.CTAN_URL }}/systems/texlive/tlnet/
 
       - name: Install latest njuthesis
         run: |
           ${{ env.SET_PATH }}
+          tlmgr option repository ${{ env.CTAN_URL }}/systems/texlive/tlnet/
+          tlmgr install xetex l3build
           l3build install
+          cd scripts
+          bash download.sh ${{ env.CTAN_URL }}
+          cd data
+          wget https://raw.githubusercontent.com/stone-zeng/tl-depend-analysis/data/data/tl-depend.json
+          cd ..
+          python3 main.py --pkg "${{ env.PACKAGES }}" --exclude "njuthesis-doc.cls"
+          tlmgr update --self --all --no-auto-install
 
       - name: Compile test file
         run: |
           ${{ env.SET_PATH }}
           cd test
-          xelatex  -halt-on-error -jobname=test-xetex-undergraduate    "\documentclass[decl-page,oneside]{njuthesis}               \input{test.tex}"
-          biber                            test-xetex-undergraduate
-          xelatex  -halt-on-error -jobname=test-xetex-undergraduate    "\documentclass[decl-page,oneside]{njuthesis}               \input{test.tex}"
-          xelatex  -halt-on-error -jobname=test-xetex-undergraduate    "\documentclass[decl-page,oneside]{njuthesis}               \input{test.tex}"
-          xelatex  -halt-on-error -jobname=test-xetex-graduate         "\documentclass[degree=mg,decl-page]{njuthesis}             \input{test.tex}"
-          xelatex  -halt-on-error -jobname=test-xetex-graduate-nlcover "\documentclass[degree=phd,nlcover]{njuthesis}              \input{test.tex}"
-          lualatex -halt-on-error -jobname=test-luatex                 "\documentclass{njuthesis} \njusetup{bib/style=author-year} \input{test.tex}"
-          biber                            test-luatex
-          lualatex -halt-on-error -jobname=test-luatex                 "\documentclass{njuthesis} \njusetup{bib/style=author-year} \input{test.tex}"
-          lualatex -halt-on-error -jobname=test-luatex                 "\documentclass{njuthesis} \njusetup{bib/style=author-year} \input{test.tex}"
-
-      - name: Upload PDF
-        uses: actions/upload-artifact@v2
+          latexmk -xelatex  -halt-on-error test-xetex-undergraduate
+          xelatex           -halt-on-error test-xetex-graduate
+          xelatex           -halt-on-error test-xetex-graduate-nlcover
+          # latexmk -lualatex -halt-on-error test-luatex
+
+      - name: Upload CLS Files
+        uses: actions/upload-artifact@v4
         with:
-          name: generated-pdf
-          path:
-            test/*.pdf
+          name: "njuthesis-cls-${{ github.sha }}"
+          path: |
+            build/unpacked/njuthesis.cls
+            build/unpacked/*.def

.github/workflows/release.yml

 name: Release
 
-on: 
+on:
   push:
     branches:
       - master
@@ -8,13 +8,9 @@ on:
     tags:
       - v*
 
-  pull_request:
-    branches:
-      - master
-
 env:
   CTAN_URL: https://mirrors.rit.edu/CTAN
-  TL_PACKAGES: alphalph auxhook background biber biblatex biblatex-gb7714-2015 bibtex booktabs caption cm-unicode colortbl csquotes ctex dashundergaps diagbox enumitem everypage fancyhdr fancyvrb fandol footmisc gbt7714 hologo hycolor hypdoc hyperref l3build latexmk libertinus-fonts listings lm-math makecell makeindex microtype multirow natbib ninecolors njuvisual pict2e preview psnfss setspace siunitx symbol tabularray tex-gyre tex-gyre-math threeparttable translator underscore unicode-math url xits xstring zref
+  PACKAGES: cm-unicode tex-gyre tex-gyre-math lexend xits natbib makeindex
 
 jobs:
   release:
@@ -25,7 +21,7 @@ jobs:
         export PATH=/tmp/texlive/bin/x86_64-linux:$PATH
     steps:
       - name: Set up Git repository
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Set Version
         run: echo "VERSION=${GITHUB_REF##*/}" >> $GITHUB_ENV
@@ -36,13 +32,43 @@ jobs:
           wget ${{ env.CTAN_URL }}/systems/texlive/tlnet/install-tl-unx.tar.gz
           tar -xzf install-tl-unx.tar.gz
           cd install-tl-20* && ./install-tl --profile ../.github/workflows/texlive.profile
-          tlmgr install ${{ env.TL_PACKAGES }}
-          tlmgr update --self --all --no-auto-install --repository=${{ env.CTAN_URL }}/systems/texlive/tlnet/
-      
-      - name: Download njuvisual package
+
+      - name: Install latest njuthesis
+        run: |
+          ${{ env.SET_PATH }}
+          tlmgr option repository ${{ env.CTAN_URL }}/systems/texlive/tlnet/
+          tlmgr install xetex l3build
+          l3build install
+          cd scripts
+          bash download.sh ${{ env.CTAN_URL }}
+          cd data
+          wget https://raw.githubusercontent.com/stone-zeng/tl-depend-analysis/data/data/tl-depend.json
+          cd ..
+          python3 main.py --pkg "${{ env.PACKAGES }}" --exclude "njuthesis.cls"
+          tlmgr update --self --all --no-auto-install
+
+      - name: Install latest ctex
+        run: |
+          ${{ env.SET_PATH }}
+          git clone https://github.com/CTeX-org/ctex-kit.git
+          cd ctex-kit/ctex
+          l3build install
+
+      - name: Install fonts
         run: |
-          wget ${{ env.CTAN_URL }}/macros/latex/contrib/njuvisual/njuvisual.dtx
-          wget ${{ env.CTAN_URL }}/macros/latex/contrib/njuvisual/njuvisual-curves.dtx
+          mkdir fonts
+          wget https://github.com/adobe-fonts/source-han-serif/raw/release/OTF/SimplifiedChinese/SourceHanSerifSC-SemiBold.otf
+          wget https://github.com/adobe-fonts/source-han-serif/raw/release/OTF/SimplifiedChinese/SourceHanSerifSC-Bold.otf
+          wget https://github.com/adobe-fonts/source-han-serif/raw/release/OTF/SimplifiedChinese/SourceHanSerifSC-Heavy.otf
+          wget https://github.com/be5invis/Iosevka/releases/download/v15.6.3/ttf-iosevka-15.6.3.zip
+          unzip ttf-iosevka-15.6.3.zip
+          cp *.otf                   /usr/share/fonts/
+          cp iosevka-lightitalic.ttf /usr/share/fonts/
+          cp iosevka-light.ttf       /usr/share/fonts/
+          cp iosevka-semibold.ttf    /usr/share/fonts/
+          chmod -x /usr/share/fonts/*.otf
+          chmod -x /usr/share/fonts/*.ttf
+          fc-cache -fv
 
       - name: Zip CTAN package
         run: |
@@ -51,20 +77,17 @@ jobs:
           mv njuthesis-ctan.zip njuthesis-ctan-$VERSION.zip
           mv njuthesis.pdf njuthesis-$VERSION.pdf
 
-      - name: Zip RELEASE package
+      - name: Zip USER package
         run: |
           ${{ env.SET_PATH }}
-          xetex njuvisual.dtx
           mv docs/* .
-          mv scripts/* .
-          mv build/unpacked/njuthesis.cls .
-          pdflatex --shell-escape "generate-img.tex"
-          zip -r njuthesis-user-$VERSION.zip njuthesis-sample.tex njuthesis-sample.bib njuthesis.cls njuvisual.sty nju-emblem.pdf nju-name.pdf LICENSE README.md
+          mv build/unpacked/* .
+          zip -r njuthesis-user-$VERSION.zip *.def njuthesis-sample* njuthesis.cls nju-*.pdf LICENSE CHANGELOG.md README.md
 
       - uses: "marvinpinto/action-automatic-releases@latest"
         with:
           repo_token: "${{ secrets.GITHUB_TOKEN }}"
-          prerelease: false
+          prerelease: true
           files: |
             njuthesis-v*.pdf
             njuthesis-user-v*.zip

.gitignore

@@ -14,12 +14,18 @@
 
 ## DocStrip generated file
 *.cls
-*.sty
+*.def
 *.ins
+*.sty
+!docs/njuthesis-setup.def
 
 ## Zip file
 *.zip
 
+## Fonts
+*.ttf
+*.otf
+
 ## Intermediate documents:
 *.hd
 *.dvi
@@ -29,15 +35,18 @@
 # these rules might exclude image files for figures etc.
 # *.ps
 # *.eps
-*.pdf
+njuthesis*.pdf
+test*.pdf
 
 # Folders
 build/
 release/
 support/
+scripts/data
 TDS/
 temp/
 mythesis/
+__pycache__/
 
 ## Bibliography auxiliary files (bibtex/biblatex/biber):
 *.bbl

CHANGELOG.md

@@ -6,6 +6,373 @@
 
 ## [未发布]
 
+### 新增
+
+- 增加 cleveref 的复数引用名称 - [#266]
+
+### 修复
+
+- 修复 macoffice 选项下无法自动加载华文中宋问题 - [#269]
+  - 感谢 [@liudongmiao]！
+- 提供新版 LaTeX2e 下兼容 cleveref 的补丁 - [#263]
+
+### 杂项
+
+- 手册匹配 `codehigh` 更新 - [lvjr/codehigh#12]
+
+## [1.4.2] - 2024-11-08
+
+### 新增
+
+- 图表标题区分单行多行设置
+- 软性规定标题和图表本身的位置关系 -[#253]
+
+### 修复
+
+- 修复 `macoffice` 配置的变量命名问题
+
+### 变动
+
+- `tableofcontents/toc-entry` 不再会影响插图清单和表格清单 -[#245]
+
+## [1.4.1] - 2024-04-22
+
+### 新增
+
+- 匹配新版盲审模板 - [#185]
+  - 作者和导师姓名用占位符代替
+  - 默认显示学校信息
+  - 恢复显示摘要页的年级
+  - 成果列表中仅显示期刊和年份
+  - `anonymous` 选项不接受输入值
+- 盲审模式可选择是否隐藏学校信息 - [#251]
+  - 新增 `anonymous-mode/no-nju` 选项
+
+### 修复
+
+- 修复成果列表中文姓名加粗的问题 - [#192]
+- 修复 LuaLaTeX 下华文中宋的载入问题
+- 修复 LuaLaTeX 下的摘要页多余换行 - [#248]
+
+## [1.4.0] - 2024-03-19
+
+### 新增
+
+- 增加 `macoffice` 字体配置 - [#164],[#169]
+  - 感谢 [@liudongmiao]！
+
+### 修复
+
+- 修复定理类环境在共享计数器时的 `cleveref` 引用名问题 - [#234]
+- 将部分 `hyperref` 默认设置项放在导言区前以便用户覆盖
+- 修正 `tabularray` 默认标题间距
+- 修复本科生诚信承诺书的换行问题
+- 修复导师名和职称之间没有空格的问题 - [#243]
+- 使用正确的变量类型 - [#240],[#243]
+  - 感谢 [@muzimuzhi]！
+- 匹配 l3doc 的修改 - [CTeX-org/ctex-kit#700], [CTeX-org/ctex-kit#703]
+- `draft` 选项不接受输入值
+
+### 杂项
+
+- 跟进 2024 届本科毕业论文规定
+- 美化 issue template 样式 - [#241]
+  - 感谢 [@muzimuzhi]！
+
+## [1.3.2] - 2023-12-05
+
+### 变动
+
+- 调整专业型学位封面的 `info/major` 项填写逻辑 - [#232]
+  - 感谢 [@liudongmiao]！
+
+### 修复
+
+- 修复双导师命令问题 - [#230]
+
+## [1.3.1] - 2023-11-14
+
+### 新增
+
+- 整合表格环境字体设置 - [#94]
+- 可以手动指定华文中宋文件位置 - [#229]
+- 匹配 LaTeX3 的 e 型展开修改 - [CTeX-org/ctex-kit#678]
+
+### 修复
+
+- 修复英文标题超长引发的页面元素混乱 - [#217]
+- 修复英文标题手动换行与摘要页的冲突 - [#227]
+
+### 杂项
+
+- 将 CI 上传的 PDF 更换为模板格式文件
+
+## [1.3.0] - 2023-06-06
+
+### 新增
+
+- 新增定理类环境共享计数器选项 `theorem/share-counter` - [#207]
+- 自动补全研究生专业型学位封面上的专业信息 - [#208]
+  - 增加 `info/major` 定义方式
+
+### 修复
+
+- 修复批量创建环境时缺少 `\crefname` 的问题 - [#206]
+- 修复禁用 `unicode-math` 时仍会配置数学字体的问题 - [#216]
+- 修复非研究生类型时调用 `nl-cover` 选项的错误
+- 将本科生封面信息恢复至 v1.1 的宋体格式
+- 修复研究生出版授权书的打勾机制 - [#223]
+
+### 杂项
+
+- 手册源码部分添加语法高亮
+- 手册样式设置拆分为单独的 `njuthesis-doc.cls`
+- 默认密级信息修改为“公开” - [#213]
+- 使用 [`tl-depend-analysis`] 重构 CI 脚本
+  - 感谢 [@stone-zeng]！
+
+## [1.2.1] - 2023-05-03
+
+### 修复
+
+- 修复国家图书馆封面学位丢失的学位名称 - [#204]
+  - 新增研究生中文学位名称选项 `info/degree` - [#200]
+- 修复研究生封面上学号下划线长度不足的问题
+
+### 杂项
+
+- 提供紫色版本的校名校徽图片
+
+## [1.2.0] - 2023-05-02
+
+### 新增
+
+- 跟进 2023 年研究生学位论文模板新设计 - [#204]
+- 新增研究生英文学位名称选项 `info/degree*` - [#200]
+- 新增研究生英文摘要条目内容下划线选项 `abstract/underline` - [#202]
+
+### 修复
+
+- 更正本科生模板封面和承诺书样式
+- 盲审模式下隐藏年级和学校名称 - [#181]
+- 修复章末参考文献表与成果列表的冲突问题 - [#191]
+
+## [1.1.2] - 2023-01-15
+
+### 修复
+
+- 补回研究生英文摘要页的下划线 - [#166]
+- 修复研究生封面上第二导师的显示问题 - [#172]
+- 修复 `\njusetname` 的可选参数问题
+
+### 变动
+
+- 本科生模板封面校徽居中 - [#173]
+
+### 杂项
+
+- 跟进 2023 届本科毕业论文规定
+- 跟进新版南大 TeX 网站
+
+## [1.1.1] - 2022-12-04
+
+### 修复
+
+- 修复研究生封面上导师信息的居中问题 - [#165]
+- 修复 macOS 下 Times New Roman 字体缺失字型的问题 - [#169]
+  - 感谢 [@AlphaZTX]！
+- 修复国家图书馆封面的编译死循环问题 - [#170]
+
+### 杂项
+
+- 手册中暂时撤去关于南大 TeX 网站的内容
+
+## [1.1.0] - 2022-10-23
+
+### 新增
+
+- 盲审模式下不显示致谢
+- 新增脚注圈码选项 `footnote/circled` 和 `footnote/circled*` - [#129]
+- 新增脚注的悬挂缩进选项 `hang` - [#129]
+
+### 修复
+
+- 修复国家图书馆封面的编译错误
+- 修复研究生英文封面的学位信息
+- 更正盲审模式隐藏的个人信息类别
+- 修复 `\le` 和 `\ge` 的定义
+
+### 变动
+
+- 脚注默认进行悬挂缩进
+
+### 杂项
+
+- 手册中以黄色突出选项
+
+## [1.0.0] - 2022-08-07
+
+### 新增
+
+- 新增博士后出站报告模板
+- 新增数学字体选项 `math-font`
+- 新增默认字号选项 `zihao`
+- 新增行距选项 `linespread`
+- 新增最小化模式选项 `minimal`
+- 新增禁用若干内置宏包的选项
+- `\njusetup` 提供更多选项输入模式
+- 可为目录中的章标题添加引导线 - [#66]
+- 新增编号连接符设置 `label-sep` - [#134]
+- 适配 `tabularray` 的表格样式设置 - [#134]
+- 新增一系列数学符号选项 `math` - [#142]
+- 可使用 `\njusetlength` 修改下划线的宽度和偏移 - [#155]
+- 可使用 `\njusetformat` 修改本科摘要标签格式 - [#155]
+- 为页面对象添加书签属性
+
+### 修复
+
+- 修正元素对象的底部间距设置
+
+### 变动
+
+- 调整 `type` 和 `degree` 文档类选项的定义 - [#117]
+- 移除毕业设计封面
+- `nlcover` 选项更名为 `nl-cover`
+- `blind` 选项更名为 `anonymous`
+- 调整定理类环境选项 `theorem`
+- 摘要、目录、页眉页脚设置项更名
+- 调整研究生模板的封面布局 - [#144]
+- 移除研究生英文摘要的下划线
+- 移除内置的 `mathtools`
+- 内部变量与函数重新命名
+
+### 杂项
+
+- 删除手册中的基础教学内容
+- 在手册中以不同颜色指示不同模块
+
+## [0.20.0] - 2022-06-10
+
+### 新增
+
+- 日期设置项可以通过留空生成空白的年月日字样 - [#150]
+- 自动处理大于四的评审委员会人数 - [#150]
+- 可使用 `\njusetformat` 修改页眉页脚样式
+- 可使用 `\njusetformat` 修改内置校名校徽颜色
+
+### 修复
+
+- 修复 0.19.0 版本中错误的研究生英文封面日期
+- 修复 0.19.0 版本中错误的本科生目录条目样式
+- 修复英文关键词列表不整齐的缩进间距
+- 更正本科模板部分字样
+
+## [0.19.0] - 2022-05-23
+
+### 新增
+
+- 可使用 `\njusetformat` 修改默认页面样式
+- 对封面上的超宽文字进行压缩
+  - 支持专硕封面的特殊标签格式 - [#147]
+- 跟进新版本科生诚信承诺书样式
+- 国家图书馆样式更新
+  - 添加学位授予日期设置项 `info/confer-date` - [#150]
+  - 添加底部日期设置项 `info/bottom-date`
+
+### 修复
+
+- 图表标题使用粗体 -[#139]
+- 修复成果列表与章末参考文献表的冲突 -[#148]
+
+### 变动
+
+- 将国家图书馆封面的标题字样修改为“学位论文”
+- 将国家图书馆封面的评审委员会人数分离为单独参数
+- 更正研究生模板普通封面上学硕和专硕不同的专业名称字样
+
+### 杂项
+- 修正文档笔误 - [#137]
+  - 感谢 [@note286]！
+
+## [0.18.0] - 2022-05-01
+
+### 新增
+
+- 新增内置定理环境的若干设置项 - [#50]
+- 新增脚注设置项 - [#129]
+  - 编号可使用带圈数字
+- 新增盲审模式 - [#130]
+
+### 修复
+
+- 正确生成出版授权书前后的空白页
+- 删除出版授权书页的页眉 - [#130]
+- 出版授权书内双导师姓名之间添加空格 - [#130]
+- 设置4、5级标题的样式
+
+### 变动
+
+- 微调校名校徽尺寸
+
+### 杂项
+
+- 说明手册中补充数学符号格式说明
+
+## [0.17.0] - 2022-04-09
+
+### 新增
+
+- 提供修改固定文本的接口 - [#111]
+- 提供修改长度值的接口 - [#121]
+- 提供修改默认样式的接口
+- 提供研究生的学位论文出版授权书 - [#116]
+
+### 优化
+
+- 优化封面标题的断行方式 - [#121]
+- PDF 书签中不显示额外空格
+
+### 杂项
+
+- 说明手册中补充扫描声明页的插入方法 - [#96]
+- 说明手册中增加“额外定制”一节
+- 说明手册中补充页眉说明 - [#119]
+- 说明手册跟进 TeX Live 2022
+
+## [0.16.1] - 2022-03-27
+
+### 修复
+
+- 修复国家图书馆封面的“UDC”名称格式
+- 修复研究生摘要标题的断行问题 - [#98], [#105], [#107]
+  - 提供 `style/abstract-title` 设置项
+- 为研究生摘要补上“摘要”小标题字样 - [#99]
+
+## [0.16.0] - 2022-03-19
+
+### 新增
+
+- 将本科生和研究生模板定义分离为单独的 `.def` 文件 - [#46]
+- 可以手动指定页眉页脚 - [#85]
+  - 新增 `style/header` 等若干设置项
+
+### 修复
+
+- 研究生模板的目录、摘要等页面也显示页眉 - [#99]
+
+### 变动
+
+- 取消对 `njuvisual` 宏包的强制依赖
+  - 简化自动安装脚本
+
+### 杂项
+
+- 说明手册中增加对 JabRef 软件的简介
+  - 感谢 [@zhoujian9410]！
+- 说明手册中增加数学字体样式说明 - [#89], [#92]
+  - 感谢 [@zepinglee]！
+- 说明手册中增加宏包依赖信息
+
 ## [0.15.0] - 2022-02-20
 
 ### 新增
@@ -231,33 +598,125 @@
 - 模板上传至 CTAN
 
 
-[unreleased]: https://github.com/nju-lug/NJUThesis/compare/v0.15.0...HEAD
-[0.15.0]: https://github.com/nju-lug/NJUThesis/releases/tag/v0.15.0
-[0.14.0]: https://github.com/nju-lug/NJUThesis/releases/tag/v0.14.0
-[0.13.1]: https://github.com/nju-lug/NJUThesis/releases/tag/v0.13.1
-[0.13.0]: https://github.com/nju-lug/NJUThesis/releases/tag/v0.13.0
-[0.12.0]: https://github.com/nju-lug/NJUThesis/releases/tag/v0.12.0
-[0.11.3]: https://github.com/nju-lug/NJUThesis/releases/tag/v0.11.3
-[0.11.0]: https://github.com/nju-lug/NJUThesis/releases/tag/v0.11.0
-[0.10.0]: https://github.com/nju-lug/NJUThesis/releases/tag/v0.10.0
-[0.9.0]: https://github.com/nju-lug/NJUThesis/releases/tag/v0.9.0
-[0.8.4]: https://github.com/nju-lug/NJUThesis/releases/tag/v0.8.4
-
-[#14]: https://github.com/nju-lug/NJUThesis/issues/14
-[#44]: https://github.com/nju-lug/NJUThesis/issues/44
-[#46]: https://github.com/nju-lug/NJUThesis/issues/46
-[#52]: https://github.com/nju-lug/NJUThesis/issues/52
-[#60]: https://github.com/nju-lug/NJUThesis/issues/60
-[#61]: https://github.com/nju-lug/NJUThesis/issues/61
-[#64]: https://github.com/nju-lug/NJUThesis/issues/64
-[#66]: https://github.com/nju-lug/NJUThesis/issues/66
-[#71]: https://github.com/nju-lug/NJUThesis/discussions/71
-[#79]: https://github.com/nju-lug/NJUThesis/issues/79
+[未发布]: https://github.com/nju-lug/NJUThesis/compare/v1.4.2...HEAD
+
+[1.4.2]: https://github.com/nju-lug/NJUThesis/compare/v1.4.1...v1.4.2
+[1.4.1]: https://github.com/nju-lug/NJUThesis/compare/v1.4.0...v1.4.1
+[1.4.0]: https://github.com/nju-lug/NJUThesis/compare/v1.3.2...v1.4.0
+[1.3.2]: https://github.com/nju-lug/NJUThesis/compare/v1.3.1...v1.3.2
+[1.3.1]: https://github.com/nju-lug/NJUThesis/compare/v1.3.0...v1.3.1
+[1.3.0]: https://github.com/nju-lug/NJUThesis/compare/v1.2.1...v1.3.0
+[1.2.1]: https://github.com/nju-lug/NJUThesis/compare/v1.2.0...v1.2.1
+[1.2.0]: https://github.com/nju-lug/NJUThesis/compare/v1.1.2...v1.2.0
+[1.1.2]: https://github.com/nju-lug/NJUThesis/compare/v1.1.1...v1.1.2
+[1.1.1]: https://github.com/nju-lug/NJUThesis/compare/v1.1.0...v1.1.1
+[1.1.0]: https://github.com/nju-lug/NJUThesis/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/nju-lug/NJUThesis/compare/v0.20.0...v1.0.0
+
+[0.20.0]: https://github.com/nju-lug/NJUThesis/compare/v0.19.0...v0.20.0
+[0.19.0]: https://github.com/nju-lug/NJUThesis/compare/v0.18.0...v0.19.0
+[0.18.0]: https://github.com/nju-lug/NJUThesis/compare/v0.17.0...v0.18.0
+[0.17.0]: https://github.com/nju-lug/NJUThesis/compare/v0.16.0...v0.17.0
+[0.16.1]: https://github.com/nju-lug/NJUThesis/compare/v0.16.0...v0.16.1
+[0.16.0]: https://github.com/nju-lug/NJUThesis/compare/v0.15.0...v0.16.0
+[0.15.0]: https://github.com/nju-lug/NJUThesis/compare/v0.14.0...v0.15.0
+[0.14.0]: https://github.com/nju-lug/NJUThesis/compare/v0.13.1...v0.14.0
+[0.13.1]: https://github.com/nju-lug/NJUThesis/compare/v0.13.0...v0.13.1
+[0.13.0]: https://github.com/nju-lug/NJUThesis/compare/v0.12.0...v0.13.0
+[0.12.0]: https://github.com/nju-lug/NJUThesis/compare/v0.11.3...v0.12.0
+[0.11.3]: https://github.com/nju-lug/NJUThesis/compare/v0.11.0...v0.11.3
+[0.11.0]: https://github.com/nju-lug/NJUThesis/compare/v0.10.0...v0.11.0
+[0.10.0]: https://github.com/nju-lug/NJUThesis/compare/v0.9.0...v0.10.0
+[0.9.0]:  https://github.com/nju-lug/NJUThesis/compare/v0.8.4...v0.9.0
+[0.8.4]:  https://github.com/nju-lug/NJUThesis/compare/v0.3.0...v0.8.4
+
+[#14]:  https://github.com/nju-lug/NJUThesis/issues/14
+[#44]:  https://github.com/nju-lug/NJUThesis/issues/44
+[#46]:  https://github.com/nju-lug/NJUThesis/issues/46
+[#50]:  https://github.com/nju-lug/NJUThesis/issues/50
+[#52]:  https://github.com/nju-lug/NJUThesis/issues/52
+[#60]:  https://github.com/nju-lug/NJUThesis/issues/60
+[#61]:  https://github.com/nju-lug/NJUThesis/issues/61
+[#64]:  https://github.com/nju-lug/NJUThesis/issues/64
+[#66]:  https://github.com/nju-lug/NJUThesis/issues/66
+[#71]:  https://github.com/nju-lug/NJUThesis/discussions/71
+[#79]:  https://github.com/nju-lug/NJUThesis/issues/79
+[#85]:  https://github.com/nju-lug/NJUThesis/discussions/85
+[#89]:  https://github.com/nju-lug/NJUThesis/discussions/89
+[#92]:  https://github.com/nju-lug/NJUThesis/issues/92
+[#94]:  https://github.com/nju-lug/NJUThesis/discussions/94
+[#96]:  https://github.com/nju-lug/NJUThesis/issues/96
+[#98]:  https://github.com/nju-lug/NJUThesis/issues/98
+[#99]:  https://github.com/nju-lug/NJUThesis/discussions/99
+[#105]: https://github.com/nju-lug/NJUThesis/discussions/105
+[#107]: https://github.com/nju-lug/NJUThesis/issues/107
+[#111]: https://github.com/nju-lug/NJUThesis/issues/111
+[#116]: https://github.com/nju-lug/NJUThesis/issues/116
+[#117]: https://github.com/nju-lug/NJUThesis/issues/117
+[#119]: https://github.com/nju-lug/NJUThesis/issues/119
+[#121]: https://github.com/nju-lug/NJUThesis/issues/121
+[#129]: https://github.com/nju-lug/NJUThesis/issues/129
+[#130]: https://github.com/nju-lug/NJUThesis/issues/130
+[#131]: https://github.com/nju-lug/NJUThesis/issues/131
+[#134]: https://github.com/nju-lug/NJUThesis/discussions/134
+[#137]: https://github.com/nju-lug/NJUThesis/issues/137
+[#139]: https://github.com/nju-lug/NJUThesis/discussions/139
+[#142]: https://github.com/nju-lug/NJUThesis/issues/142
+[#144]: https://github.com/nju-lug/NJUThesis/issues/144
+[#147]: https://github.com/nju-lug/NJUThesis/discussions/147
+[#148]: https://github.com/nju-lug/NJUThesis/issues/148
+[#150]: https://github.com/nju-lug/NJUThesis/discussions/150
+[#155]: https://github.com/nju-lug/NJUThesis/discussions/155
+[#164]: https://github.com/nju-lug/NJUThesis/issues/164
+[#165]: https://github.com/nju-lug/NJUThesis/discussions/165
+[#166]: https://github.com/nju-lug/NJUThesis/discussions/166
+[#169]: https://github.com/nju-lug/NJUThesis/issues/169
+[#170]: https://github.com/nju-lug/NJUThesis/issues/170
+[#172]: https://github.com/nju-lug/NJUThesis/issues/172
+[#173]: https://github.com/nju-lug/NJUThesis/issues/173
+[#181]: https://github.com/nju-lug/NJUThesis/issues/181
+[#191]: https://github.com/nju-lug/NJUThesis/issues/191
+[#192]: https://github.com/nju-lug/NJUThesis/discussions/192
+[#200]: https://github.com/nju-lug/NJUThesis/discussions/200
+[#202]: https://github.com/nju-lug/NJUThesis/discussions/202
+[#204]: https://github.com/nju-lug/NJUThesis/issues/204
+[#206]: https://github.com/nju-lug/NJUThesis/issues/206
+[#207]: https://github.com/nju-lug/NJUThesis/issues/207
+[#208]: https://github.com/nju-lug/NJUThesis/issues/208
+[#213]: https://github.com/nju-lug/NJUThesis/issues/213
+[#216]: https://github.com/nju-lug/NJUThesis/issues/216
+[#217]: https://github.com/nju-lug/NJUThesis/issues/217
+[#223]: https://github.com/nju-lug/NJUThesis/issues/223
+[#227]: https://github.com/nju-lug/NJUThesis/issues/227
+[#229]: https://github.com/nju-lug/NJUThesis/discussions/229
+[#230]: https://github.com/nju-lug/NJUThesis/issues/230
+[#232]: https://github.com/nju-lug/NJUThesis/issues/232
+[#234]: https://github.com/nju-lug/NJUThesis/issues/234
+[#243]: https://github.com/nju-lug/NJUThesis/issues/243
+[#245]: https://github.com/nju-lug/NJUThesis/discussions/245
+[#248]: https://github.com/nju-lug/NJUThesis/issues/248
+[#251]: https://github.com/nju-lug/NJUThesis/discussions/251
+[#253]: https://github.com/nju-lug/NJUThesis/pull/253
+[#263]: https://github.com/nju-lug/NJUThesis/issues/263
+[#266]: https://github.com/nju-lug/NJUThesis/discussions/266
+[#269]: https://github.com/nju-lug/NJUThesis/pull/269
+
+[CTeX-org/ctex-kit#678]: https://github.com/CTeX-org/ctex-kit/pull/678
+[CTeX-org/ctex-kit#700]: https://github.com/CTeX-org/ctex-kit/pull/700
+[CTeX-org/ctex-kit#703]: https://github.com/CTeX-org/ctex-kit/pull/703
+[lvjr/codehigh#12]: https://github.com/lvjr/codehigh/issues/12
 
 [更新日志]: https://keepachangelog.com/zh-CN/1.0.0/
 [语义化版本]: https://semver.org/lang/zh-CN/
 [南大 TeX]: https://tex.nju.edu.cn/
 [NJU Thesis 2021]: https://github.com/FengChendian/NJUThesis2021
+[`tl-depend-analysis`]: https://github.com/stone-zeng/tl-depend-analysis/
 
 [@zepinglee]: https://github.com/zepinglee
 [@hushidong]: https://github.com/hushidong
+[@zhoujian9410]: https://github.com/zhoujian9410
+[@note286]: https://github.com/note286
+[@AlphaZTX]: https://github.com/AlphaZTX
+[@stone-zeng]: https://github.com/stone-zeng
+[@liudongmiao]: https://github.com/liudongmiao
+[@muzimuzhi]: https://github.com/muzimuzhi

Makefile

-###############################################################################
-#
-# 	Makefile for the user manual of njuthesis
-#
-# 	Copyright (C) 2013 Haixing Hu,
-#   Department of Computer Science and Technology, Nanjing University.
-#
-#	Home Page of the Project: https://github.com/Haixing-Hu/nju-thesis
-#
-###############################################################################
-
-PROJECT=njuthesis
-TEXSOURCE=$(shell ls *.tex)
-BIB=njuthesis.bib
-
-.PHONY: all clean
-
-all:	$(PROJECT).pdf
-
-$(PROJECT).pdf: $(PROJECT).tex $(BIB) $(TEXSOURCE)
-	xelatex $(PROJECT).tex
-	biber $(PROJECT)
-	xelatex $(PROJECT).tex
-	xelatex $(PROJECT).tex
-
-###### clean
-
-clean:
-	-@rm -f \
-		*.aux \
-		*.bak \
-		*.bbl \
-		*.bcf \
-		*.blg \
-		*.dvi \
-		*.glo \
-		*.gls \
-		*.idx \
-		*.ilg \
-		*.ind \
-		*.ist \
-		*.loe \
-		*.lof \
-		*.log \
-		*.lot \
-		*.out \
-		*.ps \
-		*.run.xml \
-		*.thm \
-		*.toc \

README-CTAN.md

@@ -2,16 +2,16 @@ The `njuthesis` class
 =====================
 
 The `njuthesis` class is intended for typesetting Nanjing University
-dissertations with LaTeX, providing support for bachelor, master, and
-doctoral thesis. Compilation of this class requires either `xelatex`
-or `lualatex` engine.
+dissertations with LaTeX, providing support for bachelor, master,
+doctoral thesis and postdoctoral report. Compilation of this class
+requires either `xelatex` or `lualatex` engine.
 
 Usage
 -----
 
 A minimal example of this document class should look like
 
-```
+```LaTeX
 \documentclass{njuthesis}
 \njusetup{}
 \begin{document}
@@ -46,4 +46,4 @@ version.
 
 -----
 
-Copyright (C) 2021 - 2022 by NJU LUG.
+Copyright (C) 2021 - 2025 by NJU LUG.

README.md

 # NJU Thesis: 南京大学学位论文 LaTeX 模板
 
-[![njuthesis](https://img.shields.io/badge/njuthesis-latex-blue)](https://git.nju.edu.cn/nju-lug/nju-latex-templates)
-[![overleaf](https://img.shields.io/badge/overleaf-supported-brightgreen)](https://tex.nju.edu.cn)
 ![build status](https://github.com/nju-lug/NJUThesis/actions/workflows/build.yml/badge.svg)
 [![CTAN](https://img.shields.io/ctan/v/njuthesis.svg)](https://www.ctan.org/pkg/njuthesis)
 [![GitHub release](https://img.shields.io/github/release/nju-lug/NJUThesis/all.svg)](https://github.com/nju-lug/NJUThesis/releases/latest)
+[![overleaf](https://img.shields.io/badge/online_editor-supported-brightgreen)](https://tex.nju.edu.cn/template)
+[![nju-git](https://img.shields.io/gitlab/stars/nju-lug/nju-latex-templates/njuthesis?gitlab_url=https%3A%2F%2Fgit.nju.edu.cn&style=social)](https://git.nju.edu.cn/nju-lug/nju-latex-templates/njuthesis)
 
-> 此项目是基于 [NJU thesis 2021](https://github.com/FengChendian/NJUThesis2021) 的重构版本，目前本科生及研究生版本**已经重构完成**。
-> 然而，研究生院并未提供完善的规定，部分格式来自于本科生院。**如果院系另有要求，请提交 issue**。
-
-本模板基于本科生院的论文撰写规范制作，同时参考研究生院提供的硕士、博士学位材料包，用于生成符合南京大学排版要求和相应的国家规范、行业标准的学位论文，力求通过 LaTeX3 语法实现清晰的实现逻辑、较高的可定制性以及友好的用户接口。目前 [`njuthesis`](https://ctan.org/pkg/njuthesis) 文档类已发布在 CTAN。
+`njuthesis` 是制作南京大学本科生毕业论文、研究生学位论文、博士后出站报告的 LaTeX 文档类。本模板基于本科生院的论文撰写规范制作，同时参考研究生院提供的硕士、博士学位材料包，用于生成符合南京大学排版要求和相应的国家标准的学位论文，力求通过 LaTeX3 语法实现清晰的实现逻辑、较高的可定制性以及友好的用户接口。
 
 ## 快速开始
 
@@ -21,9 +18,11 @@
 
 [南大 TeX](https://tex.nju.edu.cn) 是 [eScience 中心](https://sci.nju.edu.cn)为南大在校师生提供的在线 LaTeX 写作平台，已*安装有本模板的最新版*。注册登录后，只需在**创建新项目**菜单中选择**论文模板**即可开始写作。
 
+**使用本平台时，请积极备份自己的文稿。**
+
 ### 本地编译
 
-请使用包管理器安装 `njuthesis` 和 `njuvisual` 的最新版。
+推荐使用包管理器安装 `njuthesis` 和 `njuvisual` 的最新版。
 
 新手同学不妨直接使用以下流程：
 
@@ -34,7 +33,7 @@
 
 ### 典型结构
 
-```
+```LaTeX
 \documentclass{njuthesis}
 \njusetup{}
 \begin{document}
@@ -47,15 +46,26 @@
 \end{document}
 ```
 
-## 常见问题
+## 反馈
 
-请参见[本项目 Wiki](https://github.com/nju-lug/NJUThesis/wiki)，或在[论坛](https://github.com/nju-lug/NJUThesis/discussions)中提问。
+在你遇到模板问题时，请遵守以下步骤：
+
+1. 在《[修订记录](https://github.com/nju-lug/NJUThesis/blob/master/CHANGELOG.md)》查看该问题是否已经修复但未发布；
+    - 若是，则可以使用仓库中的开发版本解决问题
+1. 在 [GitHub Issues](https://github.com/nju-lug/NJUThesis/issues) 和 [Discussions](https://github.com/nju-lug/NJUThesis/discussions) 中搜索该问题的关键词；
+1. 浏览[本项目 Wiki](https://github.com/nju-lug/NJUThesis/wiki) 和[用户手册](http://mirrors.ctan.org/macros/unicodetex/latex/njuthesis/njuthesis.pdf)；
+1. 在你确定这是一个新问题时
+    - 对于模板 bug、请求新功能、文档笔误等提出[新 issue](https://github.com/nju-lug/NJUThesis/issues/new/choose)
+    - 对于用法的疑惑、格式上的斟酌等提出[新 discussion](https://github.com/nju-lug/NJUThesis/discussions/new)
+    - 两个划分不绝对，区别在于 issue 是解决即关闭的
+    - 如果确实重复了，会打上 duplicate 标签并将你引导至本问题首条提问
+
+如果导师或院系有额外要求，请一同附上要求原文或格式截图。
 
 ## 贡献
 
-如果你发现了模板的问题，欢迎在 GitHub 中提交 [issue](https://github.com/nju-lug/NJUThesis/issues) 或者 [PR](https://github.com/nju-lug/NJUThesis/pulls)。
+欢迎提交 [PR](https://github.com/nju-lug/NJUThesis/pulls)。
 
 ## 许可
 
 本模板的发布遵守 [LaTeX Project Public License（版本 1.3c 或更高）](https://www.latex-project.org/lppl/lppl-1-3c/)。
-

build.lua

@@ -13,7 +13,7 @@ ctanreadme    = "README-CTAN.md"
 
 sourcefiledir = "source"
 sourcefiles   = {"*.dtx"}
-installfiles  = {"*.cls"}
+installfiles  = {"*.cls", "*.def"}
 
 typesetexe    = "xelatex"
 typesetfiles  = {"njuthesis.dtx"}

docs/njuthesis-sample.bib

-@book{goossens93,
-  author = "Frank Mittelbach and Michel Goossens and Johannes Braams and David Carlisle  and Chris Rowley",
-  title = "The {LaTeX} Companion",
-  year = "1993",
-  publisher = "Addison-Wesley",
-  address = "Reading, Massachusetts"
-}
-@article{schollwock2011,
-  title = {The Density-Matrix Renormalization Group in the Age of Matrix Product States},
-  author = {Schollwöck, Ulrich},
-  date = {2011-01},
-  journaltitle = {Annals of Physics},
-  shortjournal = {Annals of Physics},
-  volume = {326},
-  number = {1},
-  pages = {96--192},
-  issn = {00034916},
-  doi = {10.1016/j.aop.2010.09.012},
-  url = {https://linkinghub.elsevier.com/retrieve/pii/S0003491610001752},
-  urldate = {2021-10-11},
-  abstract = {The density-matrix renormalization group method (DMRG) has established itself over the last decade as the leading method for the simulation of the statics and dynamics of one-dimensional strongly correlated quantum lattice systems. In the further development of the method, the realization that DMRG operates on a highly interesting class of quantum states, so-called matrix product states (MPS), has allowed a much deeper understanding of the inner structure of the DMRG method, its further potential and its limitations. In this paper, I want to give a detailed exposition of current DMRG thinking in the MPS language in order to make the advisable implementation of the family of DMRG algorithms in exclusively MPS terms transparent. I then move on to discuss some directions of potentially fruitful further algorithmic development: while DMRG is a very mature method by now, I still see potential for further improvements, as exemplified by a number of recently introduced algorithms.},
-  langid = {english}
+@article{preskill2018,
+  title = {Quantum {{Computing}} in the {{NISQ}} Era and Beyond},
+  author = {Preskill, John},
+  author+an = {1=thesisauthor},
+  date = {2018-08-06},
+  journaltitle = {Quantum},
+  volume = {2},
+  pages = {79},
+  publisher = {{Verein zur Förderung des Open Access Publizierens in den Quantenwissenschaften}},
+  doi = {10.22331/q-2018-08-06-79},
+  url = {https://quantum-journal.org/papers/q-2018-08-06-79/},
+  urldate = {2022-10-27},
+  langid = {british}
 }

docs/njuthesis-sample.tex

 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-% njuthesis - 南京大学学位论文模板
-% Version 0.15.0  2022-02-20
-%
-% 关注项目地址以获取最新变化
+% njuthesis 示例模板 v1.4.2 2024-11-08
 % https://github.com/nju-lug/NJUThesis
-% https://git.nju.edu.cn/nju-lug/nju-latex-templates/njuthesis
-% https://ctan.org/pkg/njuthesis
 %
 % 贡献者
 % Yu XIONG @atxy-blip   Yichen ZHAO @FengChendian
 % Song GAO @myandeg     Chang MA @glatavento
 % Yilun SUN @HermitSun  Yinfeng LIN @linyinfeng
+% Yukai Chou @Muzimuzhi
 %
 % 许可证
 % LaTeX Project Public License（版本 1.3c 或更高）
-%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
 %---------------------------------------------------------------------
@@ -31,202 +26,43 @@
 %---------------------------------------------------------------------
 
 \documentclass[
-    % 模板选项：
+    % 模板选项(注意右端逗号)：
+    %
+    % type = bachelor|master|doctor|postdoc, % 文档类型，默认为本科生
+    % degree = academic|professional,        % 学位类型，默认为学术型
     %
-    %   学位信息
-    % degree = ug|mg|mf|phd,  % 学位类型，默认为本科
-    % type = thesis|design,   % 文档类型，默认为毕业论文
+    % nl-cover,   % 是否需要国家图书馆封面，默认关闭
+    % decl-page,  % 是否需要诚信承诺书或原创性声明，默认关闭
     %
-    %   特殊页面
-    % nlcover = true|false,   % 是否需要国家图书馆封面，默认关闭
-    % decl-page = true|false, % 是否需要诚信承诺书或原创性声明，默认关闭
+    %   页面模式，详见手册说明
+    % draft,                  % 开启草稿模式
+    % anonymous,              % 开启盲审模式
+    % minimal,                % 开启最小化模式
     %
     %   单双面模式，默认为适合印刷的双面模式
     % oneside,                % 单面模式，无空白页
     % twoside,                % 双面模式，每一章从奇数页开始
     %
-    %   建议定稿前一直开启草稿模式以提升编译速度
-    % draft = true|false,     % 是否开启草稿模式，默认关闭
-    %
-    %   以下两项为字体设置，不改动则自动调用系统预装字体
-    % latin-font = win|mac|linux|gyre|none,
-    % cjk-font = win|mac|linux|fandol|founder|noto|source|none,
-    ]{njuthesis}
+    %   字体设置，不填写则自动调用系统预装字体，详见手册
+    % fontset = win|mac|macoffice|fandol|none,
+  ]{njuthesis}
 
-\njusetup {
-    % 设置参数
-    %
-    % 一些提醒：
-    %   1. 千万不要有空行
-    %   2. 使用英文半角逗号(,)分隔选项
-    %   3. 等于号(=)两侧的空格会被忽略
-    %       3.1. 为避免歧义，请用花括号({})包裹内容
-    %   4. 本科生无需填写的项目已被特别标注
-    %
-    % info 类用于录入个人信息
-    %   带*号的为对应英文字段
-    info = {
-        title = {第一行标题\\第二行标题\\第三行标题},
-        % 中文题目
-        % 直接填写标题就是自动换行
-        % 可以使用换行控制符(\\)手动指定换行位置
-        %
-        title* = {My Title in English},
-        % 英文题目
-        %
-        author = {姓名},
-        % 作者姓名
-        %
-        author* = {Ming Xing},
-        % 作者英文姓名
-        % 一般使用拼音
-        %
-        keywords = {我,就是,充数的,关键词},
-        % 中文关键词列表
-        % 使用英文半角逗号(,)分隔
-        %
-        keywords* = {Dummy,Keywords,Here,{It Is}},
-        % 英文关键词
-        % 使用英文半角逗号(,)分隔
-        %
-        grade = {2018},
-        % 年级
-        %
-        student-id = {189114514},
-        % 学号
-        % 研究生请斟酌大小写字母格式
-        % 本模板并不会自动更正大小写
-        %
-        department = {化学化工学院},
-        department* = {School of Chemistry and Chemical Engineering},
-        % 院系
-        %
-        major = {化学},
-        major* = {Chemistry},
-        % 专业
-        %
-        supervisor = {导师姓名,教授},
-        supervisor*= {Professor My Supervisor},
-        % 导师全称
-        % 新版对选项进行了改动
-        % 使用英文半角逗号(,)分隔中文姓名和职称
-        %
-        % supervisor-ii = {第二导师姓名,副教授},
-        % supervisor-ii* = {Associate professor My Second Supervisor},
-        % 第二导师全称
-        % 如果确实没有第二导师，不填写即可
-        %
-        submit-date = {2021-08-10},
-        % 提交日期
-        % 格式为 yyyy-mm-dd
-        % 不填就是编译当天日期
-        %
-        %
-        % 以下均为研究生项
-        field = {物理化学},
-        field* = {Physical Chemistry},
-        % 研究领域
-        %
-        defend-date = {2021-09-19},
-        % 答辩日期
-        % 格式为 yyyy-mm-dd
-        % 不填就是编译当天日期
-        %
-        %
-        % 以下用于国家图书馆封面
-        chairman = {某某某~教授},
-        % 答辩委员会主席
-        % 推荐使用波浪号(~)分隔姓名和职称
-        %
-        reviewer = {
-            某某某~教授,
-            某某某~教授
-        },
-        % 答辩委员会成员
-        % 一共四名，使用英文半角逗号(,)分隔
-        %
-        clc = {0175.2},
-        % 中图分类号
-        %
-        secret-level = {限制},
-        % 密级
-        %
-        udc = {004.72},
-        % UDC分类号
-        %
-        supervisor-contact = {
-            南京大学~
-            江苏省南京市栖霞区仙林大道163号
-        }
-        % 导师联系方式
-    },
-    %
-    %
-    % bib 类用于参考文献设置
-    bib = {
-        % style = author-year,
-        % 参考文献样式
-        % 默认为顺序编码制（numeric）
-        % 可选著者-出版年制（author-year）
-        %
-        resource = {njuthesis-sample.bib},
-        % 参考文献数据源
-        % 需要带扩展名的完整文件名
-        % 可使用逗号分隔多个文件
-        % 此条等效于 \addbibresource 命令
-        %
-        % option = {
-            % doi    = false,
-            % isbn   = false,
-            % url    = false,
-            % eprint = false,
-            % 关闭部分无用文献信息
-            %
-            % refsection = chapter
-            % 将参考文献表置于每章后
-        %   }
-        % 额外的 biblatex 宏包选项
-    },
-    %
-    %
-    % style 类用于外观样式设置
-    style = {
-        emblem-img = {nju-emblem},
-        % 外置校徽图片路径
-        % 建议使用矢量图
-        % 使用外置图片有助于减少编译时间
-        % 空置时会自动使用 njuisual 宏包绘制
-        %
-        name-img = {nju-name},
-        % 外置校名图片路径
-        % 说明同上
-        %
-        % abstract-in-toc = false,
-        % 是否在目录中显示摘要，默认显示
-        %
-        % toc-in-toc = false
-        % 是否在目录中显示目录，默认显示
-    }
-}
+% 模板选项设置，包括个人信息、外观样式等
+% 较为冗长且一般不需要反复修改，我们把它放在单独的文件里
+\input{njuthesis-setup.def}
 
 % 自行载入所需宏包
-% \usepackage{subcaption} % 用于嵌套小幅图像，比 subfig 和 subfigure 好用
-% \usepackage{wrapfig} % 用于生成文字环绕的图片
-% \usepackage{siunitx} % 用于书写单位符号
-% \usepackage[version=4]{mhchem} % 用于绘制分子式
-% \usepackage{listings} % 用于展示代码
-% \usepackage{algorithm,algorithmic} % 用于展示算法伪代码
-
-% 设置图片存储位置
-% \graphicspath{{figure/}}
+% \usepackage{subcaption} % 嵌套小幅图像，比 subfig 和 subfigure 更新更好
+% \usepackage{siunitx} % 标准单位符号
+% \usepackage{physics} % 物理百宝箱
+% \usepackage[version=4]{mhchem} % 绘制分子式
+% \usepackage{listings} % 展示代码
+% \usepackage{algorithm,algorithmic} % 展示算法伪代码
 
 % 在导言区随意定制所需命令
-% https://tex.stackexchange.com/questions/33264/span-as-a-math-operator
-\DeclareMathOperator{\spn}{span}
-\renewcommand{\vec}[1]{\mathbf{#1}}
+% \DeclareMathOperator{\spn}{span}
 % \NewDocumentCommand\mathbi{m}{\textbf{\em #1}}
 
-
 % 开始编写论文
 \begin{document}
 
@@ -237,29 +73,25 @@
 % 生成封面页
 \maketitle
 
-% 文档默认使用 \flushbottom，即底部平齐
+% 模板默认使用 \flushbottom，即底部平齐
 % 效果更好，但可能出现 underfull \vbox 信息
-% 如需抑制这些信息，可以反注释以下命令
-% \raggedbottom
-
-% \begin{preface}
-%     前言
-% \end{preface}
+% 以下命令用于抑制这些信息
+\raggedbottom
 
 \begin{abstract}
-    中文摘要
+  中文摘要
 \end{abstract}
 
 \begin{abstract*}
-    English abstract
+  English abstract
 \end{abstract*}
 
 % 生成目录
 \tableofcontents
 % 生成图片清单
-\listoffigures
+% \listoffigures
 % 生成表格清单
-\listoftables
+% \listoftables
 
 %---------------------------------------------------------------------
 %	正文部分
@@ -270,23 +102,24 @@
 % 语法与 description 环境一致
 % 两个可选参数依次为说明区域宽度、符号区域宽度
 % 带星号的符号表(notation*)不会插入目录
-\begin{notation}[10cm]
-  \item[DFT] 密度泛函理论 (Density functional theory)
-  \item[DMRG] 密度矩阵重整化群 (Density-Matrix Reformation-Group)
-\end{notation}
+% \begin{notation}[10cm]
+%   \item[DFT] 密度泛函理论 (Density functional theory)
+%   \item[DMRG] 密度矩阵重正化群 (Density-Matrix Reformation-Group)
+% \end{notation}
 
 % 建议将论文内容拆分为多个文件
 % 即新建一个 chapters 文件夹
-% 把每一章的内容单独放入一个 tex 文件
-% 然后在这里用 \input{} 导入，例如
-%   \input{chapters/introduction}
-%   \input{chapters/environments}
+% 把每一章的内容单独放入一个 .tex 文件
+% 然后在这里用 \include 导入，例如
+%   \include{chapters/introduction}
+%   \include{chapters/environments}
 
 \chapter{引言}
 
-\section{tDMRG}
+\section{量子计算}
 
-矩阵乘积态也被用于含时薛定谔方程的求解，形成了含时密度矩阵重整化群方法\cite{schollwock2011}。
+John Preskill 认为我们现在处于“含噪声的中型量子时代”。\cite{preskill2018}
+量子位的不稳定性和有限的量子比特数量限制了量子计算机的复杂度和纠错能力。
 
 %---------------------------------------------------------------------
 %	参考文献
@@ -300,9 +133,17 @@
 %---------------------------------------------------------------------
 
 \begin{acknowledgement}
-    感谢 \href{https://git.nju.edu.cn/nju-lug/lug-introduction}{LUG@NJU}。
+  感谢 \href{https://git.nju.edu.cn/nju-lug/lug-introduction}{LUG@NJU}。
 \end{acknowledgement}
 
+%---------------------------------------------------------------------
+%	学术简历
+%---------------------------------------------------------------------
+
+% 详见手册中“成果列表”一节
+% \njuchapter{学术成果}
+% \njupaperlist[攻读博士学位期间发表的学术论文]{preskill2018}
+
 %---------------------------------------------------------------------
 %	附录部分
 %---------------------------------------------------------------------
@@ -311,6 +152,8 @@
 \appendix
 
 % 可以在这里插入补充材料
+\chapter{正文中涉及的数据及源代码}
+\dots
 
 % 完工
 \end{document}

docs/njuthesis-setup.def

+% njuthesis 参数设置文件 v1.4.2 2024-11-08
+
+% 一些提醒：
+%   1. \njusetup 内部千万不要有空行
+%   2. 使用英文半角逗号(,)分隔选项
+%   3. 等于号(=)两侧的空格会被忽略
+%       3.1. 为避免歧义，请用花括号({})包裹内容
+%   4. 本科生无需填写的项目已被特别标注
+%   5. 可以尽情删除本注释
+
+% info 类用于录入个人信息
+%   带*号的为对应英文字段
+\njusetup[info]{
+    title = {第一行标题\\第二行标题\\第三行标题},
+    % 中文题目
+    % 直接填写标题就是自动换行
+    % 可以使用换行控制符(\\)手动指定换行位置
+    %
+    title* = {My Title in English},
+    % 英文题目
+    %
+    author = {姓名},
+    % 作者姓名
+    %
+    author* = {Ming Xing},
+    % 作者英文姓名
+    % 一般使用拼音
+    %
+    keywords = {我,就是,充数的,关键词},
+    % 中文关键词列表
+    % 使用英文半角逗号(,)分隔
+    %
+    keywords* = {Dummy,Keywords,Here,{It Is}},
+    % 英文关键词
+    % 使用英文半角逗号(,)分隔
+    %
+    grade = {2018},
+    % 年级
+    %
+    student-id = {181850195},
+    % 学号或工号
+    % 研究生请斟酌大小写字母格式
+    % 本模板并不会自动更正大小写
+    %
+    department = {化学化工学院},
+    department* = {School of Chemistry and Chemical Engineering},
+    % 院系
+    %
+    major = {化学},
+    major* = {Chemistry},
+    % 专业
+    %
+    % major = {封面专业,摘要专业},
+    % 研究生专业型学位可能遇到两处内容不一致的情况
+    %
+    supervisor = {导师姓名,教授},
+    supervisor*= {Professor My Supervisor},
+    % 导师全称
+    % 使用英文半角逗号(,)分隔中文姓名和职称
+    %
+    % supervisor-ii = {第二导师姓名,副教授},
+    % supervisor-ii* = {Associate professor My Second Supervisor},
+    % 第二导师全称
+    % 如果确实没有第二导师，不填写即可
+    %
+    submit-date = {2022-05-20},
+    % 提交日期
+    % 格式为 yyyy-mm-dd
+    % 不填就是编译当天日期
+    %
+    %
+    % 以下均为研究生项
+    %
+    % degree = {工程硕士},
+    % degree* = {Master of Engineering},
+    % 覆盖默认学位名称
+    %
+    field = {物理化学},
+    field* = {Physical Chemistry},
+    % 研究领域
+    %
+    chairman = {某某某~教授},
+    % 答辩委员会主席
+    % 推荐使用波浪号(~)分隔姓名和职称
+    %
+    reviewer = {
+        某某某~教授,
+        某某某~教授
+    },
+    %
+    % 答辩委员会成员
+    % 一般为四名，使用英文半角逗号(,)分隔
+    %
+    clc = {O643.12},
+    % 中国图书分类号
+    %
+    udc = {544.4},
+    % 国际图书分类号
+    %
+    secret-level = {公开},
+    % 密级
+    %
+    defend-date = {2022-05-21},
+    % 答辩日期
+    % 格式为 yyyy-mm-dd
+    % 不填就是编译当天日期
+    %
+    email = {xyz@smail.nju.edu.cn},
+    % 电子邮箱地址
+    % 只用于出版授权书
+    %
+    %
+    % 以下用于国家图书馆封面
+    confer-date = {2022-05-22},
+    % 学位授予日期
+    %
+    bottom-date = {2022-05-23},
+    % 封面底部日期
+    %
+    supervisor-contact = {
+        南京大学~
+        江苏省南京市栖霞区仙林大道163号
+    }
+    % 导师联系方式
+}
+
+% bib 类用于参考文献设置
+\njusetup[bib]{
+    % style = numeric|author-year,
+    % 参考文献样式
+    % 默认为顺序编码制（numeric）
+    % 可选著者-出版年制（author-year）
+    %
+    resource = {njuthesis-sample.bib},
+    % 参考文献数据源
+    % 需要带扩展名的完整文件名
+    % 可使用逗号分隔多个文件
+    % 此条等效于 \addbibresource 命令
+    %
+    % option = {
+        % doi    = false,
+        % isbn   = false,
+        % url    = false,
+        % eprint = false,
+        % 关闭部分无用文献信息
+        %
+        % refsection = chapter,
+        % 将参考文献表置于每章后
+        %
+        % gbnamefmt = lowercase
+        % 使用仅首字母大写的姓名
+    %   }
+    % 额外的 biblatex 宏包选项
+}
+
+% image 类用于载入外置的图片
+\njusetup[image]{
+    % path = {{./figure/}{./image/}},
+    % 图片搜索路径
+    %
+    nju-emblem = {nju-emblem},
+    nju-name = {nju-name},
+    % 校徽和校名图片路径
+    % 建议使用 PDF 格式的矢量图
+    % 使用外置图片有助于减少编译时间
+    % 空置时会自动使用 njuvisual 宏包绘制
+    %
+    % nju-emblem = {nju-emblem-purple},
+    % nju-name = {nju-name-purple},
+    % 替换为紫色版本
+    % 这个选项只能填写一次
+    % 切换时要注释掉上方的黑色版本
+}
+
+% abstract 类用于设置摘要样式
+\njusetup[abstract]{
+    toc-entry = false,
+    % 摘要是否显示在目录条目中
+    %
+    % underline = false,
+    % 研究生英文摘要页条目内容是否添加下划线
+    %
+    % title-style = strict|centered|natural
+    % 研究生摘要标题样式，详见手册
+}
+
+% 目录自身是否显示在目录条目中
+\njusetup{
+    % tableofcontents/toc-entry = false,
+    % listoffigures/toc-entry   = false,
+    % listoftables/toc-entry    = false
+}
+
+% 为目录中的章标题添加引导线
+\njusetup[tableofcontents/dotline]{chapter}
+
+% math 类用于设置数学符号样式，功能详见手册
+\njusetup[math]{
+    % style              = TeX|ISO|GB,
+    % 整体风格，缺省值为国标（GB）
+    % 相当于自动设置以下若干项
+    %
+    % integral           = upright|slanted,
+    % integral-limits    = true|false,
+    % less-than-or-equal = slanted|horizontal,
+    % math-ellipsis      = centered|lower,
+    % partial            = upright|italic,
+    % real-part          = roman|fraktur,
+    % vector             = boldfont|arrow,
+    % uppercase-greek    = upright|italic
+}
+
+% theorem 类用于设置定理类环境样式，功能详见手册
+\njusetup[theorem]{
+    % define,
+    % 默认创建内置的七种定理环境
+    %
+    % style         = remark,
+    % header-font   = \sffamily \bfseries,
+    % body-font     = \normalfont,
+    % qed-symbol    = \ensuremath { \male },
+    % counter       = section,
+    % share-counter = true,
+    % type          = {...}
+    % 以上设置项在重新调用 theorem/define 后生效
+}
+
+% footnote 类用于设置脚注样式，功能详见手册
+\njusetup[footnote]{
+  % style = pifont|circled,
+  % 使用圈码编号
+  %
+  % hang = false,
+  % 不使用悬挂缩进
+}
+
+% 页眉页脚内容设置
+\njusetup{
+  % header/content = {
+  %     {OR}{\thepage},{OL}{\rightmark},
+  %     {EL}{\thepage},{ER}{\leftmark}
+  %   },
+  % 页眉设置，详见手册
+  % 奇数页页眉：左侧章名，右侧页码
+  % 偶数页页眉：左侧页码，右侧节名
+  %
+  % footer/content = {}
+}
+
+% 页眉页脚的字体样式
+% \njusetformat{header}{\small\kaishu}
+% \njusetformat{footer}{}
+
+% 在盲审模式下隐藏学校信息
+% \njusetup{anonymous-mode/no-nju}
+
+% 一些灵活调整
+% \njusetname{type}{本科毕业设计}                 % 我做的是毕业设计
+% \njusetname{notation}{术语表}                   % 更改符号表名称
+% \njusetlength{crulewd}{240pt}                   % 加长封面页下划线
+% \njusetformat{tabular}{\zihao{-4}\bfseries}     % 修改表格环境的字号
+% \EditInstance{nju}{u/cover/emblem-img}{align=l} % 左对齐的本科生封面校徽

install-unix.sh

 #!/usr/bin/env sh
 
-mkdir -p "mythesis"
-cd "mythesis"
+mkdir -p mythesis
+cd mythesis
 
-cp -f "../docs/njuthesis-sample.tex"            .
-cp -f "../docs/njuthesis-sample.bib"            .
-cp -f "../source/njuthesis.dtx"                 .
-cp -f "../scripts/generate-img.tex"             .
+cp -f ../docs/njuthesis-sample.tex            .
+cp -f ../docs/njuthesis-sample.bib            .
+cp -f ../docs/njuthesis-setup.def             .
+cp -f ../docs/nju-emblem*.pdf                 .
+cp -f ../docs/nju-name*.pdf                   .
+cp -f ../source/njuthesis.dtx                 .
 
-wget -q "https://mirror.nju.edu.cn/CTAN/macros/latex/contrib/njuvisual/njuvisual.dtx"
-wget -q "https://mirror.nju.edu.cn/CTAN/macros/latex/contrib/njuvisual/njuvisual-curves.dtx"
+xetex njuthesis.dtx > /dev/null
 
-xetex "njuthesis.dtx"                      > /dev/null
-xetex "njuvisual.dtx"                      > /dev/null
-pdflatex --shell-escape "generate-img.tex" > /dev/null
-
-rm *.aux
-rm *.auxlock
-rm *.dpth
 rm *.dtx
 rm *.ins
 rm *.log
-rm *.md5
-rm generate-img.tex
-rm generate-img.pdf
-rm njuvisual-example.tex
+rm njuthesis-doc.cls
 
 cd ..

install-win.bat

@@ -5,25 +5,16 @@ CD    "mythesis"
 
 COPY /Y "..\docs\njuthesis-sample.tex"            .
 COPY /Y "..\docs\njuthesis-sample.bib"            .
+COPY /Y "..\docs\njuthesis-setup.def"             .
+COPY /Y "..\docs\nju-emblem*.pdf"                 .
+COPY /Y "..\docs\nju-name*.pdf"                   .
 COPY /Y "..\source\njuthesis.dtx"                 .
-COPY /Y "..\scripts\generate-img.tex"             .
-
-curl -s -o "njuvisual.dtx" "https://mirror.nju.edu.cn/CTAN/macros/latex/contrib/njuvisual/njuvisual.dtx"
-curl -s -o "njuvisual-curves.dtx" "https://mirror.nju.edu.cn/CTAN/macros/latex/contrib/njuvisual/njuvisual-curves.dtx"
 
 xetex "njuthesis.dtx"                      > NUL
-xetex "njuvisual.dtx"                      > NUL
-pdflatex --shell-escape "generate-img.tex" > NUL
 
-DEL "*.aux"
-DEL "*.auxlock"
-DEL "*.dpth"
 DEL "*.dtx"
 DEL "*.ins"
 DEL "*.log"
-DEL "*.md5"
-DEL "generate-img.tex"
-DEL "generate-img.pdf"
-DEL "njuvisual-example.tex"
+DEL "njuthesis-doc.cls"
 
 CD ..