编辑器与编译 - nju-lug/NJUThesis GitHub Wiki

本地编译

  1. 从南大镜像站下载并安装最新的 TeX 发行版，并更新所有宏包
  2. 下载包含模板全部文件的压缩包 njuthesis-user-v*.zip
  3. 根据需要更改 njuthesis-sample.tex 文件中的内容
  4. 在模板根目录下运行 latexmk -xelatex ，得到对应的 PDF 文件

方法

  • 模板仅支持 XeLaTeX、LuaLaTeX 两种编译程序，以及 biber 文献工具
  • 如果使用 latexmk，请务必使用完整的命令 latexmk -xelatex 以免默认调用的 pdfLaTeX 引擎引发模版报错
  • 如果使用 xelatex 或 lualatex 命令，需要按照 xelatex/lualatex -> biber -> xelatex/lualatex -> xelatex/lualatex 的顺序编译，以生成正确的页码、编号、目录与参考文献表。

注意事项

  1. 不同系统上的所使用的字体有一定差别，实际输出结果可能会与其他环境有细微不同，本科生院的文件以 Windows 字体为标准，如果想要在其他系统（macOS\Linux）上也使用 Windows 的字体，请自行安装相关字体。

  2. 推荐使用 Visual Studio Code 搭配 LaTeX Workshop 插件完成论文编写，也可以使用其他编辑器，如 TeXworks、TeXstudio。

    若使用 LaTeX Workshop 插件，本项目在 .vscode/ 中附带一份 VS Code 的 LaTeX WorkShop 插件配置文件，可根据需要使用

  3. 使用latexmk时卡住不动

    这可能是因为未指定 -xelatex 参数，会默认调用 pdflatex，从而卡住无法结束编译；也可能是因为 latexmk 遇到了错误，请检查你的代码是否出错。

在线编译

南大 TeX基于 ShareLaTeX 平台，是 eScience 中心提供的在线 LaTeX 编辑器。南大 TeX 已预置最新版njuthesis，进行论文写作时无需上传 .cls 文件。

上传模板的方法（不推荐）

如果希望对模板格式进行修改，或者南大 TeX 安装的版本未及时更新错误补丁，也可以自行上传本模板进行在线写作。

  1. 下载包含模板全部文件的压缩包 njuthesis-user-v*.zip

  2. 登录南大 TeX，点击新建项目 -> 上传项目上传刚刚得到的压缩包，上传后 njuthesis-sample.tex、njuthesis.cls 等文件应在根目录，v0.14.0以后的目录结构如下所示：

    │
│ nju-emblem.pdf
│ nju-name.pdf
│ njuthesis-sample.bib
│ njuthesis-sample.tex
│ njuthesis.cls
│ njuvisual.sty

  3. 在南大TeX项目内页面左上角的菜单中，检查编译器是否为 XeLaTeX 或 LuaLaTeX

  4. 编写 TeX 文档