提示:本教程存在过时问题,更详细教程请阅读 小蓝书Typst 中文社区导航 FAQ
注意:该中文文档为社区驱动的非官网文档,可能存在错译、漏译或过时等问题,请以官网文档 Documentation 为准,如发现错漏,也欢迎 您的贡献镜像)。Typst 非官方中文交流 QQ 群:793548390
Warning: the Chinese document is a community-driven non-official document, there may be mistranslation, omission or outdated problems, please refer to the official website documentation.
Typst 中文文档

document 元素
元素函数可以通过 set 和 show 规则进行样式自定义。

文档根元素及其元数据。

所有文档都会自动包装在一个 document 元素中。您不能自己创建文档元素。 此功能仅能与 Set 规则 一起使用,以指定文档元数据。此类 Set 规则必须出现在文档内容之前。

#set document(title: [Hello])

这没有可见的输出,但会将元数据嵌入 PDF 中!
Preview

请注意,使用此功能设置的元数据不会在 文档内呈现。相反,它被嵌入到编译后的 PDF 文件中。

参数
参数是函数的输入,它们在函数名称后面的括号中传入。

title
none content
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

文档的标题。这通常会呈现为 PDF 查看器窗口的标题。

虽然这可以是任意内容块,但 PDF 查看器仅支持纯文本 标题,因此转换可能会有损失。

默认:none

author
str array
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

文档的作者。

默认:()

keywords
str array
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

文档的关键词。

默认:()

date
none auto datetime
可用 Set 规则
可以使用 Set 规则,为函数后续所有的使用设置默认参数。

文档的创建日期。

如果这是 auto(默认),Typst 使用当前日期和时间。 将其设置为 none 可以防止 Typst 嵌入任何创建日期 到 PDF 元数据中。

年份必须至少为零才能嵌入到 PDF。

默认:auto