Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
131 lines (83 sloc) 6.97 KB

上海交通大学学位论文模板

Build Status Build status GitHub Release GitHub Release Date Join the chat at https://gitter.im/sjtug/SJTUThesis

这是为撰写上海交通大学学士、硕士、博士学位论文或课程论文而准备的 XeLaTeX 模板,非官方出品。生成的学位论文文件参见 README.pdf,详细使用说明参见 SJTUThesis Wiki

封面展示

如何使用

SJTUThesis 共有三种编译方式支持:

第一种编译方式需要在本地安装 TeX 发行版,好处在于环境问题少,坏处在于安装过程比较漫长且繁琐。第二种编译方式是完全在线的,不需要在本地安装任何环境,缺点在于需要完全依赖 ShareLaTeX 网站,其在国内的稳定性存疑。第三种方式需要在本地安装 Docker,相比第一种,不会污染本地的环境。但要求用户对 Docker 有一定了解。

本地编译

因为本地编译涉及到 TeX 发行版的安装, 因此具体可参见 本地安装使用指南

ShareLaTeX 在线编译

我们有多个版本的模板在 ShareLaTeX 上可用,但是推荐使用最新版本,以避免可能遇到的一些问题。此外如果在 ShareLaTeX 上遇到问题建议尝试本地编译。

使用 Docker 编译

Docker Repository on Quay

在模板目录下执行以下命令即可:

docker pull quay.io/sjtug/sjtuthesis
./scripts/start-build.sh

Makefile 使用

编译生成学位论文 PDF 文件

通过以下指令,可以编译生成 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 授权。

You can’t perform that action at this time.