{"id":13728694,"url":"https://github.com/werifu/HUST-typst-template","last_synced_at":"2025-05-08T00:32:13.940Z","repository":{"id":151227454,"uuid":"621688355","full_name":"werifu/HUST-typst-template","owner":"werifu","description":"华科毕业论文（本科）的 typst 模板","archived":false,"fork":false,"pushed_at":"2025-04-04T05:14:53.000Z","size":9797,"stargazers_count":211,"open_issues_count":4,"forks_count":28,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-04T17:03:32.664Z","etag":null,"topics":["hust","typst","typst-template"],"latest_commit_sha":null,"homepage":"","language":"Typst","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/werifu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-31T07:15:01.000Z","updated_at":"2025-04-04T05:14:56.000Z","dependencies_parsed_at":"2023-12-01T18:29:26.637Z","dependency_job_id":"5f01338d-9c4d-47d4-8182-29e3b2d929b2","html_url":"https://github.com/werifu/HUST-typst-template","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/werifu%2FHUST-typst-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/werifu%2FHUST-typst-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/werifu%2FHUST-typst-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/werifu%2FHUST-typst-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/werifu","download_url":"https://codeload.github.com/werifu/HUST-typst-template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252978216,"owners_count":21834898,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hust","typst","typst-template"],"created_at":"2024-08-03T02:00:48.277Z","updated_at":"2025-05-08T00:32:08.909Z","avatar_url":"https://github.com/werifu.png","language":"Typst","funding_links":[],"categories":["课程实验和报告","模板"],"sub_categories":["全校通用","中国大学论文"],"readme":"# HUST-typst-template\n\n用于华科毕业设计（本科）的 typst 模板，一键、快速、持续生成毕业论文 pdf。\n\n![](assets/sample.png)\n\n## ⚠️风险警告⚠️\n\n- 民间模板，存在不被认可风险\n  - 作者用此模板已成功从网安学院毕业\n- 有部分难以短期解决的问题：\n  - 无伪粗体：暂时无法解决，但是标题所需的黑体粗体在打印出来的情况下几乎看不出区别\n\n## 什么是 typst\n\n[typst](https://github.com/typst/typst) 是最新最热的标记文本语言，定位与 LaTeX 类似，具有极强的排版能力，通过一定的语法写文档，然后生成 pdf 文件。与 LaTeX 相比有以下的优势：\n\n1. 编译巨快：因为提供增量编译的功能所以在修改后基本能在一秒内编译出 pdf 文件，typst 提供了监听修改自动编译的功能，可以像 Markdown 一样边写边看效果。\n2. 环境搭建简单：原生支持中日韩等非拉丁语言，不用再大量折腾字符兼容问题以及下载好几个 G 的环境。只需要下载命令行程序就能开始编译生成 pdf。\n3. 语法友好：对于普通的排版需求，上手难度跟 Markdown 相当，同时文本源码阅读性高：不会再充斥一堆反斜杠跟花括号\n\n个人观点：跟 Markdown 一样好用，跟 LaTeX 一样强大\n\n可以从[这里速通 typst](https://typst.app/docs/tutorial)\n\n跟 word 比的优势：格式好调，玄学问题少。\n\n## 使用\n\n快速浏览效果：[查看sample.pdf](./sample.pdf)，样例论文源码：[查看sample.typ](./sample.typ)\n\n### 本地编辑（推荐）\n\n1. 下载对应平台的 typst：https://github.com/typst/typst/releases 记得先看看它的 README\n2. clone 本仓库\n3. 按本仓库中的 sample.typ 照葫芦画瓢即可，sample.typ 既是样例也是说明书\n4. 在本项目目录里，命令行执行 `typst watch xxx.typ` 的命令即可编译同名 pdf 文件，而且一旦更新就会增量编译，推荐在 VSCode 中编辑，下载 `Typst LSP` 插件获得语法提示，使用 [`Typst Preview`](https://github.com/enter-tainer/typst-preview-vscode) 插件可以实现文本和预览之间的快速跳转与实时预览。\n\n\n### 线上编辑（不推荐）\n\ntypst 也提供了线上编辑器（类似overleaf），查看本模板：\nhttps://typst.app/project/rqTPs502DAhLTQctaUmbtn\n\n（ps：浏览器可能没有微软宋体、微软黑体等学校要求的字体，不建议在该平台上生成）\n\n## 其他特性\n\n* 支持匿名处理，anonymous 参数设置为 true 即为匿名，会把校名以及个人信息等替换成小黑条，论文提交阶段使用，不需要再对 pdf 作特殊编辑（致谢中的敏感信息仍需自己处理）\n\n![](assets/anony-sample.png)\n\n## 说明\n\n该模板仍需完善，有一定肉眼排版成分，所以有可能不完全符合华科排版要求，如果遇到不对的间距、字体等请提交 issue 说明，也欢迎 pull request 贡献。\n\n不同学院的模版不太一致，因此在原网安学院的模版上稍加修改得到了计算机学院的模版，如果使用**计算机学院**的模版，请在 `sample.typ` 中选择导入`cs-template.typ` \n\n**Help Wanted** 笔者已毕业跑路，无法勤快维护，希望能有对本项目有兴趣的人参与，可做的事情还有很多:)\n\n### TODO\n[ ] 模板翻新（基本在 Typst 0.6.0 前成型，有部分人工造轮子成分）\n\n[ ] 支持 HUST 硕士、博士论文甚至作业报告模板\n\n[ ] template.typ 模块化\n\n\n## 参考及致谢\n\n* https://github.com/zfengg/HUSTtex HUSTTex 项目\n* https://www.overleaf.com/read/fdbtqrqrqgfg 计院模板\n* https://github.com/nju-lug/nju-thesis-typst NJU 模板，文档相对完善，对中文 Typst 模板有疑问可以查询\n* https://github.com/redleafnew/Chinese-STD-GB-T-7714-related-csl/blob/main/462huazhong-university-of-science-and-technology-school-of-cyber-science-and-engineering.csl 华科网安版本 CSL，稍加改写以通过 Rust 的 quick-xml 库编译","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwerifu%2FHUST-typst-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwerifu%2FHUST-typst-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwerifu%2FHUST-typst-template/lists"}