适用于哈尔滨工业大学学位论文的 Typst 模板
本仓库在原模板的基础上进行修改，增加了毕设开题模板，格式仿照官网提供的word模板文件。
Warning
本模板正处于积极开发阶段，存在一些格式问题，适合尝鲜 Typst 特性
本模板是民间模板，可能不被学校认可，正式使用过程中请做好随时将内容迁移至 Word 或 LaTeX 的准备
Typst 是使用 Rust 语言开发的全新文档排版系统，有望以 Markdown 级别的简洁语法和编译速度实现 LaTeX 级别的排版能力，即通过编写遵循 Typst 语法规则的文本文档、执行编译命令，来可生成目标格式的 PDF 文档。
universal-hit-thesis 是一套简单易用的哈尔滨工业大学学位论文 Typst 模板，受 hithesis 启发，计划囊括一校三区本科、硕士、博士的学位论文格式。
预览效果
- 本科通用：universal-bachelor.pdf
- 本科开题报告：proposal-bachelor.pdf
在本地编辑II下，修改 universal-bechelor.typ中的doc-type变量值为 "proposal"：
#show: doc.with(
thesis-info: (
title-cn: "...",
// ...
doc-type: "proposal", // <==
),
// ...
)
- 使用SimHei作为黑体似乎会遇到封面文字未对齐的情况，使用FandolHei可避开此问题。
- 可以将
universal-bachelor.typ第一行改成#import "../lib.typ": universal-bachelor直接使用模板，而不用设置复杂的环境变量（这句话不要让作者看到）
这种方式适合大多数用户。
首先安装 Typst，您可以在 Typst Github 仓库的 Release 页面 下载最新的安装包直接安装，并将 typst 可执行程序添加到 PATH 环境变量；如果您使用 Scoop 包管理器，则可以直接通过 scoop install typst 命令安装。
安装好 Typst 之后，您只需要选择一个您喜欢的目录，并在此目录下执行以下命令：
typst init @preview/universal-hit-thesis:0.2.1Typst 将会创建一个名为 universal-hit-thesis 的文件夹，进入该目录后，您可以直接修改目录下的 universal-bachelor.typ ，然后执行以下命令进行编译生成 .pdf 文档：
typst compile universal-bachelor.typ或者使用以下命令进行实时预览：
typst watch universal-bachelor.typ当您要实时预览时，我们更推荐使用 Visual Studio Code 进行编辑，配合 Tinymist Typst, Typst Preview 等插件可以大幅提升您的编辑体验。
这种方法适合 Typst 开发者。
首先使用 git clone 命令 clone 本项目，或者直接在 Release 页面下载特定版本的源码。在 templates/ 目录下选择您需要的模板，直接修改或复制一份，在根目录运行以下命令进行编译：
typst compile ./templates/<template-name>.typ --root ./或者使用如下命令进行实时预览：
typst watch ./templates/<template-name>.typ --root ./Tip
本模板正处于积极开发阶段，更新较为频繁，虽然已经上传至 Typst Universe，但是您依然可以借助 Typst local packages 来实现在 Typst Universe 同步本模板的最新版本前，在本地体验本模板的最新版本，具体做法为：
-
在 Release 页面下载对应版本的源码压缩包，并将其解压到
{data-dir}/typst/packages/local/universal-hit-thesis/{version}，{data-dir}在不同操作系统下的值为：$XDG_DATA_HOMEor~/.local/shareon Linux~/Library/ApplicationSupport on macOS%LOCALAPPDATA%on Windows
{version}的值为typst.toml中version项的值.解压完成后
typst.toml文件应该出现在{data-dir}/typst/packages/local/universal-hit-thesis/{version}目录下. -
接着您需要在您的论文中将
#import "@preview/universal-hit-thesis:0.2.1"修改为#import "@local/universal-hit-thesis:{version}"，即可更新模板.
本模板已上传 Typst Universe，您可以使用 Typst 的官方 Web App 进行编辑。
具体来说，在 Typst Web App 登录后，点击 Start from template，在弹出的窗口中选择 universal-hit-thesis，即可从模板创建项目。
Note
Typst Web App 的排版渲染在浏览器本地执行，所以实时预览体验几乎与在本地编辑无异。
默认情况下，Web App 中的模板字体显示与预期可能存在差异，这是因为 Web App 默认不提供 SimSun, Times New Roman 等中文排版常用字体。为了解决这个问题，您可以在搜索引擎搜索以下字体文件：
TimesNewRoman.ttf（包括Bold,ItalicBold-Italic等版本）SimSun.ttfSimHei.ttfKaiti.ttfConsolas.ttfCourier New.ttf
并将这些文件手动上传至 Web App 项目根目录中，或为了目录整洁，可以创建一个 fonts 文件夹并将字体置于其中，Typst Web App 将自动加载这些字体，并正确渲染到预览窗口中.
由于每次在 Typst Web App 中打开项目时都需要重新下载字体，而中文字体体积普遍较大，加载时间较长，因此我们更推荐本地编辑。
Note
注意到，官方提供的本科毕业设计 Microsoft Word 论文模板 本科毕业论文（设计）书写范例（理工类）.doc 在一校三区是通用的，意味着本 Typst 模板的本科论文部分理论上也是在一校三区通用的，因此我们提供适用于各校区的本科毕业论文模板模块导出，即以下四种导入模块的方式效果相同：
#import "@preview/universal-hit-thesis:0.2.1": harbin-bachelor
#import harbin-bachelor: * // 哈尔滨校区本科#import "@preview/universal-hit-thesis:0.2.1": weihai-bachelor
#import weihai-bachelor: * // 威海校区本科#import "@preview/universal-hit-thesis:0.2.1": shenzhen-bachelor
#import shenzhen-bachelor: * // 深圳校区本科#import "@preview/universal-hit-thesis:0.2.1": universal-bachelor
#import universal-bachelor: * // 一校三区本科通用若要书写和引用伪代码，您可以使用 algorithm-figure，为此，您需要导入 algorithmic 或 lovelace 包。
#import "@preview/algorithmic:0.1.0"
#import algorithmic: algorithm
#import "@preview/lovelace:0.2.0": *使用方式详见模板中的伪代码节
尽管本 Typst 模板各部分字体、字号等设置均与原 Word 模板一致，但段落排版视觉上仍与 Word 模板有一些差别，这与字符间距、行距、段落间距有一定肉眼排版成分有关.
- 学校对参考文献格式的要求与标准的
GB/T 7714-2015 numeric格式存在差异，我们已修改相关 CSL 文件并形成gb-t-7714-2015-numeric-hit.csl以修复作者名字大小写等问题，但仍有以下已知特性尚未支持：- 仅纯电子资源（如网页、软件）显示引用日期和 URL
- 无 DOI
- 引用其他学校的学位论文时参考文献页对应条目存在格式问题，因为 Typst 尚不支持 CSL 文件中的
school等字段. - 目前版本的 Typst 对 CSL 支持程度成谜，更多问题可参考 SEU-Typst-Template 参考文献已知问题.
- 感谢 HUST-typst-template 为本模板早期版本的框架提供思路.
- 感谢 @csimide 和 @OrangeX4 提供的中英双语参考文献实现.
- 感谢 modern-nju-thesis 为本模板的一些特性提供实现思路.