SJTUThesis is an unofficial XeLaTeX template for preparing bachelor, master, or doctor thesis in Shanghai Jiao Tong University.
这是为撰写上海交通大学学士、硕士或博士论文而准备的 XeLaTeX 模板，非官方出品。生成的学位论文文件参见 README.pdf。
P.S. 该 README 用于重要的文档更新，其他细节更新正考虑逐步搬移到 SJTUThesis Wiki, 欢迎贡献你的力量。:-)
使用方法大致可以分为在线和本地两种，在线编辑基于 ShareLaTeX 网站，下面分两种情况做详细说明。
TeX 本地编译大家可能比较熟悉，但偶尔也会由于各种各样的原因导致你不能顺畅地在本地使用该模板写论文，这个时候不妨考虑下在 ShareLaTeX 上在线编辑，不受系统的影响，无需本地安装 TeX 发行版以及其他字体适配等工作。只要有一个稍微现代一点的浏览器如 Firefox, Chrome/Chromium 就行了。缺点是由于服务器在国外，访问起来不是很快，第一次编译可能会稍慢，这可能与 ShareLaTeX 后端的缓存策略有关。
模板地址 ==> SJTUThesis Template - ShareLaTeX.
如果直接从以上模板新建时显示『500 internal server error』的话说明 ShareLaTeX 的从模板新建的功能挂掉了，且登陆后出现的项目是错误的，务必及时删除。改从 这里 以复制的形式新建你自己的项目。左侧菜单(Menu) -> Copy Project 即导入到自己的项目中。
其他详细截屏教程见 Usage - 使用文档
支持 XeTeX 的完整 TeX 发行版。2013/2014/2015年的 TeXLive 和 MacTeX 发行版都能编译此模板。据不完全统计，Windows 下的 CTeX(2.9.2) 也能顺利编译此模板。
以 TexLive/MacTeX 为例，根据你使用的发行版和宏包版本，你需要使用以下不同的分支：
- 2015 年的发行版：使用 master(v0.9) 分支。
- 2014 年的发行版：建议使用 v0.8 分支。
- 2013 年的发行版：建议使用 v0.7 分支。
Windows用户请使用 Babun 作为命令行终端。Babun 已默认安装有这些工具：git(版本控制)、GNUmake(编译控制)、perl(字数统计)。
中英文分别依赖 Adobe 的四套简体中文字体和 TeX Gyre Termes 西文字体。Adobe 的四套字体可以从 GitCafe 或者 GitHub 处下载。Tex Gyre Termes 则可以从 CTAN 中下载，共有 regular, bold, bolditalic, italic 四种不同的字型需要下载，四种字型的打包下载见 这里。字体的安装双击即可，Linux 下可能需要刷新下字体缓存。
对中文字体的一点说明：Windows 下如果使用 Word 进行排版的话，中文衬线字体使用的一般是俗称「宋体」的「中易宋体」。实际上对于印刷体来说，Adobe 家的四款中文字体 AdobeSongStd, AdobeKaitiStd, AdobeHeitiStd, AdobeFangsongStd 效果更好，因此在绝大多数高校学位论文模板中默认使用这四套中文字体编译生成 PDF。
根据「系统需求」中情形选择适合你系统情况的分支，然后根据情况选择 git 克隆或者下载 GitHub 上的压缩包。尽管下载压缩包的方式简单粗暴，但为了能使用模板的最新功能，还是大力推荐终端中克隆的方式。不熟悉命令行没有关系，下文将详述方法。
打开终端，OS X 用户需要在 spotlight 中搜索terminal, Windows 用户则使用前文推荐的 Babun. 在终端下按如下步骤操作。
友情提示：Windows 下的 Babun 默认使用鼠标右键作为终端中的粘贴功能。
cd
git clone https://github.com/weijianwen/SJTUThesis.git如果之前有克隆过此模板但是想与 GitHub 上的最新版本同步，以master分支为例，执行以下命令更新到最新版。
git pull origin master
若是自己 fork 后克隆下来的，则执行以下命令。
git pull upstream master
- 2015 年的发行版：使用 master(v0.9) 分支。
- 2014 年的发行版：建议使用 v0.8 分支。
- 2013 年的发行版：建议使用 v0.7 分支。
编译模板，生成学位论文PDF文件。GNUMake将调用latexmk程序，自动完成模板的多轮编译。平时写论文时推荐使用make pvc达到「持续集成」——持续监听文件改动，用户无需操心后台编译的问题，编译好后会自动打开 PDF 文档，这个特性在没定稿之前非常方便！由于 CTeX 下的 Miktex texify/latexmk 有可能有问题，故还是推荐 Windows 用户使用 TeXLive 发行版试试看。终端下执行以下命令即可。
make pvc
由于latexmk -pvc使用系统默认的 PDF 阅读器打开编译好的 PDF，且默认不能自动更新 PDF 中的内容。你可以对这一行为进行定制，从而可使用能自动更新 PDF 的阅读器来预览学位论文，通过这种「曲线救国」的方式勉强可以达到「所见即所得」的效果。论文根目录下的latexmkrc中已经写好了 OS X 下使用 Skim 来预览 PDF 的配置文件(默认不启用)。其他如 Linux 和 Windows 系统可以参考latexmk的手册或是搜索下网路上其他人给出的配置文件进行测试。
如果最终定稿，则使用以下命令编译。
$ make clean thesis.pdf
若需要生成用于提交盲审的论文(隐去作者、导师等信息)，可在thesis.tex中为sjtuthesis文档类添加review选项。 若需要生成包含“原创性声明扫描件”和“授权书”签名扫描件的学位论文，请将扫描件分别保存为pdf/origignal.pdf和pdf/authorization.pdf，然后添加submit选项重新编译模板。
双击compile.bat即可完成编译过程，生成thesis.pdf，不依赖于 GNUMake。
make wordcount
编译失败时，可以尝试手动逐次编译。 结合文档 README.pdf 中的说明，有助于定位故障。
$ xelatex -no-pdf thesis
$ biber --debug thesis
$ xelatex thesis
$ xelatex thesis
建议以如下的顺序反馈使用问题：
- 精简代码；
- 改进开章页设计；
- v 0.9: 当前master分支，适配ctex 2.x宏包，需要使用2015年的TeX发行版，无法使用更早的发行版编译。
- v 0.8：使用biber/biblatex处理参考文献，需要使用2014的TeX发行版，无法使用2013年和2015年的TeX发行版编译。
- v 0.7：使用bibex处理参考文献（会产生错误信息，可忽略），需要使用2013或2014年的TeX发行版，无法使用2015年的TeX发行版编译。
上海交通大学校徽图片(sjtulog.png)和横幅图片(sjtubanner.png)的版权归原作者所有。其他部分使用 Apache License 2.0 授权。