基于 Typst 的中国地质大学（武汉）学位论文模板

cug-thesis-typst 适用于中国地质大学（武汉）学位论文模板，具有便捷、简单、实时渲染等特性。欢迎各位同学、校友们前来 Issues 交流学习~

为什么考虑 Typst 实现学位论文模板？

1. 首要是为了学习。看到 Typst 惊人的成长速度，确实有点小激动。Typst 似乎继承了 Markdown、Tex、Wiki 各自的优点于自身。
2. 本人写文档相对来说较为粗心，使用 Word 模板会忍不住的反复去检查格式是否符合要求。又听说 Latex 写毕业论文可能后面编译一次需要几十秒~~ 虽然这个自己只是听说，但是 LaTex 在线编辑的方式 Overleaf 达到一定的编译时间收费这个是真的，就我小论文都勉强够用。自己使用开源的 Overleaf 搭建的平台功能上总是缺点什么，奈何自己又不懂~ 自己搭建的本地的 Tex 环境随解决了编译时间付费问题。但是涉及到的宏包、环境，前段时间打开突然不能用了，捣鼓半天不知是何原因~ 直至重新装了2024年的 LaTex 环境才重新运行自己的学位论文。
3. 惊喜的发现 Typst 编译速度真的非常快~ 经过一段时间的了解，发现基本满足制作学位论文的需求，于是乎~就有了这个cug-thesis-typst。

参考规范

• 本科生论文模板参考：学士学位论文写作规范（2018版）-中国地质大学本科生院
• 研究生论文模板参考：研究生学位论文写作规范（2015版）-中国地质大学研究生院

模板认可度问题

值得提醒的是毕竟是民间实现模板，有不被学院认可的可能性~

目前已知情况，计算机学院、地信学院对于学位论文要求不是太苛刻。去年计算机学院师兄使用了 Github 的 Latex 模板 Timozer/CUGThesis: 中国地质大学（武汉）研究生学位论文 TeX 模板 完成学位论文。

而且哈~ 咱们的研究生学位论文写作规范（2015版）似乎要求似乎不是特别苛刻。请自行斟酌~

小声~ 研究生学位论文写作规范（2015版）似乎还有一处前后矛盾的要求，斯~

使用方法

Typst 在线编辑

本模板已上传 Typst Universe，您可以使用 Typst 的官方 Web App 进行编辑。只需要在 Typst Web App 中的 Start from template 里选择 modern-cug-thesis，即可从模板创建项目。

如果你经常使用 VS Code，比较推荐使用这个~

使用步骤：安装 typst (命令行工具) → VS Code 插件(实时预览、智能提醒)，随后就可以准备开始项目了(打开项目文件、撰写论文内容)

1. 安装 typst ：

   • macOS: brew install typst
   • Windows: winget install --id Typst.Typst -l "D:\bw_ch\toolkits\typst"

2. 安装插件：在 VS Code 中安装 Tinymist Typst

3. 准备项目文件：

   • 方法一：Fork Repo。去项目页面Fork ，随后使用命令 git clone https://github.com/<you github username>/cug-thesis-typst.git 将整个项目克隆到本地，寻找 template/thesis.typ。
   • 方法二：使用 Typst Packages。按下 Ctrl + Shift + P 打开命令界面，输入 Typst: Show available Typst templates (gallery) for picking up a template 打开 Tinymist 提供的 Template Gallery，然后从里面找到 cug-thesis，点击 ❤ 按钮进行收藏，以及点击 + 号，就可以创建对应的论文模板了，会出现 ref.bib 以及 thesis.typ。

4. 打开开始编写论文内容~

版本提醒： 请确保本地已安装 Typst，推荐使用最新版本。 下面是推荐的 Typst、VS Code 插件与模板版本的对应关系：

如果是Typst 0.12.0 版本的老用户，仅仅需要在命令行使用 typst update即可。其中，VS Code插件版本也需要对应，建议设置为自动更新插件。

Typst 版本	模板版本	Tinymist Typst插件	主要更新内容
0.13.0	0.2.6	0.12.21	最后一个已知问题： 首段首行缩进对于标题垂直间距产生影响
0.12.0	0.2.5	0.12.19	第一个比较完善的版本

Q&A

使用这个模板需要了解些什么？

需要掌握一些 Markdown Like 标记用来编写文档，了解文章大致结构即可【见 template\thesis.typ 中介绍】。

参考资料：

• 官网Tutorial：Writing in Typst – Typst Documentation、Tutorial中文翻译
• Typst 语法官网文档：Syntax – Typst Documentation、语法中文翻译
• 中文社区小蓝书：The Raindrop-Blue Book (Typst中文教程)

我不会代码、不会 LaTeX 可以使用吗？从接触到使用需要多久？

可以的。因为文档样式该模板已经提供，Typst 有标记模式（语法糖），使用起来就类似于 Markdown，完全不需要较多的代码功底。

如果有 Markdown 基础，基本上可以直接上手~ 如果没有，跳回第一个问题，查看相关说明。

为啥使用方法里面建议 Fork ？不是直接 Clone ？

这样可以同步更新。模板刚刚发布，虽然基本没有什么问题了，可能会有细节调整或者代码优化。

建议： 大家使用时，可以直接复制 template 文件夹，重命名为 mythesis （已经添加至 .gitignore），这样更新布局不会影响到个人的论文内容。

Typst 是个啥玩意？相较于 LaTeX 有啥优势？

提供两篇写的很用心的文章：

• 探索 Typst，一种类似于 LaTeX 的新排版系统（译文）、原文
• Typst 中文用户使用体验 - OrangeX4大佬

在线模式字体显示异常，怎么办？

你需要上传 https://github.com/Rsweater/cug-thesis-typst/tree/main/fonts/Windows-SysFonts 里面所有字体，将 fonts/Windows-SysFonts 文件夹上传至模板创建的项目根目录即可。

为什么提醒类似 unknown font family: songti sc 的 Warning ?

如果你的设备是 Windows ，会遇见所有的 sc 结尾的字体找不到的提醒，因为这个是 Mac OS 系统字体，可以忽略。模板为了适应不同的平台，模板默认设置了多种字体。但是只要不是两种系统的字体均报 Warning，就不会影响渲染效果。如果不想看报错，可以去 Rsweater/cug-thesis-typst/tree/main/fonts 安装所有字体。

致谢

• 感谢 modern-nju-thesis、better-thesis、HIT-Thesis-Typst 为本模板提供了项目实现思路。
• 感谢 Timozer/CUGThesis: 中国地质大学（武汉）研究生学位论文 TeX 模板 提供了页面布局依据。
• 感谢 Typst 非官方中文交流群 的大佬的答疑解惑，感谢 tzhTaylor 大佬交流 CJK 第一段首行缩进的解决方案。
• 感谢 evibhm 校友抓虫子。

License

This project is licensed under the MIT License.