Awesome
基于 Typst 的中山大学学位论文模板
本科生模板已经符合学位论文格式要求(#6),欢迎同学/校友们贡献代码/反馈问题(GitLab issue/邮件)!
模板交流 QQ 群:797942860
参考规范
- 本科生论文模板参考 中山大学本科生毕业论文(设计)写作与印制规范 2020年发
- 研究生论文模板参考 中山大学研究生学位论文格式要求
使用方法
typst.app
经过近一月紧张的迭代重构,本模板已经发布在typst-app.universe上,点击此处直接创建你的论文工程,并直接开始编写你的论文!
<!-- TODO(#1): 在 typst.universe 版本上线后分离模板项目 -->Windows 用户
- 下载本仓库,或者使用
git clone https://gitlab.com/sysu-gitlab/thesis-template/better-thesis
命令克隆本仓库。 - 右键
install_typst.ps1
文件,选择“用 Powershell 运行”,等待 Typst 安装完成。 - 根据 Typst 文档,参考 项目结构 中的说明,按照你的需要修改论文的各个部分。
- 双击运行
compile.bat
,即可生成thesis.pdf
文件。
Linux/macOS 用户
- 下载本仓库,或者使用
git clone https://gitlab.com/sysu-gitlab/thesis-template/better-thesis
命令克隆本仓库。 - 使用命令行安装 Rust 工具链以及 Typst:
# 安装 Rust 环境并激活,之前安装过则不需要执行下面这两行
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source $HOME/.cargo/env
# 安装 Typst CLI
cargo install 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 typst-cli
项目结构
详见 template\thesis.typ
FAQ
为什么 XXX 的功能不能用/不符合预期?
- 先参考 Typst 中文支持相关问题,以及 Typst 官方文档 与 tpyst.app/universe 仓库,了解相关问题进展或解决方案
- 如果在以上资料中找不到关联资料,可以参考是否在的 issue 列表 中能找到相关问题与进展。
- 如果依然没有线索,欢迎反馈问题(GitLab issue/邮件)
为什么学校学位论文已经有了 LaTeX 模板,还有 Typst 模板?
- 前述 LaTeX 模板目前仅有计算机学院官方指定使用,其他学院并没有统一指定
- 考虑到 LaTeX 对于大部分非计算机/理工科的学生入门成本比较高,因此有必要提供一种更加简洁清晰并且方便的论文模板,包括:
- 开箱即用:
- 如前文所述,本模板提供了在线直接编辑/保存/备份方案
- 本地使用模板时,模板组件可以简单地通过
typst
命令自动管理安装
- 语法简洁:typst 是与 markdown 类似的标记性语言,可以通过标记的方式来轻松控制语法(如
= 标题
、*粗体*
、_斜体_
@引用
、 数学公式$E = m c^2$
)
- 开箱即用:
为什么有两份 Typst 模板(sysu-thesis-typst 和 modern-sysu-thesis)?
后者是在前者的基础上,同时参考 modern-nju-thesis ,改造后适配了 typst.app/universe。以及,放到 @sysu 组织下提高了曝光度。
致谢
- 感谢 sysu-thesis-typst 提供了中山大学的页面样式与初版源码
- 感谢 modern-nju-thesis 提供了一个更好的代码组织架构
- 感谢中山大学 Typst 模板交流群(797942860)、Typst 中文交流群(793548390)群友的帮助交流。