5. Citations

References are collected in doc/bibliography.inc, which contains some elisp helpers for citing RFCs and Wikipedia.

Note

Citations are realized as regular labels/hyperlinks. So `WPABBR`_ and [WPABBR]_ reference the same target, if they are defined in the same document. [WPABBR]_ also works, if the definition is in another document, while `WPABBR`_ is undefined in that case.

Emacs IDE support is available in global eIDE-menu (f5 f7):

75 => CITE: insert ReST citation from BibTeX/RIS citation (local "cite/" or "./") (`C-u C-c C-i C-u` use global "~/project/documentation/cite/")
76 => CITE: insert ReST citation from BibTeX/RIS citation (global "documentation/cite/") (`C-u C-c C-i C-u` use local "cite/" or "./")
77 => CITE: insert ReST citation from www.sciencedirect.com text citation
78 => CITE: Wikipedia

5.1. pandoc Citations

Source: Citations.

When the --citeproc option is used, pandoc can automatically generate citations and a bibliography in a number of styles. Basic usage is

pandoc --citeproc myinput.txt

To use this feature, you will need to have

Source: Specifying bibliographic data.

You can specify an external bibliography using the bibliography metadata field in a YAML metadata section or the --bibliography command line argument. If you want to use multiple bibliography files, you can supply multiple --bibliography arguments or set bibliography metadata field to YAML array. A bibliography may have any of these formats:

Format File extension
BibLaTeX .bib
BibTeX .bibtex
CSL JSON .json
CSL YAML .yaml
RIS .ris

5.1.1. Conversion of Bibliographic Data

As mentioned in Specifying bibliographic data, bibliographic data can be converted from input documents with the options --standalone and --citeproc.

pandoc cite/SHINY.ris --standalone --citeproc --csl apa --to plain
pandoc cite/SHINY.ris --standalone --citeproc --csl apa --to rst

pandoc cite/SHINY.ris --standalone --citeproc --to biblatex

pandoc cite/deKleer1999.bib --standalone --citeproc --to rst
pandoc cite/deKleer1999.bib --standalone --citeproc --to gfm
pandoc cite/deKleer1999.bib --standalone --citeproc -o xx-bib-test.pdf

5.1.2. Citation Example

( echo "[@deKleer1999]"; echo; echo "# References" ) | pandoc --biblio cite/deKleer1999.bib --citeproc --to rst

Produces:

(Kleer 1999)

References
==========

.. container:: references csl-bib-body hanging-indent
   :name: refs

   .. container:: csl-entry
      :name: ref-deKleer1999

      Kleer, Johan de. 1999. “An Improved Incremental Algorithm for
      Generating Prime Implicates.” In *Logical Foundations for
      Cognitive Agents: Contributions in Honor of Ray Reiter*, edited by
      Hector J. Levesque and Fiora Pirri, 103–12. Berlin, Heidelberg:
      Springer Berlin Heidelberg.
      https://doi.org/10.1007/978-3-642-60211-5_9.

5.1.3. Citation Styles

Citations and references can be formatted using any style supported by the Citation Style Language, listed in the Zotero Style Repository. These files are specified using the --csl option or the csl (or citation-style) metadata field. By default, pandoc will use the Chicago Manual of Style author-date format. (You can override this default by copying a CSL style of your choice to default.csl in your user data directory.) The CSL project provides further information on finding and editing styles.

The --citation-abbreviations option (or the citation-abbreviations metadata field) may be used to specify a JSON file containing abbreviations of journals that should be used in formatted bibliographies when form="short" is specified. The format of the file can be illustrated with an example:

{ "default": {
    "container-title": {
            "Lloyd's Law Reports": "Lloyd's Rep",
            "Estates Gazette": "EG",
            "Scots Law Times": "SLT"
    }
  }
}

pandoc comes with two citation styles that can be examined:

  • /usr/share/pandoc/data/jats.csl
  • /usr/share/pandoc-citeproc/chicago-author-date.csl

Get styles from citation-style-language/styles: Official repository for Citation Style Language (CSL) citation styles. (see also Finding and Installing Styles at Authors - Citation Style Language)

Install other styles in directory /usr/local/share/pandoc/csl or ~.local/share/pandoc/csl. Source: Can’t find CSL in ~/.csl directory *or* follow relative paths to CSL files. · Issue #50 · jgm/citeproc

mkdir -p "${HOME}/.local/share/pandoc/csl"
wget -q -O "${HOME}/.local/share/pandoc/csl/apa-no-abstract.csl" 'https://raw.githubusercontent.com/citation-style-language/styles/refs/heads/master/apa.csl'
wget -q -O "${HOME}/.local/share/pandoc/csl/apa-with-abstract.csl" 'https://raw.githubusercontent.com/citation-style-language/styles/refs/heads/master/apa-with-abstract.csl'
ln -s "apa-with-abstract.csl" "${HOME}/.local/share/pandoc/csl/apa.csl"

5.1.4. pandoc User Data Directory

pandoc --version

User data directory: /home/ws/.vnc/share/pandoc
Copyright (C) 2006-2024 John MacFarlane. Web: https://pandoc.org
This is free software; see the source for copying conditions. There is no
warranty, not even for merchantability or fitness for a particular purpose.