Skip to content
/ SJTUThesis Public template

上海交通大学 LaTeX 论文模板 | Shanghai Jiao Tong University LaTeX Thesis Template

License

Notifications You must be signed in to change notification settings

sjtug/SJTUThesis

Folders and files

NameName
Last commit message
Last commit date
Oct 21, 2024
Dec 27, 2023
Feb 25, 2025
Dec 27, 2023
Jan 1, 2025
Nov 7, 2024
Aug 28, 2022
Dec 27, 2022
Feb 13, 2022
Jul 16, 2024
Nov 26, 2024
Nov 29, 2019
May 5, 2023
Oct 21, 2024
Oct 21, 2024
Feb 25, 2025
Dec 27, 2023
Feb 25, 2025

Repository files navigation

SJTUThesis 示例模板

Build Status SJTUTeX Join Discussions

欢迎使用上海交通大学论文模板

本示例模板是应用上海交通大学学位论文 LaTeX 文档类 SJTUThesis 的一个完整实现。演示了排版中常用的例子,包括公式、表格、算法、参考文献等。 用户可以参考或者直接基于此示例文档撰写论文。

SJTUThesis 支持 XeTeX 与 LuaTeX 引擎,字符编码仅支持 UTF-8。

获取模板

下载模版

普通用户可以直接 clone 或者下载 master.zip

git clone https://github.com/sjtug/SJTUThesis.git
# ...or with SJTUG mirror
git clone https://mirror.sjtu.edu.cn/git/SJTUThesis.git/

模版更新频繁,且只维护最新版。如有问题,可以先尝试升级模版,而后根据“反馈问题”一栏进行反馈。

在线 LaTeX 编辑器

TeXPage

Overleaf

点击上方图标即可直接使用。

如果需要在其他在线 LaTeX 编辑器上使用(比如 SJTU LaTeX 文档助手),您可以下载 最新版压缩包,然后上传至相应平台。请注意,一般在线编辑器新建项目默认使用 pdflatex 编译器,您需要设置使用 XeLaTeX 编译器。

模板使用

如果你不熟悉 LaTeX 的编译流程,请参考以下说明编译文档。在编译前,需要安装最新的 TeXLive 发行版。

使用编辑器

VS Code

安装 “LaTeX Workshop” 扩展,选择预设配方 Recipe: latexmk (xelatex) 编译即可;也可以在设置中将 latex-workshop.latex.recipe.default 改为 latexmk (xelatex) 将其设置为默认选项。

TeXstudio

模板内置 TeXstudio 魔术注释,可开箱即用。

使用脚本

Linux 与 macOS

推荐使用模版提供的 Makefile 进行编译,具体来说我们提供了如下几条可用的命令:

make all                      # 编译生成 main.pdf
make clean                    # 删除编译所产生的中间文件
make cleanall                 # 删除 main.pdf 和所有中间文件
make wordcount                # 论文字数统计

Windows

对于 Windows 用户,我们也提供了编译脚本 Compile.bat。可以双击直接编译,也可以在命令提示符窗口中使用脚本提供的额外功能:

.\Compile.bat thesis          # 编译生成 main.pdf
.\Compile.bat clean           # 删除编译所产生的中间文件
.\Compile.bat cleanall        # 删除 main.pdf 和所有中间文件
.\Compile.bat wordcount       # 论文字数统计

更多关于模板的实现细节以及使用信息,请查看使用文档 sjtutex.pdf

反馈与贡献

本模版是由诸多感兴趣的同学一起维护的开源项目,我们非常欢迎问题反馈和新的贡献者!

反馈问题

如果在使用上有任何问题,建议先查阅项目的 Wiki 文档,并使用左上角的搜索功能进行搜索。 如果以上方法不能解决你的问题,建议通过以下方式进行反馈(按推荐顺序排序):

成为贡献者

这个仓库是面向用户的示例模版,如果你有很好的排版示例,可以提交到此仓库与大家分享。如果你想要为 SJTUThesis 文档类贡献代码,可移步 SJTUTeX

texmf/tex/latex/sjtuthesis 目录下的内容都是通过 SJTUTeX 的 sjtuthesis.dtx 文件自动生成的。如果您需要修改文档类的内容,应该修改 SJTUTeX 仓库中的 sjtuthesis.dtx,而非直接修改 cls 文件。

因此,如果您修改了 sjtuthesis 模版类,应该先给 SJTUTeX 发 PR,然后再将更新同步到本仓库。

在贡献之前,你可以从这些问题开始熟悉贡献代码的流程。除了提交 Pull Request 之外,还有以下方式可以进行贡献:

  • 帮助我们解答同学们的问题,这些问题你也可能遇到过并且知道如何解决;
  • 与我们一起维护项目的 Wiki 文档,Wiki 任何人都可以直接编辑;
  • 向周围同学安利 SJTUThesis,让更多的同学使用我们维护的模板;
  • 在我们的讨论组中分享你的使用体验,以及吐槽。如果你也想成为项目的长期维护者,也可以通过讨论组告诉我们。:-)

致谢

  • 感谢 CTeX-kit 提供了 LaTeX 的中文支持;
  • 感谢那位最先制作出博士学位论文 LaTeX 模板的物理系同学;
  • 感谢 William Wang 同学对模板移植做出的贡献;
  • 感谢 @weijianwen 学长开创性的工作;
  • 感谢 @sjtug 对 0.10 及之后版本的开发和维护工作;
  • 感谢所有为模板贡献过代码的同学们,以及所有测试和使用模板的各位同学。

软件许可证

上海交通大学校徽校名图片(sjtu-vi-logo-blue.pdf 等)的版权归上海交通大学所有。

sjtuthesis.cls 文档类与相关附属文件使用 LPPL 授权。

其他部分使用 Apache License 2.0 授权。