注意 / Info本站经 Typst GmbH 许可，提供 Typst v0.10.0+后期随缘更新官方文档的翻译，由中文社区维护。建议与官方文档一同阅读，因为可能存在错译、漏译或过时信息。如有意改进翻译内容或网站本身，可在GitHub上提出 Issue、发起 Pull Requests。此外，也欢迎加入「Typst 非官方中文交流群」（QQ 793548390）。
This site provides a Chinese translation of the Typst v0.10.0+后期随缘更新 documentation maintained by the “Typst Chinese Community” with permission from Typst GmbH. We recommend using this alongside the official documentation. We welcome contributions through Issues and Pull Requests on our GitHub repository for both translation improvements and website enhancements. Feel free to join our QQ chat group “Typst 非官方中文交流群” (793548390).

`bibliography`
元素
元素
元素函数可用`set`和`show`规则自定义样式。

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

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

Hayagriva .yml 文件。Hayagriva 是一种新的参考文献文件格式，专为 Typst 设计。访问其文档以获取更多详细信息。
BibLaTeX .bib 文件。

一旦在文档中添加了参考文献，您就可以开始使用引用语法（@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")

参数
参数
参数是传给函数的输入，写在函数名后的括号中。

bibliography(

)->

`path`
str array
必需参数
必需参数
必需参数在调用函数时必须传入。
位置参数
位置参数
位置参数按顺序传入，不带参数名。

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

`title`
none auto content
可用set规则
可用set规则
可用`set`规则设置参数，更改后续调用时的默认值。

参考文献的标题。

当设置为 auto 时，将使用适用于文本语言的适当标题。这是默认值。
当设置为 none 时，参考文献将没有标题。
可以通过传递内容来设置自定义标题。

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

默认值：

auto

`full`
bool
可用set规则
可用set规则
可用`set`规则设置参数，更改后续调用时的默认值。

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

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

默认值：

false

`style`
str
可用set规则
可用set规则
可用`set`规则设置参数，更改后续调用时的默认值。

参考文献样式。

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

默认值：

"ieee"

可填写的值

american-anthropological-association
美国人类学协会
springer-lecture-notes-in-computer-science
Springer - 计算机科学讲义
american-medical-association
美国医学协会第11版
sage-vancouver
SAGE - 温哥华
biomed-central
BioMed Central
american-society-of-civil-engineers
美国土木工程师协会
taylor-and-francis-chicago-author-date
Taylor & Francis - 芝加哥式样式（作者-日期）
gb-7714-2015-note
中国国家标准 GB/T 7714-2015（注释，中文）
american-society-for-microbiology
美国微生物学协会
american-meteorological-society
美国气象学会
future-medicine
未来医学杂志
bristol-university-press
布里斯托大学出版社
public-library-of-science
科学公共图书馆
pensoft
Pensoft 期刊
american-institute-of-aeronautics-and-astronautics
美国航空航天学会
mary-ann-liebert-vancouver
Mary Ann Liebert - 温哥华
modern-humanities-research-association
现代人文研究协会第3版（带有参考文献的注意事项）
springer-socpsych-author-date
Springer - SocPsych（作者-日期）
trends
Trends 期刊
gost-r-705-2008-numeric
俄罗斯 GOST R 7.0.5-2008（数字）
american-political-science-association
美国政治科学协会
future-science
未来科学集团
association-for-computing-machinery
计算机协会
elsevier-harvard
爱思唯尔 - 哈佛（带标题）
american-chemical-society
美国化学学会
cell
细胞
royal-society-of-chemistry
英国皇家化学学会
sist02
SIST02（日本语）
gb-7714-2005-numeric
中国国家标准 GB/T 7714-2005（数字，中文）
institute-of-electrical-and-electronics-engineers
IEEE
springer-humanities-author-date
Springer - 人文学科（作者-日期）
deutsche-gesellschaft-für-psychologie
德国心理学协会第5版（德语）
springer-basic-author-date
Springer - 基础（作者-日期）
institute-of-physics-numeric
物理研究所（数字）
vancouver
温哥华
nature
自然
current-opinion
Current Opinion 期刊
annual-reviews-author-date
年度评论（作者-日期）
american-institute-of-physics
美国物理学会第4版
gb-7714-2015-numeric
中国国家标准 GB/T 7714-2015（数字，中文）
the-lancet
The Lancet
springer-basic
Springer - Basic（数字，括号）
american-geophysical-union
American Geophysical Union
turabian-fullnote-8
Turabian 第8版（完整注释）
taylor-and-francis-national-library-of-medicine
Taylor & Francis - National Library of Medicine
american-physiological-society
American Physiological Society
thieme
Thieme-German（德语）
copernicus
Copernicus Publications
the-institution-of-engineering-and-technology
The Institution of Engineering and Technology
annual-reviews
Annual Reviews（按出现顺序排序）
deutsche-sprache
Deutsche Sprache（德语）
harvard-cite-them-right
Cite Them Right 第12版 - 哈佛风格
chicago-fullnotes
芝加哥风格手册第17版（完整注释）
iso-690-author-date
ISO-690（作者-日期，英语）
council-of-science-editors-author-date
Council of Science Editors，姓名-年份（作者-日期）
springer-mathphys
Springer - MathPhys（数字，括号）
american-society-of-mechanical-engineers
American Society of Mechanical Engineers
karger
Karger期刊
multidisciplinary-digital-publishing-institute
Multidisciplinary Digital Publishing Institute
american-psychological-association
美国心理学协会第7版
modern-language-association-8
现代语言协会第8版
gb-7714-2015-author-date
中国国家标准 GB/T 7714-2015（作者-日期，中文）
springer-vancouver
Springer - Vancouver（括号）
british-medical-journal
BMJ
turabian-author-date
Turabian 第9版（作者-日期）
chicago-author-date
芝加哥风格手册第17版（作者-日期）
associacao-brasileira-de-normas-tecnicas
巴西技术标准协会（葡萄牙语 - 巴西）
vancouver-superscript
Vancouver（上标）
angewandte-chemie
Angewandte Chemie International Edition
elsevier-with-titles
Elsevier（数字，带标题）
iso-690-numeric
ISO-690（数字，英语）
modern-language-association
现代语言协会第9版
council-of-science-editors
Council of Science Editors，引文序列（数字，括号）
spie
SPIE期刊
springer-fachzeitschriften-medizin-psychologie
Springer - Fachzeitschriften Medizin Psychologie（德语）
frontiers
Frontiers期刊
american-physics-society
American Physical Society
american-sociological-association
美国社会学协会第6版
elsevier-vancouver
Elsevier - Vancouver
chicago-notes
芝加哥风格手册第17版（注释）
alphanumeric
字母数字混合

bibliography元素元素元素函数可用set和show规则自定义样式。

样式

示例

参数参数参数是传给函数的输入，写在函数名后的括号中。

pathstrarray必需参数必需参数必需参数在调用函数时必须传入。位置参数位置参数位置参数按顺序传入，不带参数名。

titlenoneautocontent可用set规则可用set规则可用set规则设置参数，更改后续调用时的默认值。

fullbool可用set规则可用set规则可用set规则设置参数，更改后续调用时的默认值。

stylestr可用set规则可用set规则可用set规则设置参数，更改后续调用时的默认值。

搜索

`bibliography`
元素
元素
元素函数可用`set`和`show`规则自定义样式。

参数
参数
参数是传给函数的输入，写在函数名后的括号中。

`path`
str array
必需参数
必需参数
必需参数在调用函数时必须传入。
位置参数
位置参数
位置参数按顺序传入，不带参数名。

`title`
none auto content
可用set规则
可用set规则
可用`set`规则设置参数，更改后续调用时的默认值。

`full`
bool
可用set规则
可用set规则
可用`set`规则设置参数，更改后续调用时的默认值。

`style`
str
可用set规则
可用set规则
可用`set`规则设置参数，更改后续调用时的默认值。