English | 中文

⚠️ 免责声明： 本项目为民间开发的 Typst 学位论文模板，
非中国科学院大学官方模板，仅供学习与参考。
实际使用时请务必自行核对学校最新的论文格式要求，本模板不保证完全符合官方规范，存在不被学校或相关部门认可的风险，因使用本模板而产生的任何问题，开发者不承担相关责任。

🚀 特性

• 🎨 规范格式：遵循《中国科学院大学研究生学位论文撰写规范指导意见（2022 年）》规范格式开发
• 🔧 易于定制：配置文件简单，支持自定义字体、样式和布局
• 🛠️ 易于使用：Typst 上手难度与 Markdown 相当，源码可读性高
• 🖥️ 环境友好：Typst 包管理按需下载，原生支持中日韩等非拉丁语言，Web App / VS Code 开箱即用
• ✨ 编译极快：Typst 基于 Rust 编写，采用增量编译和高效缓存，文档再长也能秒级生成 PDF
• 🧑‍💻 现代编程：Typst 拥有变量、函数、包管理、错误检查、闭包等现代特性，支持函数式编程，标记/脚本/数学多模式可嵌套

⏩ 快速开始

1. 获取模板

# 方式一：直接克隆仓库
git clone https://github.com/WayneXuCN/modern-ucas-thesis.git
cd modern-ucas-thesis

# 方式二：下载最新版本
wget https://github.com/WayneXuCN/modern-ucas-thesis/archive/refs/heads/main.zip
unzip main.zip

2. 编辑论文

修改 template/thesis.typ 文件开始撰写您的论文：

#import "../lib.typ": *

#show: documentclass.with(
  title: "您的论文标题",
  author: "您的姓名",
  // 其他配置...
)

// 开始撰写您的论文内容

3. 编译生成

# 编译生成 PDF
typst compile template/thesis.typ

# 监听文件变化，自动编译
typst watch template/thesis.typ

📁 项目结构

modern-ucas-thesis/
├── template/           # 模板文件目录
│   ├── thesis.typ     # 主论文文件
│   ├── ref.bib        # 参考文献
│   └── images/        # 图片资源
├── utils/             # 工具函数
├── pages/             # 页面模板
├── layouts/           # 布局模板
├── lib.typ            # 主库文件
└── docs/              # 文档

🛣️ 开发路线

🧰 基础功能

🎯 学位类型支持

⚙️ 高级功能

图例：✅ 已完成 | 🚧 进行中 | 📋 计划中

🔧 配置说明

基本配置

在 template/thesis.typ 文件中修改以下配置：

#show: documentclass.with(
  title: "论文标题",
  author: "作者姓名",
  supervisor: "导师姓名",
  degree: "学位类型",
  major: "专业名称",
  // 更多配置选项...
)

自定义字体

模板支持自定义字体配置，详见 fonts/ 目录。

图片与资源

将图片放置在 template/images/ 目录下，在论文中使用相对路径引用。

🛠️ 开发指南

template 目录

• thesis.typ 文件: 你的论文源文件，可以随意更改这个文件的名字，甚至你可以将这个文件在同级目录下复制多份，维持多个版本。
• ref.bib 文件: 用于放置参考文献。
• images 目录: 用于放置图片。

内部目录

• utils 目录: 包含了模板使用到的各种自定义辅助函数，存放没有外部依赖，且 不会渲染出页面的函数。
• pages 目录: 包含了模板用到的各个 独立页面，例如封面页、声明页、摘要等，即 会渲染出不影响其他页面的独立页面的函数。
• layouts 目录: 布局目录，存放着用于排篇布局的、应用于 show 指令的、横跨多个页面的函数，例如为了给页脚进行罗马数字编码的前言 preface 函数。
  • 主要分成了 doc 文稿、preface 前言、mainmatter 正文与 appendix 附录/后记。
• lib.typ:
  • 职责一: 作为一个统一的对外接口，暴露出内部的 utils 函数。
  • 职责二: 使用 函数闭包 特性，通过 documentclass 函数类进行全局信息配置，然后暴露出拥有了全局配置的、具体的 layouts 和 pages 内部函数。

代码格式化

本项目使用 typstyle 进行代码格式化：

# 安装 typstyle
brew install typstyle  # macOS
cargo install typstyle # 其他平台

# 格式化代码
make format           # 格式化所有文件
make format-check     # 检查格式
./format-typst.sh -a  # 使用脚本格式化

参与贡献

• 在 Issues 中提出你的想法，如果是新特性，可以加入路线图！
• 实现路线图中仍未实现的部分，然后欢迎提出你的 PR。
• 同样欢迎 将这个模板迁移至你的学校论文模板，大家一起搭建更好的 Typst 社区和生态吧。

📝 文档

• 格式化工具文档
• 常见问题解答

🤝 致谢

• 感谢 nju-lug 开发的 modern-nju-thesis 模板，为此版本的开发提供了良好基础。
• 感谢 mohuangrui 开发的 ucasthesis LaTeX 模板，为此版本的开发提供了思路参考

📄 许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

⚖️ UCAS 标识版权声明

重要提示：本模板中包含的中国科学院大学（UCAS）相关标识和 Logo（位于 assets/vi/ 目录下）不适用于上述 MIT 许可证。

根据中国科学院大学官网声明：

1. 中国科学院大学形象标识的版权归中国科学院及中国科学院大学所有
2. 未经学校批准或者授权不得擅自使用，否则将视为侵权，为个人学习使用以及课堂教学使用等合理使用的情况除外
3. 对于不遵守此声明或者其他违法使用学校形象标识者，学校保留依法追究相关侵权行为人所有法律责任的权利

本模板作为学术论文撰写工具，属于个人学习使用和课堂教学使用范畴，符合合理使用原则。

如需将相关标识用于其他用途，请：

• 联系中国科学院大学相关部门获得授权
• 或使用自己的标识替换相关文件

免责声明：使用者应当了解并遵守相关版权法律法规，因违规使用 UCAS 标识而产生的法律责任由使用者自行承担。

📋 详细版权声明请参阅：LOGO_COPYRIGHT.md

💬 支持与反馈

如果您在使用过程中遇到问题或有改进建议，欢迎：

• 🐛 报告问题
• 💡 提出建议
• 🔧 提交代码