基本格式
之前您已经写了一份报告,包含若干文本、公式和图片,但它看起来还很朴素。您的助教还不知道您在使用新的排版系统,而您希望自己的报告与其他学生的提交在外观上一致。本章我们将学习使用Typst的样式系统,并设置报告的格式。
set规则
如前一章所述,Typst既有函数单纯向文档插入内容块(如image),也有函数从参数接收内容块并处理之(如figure)。想更改字体时,您的第一反应可能是找到相应函数并把整篇文档套进去,像下面这样。
#text(font: "New Computer Modern")[
= Background
In the case of glaciers, fluid
dynamics principles can be used
to understand how the movement
and behaviour of the ice is
influenced by factors such as
temperature, pressure, and the
presence of other fluids (such as
water).
]

等等,函数的参数不应该都填在圆括号中吗?为何圆括号后面又有一对方括号包裹的内容块?答案是,由于Typst中经常要将内容块传给函数,因此它有特殊语法:方括号包裹的内容块,可直接放在普通参数后传给函数。与将内容块放在参数列表中相比,这样能少写几个标点符号。
【译注】这其实只是一个语法糖,即 fn(…, [X], [Y], [Z]) 可简写为 fn(…)[X][Y][Z],其中fn是任意函数,[X], [Y], [Z]是内容块参数,其余参数按普通填法填在…处。
如上所示,这种写法确实有效,text函数成功修改了里面所有文本的字体。不过这种方法要将文档套在无数函数中,到处重复选用的样式,十分麻烦。
好在Typst有更优雅的解决方案。利用set规则,您可以将样式设置应用于某类内容的所有实例。编写set规则的方法是先输入set关键字,再跟上要设置的函数的名称,然后在圆括号中填写要设置的参数。
【译注】用Typst写中文一般需要设置中文字体,否则随机选出的中文字体可能非常魔幻,因为Typst内置字体不含汉字。对于简单需求,可如下设置,这会启用中文排版规则并设置字体为思源宋体。
#set text(lang: "zh", font: "Noto Serif CJK SC")如果遇到问题,或有中英文分设字体等复杂需求,请参考中文社区导航「如何设置(中文)字体」。
#set text(
font: "New Computer Modern"
)
= Background
In the case of glaciers, fluid
dynamics principles can be used
to understand how the movement
and behaviour of the ice is
influenced by factors such as
temperature, pressure, and the
presence of other fluids (such as
water).

用更技术的方式来说:
set规则给函数的参数设置默认值。此后再调用这一函数时,参数默认取set规则设置的值。
自动补全面板
如果您跟着在应用里操作了,那么可能已经注意到,输入#字符会弹出一个面板展示可用函数,该面板在参数列表中还会显示可用参数。这就是自动补全面板。它在写作时非常有用:按回车键应用补全建议,按方向键切换要应用的补全。按 Esc 键关闭面板,关闭后可再输入#或按 Ctrl + Space 打开。善用自动补全面板查找要用的函数参数。大多数补全建议还附有简短的功能说明。

设置页面版式
回到set规则:规则用什么函数取决于要给什么元素设置样式。以下列出了set规则常用的函数:
text——设置文本的字体、字号、颜色等属性page——设置页面尺寸、边距、页眉页脚、分栏数量par——启用两端对齐、设置行距等heading——设置章节标题样式、启用编号document——设置PDF输出包含的元数据,例如全文标题和作者
并非所有函数参数都能用set规则。通常,决定函数怎样做某事的参数可用set规则,而决定函数做什么的参数用不了set规则。在参考手册中,各函数页面会标注哪些参数可用set规则。
让我们向文档添加更多样式。我们想要加大边距并使用衬线字体。出于示例的目的,我们还将设置另一种页面尺寸。
#set page(
paper: "a6",
margin: (x: 1.8cm, y: 1.5cm),
)
#set text(
font: "New Computer Modern",
size: 10pt
)
#set par(
justify: true,
leading: 0.52em,
)
= Introduction
In this report, we will explore the
various factors that influence fluid
dynamics in glaciers and how they
contribute to the formation and
behaviour of these natural structures.
...
#align(center + bottom)[
#image("glacier.jpg", width: 70%)
*Glaciers form an important
part of the earth's climate
system.*
]

这里有几点需要解释。
首先是page的set规则,它接收两个参数:页面尺寸和边距。页面尺寸是个字符串,Typst接受许多标准页面尺寸,但您也可以自行定制。页边距用字典指定,字典是键值对的集合。在本例中,键为x和y,而值分别为水平和竖直边距。我们还可以给每条边单独指定边距,方法是把字典的键改为left、right、top和bottom。
其次是text的set规则。此处将字号设置为10pt,将字体设置为"New Computer Modern"。Typst在线应用附带许多字体,您可在文档中随意尝试。您输入text函数的font参数时,可利用自动补全面板搜索可用字体。
接着我们设置了相邻两行的间距(即行距leading):它按长度设定,可用em单位相对字号指定:1em相当于当前字号的尺寸(默认为11pt)。
最后,我们让图片对齐到底部,方法是把竖直方向的对齐加到水平方向的居中对齐上。竖直和水平对齐可用+运算符结合使用,表示二维对齐。
【译注】以上前三点都涉及中文特色,下面倒着补充一下。
行距与
em:Typst的行距模型默认按照西文习惯,用于中文会显得较挤;如想更接近中文习惯,可设置#set text(top-edge: "ascender", bottom-edge: "descender")。详见中文社区导航「行距 leading 是什么距离?文字外框的计算方式?」。此外,1em相当于一个汉字的宽度。字号的号数制:中文习惯用号数制,最常用的五号一般对应
10.5pt,次常用的小四一般对应12pt。不过各家号数制并不统一,Typst也不支持;需要时请参考pointless-size中的表格按pt点数指定。版心宽度与页边距:中文一般要求每行能排下整数个汉字,所以更习惯设置版心宽度,而间接余出版心左右的边距。这种需求可变通实现,例如
#set page(margin: (x: (100% - 42em) / 2))表示每行42字,左右边距等宽1。
精致一点
为了更清楚地组织我们的文档,现在要对章节标题编号,方法是设置heading函数的numbering参数。
#set heading(numbering: "1.")
= Introduction
#lorem(10)
== Background
#lorem(12)
== Methods
#lorem(15)

我们向numbering参数填了字符串"1.",这会让Typst用阿拉伯数字对章节标题编号,并用句点分隔各级编号。我们还可以使用字母、罗马数字和符号作为编号:
【译注】若用"一、"编号,可能要参考中文社区导航「如何去掉标题的编号后面的空格」。
#set heading(numbering: "1.a")
= Introduction
#lorem(10)
== Background
#lorem(12)
== Methods
#lorem(15)

此示例还使用lorem函数生成一些占位文本。此函数接收一个数字作为参数,并从Lorem Ipsum乱数假文生成相应数量的单词。
您是否好奇为何heading和text的set规则适用于所有文本和章节标题,尽管它们并不是用相应函数生成的?
您写= Conclusion时,Typst会在内部调用heading函数。其实函数调用#heading[Conclusion]等效于上面的章节标题标记。其它标记元素也采用类似机制,它们仅仅是相应函数调用的语法糖。
show规则
您已经很满意这个结果了,但还有件事要改:您写的这份报告会用于一个更大的项目,每次提及其名称时,必须附上项目图标,即使在普通正文中也应如此。
您在考虑有哪些实现方法。您可以使用查找替换,找到所有提及项目名称之处,并在每一处之前添加#image("logo.svg")调用——这听起来十分麻烦。换种方法,您也可以自己定义一个函数,专门生成图标图片。不过其实还有更简单的方法:
使用show规则,您可以重新定义Typst显示某些元素的方式。您指定哪些元素要修改显示方式,再写明应如何显示。show规则可用于文本实例、各类函数,甚至整个文档。
#show "ArtosFlow": name => box[
#box(image(
"logo.svg",
height: 0.7em,
))
#name
]
This report is embedded in the
ArtosFlow project. ArtosFlow is a
project of the Artos Institute.

这个例子涉及几种新语法:我们写上show关键字,后面跟一个我们希望以不同方式显示的文本字符串,再跟一个冒号。然后,我们编写一个函数,该函数输入的参数是应显示的内容。此处我们称该参数为name,这样在函数体内就能用name变量输出项目名称ArtosFlow。我们这条show规则在名称前添加图标图片,并将结果放入box中,以防止在图标和名称之间断行。图片本身也放在box中,以避免它单独成段。
调用第一个box函数和image函数时,不需要前导#,因为它们没有直接写在标记模式中。Typst处于脚本模式而非标记模式时,访问函数、关键字和变量不需要前导#。函数参数列表、函数定义和脚本块中也是同样的道理。
小结
现在您已知道如何设置Typst文档的基本格式。您学习了如何设置字体、两端对齐段落、更改页面尺寸,以及用set规则给章节标题编号。您还学习了如何使用基本的show规则来更改文本在整个文档中的显示方式。
您提交了报告。您的导师对此非常满意,想将其改编成会议论文!在下一节中,我们将学习如何使用更高级的show规则和函数将文档编排为论文。
- 1
100%表示纸张全宽,42em表示42个汉字的宽度,二者之差的一半即为page函数所需水平边距。