本地配置#

如果你说，我不想在线编辑，那就乖乖按以下步骤配置吧！访问 Typst 的 Github网站，在 release 中选择自己操作系统的安装包下载，例如 Windows 就选择 typst-x86_64-pc-windows-msvc.zip 这个。下载完成后解压安装包，把里面的文件放在想要放的目录下，然后记住这个目录，去配置环境变量（具体怎么配置就略过了，网上有教程）。打开终端，输入 Typst，如果显示Welcome to Typst, we are glad to have you here! ❤️等内容则配置成功。

之后打开 VSCode，在插件中搜索并安装 Typst Companion 和 Tinymist Typst，就可以在 VSCode 里敲 Typst 代码啦！

节指令（标题）#

• 一级标题 = X，即 X 为一级标题
• 二级标题 == X，即 X 为二级标题
• 以此类推…

示例：

= 这是一级标题
== 这是二级标题
=== 这是三级标题
...

列表#

1. 有序列表元素1
2. 有序列表元素2
3. 有序列表元素3

· 无序列表元素1
· 无序列表元素2
· 无序列表元素3

图指令#

以一个例子来说明：

#figure(
  image("./glacier.jpg", width: 70%),
  caption: [
    _Glaciers_ form an important part of the earth's climate system.
  ],
) <fig:glaciers>

具体解释：

• #figure()是插入图片的基本语法，如果不想添加其他格式，最简单的图片插入语句是#image("glacier.jpg")，这样将使用默认格式。
• image("./glacier.jpg", width: 70%)说明了要插入图片的相对路径（也可以用绝对路径、url等），以及占全行的宽度（70%）。
• caption:[_Glaciers_ form an important ...]是图片下方的文字说明
• <fig:glacier>是插入图片的标签，引用的时候会用到

效果如下：

表指令#

还是以一个例子来说明：

#table(
    columns: (1fr, auto, auto),
    inset: 10pt,
    align: horizon,
    table.header(
        [], [*Volume*], [*Parameters*],
    ),
    image("cylinder.svg"),
    $ pi h (D^2 - d^2) / 4 $,
    [
        $h$: height \
        $D$: outer radius \
        $d$: inner radius
    ],
    image("tetrahedron.svg"),
    $ sqrt(2) / 12 a^3 $,
    [$a$: edge length]
)

具体解释：

• #table(是 Typst 中创建表格的语法。#table 是表格的构造函数，表示开始定义一个表格。
• columns: (1fr, auto, auto)定义表格的列宽：
  • 1fr：第一列占用剩余可用空间（fr 是分数单位，表示比例分配）。
  • auto：第二列和第三列根据内容自动调整宽度。
• inset: 10pt设置表格单元格的内边距（padding）为 10pt（点）。
• align: horizon设置表格内容的对齐方式为水平对齐
• table.header()定义表格的表头部分
• 剩余部分，以image, 数学公式$$或表格元素[]对应填入表格的内容

效果如下：

数学公式#

Typst 的数学公式插入和 LaTeX 基本相似，稍有不同的是在命令中不使用\，如 LaTeX 写法为 $ 7.32 \beta + \sum_{i=0}^\nabla \frac{Q_i}{2} $ 的公式，Typst 写为 $ 7.32 beta + sum_(i=0)^nabla Q_i / 2 $，更加简洁一些。其他的一些区别是例如替换一些 LaTeX 中的花括号 {} 为圆括号 ()等等

The equation $Q = rho A v + C$ defines the glacial flow rate.

Total displaced soil by glacial flow:

$ 7.32 beta + sum_(i=0)^nabla (Q_i (a_i - epsilon)) / 2 $

参考文献#

使用bibliography函数向文档中添加参考文献，此函数需要参考文献文件的路径。

假设有一个名works.bib的文件，需要将其中的内容插入到文章末尾，那么使用#bibliography("works.bib")即可，示例如下：

= Methods
We follow the glacier melting models
established in @glacier-melt.

#bibliography("works.bib")

效果如下：