# nwafuthesis-l3

**Repository Path**: nwafu_nan/nwafuthesis-l3

## Basic Information

- **Project Name**: nwafuthesis-l3
- **Description**: 基于LaTeX3开发的西北农林科技大学学位论文模板
- **Primary Language**: TeX/LaTeX
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 120
- **Forks**: 47
- **Created**: 2021-05-12
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 西北农林科技大学学位论文LaTeX文档类(模板)
### **特别声明**
--------------------
本模板目前仅支持`XeTeX`和`LuaTeX`引擎，对其他引擎(包括pdfTeX和ApTeX)暂未列入支持计划。同时，本模板仅支持`UTF-8`编码的TeX源文件。

在您使用`nwafuthesis`之前，请务必仔细阅读模板文档[nwafuthesis.pdf](https://mirrors.aliyun.com/CTAN/macros/unicodetex/latex/nwafuthesis/nwafuthesis.pdf)

由于用到了一些LaTeX较新的特性及较新的宏包，该模板后期不再支持2024及以下TeX发行版，请及时升级发行版并更新所有宏包。例如，TeXLive2025之后的发行版。

该模板的测试主要是在**TeXLive2026+Ubuntu 26.04**平台完成。

### 简介
---------------------

西北农林科技大学学位论文LaTeX文档类(模板)，支持本科(学士)、硕士(学硕/专硕)、博士学位论文。


#### 模板安装
--------------------
该模板已上传ctan，被TeX发行版收录，通过TeX发行版的包管理器即可完成该模板的安装。只需及时更新发行版，便可自动安装该模板并安装相关依赖。

作为终端用户，仅需要用`\documentclass{nwafuthesis}`载入该文档类(模板)即可使用该模板，其工作流如下图所示：

![](./screenshots/workingflow.png)

如果需要手动安装，则可执行相应的包管理命令。例如，对于TeXLive发行版，可在命令行执行如下命令进行安装(有可能需要管理员权限)：

```shell
tlmgr install nwafuthesis
```

当然，如果您对**模板开发**感兴趣，也可以进入`expl3-dtx`文件夹通过操作**nwafuthesis.dtx**是开发文档实现对模板的修改和完善，然后在命令行顺序执行如下操作:

```shell
  xelatex nwafuthesis.dtx
  makeindex -s gind.ist -o nwafuthesis.ind nwafuthesis.idx
  makeindex -s gglo.ist -o nwafuthesis.gls nwafuthesis.glo
  xelatex nwafuthesis.dtx
  xelatex nwafuthesis.dtx
  xelatex nwafuthesis.dtx
```
从而得到需要的`nwafuthesis.cls`模板文件和`nwafuthesis.pdf`说明文件。

#### 使用样例
--------------------
创建独立的工作目录，并在工作目录中创建`logo`文件夹，将学校的`nwafu-bar.pdf`校微矢量图(不可更改文件名)置于`logo`中，然后创建如下`main.tex`主文件(以本科学位论文为例)：
```tex
% 文档类(模板)
\documentclass[%
  type = bachelor,  % 本科论文(设计)
  % oneside,        % 单面模式
  twoside,          % 双面模式(openany)
]{nwafuthesis}
% 导言区

% 将需要载入的宏包统一在settings/package.tex中进行管理
\input{settings/packages.tex}
% 将必要的设置统一在settings/format.tex中进行管理
\input{settings/format.tex}

% 排版参数设置
\nwafuset{
% 论文基础格式
  style = {
    % 由于版权原因，本模板不提供任何字体安装文件，如有需要请自行按需安装。
    % 对于对于Times New Roman这一西文字体的要求，在论文撰写规范中明确说明，
    % 可以使用相似字体进行替换，请根据情况自行决定。
    % 在此，强烈建议让系统自行选择使用合适的字体，
    % 非特殊情况不要设置font和cjk-font这两个选项。
    % 如果中文排版出现“🄵”(主要发生在姓名排版中)，则可更改cjk-font选项。
    % font          = times*,            % 西文字体(garamond|libertinus|lm|palatino|times|times*|none)
    % cjk-font      = windows,           % 中文字体(adobe|fandol|founder|mac|sinotype|sourcehan|windows|none)
    bib-resource  = {bib/sample.bib},   % 参考文献数据源文件名，注意需要完整路径及后缀名
    % figtabtoc,                          % 是否输出本科插图与表格清单(默认不输出)
    % anonymous     = false,              % 是否输出盲审格式论文
    % hyperlink     = color,              % 彩色超链接，仅为检查交叉引用，提交论文时建议注释该颜色选项
  },
% 基本信息录入
  info = {
    grade = {2026},   % 毕业年份(届)
    btype = {paper},  % 本科类型(论文/设计，paper/design)
    bachelortype = { 工学 }, % 申请学位类别
    title = { \nwafuthesis{}快速上手示例文档 },                    % 论文中文标题
    title* = { \nwafuthesis{} Quick Start and Document Snippets }, % 论文英文标题
    department = { 信息工程学院 },      % 学院名称
    major = {计算机科学与技术},         % 专业
    author = { \TeX{}爱好者 },          % 作者中文姓名
    student-id = {202101000},           % 学号
    supervisor = { 耿楠 },              % 指导教师
    cosupervisor = {Donald Knuth 大师}, % 协助指导教师
    date = {2026年6月},                 % 学位会召开时间
    foundation = {% 资助基金，每个条目包括项目来源、名称和编号三项，用英文逗号分隔
        {国家高新研发计划(863项目),作物三维点云快速获取,20140422124},
        {陕西省重点研发计划,基于大数据的陕西苹果物联网研究,NT20170445463},
      },
  },
}
% 录入摘要、符号对照表、术语表等信息
\nwafuset{
  abstract = {
    abstractfile  = { contents/chap00-abs-zh.tex }, % 中文摘要文件名称(注意需要有.tex后缀名)
    abstractfile* = { contents/chap00-abs-en.tex }, % 英文摘要文件名称(注意需要有.tex后缀名)
    keywords      = {学位论文, 模板, \nwafuthesis}, % 中文关键字列表(注意用英文逗号分隔)
    keywords*     = {NWAFU thesis, document class, space is accepted here}, % 英文关键字列表(注意用英文逗号分隔)
    notationfile  = { contents/chap00-notation.tex }, % 主要符号对照表文件名称(注意需要有.tex后缀名，
                                                      % 若忽略该参数或提供空参数，则不输出主要符号注释表)
    termfile      = { contents/chap00-term.tex }      % 术语表(注意需要有.tex后缀名，
                                                      % 若忽略该参数或提供空参数，则不输出术语表)
  },
}

% 正文区(有且只能有一个)
\begin{document}
% 这个命令用来关闭版心底部强制对齐，
% 可以减少不必要的 underfull \vbox 提示，但会影响排版效果
% \raggedbottom

% 由于论文模板中已设计了自动排版封面、摘要、目录等功能，
% 因此，无需手动排版。

% 主体部分是论文的核心
\mainmatter

% 建议采用多文件编译的方式编写论文，
% 比较好的做法是把每一章放进一个单独的 tex 文件里，
% 并在这里用 \include 导入，如：

% <论文主体>

% 打印参考文献列表
\bibmatter*
\printbibliography

% 排版附录，可选
\appendix
% <附录文档>

% 排版致谢
\backmatter
% <致谢文档>

% 个人简历， 本科生可选
% <个人简历文档>

\end{document}
```

更多样例，请分别参阅`demo`文件夹中`Bachelor`(本科)、`Master-Academic`(学硕)、`Master-Professional`(专硕)和`PhD`(博士)学位论文样例，可以直接通过修改样例完成学位论文(设计)排版。

由于模板已被收录于ctan，因此，论文可以不依赖于当前工作路径中的`nwafuthesis.cls`文件，在论文撰写中。

排版样例源代码及模板开发源代码也可以通过[nwafuthesis发行版](https://gitee.com/nwafu_nan/nwafuthesis-l3/releases/)获得。

###  重要提醒
---------------------

1. 由于PDF格式文档与Word文档之间**不存在转换关系**，虽学校相关部门接收PDF格式的学位论文，但使用该模板之前请与导师/导师组进行充分沟通，以确认不需要进行PDF文档到Word文档的转换操作。
2. 本模板功能仍处于开发和完善中，不确保证接口的稳定性。在撰写论文的过程中，请慎重考虑是否要同步进行更新。
3. 任何由于使⽤本模板⽽引起的论⽂格式审查问题均与本模板作者⽆关。

###  致谢
---------------------

该模板参考了stone-zeng用LaTeX3开发的[复旦大学论文模板](https://github.com/stone-zeng/fduthesis)，通过添加/修改相关代码实现，另外，该模板开发过程中的参考文献样式由[biblatex-gb7714-2015样式包](https://github.com/hushidong/biblatex-gb7714-2015)作者胡振震开发的gb7714-NWAFU样式文件实现。在此，对他们表示由衷的感谢。

###  参与贡献
---------------------
1. 本项目由西北农林科技大学信息工程学院耿楠创建和维护
2. 如果您愿意一同参与工作(不计报酬，免费自由)，请及时与作者联系
3. 如果您有任何改进意见或者功能需求，欢迎提交 [issue](https://gitee.com/nwafu_nan/nwafuthesis-l3/issues) 或 [pull request](https://gitee.com/nwafu_nan/nwafuthesis-l3/pulls)。