- name: bibliography
  schema:
    maybeArrayOf: path
  description: |
    Document bibliography (BibTeX or CSL). May be a single file or a list of files

- name: csl
  schema: path
  description: Citation Style Language file to use for formatting references.

- name: citations-hover
  schema: boolean
  tags:
    formats: [$html-files]
  default: true
  description: Enables a hover popup for citation that shows the reference information.

- name: citation-location
  schema:
    enum: [document, margin]
  tags:
    formats: [$html-doc]
  default: document
  description: Where citation information should be displayed (`document` or `margin`)

- name: cite-method
  tags:
    formats: [$pdf-all]
  schema:
    enum: [citeproc, natbib, biblatex]
  default: citeproc
  description: |
    Method used to format citations (`citeproc`, `natbib`, or `biblatex`).

- name: citeproc
  schema: boolean
  default: true
  description:
    short: "Turn on built-in citation processing"
    long: |
      Turn on built-in citation processing. To use this feature, you will need
      to have a document containing citations and a source of bibliographic data: 
      either an external bibliography file or a list of `references` in the 
      document's YAML metadata. You can optionally also include a `csl` 
      citation style file.

- name: biblatexoptions
  schema:
    maybeArrayOf: string
  tags:
    formats: [$pdf-all]
  description: A list of options for BibLaTeX.

- name: natbiboptions
  schema:
    maybeArrayOf: string
  tags:
    formats: [$pdf-all]
  description: One or more options to provide for `natbib` when generating a bibliography.

- name: biblio-style
  schema: string
  tags:
    formats: [$pdf-all]
  description: The bibliography style to use (e.g. `\bibliographystyle{dinat}`) when using `natbib` or `biblatex`.

- name: biblio-title
  schema: string
  tags:
    formats: [$pdf-all]
  description: The bibliography title to use when using `natbib` or `biblatex`.

- name: biblio-config
  schema: boolean
  tags:
    formats: [$pdf-all]
  description: Controls whether to output bibliography configuration for `natbib` or `biblatex` when cite method is not `citeproc`.

- name: citation-abbreviations
  schema: path
  description:
    short: "JSON file containing abbreviations of journals that should be used in formatted bibliographies."
    long: |
      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:

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