Skip to content
Bruce D'Arcus edited this page May 8, 2021 · 52 revisions

This provides a mapping from possible org-cite style and sub-style names to different export formats.

Style Names and Mappings

For citeproc-org, the asterisk represents a suggested supported style.

org-cite style org-cite shortcut natbib biblatex citeproc-org notes
default (no style) \citep \autocite default
text t \citet \textcite *
author a \citeauthor \citeauthor *
title ti \citetitle *
year y \citeyear \citeyear *
locators l \pnotecite * page numbers and such only (p23)
nocite n \nocite *

Note that CSL implementations like citeproc-el are based around biblatex autocite-like functionality as default. The CSL style controls how the default cite command is formatted. While this is less-flexible than biblatex, for example, it's simpler for the user, as you use the same base command regardless of whether you are using an author-date, numeric, or note-based style.

Sub-styles

Can be appended to the above styles as a way to handle some of the natbib and biblatex variants, without an explosion of styles. This includes the default style, which would result in [cite//alt:@doe].

  • alt (removes citation enclosing punctuation; for example cite:locators/alt -> biblatex \notecite); I think "bare" would be more clear?
  • full (rather than shortened, author list; for example \citet*)
  • caps (force initial capitalization)

TBD: if this is supported, and if yes, what the model and syntax; two options:

  1. a list (in the branch code, currently slash-delimited; so cite/text/caps)
  2. a string (cite/caps+full or shortcut of cite/c+f)

Caveats

Not all styles and sub-styles are relevant to all intermediate output formats or final output styles.

  • in text/alt the sub-style overrides the style, at least in author-date citation styles
  • in year/caps the sub-style has no effect
  • etc (todo)
Clone this wiki locally