这是为撰写上海交通大学学士、硕士或博士论文而准备的 XeLaTeX 模板，非官方出品。生成的学位论文文件参见 README.pdf，详细使用说明参见 SJTUThesis Wiki。
SJTUThesis 共有三种编译方式支持:
第一种编译方式需要在本地安装 TeX 发行版，好处在于环境问题少，坏处在于安装过程比较漫长且繁琐。第二种编译方式是完全在线的，不需要在本地安装任何环境，缺点在于需要完全依赖 ShareLaTeX 网站，其在国内的稳定性存疑。第三种方式需要在本地安装 Docker，相比第一种，不会污染本地的环境。但要求用户对 Docker 有一定了解。
本地编译需要依赖一个可用的 LaTeX 发行版，以及中文字体的支持。
SJTUThesis 需要使用 XeTeX 引擎编译。，Windows 和 Linux 用户可以安装 TeX Live，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编译模板，生成学位论文 PDF 文件。GNUMake 将调用 latexmk 程序，自动完成模板的多轮编译。
make pvc定稿后可使用以下命令生成最终版本。
make cleanall thesis.pdf若需要生成用于提交盲审的论文(隐去作者、导师等信息)，可在 thesis.tex 中为 sjtuthesis 文档类添加 review 选项。 若需要生成包含“原创性声明扫描件”和“授权书”签名扫描件的学位论文，请将扫描件分别保存为 pdf/origignal.pdf 和 pdf/authorization.pdf，然后添加 submit 选项重新编译模板。
双击 compile.bat 即可完成编译过程，生成 thesis.pdf。
make wordcount编译失败时，可以尝试手动逐次编译。 结合文档 README.pdf 中的说明，有助于定位故障。
xelatex -no-pdf thesis
biber --debug thesis
xelatex thesis
xelatex thesis
我们有多个版本的模板在 ShareLaTeX 上可用，但是推荐使用最新版本，以避免可能遇到的一些问题。此外如果在 ShareLaTeX 上遇到问题建议尝试本地编译。
在模板目录下执行以下命令即可:
docker pull quay.io/sjtug/sjtuthesis
./scripts/start-build.sh建议以如下的顺序反馈使用问题：
- 分离学位论文的使用文档和示例文档，准备提交到 CTAN #47
- 感谢 CTeX 提供了 LaTeX 的中文支持
- 感谢那位最先制作出博士学位论文 LaTeX 模板的交大物理系同学
- 感谢 William Wang 同学对模板移植做出的巨大贡献
- 感谢 @weijianwen 学长一直以来的开发和维护工作
- 感谢 @sjtug 以及 @dyweb 对 0.9.5 之后版本的开发和维护工作
- 感谢所有为模板贡献过代码的同学们，以及所有测试和使用模板的各位同学
上海交通大学校徽图片(sjtulogo.pdf 等)的版权归上海交通大学所有。其他部分使用 Apache License 2.0 授权。