Re: Citation syntax: a revised proposal

[tsd@tsdye.com (Thomas S. Dye)]

Rasmus <rasmus@gmx.us> writes:

> Probably a CITATION_STYLE as well, e.g. "numeric", "author-year", etc.

I suggest we keep Patrick Daly's distinction between "citation style"
and "citation mode".  Hence, #+CITATION_MODE instead
of #+CITATION_STYLE. 
 
IIUC, there are three citation modes:
 1. Harvard, author-date, author-year, etc.  In this mode, some
    citation detail is given at the point of the Org mode citation.
 2. Vancouver, footnote, etc.  In this mode, the point of the Org mode
    citation is indicated by a number that references a footnote or
    endnote where some citation detail is given.  In some variants of
    this mode, the full citation information is provided in the
    footnote or endnote and no separate bibliography is used, while in
    others only partial citation detail is provided in the footnote or
    endnote and a bibliography is provided.
 3. Numerical.  In this mode, no citation detail is inserted, only a
    number that references an entry in the bibliography.

Within each of these three modes, there are numerous citation styles,
which refer to the placement of items and the kinds of punctuation in
the citation.

In the wild, a particular citation style might appear with one
bibliographic style or another.  Hence, the separation of citation
styles from bibliographic styles in systems such as biblatex.

The following tables describe my uncertainty about how the Org mode
citations map to these three modes.  The tables show example (modulo
style) replacement text at the point of the Org mode citation.  Note
that the Vancouver mode will also require the addition of citation
information in a footnote or endnote, separate from the position of the
Org mode citation.

#+name: first-map
| citation | Harvard       | Vancouver | numerical |
|----------+---------------+-----------+-----------|
| @key     | author year   |         1 |         1 |
| [@key]   | (author year) |       (1) |       (1) |
| cite:    | author year   |         1 |         1 |
| (cite):  | (author year) |       (1) |       (1) |

#+name: second-map
| citation | Harvard       | Vancouver  | numerical  |
|----------+---------------+------------+------------|
| @key     | author (year) | author (1) | author (1) |
| [@key]   | (author year) | (1)        | (1)        |
| cite:    | author (year) | author (1) | author (1) |
| (cite):  | (author year) | (1)        | (1)        |

Or, is there a third-map that better captures what we're discussing?

All the best,
Tom

-- 
Thomas S. Dye
http://www.tsdye.com