bibliographyElement
A bibliography / reference listing.
You can create a new bibliography by calling this function with a path to a bibliography file in either one of two formats:
- A Hayagriva
.ymlfile. Hayagriva is a new bibliography file format designed for use with Typst. Visit its documentation for more details. - A BibLaTeX
.bibfile.
As soon as you add a bibliography somewhere in your document, you can start citing things with reference syntax (@key) or explicit calls to the citation function (#cite(<key>)). The bibliography will only show entries for works that were referenced in the document.
Styles
Typst offers a wide selection of built-in citation and bibliography styles. Beyond those, you can add and use custom CSL (Citation Style Language) files. Wondering which style to use? Here are some good defaults based on what discipline you're working in:
| Fields | Typical Styles |
|---|---|
| Engineering, IT | "ieee" |
| Psychology, Life Sciences | "apa" |
| Social sciences | "chicago-author-date" |
| Humanities | "mla", "chicago-notes", "harvard-cite-them-right" |
| Economics | "harvard-cite-them-right" |
| Physics | "american-physics-society" |
Example
This was already noted by
pirates long ago. @arrgh
Multiple sources say ...
@arrgh @netwok.
#bibliography("works.bib")
Parameters
path
Path(s) to Hayagriva .yml and/or BibLaTeX .bib files.
title
The title of the bibliography.
- When set to
auto, an appropriate title for the text language will be used. This is the default. - When set to
none, the bibliography will not have a title. - A custom title can be set by passing content.
The bibliography's heading will not be numbered by default, but you can force it to be with a show-set rule: show bibliography: set heading(numbering: "1.")
Default: auto
full
Whether to include all works from the given bibliography files, even those that weren't cited in the document.
To selectively add individual cited works without showing them, you can also use the cite function with form set to none.
Default: false
style
The bibliography style.
Should be either one of the built-in styles (see below) or a path to a CSL file. Some of the styles listed below appear twice, once with their full name and once with a short alias.
View options
| Variant | Details |
|---|---|
"annual-reviews" | Annual Reviews (sorted by order of appearance) |
"pensoft" | Pensoft Journals |
"annual-reviews-author-date" | Annual Reviews (author-date) |
"the-lancet" | The Lancet |
"elsevier-with-titles" | Elsevier (numeric, with titles) |
"gb-7714-2015-author-date" | China National Standard GB/T 7714-2015 (author-date, 中文) |
"royal-society-of-chemistry" | Royal Society of Chemistry |
"american-anthropological-association" | American Anthropological Association |
"sage-vancouver" | SAGE - Vancouver |
"british-medical-journal" | BMJ |
"frontiers" | Frontiers journals |
"elsevier-harvard" | Elsevier - Harvard (with titles) |
"gb-7714-2005-numeric" | China National Standard GB/T 7714-2005 (numeric, 中文) |
"angewandte-chemie" | Angewandte Chemie International Edition |
"gb-7714-2015-note" | China National Standard GB/T 7714-2015 (note, 中文) |
"springer-basic-author-date" | Springer - Basic (author-date) |
"trends" | Trends journals |
"american-geophysical-union" | American Geophysical Union |
"american-political-science-association" | American Political Science Association |
"american-psychological-association" | American Psychological Association 7th edition |
"cell" | Cell |
"spie" | SPIE journals |
"harvard-cite-them-right" | Cite Them Right 12th edition - Harvard |
"american-institute-of-aeronautics-and-astronautics" | American Institute of Aeronautics and Astronautics |
"council-of-science-editors-author-date" | Council of Science Editors, Name-Year (author-date) |
"copernicus" | Copernicus Publications |
"sist02" | SIST02 (日本語) |
"springer-socpsych-author-date" | Springer - SocPsych (author-date) |
"modern-language-association-8" | Modern Language Association 8th edition |
"nature" | Nature |
"iso-690-numeric" | ISO-690 (numeric, English) |
"springer-mathphys" | Springer - MathPhys (numeric, brackets) |
"springer-lecture-notes-in-computer-science" | Springer - Lecture Notes in Computer Science |
"future-science" | Future Science Group |
"current-opinion" | Current Opinion journals |
"deutsche-gesellschaft-für-psychologie" | Deutsche Gesellschaft für Psychologie 5. Auflage (Deutsch) |
"american-meteorological-society" | American Meteorological Society |
"modern-humanities-research-association" | Modern Humanities Research Association 3rd edition (note with bibliography) |
"american-society-of-civil-engineers" | American Society of Civil Engineers |
"chicago-notes" | Chicago Manual of Style 17th edition (note) |
"institute-of-electrical-and-electronics-engineers" | IEEE |
"deutsche-sprache" | Deutsche Sprache (Deutsch) |
"gb-7714-2015-numeric" | China National Standard GB/T 7714-2015 (numeric, 中文) |
"bristol-university-press" | Bristol University Press |
"association-for-computing-machinery" | Association for Computing Machinery |
"associacao-brasileira-de-normas-tecnicas" | Associação Brasileira de Normas Técnicas (Português - Brasil) |
"american-medical-association" | American Medical Association 11th edition |
"elsevier-vancouver" | Elsevier - Vancouver |
"chicago-author-date" | Chicago Manual of Style 17th edition (author-date) |
"vancouver" | Vancouver |
"chicago-fullnotes" | Chicago Manual of Style 17th edition (full note) |
"turabian-author-date" | Turabian 9th edition (author-date) |
"springer-fachzeitschriften-medizin-psychologie" | Springer - Fachzeitschriften Medizin Psychologie (Deutsch) |
"thieme" | Thieme-German (Deutsch) |
"taylor-and-francis-national-library-of-medicine" | Taylor & Francis - National Library of Medicine |
"american-chemical-society" | American Chemical Society |
"american-institute-of-physics" | American Institute of Physics 4th edition |
"taylor-and-francis-chicago-author-date" | Taylor & Francis - Chicago Manual of Style (author-date) |
"gost-r-705-2008-numeric" | Russian GOST R 7.0.5-2008 (numeric) |
"institute-of-physics-numeric" | Institute of Physics (numeric) |
"iso-690-author-date" | ISO-690 (author-date, English) |
"the-institution-of-engineering-and-technology" | The Institution of Engineering and Technology |
"american-society-for-microbiology" | American Society for Microbiology |
"multidisciplinary-digital-publishing-institute" | Multidisciplinary Digital Publishing Institute |
"springer-basic" | Springer - Basic (numeric, brackets) |
"springer-humanities-author-date" | Springer - Humanities (author-date) |
"turabian-fullnote-8" | Turabian 8th edition (full note) |
"karger" | Karger journals |
"springer-vancouver" | Springer - Vancouver (brackets) |
"vancouver-superscript" | Vancouver (superscript) |
"american-physics-society" | American Physical Society |
"mary-ann-liebert-vancouver" | Mary Ann Liebert - Vancouver |
"american-society-of-mechanical-engineers" | American Society of Mechanical Engineers |
"council-of-science-editors" | Council of Science Editors, Citation-Sequence (numeric, brackets) |
"american-physiological-society" | American Physiological Society |
"future-medicine" | Future Medicine journals |
"biomed-central" | BioMed Central |
"public-library-of-science" | Public Library of Science |
"american-sociological-association" | American Sociological Association 6th edition |
"modern-language-association" | Modern Language Association 9th edition |
"alphanumeric" | Alphanumeric |
Default: "ieee"