Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
2154243
删去第四章和附录中多余的图像,附录改为展示如何导入外部.csv表格
1FCENdoge May 24, 2026
d25844e
注释ppt模板中的图片
1FCENdoge May 24, 2026
52ce396
重写论文模板示例内容
1FCENdoge May 25, 2026
752cff8
为ppt示例添加图像
1FCENdoge May 25, 2026
b2cb78d
将本科生论文写作规范换成网页版链接
1FCENdoge May 25, 2026
4b20b6c
参考文献样式使用国标样式
1FCENdoge May 25, 2026
15c7ec3
参考文献引用格式全面适配gbt 7714-2025
1FCENdoge May 26, 2026
df763f2
issue #115 #122 ,将参考文献样式从[C]//改为[C].
1FCENdoge May 26, 2026
7e7bb29
将研究生论文写作规范换成网页版链接
1FCENdoge May 27, 2026
06ee2ee
将研究生论文写作规范换成网页版链接
1FCENdoge May 27, 2026
99cb9ed
优化摘要页的代码
1FCENdoge May 27, 2026
79dc4f4
删除模板多余图片
1FCENdoge May 30, 2026
979c7cf
修改readme文档
1FCENdoge May 30, 2026
6fa5f9a
修改README.md
1FCENdoge May 30, 2026
09c062d
debug
1FCENdoge May 30, 2026
0a657b4
修改 gitignore 文件
1FCENdoge May 31, 2026
f568baa
对 guide 中部分内容做了修订
1FCENdoge May 31, 2026
dca3c48
修订 guide
1FCENdoge May 31, 2026
ea82a06
修订 guide,对老版本 LaTeX 编译器提供支持
1FCENdoge Jun 1, 2026
0b31507
修复一些次要的警告,删除一些不正确的文献引用
1FCENdoge Jun 1, 2026
650684e
添加示例内容并编写 changelog
1FCENdoge Jun 1, 2026
02551dc
修订 guide
1FCENdoge Jun 1, 2026
6614d3f
ppt 模板添加示例内容
1FCENdoge Jun 2, 2026
81bf53e
bug fix
1FCENdoge Jun 2, 2026
79a717e
ppt 模板增加示例内容
1FCENdoge Jun 2, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 8 additions & 70 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,9 +1,7 @@
*.swp

node_modules/

/.vscode
/*.synctex.gz
main.pdf
sysuthesis-guide.pdf
pre.pdf
*.hd

## Core latex/pdflatex auxiliary files:
*.aux
Expand All @@ -27,7 +25,6 @@ node_modules/
# *.ps
# *.eps
# *.pdf
!template/image/sysu-logo.pdf

## Generated if empty string is given at "Please type another file name for output:"
.pdf
Expand Down Expand Up @@ -117,11 +114,6 @@ acs-*.bib
*.glo
*.gls
*.glsdefs
*.lzo
*.lzs

# uncomment this for glossaries-extra (will ignore makeindex's style files!)
# *.ist

# gnuplottex
*-gnuplottex-*
Expand All @@ -143,20 +135,18 @@ acs-*.bib

# knitr
*-concordance.tex
# TODO Uncomment the next line if you use knitr and want to ignore its generated tikz files
# *.tikz
# TODO Comment the next line if you want to keep your tikz graphics files
*.tikz
*-tikzDictionary

# listings
*.lol

# luatexja-ruby
*.ltjruby

# makeidx
*.idx
*.ilg
*.ind
*.ist

# minitoc
*.maf
Expand Down Expand Up @@ -220,10 +210,6 @@ pythontex-files-*/
# todonotes
*.tdo

# vhistory
*.hst
*.ver

# easy-todo
*.lod

Expand All @@ -236,9 +222,8 @@ pythontex-files-*/
# xindy
*.xdy

# xypic precompiled matrices and outlines
# xypic precompiled matrices
*.xyc
*.xyd

# endfloat
*.ttt
Expand All @@ -261,15 +246,9 @@ TSWLatexianTemp*
# Kile
*.backup

# gummi
.*.swp

# KBibTeX
*~[0-9]*

# TeXnicCenter
*.tps

# auto folder when using emacs and auctex
./auto/*
*.el
Expand All @@ -279,44 +258,3 @@ TSWLatexianTemp*

# standalone packages
*.sta

# Makeindex log files
*.lpz

# xwatermark package
*.xwm

# REVTeX puts footnotes in the bibliography by default, unless the nofootinbib
# option is specified. Footnotes are the stored in a file with suffix Notes.bib.
# Uncomment the next line to have this generated file ignored.
#*Notes.bib
diff
*.xml
*.nav
*.snm
~*
.~*
.fuse*
*.txt.data
*.zip
analyse/
paper
ardrone.pdf
template.pdf
old
*.aux
*.bbl
*.blg
*.ent
*.loa
*.lof
*.log
*.lot
*.out
*.toc
main.pdf
missfont.log
svn-commit.tmp
sysuthesis.tar.gz
中山大学本科毕业论文非官方LaTeX模版0.0.*.tar.gz

12 changes: 12 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

## [2.1.0] - 2026-06-01

### 版本亮点

- 支持本科/研究生论文模板切换。
- 支持 GB/T 7714-2025 参考文献引用样式。
- 支持跨平台编译。
- 附带中山大学答辩 ppt LaTeX 模板。
- 简化示例内容。


[Unreleased]: https://github.com/SYSU-SCC/sysu-thesis/compare/v2.1.0...HEAD
[2.1.0]: https://github.com/SYSU-SCC/sysu-thesis/releases/tag/v2.1.0
129 changes: 56 additions & 73 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,32 @@
# 中山大学 $\LaTeX$ 毕业论文模板
# 中山大学 $\LaTeX$ 毕业论文模板(本科/研究生)

本项目现已得到中山大学计算机学院支持。我们正在努力增加 feature ,满足本院毕业设计的要求,并争取进一步完善,成为中大官方 $\LaTeX$ 毕设模板。Demo 与源码可在 [releases](https://github.com/SYSU-SCC/sysu-thesis/releases) 页面下载。
[![GitHub release](https://img.shields.io/github/release/SYSU-SCC/sysu-thesis/all.svg)](https://github.com/SYSU-SCC/sysu-thesis/releases/latest)
[![GitHub commits](https://img.shields.io/github/commits-since/SYSU-SCC/sysu-thesis/latest.svg)](https://github.com/SYSU-SCC/sysu-thesis/commits/master/)
[![Test](https://github.com/SYSU-SCC/sysu-thesis/actions/workflows/test.yml/badge.svg)](https://github.com/SYSU-SCC/sysu-thesis/actions/workflows/test.yml)

**本模板在 v2.0 版本进行开始([#114](https://github.com/SYSU-SCC/sysu-thesis/pull/114))支持本硕博切换,其中本科生模板为计算机学院官方模板,硕博模板正在通过学院审核。使用前请注意,2.0 版本代码进行了重构,与之前的格式可能有细微差别,如遇学校格式审核问题,请回退至 [v1.2](https://github.com/SYSU-SCC/sysu-thesis/releases/tag/v1.2.20241211) 。**
本项目是中山大学的毕业论文/设计 LaTeX 模板 sysu-thesis,现已得到中山大学计算机学院等学院的支持,兼容最新版的 TeX Live、MacTeX 、MiKTeX 发行版,支持跨平台使用。

**诚挚邀请广大校友加入本项目维护,详见 [#67](https://github.com/SYSU-SCC/sysu-thesis/issues/67)、[#105](https://github.com/SYSU-SCC/sysu-thesis/pull/105)。希望加入 collaborator 团队的同学可联系 [@wu-kan](https://github.com/wu-kan)。**
注意:

## 如何使用
1. 使用说明文档 `sysuthesis-guide.pdf` 在发布版中附带,用户也可自行编译;**使用模板前应仔细阅读使用说明文档 `sysuthesis-guide.pdf`**。

2. 本科论文模板格式按照本科生论文规范编写,全校通用。研究生模板满足中法核工程与技术学院研究生论文格式要求的同时,也为其他学院提供可供使用和参考的模板。如遇格式问题,请及时提交 issue 或者通过QQ群反馈,QQ群号:929324613。

3. 本模板要求 TeX Live、MacTeX、MiKTeX 不低于 2020 年的发行版, 并且尽可能升级到最新。安装和升级方法见[新手指南](https://github.com/ustctug/ustcthesis/wiki/新手指南)。

### overleaf 编辑(在线)
4. **不支持** [CTeX 套装](https://github.com/ustctug/ustcthesis/wiki/常见问题#3-模板支持用-ctex-套装编译吗)。

本模板可以使用 [overleaf](https://www.overleaf.com/) 在线编辑,需要在 [releases](https://github.com/SYSU-SCC/sysu-thesis/releases) 页面提前下载 `Source code (zip)`。
**诚挚邀请广大校友加入本项目维护,希望加入 collaborator 团队的同学可联系 [@wu-kan](https://github.com/wu-kan)。**

步骤如下:
## Star History:

1. 进入 [overleaf](https://overleaf.com) 并登录账号
2. 左侧 `New Project` 选择 `Upload Project`
3. 上传 `.zip` 压缩包,建立新项目
4. 点击 `menu`,滑动到下方 `Settings` 的 `Compiler` 选择 `XeLaTeX`
5. 打开 `main.tex` 文件,点击中间右侧上方的 `Recompile` 进行编译
6. 如果顺利可以看到 pdf 的预览
7. 如果无法加载图片只有路径信息,点击 `Recompile` 旁边的倒三角,其中的 `Compile Mode` 选择 `Normal` 模式
[![Stargazers over time](https://starchart.cc/SYSU-SCC/sysu-thesis.svg?variant=adaptive)](https://starchart.cc/SYSU-SCC/sysu-thesis)

此时可以得到完整的 `main.pdf` 文件。
## 下载地址

- GitHub Releases:<https://github.com/SYSU-SCC/sysu-thesis/releases>

## 如何使用

### GitHub Actions 自动构建(在线)

Expand All @@ -42,34 +46,41 @@

在容器环境中,可以使用 `make`(或 `make help`)查看所有可用的编译子命令。例如,使用 `make main` 进行编译并生成 `main.pdf` 文件,或者使用 LaTeX Workshop 插件进行编译与预览。

### texlive 编辑(本地)

本模板需要使用 texlive(>=2020) 进行编译,编译命令如下:
### TeX Live 编辑(本地)

```bash
# 查看帮助信息,列出所有可用编译子命令
# make help
# 编译论文正文
make main
```
本模板需要使用不低于 2020 年的 TeX Live 发行版进行编译,编译命令如下:

即可生成 `main.pdf` 文件。如有环境问题,推荐对照 [GitHub Actions](./.github/workflows/test.yml) 中的环境进行配置。
- 编译模板的使用说明文档 `sysuthesis-guide.pdf`:
```
latexmk -xelatex sysuthesis-guide.tex
```
- 编译论文 `main.pdf`:
```
latexmk -xelatex main.tex
```
- 如需清理论文编译过程中的临时文件,可以:
```
latexmk -c
```

## TODO List
- 以上编译过程也可以用 `make` 工具:
```
make doc # 编译生成 sysuthesis-guide.pdf
make # 编译生成论文 main.pdf
make clean # 删除编译过程中生成的临时文件
```

- [ ] 增加 [overleaf](https://www.overleaf.com/) 等模板库的自动发布,可一键在 overleaf 中打开项目。
- [ ] 进一步优化代码,可支持多种需求
如有环境问题,推荐对照 [GitHub Actions](./.github/workflows/test.yml) 中的环境进行配置。

希望大家踊跃提出自己的想法,提交 pr,一起完善该 $\LaTeX$ 模板, Make **SYS**U Great Again!

## 需要注意的问题

1. 字体问题,见 [#29](https://github.com/SYSU-SCC/sysu-thesis/issues/29)

## 相关规范

1. [本科生](./specifications/附件1.中山大学本科生毕业论文(设计)写作与印制规范.doc)
2. [研究生](http://graduate.sysu.edu.cn/rules)
1. [本科生](https://spa.sysu.edu.cn/zh-hans/article/1744)
2. [研究生](https://lifesciences.sysu.edu.cn/sites/default/files/2025-03/中山大学研究生学位论文格式要求.pdf)

## 关于展示

Expand All @@ -82,49 +93,21 @@ make main
- [NelsonCheung-cn/SYSU-beamer-template](https://github.com/NelsonCheung-cn/SYSU-beamer-template)
- [Very-White/sysu_ppt_template](https://github.com/Very-White/sysu_ppt_template)

## 一些说明

1. 已征得原作者,17 届中大数据院软件工程校友黄俊杰(@huangjj27)的同意,我们团队未来将长期维护该项目。
2. 原项目 repo 可见 [gitlab](https://gitlab.com/sysu-gitlab/latex-group/thesis),原项目 wiki 可见 [wiki](https://gitlab.com/sysu-gitlab/latex-group/thesis/-/wikis/home),原 repo 中的信息将会在之后更新到本 repo 中。

---

~~这里是分割线,以下是原始 repo 的 README~~

---

本维护项目由 17 届中大数据院软件工程校友黄俊杰(@huangjj27)发起, 发起理由如下:

1. 中山大学在 github 上[LaTeX 官方模板项目](http://github.com/sysu/sysuthesis)已经有 2 年多的时间没有维护
1. [@chunkwong](https://github.com/chungkwong)师兄在 github 上放出了中大的第一个[非官方的本科论文 LaTeX 模板](https://github.com/chungkwong/sysu_thesis), 并由[@guanyingc](https://github.com/guanyingc)师兄接力改进
1. 上述两位师兄毕业后均无法抽空维护项目

基于以上理由,本项目维护小组成立,并***诚邀各届校友参与开发维护, 为中大莘莘学子编写毕业论文提供方便***。

## 使用指南

请移步到[项目 wiki](https://gitlab.com/sysu-gitlab/latex-group/thesis/wikis/home)

_注意: 最新代码在 dev 分支上, 获取代码前请先确认分支._

## 致谢
## 反馈问题

1. 感谢[@chunkwong](https://github.com/chungkwong)师兄在 Github 上放出了中大第一个[非官方的本科论文 LaTex 模板](https://github.com/chungkwong/sysu_thesis)
1. 感谢[@guanyingc](https://github.com/guanyingc)师兄在模板结构化分解上作出了[极大的贡献](https://github.com/guanyingc/SYSU-LaTex-Thesis)
1. 感谢@huangjj27 师兄在模板样式规范化做出极大的贡献
1. 感谢@a20185 @Kinpzz @yttty @perqin @noeagles 等人[对 v4.6.0 作出极大的贡献](https://gitlab.com/sysu-gitlab/latex-group/thesis/merge_requests/32)
1. PPT 的模板源自<http://far.tooold.cn/post/latex/beamertsinghua>
1. 最后, 感谢 Donald Ervin Knuth 教授发明了`tex`这么好(zhe)用(teng)的工具。
Finally, thanks Prof. Donald Ervin Knuth for inventing such useful tool as tex.
如果发现模板有问题,请按照以下步骤操作:

## 错误反馈以及改进
1. 阅读学校的标准,判断是否符合学校的要求:[本科生论文规范](https://spa.sysu.edu.cn/zh-hans/article/1744);[研究生论文规范](https://lifesciences.sysu.edu.cn/sites/default/files/2025-03/中山大学研究生学位论文格式要求.pdf);
2. 阅读 [常见问题 FAQ](https://github.com/ustctug/ustcthesis/wiki/常见问题);
3. 将 TeX 发行版和宏包升级到最新,并且将模板升级到 Github 上最新版本,查看问题是否已经修复;
4. 在 [GitHub Issues](https://github.com/ustctug/ustcthesis/issues)中搜索该问题的关键词;
5. 在 [GitHub Issues](https://github.com/1FCENdoge/sysuthesis/issues)中提出新 issue。

1. 同学们如果在编译或者使用过程中遇到了一些问题,请参照[这里](ihttps://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way)的步骤尝试解决问题。如果还是没法解决,请[email](mailto:incoming+sysu-gitlab/latex-group/thesis@gitlab.com)汇报错误。
1. 如果您想参与项目的维护,我们强烈建议您发起访问请求(Access request)到本项目,即可成为本项目的开发人员! 我们***非常欢迎校友的加入***。
或者,克隆本仓库到您的 gitlab 仓库中,修改完成后给本项目提交`Merge Request`。
如果导师或者院系在格式上有额外的要求,请将老师的邮件截图放在 issue 中或者在QQ群中反馈。作者会考虑增加接口以便修改格式。QQ群号:929324613,或者扫描下方二维码:
<img width="1284" height="2283" alt="IMG_0515" src="https://github.com/user-attachments/assets/35a835fa-05a8-472e-a14b-3ce8adea3c0e" />

## 声明
## 更多资料

1. 您可以任意地使用和修改这个模板,但该模板可能无法满足最新的《中山大学本科生毕业论文(设计)写作与印制规范》。
1. 目前项目组人手紧缺,**强烈欢迎校友们的加入**。
1. 目前基于 GitLab CI 的构建工具[使用的字体与规范要求有轻微的区别](https://gitlab.com/sysu-gitlab/latex-group/thesis/merge_requests/29#note_66184589),请在使用时注意风险。
- [LaTeX 新手入门指南](https://github.com/ustctug/ustcthesis/wiki/新手指南)
- [常见问题 FAQ](https://github.com/ustctug/ustcthesis/wiki/常见问题)
- [参与开发](https://github.com/ustctug/ustcthesis/wiki/参与开发)
5 changes: 3 additions & 2 deletions docs/abstract.tex
Original file line number Diff line number Diff line change
@@ -1,9 +1,10 @@
% !TeX root = ../main.tex

\sysusetup{
keywords = {本科毕业论文,\LaTeX\ 模板,中山大学},
keywords = {本科毕业论文, \LaTeX\ 模板, 中山大学},
keywords* = {undergraduate thesis, \LaTeX\ template, Sun Yat-Sen University},
keywords** = {Mémoire de bachelor, L'Abstract, Mots-clés},
% 法语摘要的关键词,不需要请注释。
% keywords** = {Mémoire de bachelor, L'Abstract, Mots-clés},
}

\begin{abstract}
Expand Down
10 changes: 4 additions & 6 deletions docs/chap01.tex
Original file line number Diff line number Diff line change
Expand Up @@ -25,15 +25,13 @@ \section{本文的论文结构与章节安排}

\label{sec:arrangement}

本文共分为六章,各章节内容安排如下:
本文共分为四章,各章节内容安排如下:

第一章绪论。简单说明了本文章的选题背景与意义。

第二章为本科生毕业论文写作与印制规范。本章节就学校的规范,逐点进行描述,并给出来了相关例子说明本模板在格式上的正确性。
第二章为插图和表格示例。

第三章为本模板的使用说明。
第三章为数学公式与定理示例。

第四章为可用的\LaTeX 的代码段方便大家进行编辑。

第五、六章是本文的最后两章,作为空白章节例子。
第四章为算法、代码与其他用法。

Loading
Loading