citeElementElementElement functions can be customized with set and show rules.
set and show rules.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")).
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.
ParameterParameterParameters are input values for functions. Specify them in parentheses after the function name.
keyRequiredRequiredRequired parameters must be specified when calling the function.PositionalPositionalPositional parameters can be set by specifying them in order, omitting the parameter name.
The citation key that identifies the entry in the bibliography that shall be cited, as a label.
Show example
// All the same
@netwok \
#cite(<netwok>) \
#cite(label("netwok"))
supplement
A supplement for the citation such as page or chapter number.
In reference syntax, the supplement can be added in square brackets:
Default value: none
Show example
This has been proven. @distress[p.~7]
#bibliography("works.bib")
form
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.
Available string values:
normalDisplay in the standard way for the active style.
proseProduces a citation that is suitable for inclusion in a sentence.
fullMimics a bibliography entry, with full information about the cited work.
authorShows only the cited work's author(s).
yearShows only the cited work's year.
Default value: "normal"
Show example
#cite(<netwok>, form: "prose")
show the outsized effects of
pirate life on the human psyche.
style
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 to a CSL file. For more details about paths, see the Paths section.
- Raw bytes from which a CSL style should be decoded.
Available string values:
alphanumericAlphanumeric
american-anthropological-associationAmerican Anthropological Association
american-chemical-societyAmerican Chemical Society
american-geophysical-unionAmerican Geophysical Union
american-institute-of-aeronautics-and-astronauticsAmerican Institute of Aeronautics and Astronautics
american-institute-of-physicsAmerican Institute of Physics 4th edition
american-medical-associationAmerican Medical Association 11th edition
american-meteorological-societyAmerican Meteorological Society
american-physics-societyAmerican Physical Society
american-physiological-societyAmerican Physiological Society
american-political-science-associationAmerican Political Science Association
american-psychological-associationAmerican Psychological Association 7th edition
apaA short alias of
american-psychological-associationamerican-society-for-microbiologyAmerican Society for Microbiology
american-society-of-civil-engineersAmerican Society of Civil Engineers
american-society-of-mechanical-engineersAmerican Society of Mechanical Engineers
american-sociological-associationAmerican Sociological Association 6th/7th edition
angewandte-chemieAngewandte Chemie International Edition
annual-reviewsAnnual Reviews (sorted by order of appearance)
annual-reviews-author-dateAnnual Reviews (author-date)
associacao-brasileira-de-normas-tecnicasAssociação Brasileira de Normas Técnicas (Português - Brasil)
association-for-computing-machineryAssociation for Computing Machinery
biomed-centralBioMed Central
bristol-university-pressBristol University Press
british-medical-journalBMJ
bmjA short alias of
british-medical-journalcellCell
chicago-author-dateChicago Manual of Style 17th edition (author-date)
chicago-fullnotesChicago Manual of Style 17th edition (full note)
chicago-notesChicago Manual of Style 17th edition (note)
copernicusCopernicus Publications
council-of-science-editorsCouncil of Science Editors, Citation-Sequence (numeric, brackets)
council-of-science-editors-author-dateCouncil of Science Editors, Name-Year (author-date)
current-opinionCurrent Opinion journals
deutsche-gesellschaft-für-psychologieDeutsche Gesellschaft für Psychologie 5. Auflage (Deutsch)
deutsche-spracheDeutsche Sprache (Deutsch)
elsevier-harvardElsevier - Harvard (with titles)
elsevier-vancouverElsevier - Vancouver
elsevier-with-titlesElsevier (numeric, with titles)
frontiersFrontiers journals
future-medicineFuture Medicine journals
future-scienceFuture Science Group
gb-7714-2005-numericChina National Standard GB/T 7714-2005 (numeric, 中文)
gb-7714-2015-author-dateChina National Standard GB/T 7714-2015 (author-date, 中文)
gb-7714-2015-noteChina National Standard GB/T 7714-2015 (note, 中文)
gb-7714-2015-numericChina National Standard GB/T 7714-2015 (numeric, 中文)
gost-r-705-2008-numericRussian GOST R 7.0.5-2008 (numeric)
harvard-cite-them-rightCite Them Right 12th edition - Harvard
institute-of-electrical-and-electronics-engineersIEEE
ieeeA short alias of
institute-of-electrical-and-electronics-engineersinstitute-of-physics-numericInstitute of Physics (numeric)
iso-690-author-dateISO-690 (author-date, English)
iso-690-numericISO-690 (numeric, English)
kargerKarger journals
mary-ann-liebert-vancouverMary Ann Liebert - Vancouver
modern-humanities-research-associationModern Humanities Research Association 4th edition (note with bibliography)
modern-language-associationModern Language Association 9th edition
mlaA short alias of
modern-language-associationmodern-language-association-8Modern Language Association 8th edition
mla-8A short alias of
modern-language-association-8multidisciplinary-digital-publishing-instituteMultidisciplinary Digital Publishing Institute
natureNature
pensoftPensoft Journals
public-library-of-sciencePublic Library of Science
plosA short alias of
public-library-of-scienceroyal-society-of-chemistryRoyal Society of Chemistry
sage-vancouverSAGE - Vancouver
sist02SIST02 (日本語)
spieSPIE journals
springer-basicSpringer - Basic (numeric, brackets)
springer-basic-author-dateSpringer - Basic (author-date)
springer-fachzeitschriften-medizin-psychologieSpringer - Fachzeitschriften Medizin Psychologie (Deutsch)
springer-humanities-author-dateSpringer - Humanities (author-date)
springer-lecture-notes-in-computer-scienceSpringer - Lecture Notes in Computer Science
springer-mathphysSpringer - MathPhys (numeric, brackets)
springer-socpsych-author-dateSpringer - SocPsych (author-date)
springer-vancouverSpringer - Vancouver (brackets)
taylor-and-francis-chicago-author-dateTaylor & Francis - Chicago Manual of Style (author-date)
taylor-and-francis-national-library-of-medicineTaylor & Francis - National Library of Medicine
the-institution-of-engineering-and-technologyThe Institution of Engineering and Technology
the-lancetThe Lancet
thiemeThieme-German (Deutsch)
trendsTrends journals
turabian-author-dateTurabian 9th edition (author-date)
turabian-fullnote-8Turabian 8th edition (full note)
vancouverVancouver
vancouver-superscriptVancouver (superscript)
Default value: auto