Variable: org-cite-export-processors

org-cite-export-processors is a customizable variable defined in oc.el.gz.

Value

((t basic))

Documentation

Processor used for exporting citations, as a triplet, or nil.

When nil, citations and bibliography are not exported.

When non-nil, the value is an association list between export backends and citation export processors:

  (BACKEND . PROCESSOR)

where BACKEND is the name of an export backend or t, and PROCESSOR is a triplet following the pattern

  (NAME BIBLIOGRAPHY-STYLE CITATION-STYLE)

There, NAME is the name of a registered citation processor providing export functionality, as a symbol. BIBLIOGRAPHY-STYLE (respectively CITATION-STYLE) is the desired default style to use when printing a bibliography (respectively exporting a citation), as a string or nil. Both BIBLIOGRAPHY-STYLE and CITATION-STYLE are optional. NAME is mandatory.

The export process selects the citation processor associated to the current export backend, or the most specific backend the current one is derived from, or, if all are inadequate, to the processor associated to t. For example, with the following value

  ((beamer natbib)
   (latex biblatex)
   (t csl))

exporting with beamer or any backend derived from it will use natbib, whereas exporting with latex or any backend derived from it but different from beamer will use biblatex processor. Any other backend, such as html, will use csl processor.

CITATION-STYLE is overridden by adding a style to any citation object. A nil style lets the export processor choose the default output. Any style not recognized by the export processor is equivalent to nil.

The citation triplet can also be set with the CITE_EXPORT keyword. E.g.,

  #+CITE_EXPORT: basic note numeric

or

  #+CITE_EXPORT: basic

In that case, basic processor is used on every export, independently on the backend.

This variable was added, or its default value changed, in Org version
9.5.

Source Code

;; Defined in /usr/src/emacs/lisp/org/oc.el.gz
(defcustom org-cite-export-processors '((t basic))
  "Processor used for exporting citations, as a triplet, or nil.

When nil, citations and bibliography are not exported.

When non-nil, the value is an association list between export backends and
citation export processors:

  (BACKEND . PROCESSOR)

where BACKEND is the name of an export backend or t, and PROCESSOR is a
triplet following the pattern

  (NAME BIBLIOGRAPHY-STYLE CITATION-STYLE)

There, NAME is the name of a registered citation processor providing export
functionality, as a symbol.  BIBLIOGRAPHY-STYLE (respectively CITATION-STYLE)
is the desired default style to use when printing a bibliography (respectively
exporting a citation), as a string or nil.  Both BIBLIOGRAPHY-STYLE and
CITATION-STYLE are optional.  NAME is mandatory.

The export process selects the citation processor associated to the current
export backend, or the most specific backend the current one is derived from,
or, if all are inadequate, to the processor associated to t.  For example, with
the following value

  ((beamer natbib)
   (latex biblatex)
   (t csl))

exporting with `beamer' or any backend derived from it will use `natbib',
whereas exporting with `latex' or any backend derived from it but different
from `beamer' will use `biblatex' processor.  Any other backend, such as
`html', will use `csl' processor.

CITATION-STYLE is overridden by adding a style to any citation object.  A nil
style lets the export processor choose the default output.  Any style not
recognized by the export processor is equivalent to nil.

The citation triplet can also be set with the CITE_EXPORT keyword.
E.g.,

  #+CITE_EXPORT: basic note numeric

or

  #+CITE_EXPORT: basic

In that case, `basic' processor is used on every export, independently on the
backend."
  :group 'org-cite
  :package-version '(Org . "9.5")
  :type '(choice (const :tag "No export" nil)
                 (alist :key-type symbol
                        :value-type
                        (list :tag "Citation processor"
                              (symbol :tag "Processor name")
                              (choice
                               (const :tag "Default bibliography style" nil)
                               (string :tag "Use specific bibliography style"))
                              (choice
                               (const :tag "Default citation style" nil)
                               (string :tag "Use specific citation style"))))))