modern-ucas-thesis

基于 Typst 的中国科学院大学学位论文模板，遵循《中国科学院大学研究生学位论文撰写规范指导意见（2022年）》与《中国科学院大学本科生毕业论文（设计）撰写规范指导意见（2023年10月修订）》格式要求。

⚠️ 免责声明：本项目非官方出品，使用前请自行核对学校最新格式要求。

快速开始

1. 安装 Typst

# macOS
brew install typst

# Windows
winget install --id Typst.Typst

# 或使用官方安装脚本
curl -fsSL https://typst.community/install | sh

2. 使用项目

# 克隆仓库
git clone https://github.com/Vncntvx/modern-ucas-thesis.git
cd modern-ucas-thesis

# 编译论文
typst compile template/thesis.typ --root . --font-path fonts

# 编译开题报告（本科/研究生共用入口，见 template/proposal.typ）
typst compile template/proposal.typ --root . --font-path fonts

# 或开启实时预览
typst watch template/thesis.typ --root . --font-path fonts

3. 配置论文信息

编辑 template/thesis.typ：

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

#let (
  doc, preface, mainmatter, appendix,
  cover, decl-page, abstract, abstract-en,
  outline-page, list-of-figures-and-tables, notation,
  bilingual-bibliography, acknowledgement, backmatter,
  bifigure, bitable, continued-table, auto-table, aligned-equation,
) = documentclass(
  doctype: "doctor",       // "bachelor" | "master" | "doctor"
  degree: "academic",      // "academic" | "professional"
  anonymous: false,        // 盲审模式
  twoside: true,           // 双面打印模式
  fontset: "mac",          // "windows" | "mac" | "fandol" | "adobe"
  info: (
    title: ("论文标题", "副标题（可选）"),
    title-en: "Thesis Title",
    author: "张三",
    author-en: "Zhang San",
    // 导师：结构化字典列表 (name:, title:, affiliation:)，多导师第一导师在前
    supervisors: (
      (name: "李四", title: "教授", affiliation: "中国科学院××研究所"),
      (name: "王五", title: "研究员", affiliation: "中国科学院××研究所"),
    ),
    supervisors-en: (
      (name: "Si Li", title: "Professor", affiliation: "Institute of XXX, Chinese Academy of Sciences"),
      (name: "Wu Wang", title: "Professor", affiliation: "Institute of XXX, Chinese Academy of Sciences"),
    ),
    department: "中国科学院××研究所",
    major: "管理科学与工程",
    category: "管理学博士",
    submit-date: datetime(year: 2024, month: 6, day: 1),
  ),
  bibliography: bibliography.with("ref.bib"),
)

#show: doc
#cover()
#decl-page()
#show: preface
// 摘要、目录、符号表...
#show: mainmatter
// 正文...

4. 配置开题报告

编辑 template/proposal.typ（结构与论文同构，经 proposalclass 组装）：

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

#let (
  doc, cover, notice, outline-page, mainmatter, bilingual-bibliography,
  bifigure, bitable, continued-table, auto-table, aligned-equation,
) = proposalclass(
  doctype: "master",       // "bachelor" | "master"（当前版式一致）
  fontset: "mac",
  info: (
    title: "论文开题题目",
    author: "张三",
    student-id: "1234567890",
    // 指导教师：填写 supervisors-full 或 supervisors-split 其一；未使用的键可省略
    supervisors-full: "李四教授",
    degree-category: "工学硕士",
    major: "计算机科学与技术",
    research-direction: "智能信息处理",
    department: "中国科学院××研究所",
    submit-date: datetime.today(),
  ),
  bibliography: bibliography.with("ref.bib"),
  // cfg: (outline-depth: 2),
)

#show: doc
#cover()
#notice()
#show: mainmatter
#outline-page()
// 正文用 = / == / ===，编号 1. / 1.1. / 1.1.2，段落自动首行缩进
#bilingual-bibliography(full: true)

项目结构

modern-ucas-thesis/
├── template/              # 论文与开题报告源文件（模板入口）
│   ├── thesis.typ        # 学位论文主文件
│   ├── proposal.typ      # 开题报告主文件
│   ├── ref.bib           # 参考文献（论文与开题共用）
│   └── images/           # 图片目录
├── pages/                # 具体页面实现（封面、声明、摘要、目录、开题报告等）
├── layouts/              # 页面级布局（doc / preface / mainmatter / appendix）
├── utils/                # 可复用工具（双语图表、续表、对齐公式、字体、编号等）
├── assets/               # 静态资源（校徽等 UCAS 视觉标识）
├── fonts/                # 字体目录（用户自行放入字体文件，见 fonts/README.md）
├── docs/                 # 文档（规范原文、定制指南、FAQ 等）
├── lib.typ               # 主库入口（documentclass / proposalclass 闭包工厂）
├── typst.toml            # Typst 包配置
└── Makefile              # 格式化与检查脚本

功能特性

实现状态对照《中国科学院大学研究生学位论文撰写规范指导意见（2022年）》docs/RULES-GRAD.md 逐项核验代码现状。状态含义：✅ 已完成｜🟡 部分实现／待完善｜❌ 未开始｜➖ 规范未强制要求。

文档配置

封面与前置页

正文排版

图表处理

公式与数学

参考文献

附录与后置

字体与排版

其他文档类型

文档

• 研究生撰写规范（中国科学院大学研究生学位论文撰写规范指导意见 2022）
• 本科生撰写规范（中国科学院大学本科生毕业论文（设计）撰写规范指导意见 2023年10月修订）
• 定制指南
• 常见问题
• 格式化工具
• UCAS 标识版权说明

开发

# 格式化代码（需先安装 typstyle）
make format           # 格式化所有 .typ
make format-check     # 只检查不改，CI 守门
make lint-quick       # 检查 typst.toml 字段与入口，不依赖外部 index

致谢

• 基于 modern-nju-thesis 开发
• 参考 ucasthesis LaTeX 模板

许可证

本项目代码采用 MIT 许可证开源。

关于 UCAS 标识：assets/vi/ 目录下的校徽、Logo 等视觉标识的版权归中国科学院大学所有。本项目将其纳入仅为方便用户撰写学位论文（属于个人学习/教学合理使用范畴），请勿用于其他商业或官方用途。如需商用授权，请联系学校相关部门。详见 docs/LOGO_COPYRIGHT.md。

报告问题 · 讨论交流 · 贡献代码