这是为撰写上海交通大学学士、硕士或博士论文而准备的 XeLaTeX 模板,非官方出品。生成的学位论文文件参见 README.pdf,详细使用说明参见 SJTUThesis Wiki。
SJTUThesis 共有三种编译方式支持:
第一种编译方式需要在本地安装 TeX 发行版,好处在于环境问题少,坏处在于安装过程比较漫长且繁琐。第二种编译方式是完全在线的,不需要在本地安装任何环境,缺点在于需要完全依赖 ShareLaTeX 网站,其在国内的稳定性存疑。第三种方式需要在本地安装 Docker,相比第一种,不会污染本地的环境。但要求用户对 Docker 有一定了解。
因为本地编译涉及到 TeX 发行版的安装, 因此具体可参见 本地安装使用指南
我们有多个版本的模板在 ShareLaTeX 上可用,但是推荐使用最新版本,以避免可能遇到的一些问题。此外如果在 ShareLaTeX 上遇到问题建议尝试本地编译。
在模板目录下执行以下命令即可:
docker pull quay.io/sjtug/sjtuthesis
./scripts/start-build.sh
通过以下指令,可以编译生成 thesis.pdf:
make
编写学位论文往往是一个修改 -> 查看论文 PDF 显示效果 -> 继续修改的过程。因此我们实现了持续编译的支持。在文件被修改后,会自动进行新一轮的编译,产生新的 PDF 文件,在写论文时无需写完重新运行 make
:
make pvc
使用以下指令可以清除之前所有的构建文件:
make clean
通过以下指令,可以查看目前的字数:
make wordcount
目前会统计两种字数:纯中文字数与总字数(英文单词 + 中文字)。其中纯中文字数只统计中文字,如英语单词,数字等都不予计入。总字数统计英文单词,以及中文字的总和,其中一个单词视为一个字。
如果在使用上有任何问题,建议先阅读常见问题与建议。如果这些不能解决你的问题,建议以如下的顺序反馈使用过程中的问题:
如果你觉得项目的使用体验不好,或者想感谢我们的维护者们等等任何与使用无关的想法,都可以通过我们的在线聊天频道告诉我们。
SJTUThesis 是一个由诸多感兴趣的同学一起维护的开源项目,我们非常欢迎新的贡献者! 这里有很多贡献的方式:
- 帮助我们解答同学们的问题,这些问题你也可能遇到过并且知道如何解决
- 与我们一起维护项目的 Wiki 文档,Wiki 是可以直接编辑的
- 向我们贡献代码,我们有一些对新的贡献者比较友好的问题,你可以从这些问题开始熟悉贡献代码的流程
- 向周围同学安利 SJTUThesis,让更多的同学使用我们维护的模板
- 在我们的在线聊天频道上告诉我们你的使用体验,以及吐槽。如果你也想成为项目的长期维护者,也可以通过在线频道告诉我们 :-)
- 分离学位论文的使用文档和示例文档,准备提交到 CTAN #47
- 感谢 CTeX 提供了 LaTeX 的中文支持
- 感谢那位最先制作出博士学位论文 LaTeX 模板的交大物理系同学
- 感谢 William Wang 同学对模板移植做出的巨大贡献
- 感谢 @weijianwen 学长一直以来的开发和维护工作
- 感谢 @sjtug 以及 @dyweb 对 0.9.5 之后版本的开发和维护工作
- 感谢所有为模板贡献过代码的同学们,以及所有测试和使用模板的各位同学
上海交通大学校徽图片(sjtulogo.pdf
等)的版权归上海交通大学所有。其他部分使用 Apache License 2.0 授权。