本地使用说明

本页面介绍如何在本地使用模板。

本地编译需要依赖一个可用的 LaTeX 发行版，以及中文字体的支持。

TeX 发行版

SJTUThesis 需要使用 XeTeX 引擎编译。

Windows 和 Linux 用户可以安装 TeX Live，推荐使用 Tex Live 最新版(2018)。

MacOS 用户可以安装 MacTeX。

注：Windows 用户推荐使用 Babun 作为命令行终端。Babun 已默认安装有这些工具：git(用于版本控制)、GNUmake(用于编译控制)、perl(用于字数统计)。

中文字体

SJTUThesis 由 CTeX 宏集提供中文支持，默认情况下可以自动检测操作系统选择字体配置，同时 CTeX 宏集也提供了相应选项以供在自动配置失效或用户有特殊需求的情况下使用。

获取模板

根据「系统需求」中情形选择适合你系统情况的分支，然后根据情况选择 git 克隆最新版代码或者下载稳定版压缩包。

压缩包下载

你可以在 GitHub Release 中找到 SJTUThesis 的所有版本，推荐使用最新版本以避免一些问题。

终端中克隆最新版

git clone https://github.com/sjtug/SJTUThesis.git

如果之前有克隆过此模板但是想与 GitHub 上的最新版本同步，以 master 分支为例，执行以下命令更新到最新版。

git pull origin master

若是自己 fork 后克隆下来的，则执行以下命令。

git pull upstream master

编译模板

在 Linux 与 macOS 上编译

编译模板，生成学位论文 PDF 文件。GNUMake 将调用 latexmk 程序，自动完成模板的多轮编译。

make pvc

定稿后可使用以下命令生成最终版本。

make cleanall thesis.pdf

若需要生成用于提交盲审的论文(隐去作者、导师等信息)，可在 thesis.tex 中为 sjtuthesis 文档类添加 review 选项。 若需要生成包含“原创性声明扫描件”和“授权书”签名扫描件的学位论文，请将扫描件分别保存为 pdf/origignal.pdf 和 pdf/authorization.pdf，然后添加 submit 选项重新编译模板。

在 Windows 上编译

双击 compile.bat 即可完成编译过程，生成 thesis.pdf。

字数统计

make wordcount

问题诊断

编译失败时，可以尝试手动逐次编译。 结合文档 [README.pdf][README] 中的说明，有助于定位故障。

xelatex -no-pdf thesis
biber --debug thesis
xelatex thesis
xelatex thesis