Skip to content
Bruce D'Arcus edited this page May 9, 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.

Variants

A number of citation system allow styles variants; for example, dropping enclosing punctuation to integrate the full citation in text.

  • alt bare (b) (removes citation enclosing punctuation; for example cite:locators/alt -> biblatex \notecite)
  • full (f) (rather than shortened, author list; for example \citet*)
  • caps (c) (force initial capitalization)

TBD: exactly how this is supported.

Sub-style option

Currently in the branch, sub-styles are full input parameters, delimited with a slash [cite:/text/caps:...].

Simple option

A convention to append something like these to the list of core styles:

  • bare (b)
  • caps (c)
  • full (f)
  • bare-caps (b+c)
  • bare-full (b+f)
  • bare-caps-full (b+c+f)
  • caps-full (c+f)

Could either be as:

  1. a simple string sub-style [cite:/t/c+f:...]
  2. no sub-styles at all; just have [cite/text+caps-full:...], or with shortcuts [cite/t+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