Cite Field

In many areas, we are frequently invited to comment on different editions and translations of the same work. In such cases, we refer not only to the authors and dates of the publications, but also to their editors, translators, publishers, and their original titles and editions. But how to do this? If citetools is enabled, then the answer lies in a small variation of Pandoc’s vanilla syntax for citations.

Use [@Citekey]{.csl_field} where .csl_field is the field name prefixed by a dot, to specify the field to print.

Practical example

Here is a printout of different citation fields followed by a concrete example of how to use them in a document.

Printout of different fields from the reference
Raw	Output
`[@AristOp]{.author}`	Aristotle
`[@AristOp]{.editor}`	Bekker
`[@AristOp]{.title}`	Aristotelis opera
`[@AristOp]{.issued}`	1831¹
`[@AristOp]{.publisher}`	Reimer
`[@AristOp]{.publisher-place}`	Berlim
`[@AristOp]{.edition}`	1
`[@AristOp]{.number-of-volumes}`	4

AristOp

type: book
id: AristOp
author:
- family: Aristotle
editor:
- family: Bekker
  given: Immanuel
title: Aristotelis opera
issued:
  date-parts:
  - 1831
number-of-volumes: '4'
publisher: Reimer
publisher-place: Berlim
edition: '1'

Document processing using Quarto and Pandoc is much faster using CSL-YAML/JSON bibliographies than using BibTeX or RIS because Pandoc also uses the Citation Style Language internally (of which CSL-YAML is a representation).

{
    "author": [
      {
        "family": "Aristotle"
      }
    ],
    "editor": [
      {
        "family": "Bekker",
        "given": "Immanuel"
      }
    ],
    "id": "AristOp",
    "issued": {
      "date-parts": [
        [
          1831
        ]
      ]
    },
    "number-of-volumes": "4",
    "publisher": "Reimer",
    "publisher-place": "Berlim",
    "title": "Aristotelis opera",
    "type": "book",
    "edition": "1"
  }

@book{AristOp,
  author = {Aristotle},
  editor = {Bekker, Immanuel},
  title = {Aristotelis opera},
  publisher = {Reimer},
  address = {Berlim},
  volumes = {4},
  edition = {1},
  year = {1831}
}

TY  - BOOK
ID  - AristOp
AU  - Aristotle
ED  - Bekker, Immanuel
TI  - Aristotelis opera
PB  - Reimer
CY  - Berlim
ET  - 1
VL  - 4
Y1  - 1831
ER  -

With this knowledge, we could state the following in our text:

The works of [@AristOp]{.author} were first edited by [@AristOp]{.editor} under the title [@AristOp]{.title} in [@AristOp]{.issued}.

Which would render as:

The works of Aristotle were first edited by Bekker under the title Aristotelis opera in 1831.

Citation Style Language

Did you notice that we used [@AristOp]{.issued} instead of ~~[@AristOp]{.date}~~? And [@AristOp]{.publisher-place} instead of ~~[@AristOp]{.city}~~?

Internally, as we said, Pandoc uses the Citation Style Language to handle bibliographies. This is a standard schema for bibliographic data, which is used by some bibliography managers, such as Zotero, and JabRef. Most, however, are closer to the conventions of BibTeX (or RIS) which is why you may not see an exact correspondence between the CSL variables and BibTeX field names.

In CSL, there are the following variables:

  abstract accessed annote archive archive_collection archive_location archive-place author authority available-date call-number chair chapter-number citation-key citation-label citation-number collection-editor collection-number collection-title compiler composer container-author container-title container-title-short contributor curator dimensions director division DOI edition editor editor-translator editorial-director event event-date event-place event-title executive-producer first-reference-note-number genre guest host illustrator interviewer ISBN ISSN issue issued jurisdiction keyword language license locator medium narrator note notes number number-of-pages number-of-volumes organizer original-author original-date original-publisher original-publisher-place original-title page page-first part-number part-title performer PMCID PMID printing-number producer publisher publisher-place recipient references reviewed-author reviewed-genre reviewed-title scale script-writer section series-creator source status submitted supplement-number title title-short translator URL version volume volume-title year-suffix

Here is a quick reference, not exhaustive by any means, of where will the data end up in the conversion from BibTeX and RIS to CSL. This means that the CSL variables on the first column are the final destination and they receive the content of the second or third-column fields depending on the format it converts from. On the second tab, we map the reference types from BibTeX to the CSL types.

CSL & BibTeX Fields
CSL & BibTeX Types

Where do BibTeX and RIS fields end up in CSL-YAML/CSL-JSON?
CSL	BibTeX	RIS
author	authors	AU
editor	editors	ED
issued	date	PY
title	title	T1
title-short	shorttitle	`-`
container-title	booktitle (inproceedings incollection inbook)	BT
container-title	journal (article book proceedings masterthesis lexicon online booklet)	JA
collection-title	series	`-`
original-title	origtitle	OR
publisher	school, institution, organization, howpublished, publisher	PB
publisher-place	address	PP
abstract	abstract	AB
url	URL	UR
keywords	keywords	KW
chapter-number	chapter	`-`
issue	issue (article), number (article)	IS
number	number (phdthesis)	IS
collection-number	number (book)	IS
volume	volume	VL
number-of-volumes	volumes	NV
page	pages	SP
edition	edition	ET
genre	type	`-`
call-number	library	ID
version	version	`-`

See also, the full list of CSL variables, BibTeX Fields and RIS Tags.

How do BibTeX types end up in CSL-YAML/CSL-JSON?
CSL	BibTeX
article-journal	article
book	book
pamphlet	booklet
chapter	inbook
chapter	incollection
paper-conference	inproceedings
book	manual
thesis	mastersthesis
thesis	misc
thesis	phdthesis
book	proceedings
report	techreport
manuscript	unpublished

See also the full list of CSL and BibTeX types.

Primary Sources

Aristotle. 1831. Aristotelis Opera. Edited by Immanuel Bekker. 1st ed. 4 vols. Berlim: Reimer. [1]

Footnotes

Note that [-@AristOp] would render as (1831).↩︎

Citation

BibTeX citation:

@online{vasconcelos2023,
  author = {Vasconcelos, BCDA},
  title = {Cite {Field}},
  date = {2023},
  url = {https://bcdavasconcelos.github.io/citetools/docs_qmd/03-cite-field.html},
  langid = {en}
}

For attribution, please cite this work as:

Vasconcelos, BCDA. 2023. “Cite Field.” 2023. https://bcdavasconcelos.github.io/citetools/docs_qmd/03-cite-field.html.