警告：本项目非官方实现，出现问题概不负责。

在本项目之前已有多个为北邮研究生学位设计的LaTeX文档类，经过张煜博士（Dazzle Zhang）和王贤凌博士（rioxwang）的努力，BUPTGraduateThesis的功能已经相当完善。 但是，之前的项目存在很多问题。 首先，由于之前的项目启动时间较早，原文档类使用了很多较为古老的方式来实现，而这些方法已经逐渐被新的方案所替代。 其次，原文档类使用了很多 LaTeX 的底层命令，再加上注释的缺乏，其代码的可读性较差。这使得项目后期维护困难，也使得让更多人参与进来的的门槛较高。 针对这些问题，本项目采用了一些新的方法来重新实现北邮研究生学位论文。 其中最主要的区别就是本项目不再直接调用xeCJK，而是通过CTeX的定制化功能来实现。由于字体选择、中文格式设定等功能大多直接由 CTeX 完成，本文档类在代码量大幅减少的同时，几乎可以实现在 Windows、MacOS上的开箱即用。Linux 系统上也只需按照 CTeX 的常规方式配置字体即可。 除此之外，对于页眉页脚、目录、引文等部分的调整也都采用相应的宏包来实现，从而尽可能的避免使用底层命令，提高代码的可读性。

由于本项目采用一些较新的工具来实现功能，对于老版本的LaTeX系统可能存在兼容性问题，建议使用最新的TeX Live或者MiKTeX来进行编译。

注意：虽然 CTeX 套装的使用依然很广泛，但由于 CTeX 套装已经多年没有维护，本项目不对 CTeX 套装的兼容性做任何保证。

虽然 CTeX 宏包可以自行适应编译引擎，但由于开发过程中主要使用 XeLaTeX 进行测试，故强烈建议使用 XeLaTeX 引擎来进行编译。 为了实现引用、编号等功能，可使用以下命令进行编译。

latexmk %DOC%

本项目提供了相应的 latexmkrc 文件用以定义 latexmk 的行为。 为了保证每次编译的速度以及效果，强烈建议大家采用 latexmk。 （在MikTex下使用 latexmk 可能需要单独安装一个 Perl）

另外也可以直接使用以下命令

xelatex %DOC%
makeglossaries %DOC%
biber %DOC%
xelatex %DOC%
xelatex %DOC%

makeglossaries %DOC% 不用在写作的过程中反复的运行，这个并不影响正文中的输出，所以只需在编译最终版的时候执行一次用以生成缩略语表即可。

现在本项目已经能在 Overleaf 上直接使用了，由于 Adobe 宋体的逗号和 Windows 自带宋体逗号有较大差异，为了最大可能减少问题的出现，故使用了 Windows 自带字体。

Overleaf模板地址

• txmath 使用该选项启用 Times 字体的数学部分。
• xits 使用 XITS 项目提供的字体。
• review 用以自动在扉页上隐藏个人信息。
• chapterbib 默认将引文列在正文的末尾，可使用该选项将采用文献列在各章的末尾。

研究生院给的扉页样例上采用了粗宋体（伪粗体），但本文档类默认绘制的扉页并没有采用粗体字。这是因为Windows上其实并没有粗宋体字形，CTeX中默认使用黑体来代替粗宋体。不过《关于研究生学位论文格式的统一要求》上并没有明确指出对粗宋体的使用，我想应该问题不大。

实在不放心的话可以自行用Word绘制中英文扉页和声明，然后导出成cover.pdf放在本项目的根目录。本文档类在发现cover.pdf之后便不会自行绘制相应的内容而是直接将cover.pdf贴在文档的最前面。

还有一个替代方案是自行选择一个粗宋体字体，将字体文件重命名为bsong.ttf。本文当类将在发现bsong.ttf文件之后自动使用其中的字体来绘制中文封面。 在进行了一些对比之后，我发现汉仪中宋的字重跟 Word 中的加粗宋体比较接近，而且是个人使用免费，推荐给大家。使用效果可参见bare_thesis.pdf的封面。由于我不知道二次分发自己下载的字体会不会有问题，麻烦大家自行前往汉仪的网站下载。

另外，如果cover.pdf和cover.tex都没有找到，文档类会直接放弃绘制扉页。

不知是我系统的问题还是newtx包存在问题，我这里调用newtxmath之后就有部分数学符号无法使用。现在暂时采用LaTeX默认的cm数学字体。不过不管用什么数学字体，LaTeX的数学排版肯定比Word强。另外本文档类提供一个txmath选项来开启newtxmath的调用。

发现我的系统里少一个叫boondox的字体包，手动安装之后便可以正常编译newtxmath了。 如果有遇到相似问题的可以尝试一下。

虽然《关于研究生学位论文格式的统一要求》里面没有明确说明，但是引文格式要求是基本符合国家标准的。 所以本项目采用biblatex-gb7714-2015来处理引文格式。 但由于该包没有在以前的文档类中使用过，并不清楚学校对该包的接受度如何。

如果编译时出现Package xkeyval Error: `gbnamefmt' undefined in families `blx@opt@pre`. [\blx@processoptions] 请更新biblatex-gb7714-2015的版本。

BUPTGraduateThesis文档类使用了给很大的篇幅来实现带圈数字的注脚，但我在《关于研究生学位论文格式的统一要求》并没有看到相应的要求。另外我觉得注脚并不是什么很有必要的功能，本项目放弃对带圈数字的实现。

BUPTGraduateThesis中实现了非常强大的自动缩略语功能，但是我在移植过程中发现自动缩略语所依赖glossaries包似乎跟biblatex冲突。由于时间紧迫，未能查明具体原因。暂时放弃实现相应的功能，现在只能手动管理缩略语了。

经过 @qin-nz 的提示，我发现原来glossaries与biblatex其实并无冲突，至少我原来遇到的问题无法再现了。

现在成功移植了BUPTGraduateThesis中自动缩略语功能。 不过\gls{}的输出会造成中英文混排的时候自动空格不出现的问题。 这个问题暂时无解，所以需要大家手动控制一下\gls{}两侧的空格。 另外编译的时候需要多加一个makeglossaries %DOC%

由于本项目几乎完全重写，功能实现其实远没有BUPTGraduateThesis项目那么完整。暂时需要大家自行修改代码来实现硕士、博士后论文，涉密论文所需的调整。如果日后有时间我会尽量完善相关的功能。

感谢张煜博士和王贤凌博士的贡献。虽然本文档类几乎完全重写，但很多设计还是继承了BUPTGraduateThesis项目。

另外一些实现细节也参考了SJTUThesis，在此也对相关人员表示感谢。