citeElement
Cite a work from the bibliography.
Before you starting citing, you need to add a bibliography somewhere in your document.
Example
This was already noted by
pirates long ago. @arrgh
Multiple sources say ...
@arrgh @netwok.
You can also call `cite`
explicitly. #cite(<arrgh>)
#bibliography("works.bib")
If your source name contains certain characters such as slashes, which are not recognized by the <> syntax, you can explicitly call label instead.
Computer Modern is an example of a modernist serif typeface.
#cite(label("DBLP:books/lib/Knuth86a")).
>>> #bibliography("works.bib")Syntax
This function indirectly has dedicated syntax. References can be used to cite works from the bibliography. The label then corresponds to the citation key.
Parameters
key
The citation key that identifies the entry in the bibliography that shall be cited, as a label.
View example
// All the same
@netwok \
#cite(<netwok>) \
#cite(label("netwok"))
supplementDefault: none
A supplement for the citation such as page or chapter number.
In reference syntax, the supplement can be added in square brackets:
View example
This has been proven. @distress[p.~7]
#bibliography("works.bib")
formDefault: "normal"
The kind of citation to produce. Different forms are useful in different scenarios: A normal citation is useful as a source at the end of a sentence, while a “prose” citation is more suitable for inclusion in the flow of text.
If set to none, the cited work is included in the bibliography, but nothing will be displayed.
View example
#cite(<netwok>, form: "prose")
show the outsized effects of
pirate life on the human psyche.
| Variant | Details |
|---|---|
"normal" | Display in the standard way for the active style. |
"prose" | Produces a citation that is suitable for inclusion in a sentence. |
"full" | Mimics a bibliography entry, with full information about the cited work. |
"author" | Shows only the cited work’s author(s). |
"year" | Shows only the cited work’s year. |
styleDefault: auto
The citation style.
This can be:
autoto automatically use the bibliography’s style for citations.- A string with the name of one of the built-in styles (see below). Some of the styles listed below appear twice, once with their full name and once with a short alias.
- A path string or
pathto a CSL file. - Raw bytes from which a CSL style should be decoded.
View options
| Variant | Details |
|---|---|
"alphanumeric" | Alphanumeric |
"american-anthropological-association" | American Anthropological Association |
"american-chemical-society" | ACS Guide 2022 revision |
"american-geophysical-union" | American Geophysical Union |
"american-institute-of-aeronautics-and-astronautics" | American Institute of Aeronautics and Astronautics |
"american-institute-of-physics" | AIP Style Manual 4th edition |
"american-medical-association" | AMA Manual of Style 11th edition |
"american-meteorological-society" | American Meteorological Society |
"american-physics-society" | American Physical Society |
"american-physiological-society" | American Physiological Society |
"american-political-science-association" | APSA Style Manual revised 2018 edition |
"american-psychological-association" | APA Style 7th edition |
"apa" | A short alias of american-psychological-association |
"american-society-for-microbiology" | American Society for Microbiology |
"american-society-of-civil-engineers" | American Society of Civil Engineers |
"american-society-of-mechanical-engineers" | American Society of Mechanical Engineers |
"american-sociological-association" | ASA Style Guide 6th/7th edition |
"angewandte-chemie" | Angewandte Chemie International Edition |
"annual-reviews" | Annual Reviews (sorted by order of appearance) |
"annual-reviews-author-date" | Annual Reviews (author-date) |
"associacao-brasileira-de-normas-tecnicas" | Associação Brasileira de Normas Técnicas (Português - Brasil) |
"association-for-computing-machinery" | Association for Computing Machinery |
"biomed-central" | BioMed Central |
"bristol-university-press" | Bristol University Press |
"british-medical-journal" | BMJ |
"bmj" | A short alias of british-medical-journal |
"cell" | Cell |
"chicago-author-date" | Chicago Manual of Style 18th edition (author-date) |
"chicago-notes" | Chicago Manual of Style 18th edition (notes and bibliography) |
"chicago-fullnotes" | A short alias of chicago-notes |
"chicago-shortened-notes" | Chicago Manual of Style 18th edition (shortened notes and bibliography) |
"copernicus" | Copernicus Publications |
"cse-citation-sequence-brackets-8th-edition" | CSE Manual: Scientific Style and Format 8th edition (citation-sequence, brackets) |
"council-of-science-editors" | A short alias of cse-citation-sequence-brackets-8th-edition |
"cse-name-year" | CSE Manual: Scientific Style and Format 9th edition (name-year) |
"council-of-science-editors-author-date" | A short alias of cse-name-year |
"current-opinion" | Current Opinion journals |
"deutsche-gesellschaft-für-psychologie" | Deutsche Gesellschaft für Psychologie 5. Auflage (Deutsch) |
"deutsche-sprache" | Deutsche Sprache (Deutsch) |
"elsevier-harvard" | Elsevier (author-date/Harvard, with titles) |
"elsevier-vancouver" | Elsevier - NLM/Vancouver (citation-sequence) |
"elsevier-with-titles" | Elsevier (numeric, with titles) |
"frontiers" | Frontiers journals |
"future-medicine" | Future Medicine journals |
"future-science" | Future Science Group |
"gb-7714-2005-numeric" | China National Standard GB/T 7714-2005 (numeric, 中文) |
"gb-7714-2015-author-date" | China National Standard GB/T 7714-2015 (author-date, 中文) |
"gb-7714-2015-note" | China National Standard GB/T 7714-2015 (note, 中文) |
"gb-7714-2015-numeric" | China National Standard GB/T 7714-2015 (numeric, 中文) |
"gost-r-705-2008-numeric" | Russian GOST R 7.0.5-2008 (numeric) |
"harvard-cite-them-right" | Cite Them Right 12th edition (author-date/Harvard) |
"institute-of-electrical-and-electronics-engineers" | IEEE Reference Guide version 11.29.2023 |
"ieee" | A short alias of institute-of-electrical-and-electronics-engineers |
"institute-of-physics-numeric" | Institute of Physics (numeric) |
"iso-690-author-date" | ISO-690 (author-date, English) |
"iso-690-numeric" | ISO-690 (numeric, English) |
"karger" | Karger journals |
"mary-ann-liebert-vancouver" | Mary Ann Liebert - NLM/Vancouver |
"modern-humanities-research-association-notes" | MHRA Style Guide 4th edition (notes) |
"modern-humanities-research-association" | A short alias of modern-humanities-research-association-notes |
"modern-language-association" | MLA Handbook 9th edition (in-text citations) |
"mla" | A short alias of modern-language-association |
"modern-language-association-8" | A short alias of modern-language-association |
"mla-8" | A short alias of modern-language-association |
"multidisciplinary-digital-publishing-institute" | Multidisciplinary Digital Publishing Institute |
"nature" | Nature |
"nlm-citation-sequence" | NLM/Vancouver: Citing Medicine 2nd edition (citation-sequence) |
"vancouver" | A short alias of nlm-citation-sequence |
"nlm-citation-sequence-superscript" | NLM/Vancouver: Citing Medicine 2nd edition (citation-sequence, superscript) |
"vancouver-superscript" | A short alias of nlm-citation-sequence-superscript |
"pensoft" | Pensoft Journals |
"public-library-of-science" | Public Library of Science |
"plos" | A short alias of public-library-of-science |
"royal-society-of-chemistry" | Royal Society of Chemistry |
"sage-vancouver" | SAGE - NLM/Vancouver |
"sist02" | SIST02 (日本語) |
"spie" | SPIE journals |
"springer-basic" | Springer - Basic (numeric, brackets) |
"springer-basic-author-date" | Springer - Basic (author-date) |
"springer-fachzeitschriften-medizin-psychologie" | Springer - Fachzeitschriften Medizin Psychologie (Deutsch) |
"springer-humanities-author-date" | Springer - Humanities (author-date) |
"springer-lecture-notes-in-computer-science" | Springer - Lecture Notes in Computer Science |
"springer-mathphys" | Springer - MathPhys (numeric, brackets) |
"springer-socpsych-author-date" | Springer - SocPsych (author-date) |
"springer-vancouver" | Springer - NLM/Vancouver (citation-sequence, brackets) |
"taylor-and-francis-chicago-author-date" | Taylor & Francis Journals Standard Reference Style Guide: Chicago author-date version 2.0 |
"taylor-and-francis-national-library-of-medicine" | Taylor & Francis - NLM/Vancouver (citation-sequence, brackets) |
"the-institution-of-engineering-and-technology" | The Institution of Engineering and Technology |
"the-lancet" | The Lancet |
"thieme" | Thieme-German (Deutsch) |
"trends" | Trends journals |
"turabian-author-date" | Chicago Manual of Style 17th edition (author-date) |
"turabian-fullnote-8" | Chicago Manual of Style 17th edition (notes and bibliography, subsequent author-title) |