提示:本教程存在过时问题,更详细教程请阅读 小蓝书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 中文文档

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

一份参考文献 / 引用列表。

您可以通过使用以下两种格式之一的路径调用此函数来创建新的参考文献:

一旦在文档中添加了参考文献,您就可以开始使用引用语法(@key)或对 citation 函数进行明确调用(#cite(<key>))进行引用。参考文献将仅显示在文档中引用的作品的条目。

样式

Typst 提供了多种内置的 引用和参考文献样式。除此之外,您还可以添加并使用自定义的 CSL(引文样式 语言)文件。想知道使用哪种样式?以下是一些根据您所在的学科的好默认值:

领域典型样式
工程,IT"ieee"
心理学,生命科学"apa"
社会科学"chicago-author-date"
人文学科"mla", "chicago-notes", "harvard-cite-them-right"
经济学"harvard-cite-them-right"
物理学"american-physics-society"

示例

这早在很久以前就被海盗们注意到了。
@arrgh

多个来源可以用 ...
@arrgh @netwok.

#bibliography("works.bib")
预览

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

path
str array
必需参数位置参数
位置参数按顺序传入,不带名称。

Hayagriva .yml 和/或 BibLaTeX .bib 文件的路径。

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

参考文献的标题。

默认情况下,参考文献的标题不会被编号,但您可以 使用 show bibliography: set heading(numbering: "1.") 规则强制进行编号。

默认:auto

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

是否包括给定参考文献文件中的所有作品,即使 它们在文档中没有被引用。

要有选择地添加单个已引用的作品而不显示它们,您还可以 使用 cite 函数,其中 form 设置为 none

默认:false

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

参考文献样式。

应该是内置样式之一(见下文)或 CSL 文件 的路径。下面列出的 一些样式出现两次,一次是它们的全名,一次是它们的简写 别名。

默认:"ieee"