Warning
本项目已暂停维护，请使用 https://github.com/sysu/better-thesis 仓库提供的模板
Gitee 仓库镜像（自动同步 GitHub 主仓库，仅供只读访问）
中山大学学位论文 Typst 模板，项目基于 PKUTHSS-Typst 重构。
当前还未完全符合学位论文格式要求，欢迎同学们贡献代码！模板交流 QQ 群：797942860（点此直接加入）
输出成品文件预览（每 6 小时自动更新）：thesis.pdf
Q：我不会 LaTeX，可以用这个模板写论文吗？
A：完全可以！Typst 是一个比 LaTeX 更简单的排版语言，同时安装更加方便，编译更加快速！
由于 Typst 还处于初期的快速开发阶段，本项目需要使用从源码编译的 Typst 版本才能正常生成 PDF。仓库提供了一键安装脚本，按照使用说明运行即可。
- 下载本仓库，或者使用
git clone https://github.com/howardlau1999/sysu-thesis-typst命令克隆本仓库。 - 右键
install_typst.ps1文件，选择“用 Powershell 运行”，等待 Typst 安装完成。 - 根据 Typst 文档，参考 项目结构 中的说明，按照你的需要修改论文的各个部分。
- 双击运行
compile.bat，即可生成thesis.pdf文件。
- 下载本仓库，或者使用
git clone https://github.com/howardlau1999/sysu-thesis-typst命令克隆本仓库。 - 使用命令行安装 Rust 工具链以及 Typst：
# 安装 Rust 环境并激活，之前安装过则不需要执行下面这两行
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source $HOME/.cargo/env
# 安装 Typst CLI
cargo install --git https://github.com/typst/typst.git typst-cli
# 访问缓慢的话，执行以下命令设置清华镜像源，并从镜像站安装
cat << EOF > $HOME/.cargo/config
[source.crates-io]
replace-with = "tuna"
[source.tuna]
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"
EOF
cargo install --git https://ghproxy.com/https://github.com/typst/typst.gitinfo.typ文件中包含论文的基本信息，包括作者、学位、导师、学位论文题目等。custom.typ文件中包含论文的自定义设置，包括行距，字体等。thesis.typ文件是论文的主体，包含论文的各个章节。在添加或者删除章节文件后，需要同步修改这个文件中的#include命令。template.typ文件是论文的模板，包含论文的各个部分的格式。一般不需要修改。
chapters文件夹包含了论文的各个章节文件，你可以自由地增加或删除章节文件，按你自己需要的方式组织文件。在添加或删除文件后，需要同步修改thesis.typ文件中的#include命令。templates文件夹包含了论文的各个部分的模板文件，你可以自由地增加或删除模板文件，按你自己需要的方式组织文件。在添加或删除文件后，需要同步修改template.typ文件中的#include命令。欢迎贡献新的模板文件。functions文件夹包含了模板使用到的各种自定义辅助函数，如果你想贡献代码，可以在这个文件夹中添加新的辅助函数。fonts文件夹包含了模板使用到的字体文件，你可以按需要添加或者删除字体文件。在添加或删除文件后，可以运行typst --font-path fonts fonts查看 Typst 检测到的字体文件。bibs文件夹包含了论文的参考文献文件，你可以按需要添加或者删除参考文献文件，目录结构没有特殊需求。images文件夹包含了论文中使用到的图片文件，你可以按需要添加或者删除图片文件，目录结构没有特殊需求。vi文件夹包含了校徽的矢量图文件。