Skip to content

Repository files navigation

GDUPT logo

GDUPT 毕业论文模板

使用 Typst /taɪpst/ 编写的非官方广东石油化工学院(Gdupt)毕业论文(设计)模板,能够简洁、快速、持续生成符合学校官方 Word 文档要求的毕业论文 PDF/SVG/PNG/HTML

cover_and_pro
查看更多图片
abstract 1c_and_2c

Important

非官方模板,存在不被学校认可的风险。

虽已尽力尝试复刻 Word 模板(通过叠层官方 Word 的 PDF 进行像素级微调),但因 Word 和 Typst 排版模型差异,还是可能存在页脚、标题间距等细微差异。

作者目前大一,不会 Word 也不会 $\LaTeX$,了解到 Typst 之后用来做课设论文发现效果不错,故萌生做毕业论文模板的想法,但对毕业论文具体写作流程不甚清楚,对使用本模板造成的损失概不负责,使用需谨慎。

Typst 是一个仍在活跃开发、可能会有较大变更的排版工具,请选择最新版模板与最新的 Typst 版本。

🤝 欢迎 Contribute,欢迎 Communicate

欢迎对 Typst 感兴趣的同学参与项目维护,提交 Issue 或 Pull Request,添加更多 features

若有 Typst 使用问题(或者想交流 $\LaTeX$/论文编写、提供流程改进建议的),请加广油学位论文 Typst 模板交流 QQ 群捏^_^:1105729905


✨ 特性

  • 符合学校规范:参考 官方 Word 文档 进行复刻,高度对齐学校格式要求
  • 现代化排版:使用 Typst 现代排版系统,实时编译,语法简洁
  • 实时预览:支持 VS Code 实时编辑、预览和双向跳转
  • 完整功能
    1. 封面
    2. 诚信承诺保证书
    3. 中英文摘要
    4. 目录
    5. 插图清单(必要时)
    6. 附表清单(必要时)
    7. 符号说明(必要时)
    8. 图表、公式、定理、算法、代码、列表等
    9. 参考文献
    10. 致谢
    11. 附录(必要时)
  • 易于定制:格式文件简洁易读,可以根据需求调整样式

🚀 快速开始

第一步:获取模板

  1. 获取模板

    # 克隆本仓库
    git clone https://github.com/hibays/gdupt-thesis-typst.git
    cd gdupt-thesis-typst

第二步:使用 VS Code (推荐)实时编辑论文

  1. 安装 VS Code,选择把VS Code注册到右键菜单

  2. 安装 Tinymist Typst 扩展(没错!只需点点鼠标简简单单安装一个插件!)

  3. 用 VS Code 打开本文件夹,右键选择“在 VS Code 中打开”(即作为工作空间打开)

  4. 在 VS Code 中打开 thesis.typ 文件 然后修改封面信息:

      #paper-cover(
        [毕业论文(设计)]      // 大标题
        [你的论文中文题目],     // 中文题目
        [Your English Title],   // 英文题目
        [你的学号],             // 学号
        [你的学院],             // 学院
        [你的专业],             // 专业
        [你的班级],             // 班级
        [你的姓名],             // 学生
        [指导教师姓名],         // 指导教师
        [指导教师职称],         // 职称
        datetime(year: 2025, month: 11, day: 12), // 启动日期
        datetime(year: 2025, month: 12, day: 30), // 结束日期
        显示下划线: true,
        仅显示下划线: false,
      )

    和摘要信息:

    #paper-abstract(
        [
           这里是中文摘要内容。
        ],
        [
           这里是英文摘要内容。
        ],
        // 关键词
        中文关键词: ([关键词1], [关键词2], [关键词3], [关键词4], [关键词5]),
        英文关键词: ([kw1], [kw2], [kw3], [kw4], [kw5]),
        )
  5. (可选)在 thesis.typ 文件头部配置盲审模式和双面打印模式:

    // 启用盲审模式(用灰框替换个人信息)
    #show: mask-pass.with(enable: true)
    
    // 启用双面打印模式(自动加入空白页占位,支持自定义)
    #show: twoside-pass.with(enable: true)
  6. 按下 Tab 栏右上角的预览键即可打开实时预览

  7. 开始编辑,预览窗口会随键入实时更新,并可以双向跳转

或者:使用 Typst CLI 编译本模板

  1. 安装 Typst

    • 访问 Typst 官网 下载并安装

    • 或使用包管理器安装:

      # macOS (Homebrew)
      brew install typst
      
      # Windows (Scoop)
      scoop install typst
      
      # Linux
      curl -proto '=https' -tlsv1.2 -sSf https://raw.githubusercontent.com/typst/typst/main/install.sh | sh
  2. 编译论文

    # 编译生成 thesis.pdf
    typst compile thesis.typ
    
    # 或使用 watch 模式(自动重新编译)
    typst watch thesis.typ

📁 项目结构

.
├── thesis.typ          # 主论文文件(在此编写内容)
├── fmt-req.typ         # 主格式要求和样式定义(更新时直接替换本文件)
├── refs.bib            # 参考文献数据库(BibTeX 格式)
├── structure.typ       # 论文Word模板复现文件
├── assets/             # 图片资源(校徽、题字等)
├── figures/            # 论文图表 xxx (有几个 example 图表)
├── extra/              # 额外模板如:任务书、选题表、开题报告等
└── docs/               # README 展示图片

📝 模板功能

核心组件

  • 封面:符合学校规范的论文封面
  • 诚信承诺书:自动生成的诚信承诺保证书
  • 中英文摘要:支持中英文双语摘要
  • 目录:自动生成的目录
  • 插图清单(必要时):插图清单支持
  • 附表清单(必要时):附表清单支持
  • 符号说明(必要时):符号说明支持
  • 页眉页脚:符合学校规范的奇偶页眉页脚
  • 参考文献:支持 BibTeX 格式和文内引用,建议使用Zotero等文献管理软件
  • 致谢:支持在盲审模式下自动删除致谢内容
  • 附录(必要时):附录章节支持

内容元素

  • 表格tablex 三线表环境,支持续表和脚注
  • 图片imagex 插图环境,支持子图和双语图题
  • 公式:支持输入 Typst 公式或 $\LaTeX$ 公式(基于 mitex
  • 算法:算法环境,支持跨页续算法
  • 代码:代码高亮显示
  • 定理证明:定理和证明环境
  • 化学方程式:支持使用 Typsium 编写化学方程式
  • Graphviz 图:支持使用 diagraph 包绘制 Graphviz 图

高级功能

  • 盲审模式:支持盲审模式,用灰框遮蔽个人信息
  • 双面打印:支持双面打印模式,可以得到和官方模板一样的打印样式

🎨 字体设置

模板默认使用 Windows 系统字体。如需修改字体:

  1. 查看系统可用字体:

    typst fonts
  2. 编辑 fmt-req.typ 文件,修改字体配置:

    // 在文件开头找到字体定义
    #let TimeSimSun = ("Times New Roman", "SimSun")   // 宋体
    #let TimeSimHei = ("Times New Roman", "SimHei")   // 黑体
    #let TimeFanSun = ("Times New Roman", "FangSong") // 仿宋_GB2312

See: 如何设置(中文)字体?为什么代码块里面的中文字体显示不正常?

😶‍🌫️ TODO & Known Issues

优先级 类型 项目
MEDIUM IMPL 边框表格续表不正确
LOW THIEDPARTY 导出为html时因equate包的实现问题导致公式被忽略,导致公式引用报错
LOW STYLE 为了脚注不错位页码垂直高度相较Word模板偏矮

📚 学习资源

Typst 入门

数学公式

第三方包

❓ 常见问题

Q: 我不会 $\LaTeX$ 也不会编程,能用这个模板吗?

A: 完全可以!Typst 语法类似 Markdown,非常容易上手。你只需要按照模板中的示例填写内容即可。

Q: 文科生能用这个模板吗?

A: 当然可以!通过 VS Code 和 Tinymist 扩展,你可以实时预览论文效果,鼠标点击预览窗口相应文字即可定位到 Typst 源码对应位置,无需任何环境配置。

Q: 为什么只有一个 thesis.typ 文件?

A: Typst 编译速度极快,大纲跳转方便,无需像 $\LaTeX$ 那样分节来加速编译,同时语法噪音小,便于查看,单文件也便于管理和同步。

Q: AI或者智能体能写Typst论文吗?

A: 当然可以!不过最好借助Typst 语法作者技能这个 Skill,手动把他输入到 Prompt 或安装到 Claude Code/Codex/OpenCode 等智能体中,这样可以减少点语法错误。

Q: 如何添加参考文献?

A:refs.bib 文件中添加 BibTeX 格式的参考文献,然后在正文中使用 @citation-key 引用。

Q: 如何添加图片?

A: 将图片放入 figures/ 目录,然后在正文中使用:

#imagex("figures/your-image.png", width: 80%)

Q: 编译时出现字体错误怎么办?

A: 确保系统中安装了所需的中文字体(宋体、黑体、Times New Roman),或修改 fmt-req.typ 中的字体配置。

PS: 如果你使用 WSL2,可以参考这里直接使用 Windows 宿主机字体:sudo ln -s /mnt/c/Windows/Fonts /usr/share/fonts/font && sudo fc-cache -fv

🙏 致谢

本模板基于以下优秀项目开发:

📄 许可证

MIT License

About

一个使用 Typst 编写的广东石油化工学院(Gdupt)毕业论文(设计)模板,能够简洁、快速、持续生成符合学校格式要求的毕业论文 PDF。

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages