Variable: org-cite-note-rules
org-cite-note-rules is a customizable variable defined in oc.el.gz.
Value
(("en-us" inside outside after) ("fr" adaptive same before))
Documentation
Alist between languages and typographic rules for citations in note style.
When org-cite-adjust-note-numbers is non-nil, and note style is requested,
citation processor is allowed to move the note marker according to some specific
rules, detailed here. More accurately, a rule is a list following the pattern
(LANGUAGE-TAG . RULE)
LANGUAGE-TAG is a down-cased string representing a language tag as defined in
RFC 4646. It may constituted of a language and a region separated with an
hyphen (e.g., "en-us"), or the language alone (e.g., "fr"). A language
without a region applies to all regions.
RULE is a triplet
(PUNCTUATION NUMBER ORDER)
PUNCTUATION is the desired location of the punctuation with regards to the
quotation, if any. It may be inside, outside, or adaptive. The latter
permits subtler control over the punctuation: when there is no space between
the quotation mark and the punctuation, it is equivalent to inside.
Otherwise, it means outside, as illustrated in the following examples:
"A quotation ending without punctuation" [cite:@org21].
"A quotation ending with a period"[cite:@org21].
Notwithstanding the above, a space always appear before the citation when it
is to become anything else than a note.
NUMBER is the desired location of the note number with regards to the
quotation mark, if any. It may be inside, outside, or same. When set
to same, the number appears on the same side as the punctuation, unless
there is punctuation on both sides or on none.
ORDER is the relative position of the citation with regards to the closest
punctuation. It may be after or before.
For example (adaptive same before) corresponds to French typography.
When the locale is unknown to this variable, the default rule is:
(adaptive outside after)
This roughly follows the Oxford Guide to Style recommendations.
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-note-rules
'(("en-us" inside outside after)
("fr" adaptive same before))
"Alist between languages and typographic rules for citations in note style.
When `org-cite-adjust-note-numbers' is non-nil, and note style is requested,
citation processor is allowed to move the note marker according to some specific
rules, detailed here. More accurately, a rule is a list following the pattern
(LANGUAGE-TAG . RULE)
LANGUAGE-TAG is a down-cased string representing a language tag as defined in
RFC 4646. It may constituted of a language and a region separated with an
hyphen (e.g., \"en-us\"), or the language alone (e.g., \"fr\"). A language
without a region applies to all regions.
RULE is a triplet
(PUNCTUATION NUMBER ORDER)
PUNCTUATION is the desired location of the punctuation with regards to the
quotation, if any. It may be `inside', `outside', or `adaptive'. The latter
permits subtler control over the punctuation: when there is no space between
the quotation mark and the punctuation, it is equivalent to `inside'.
Otherwise, it means `outside', as illustrated in the following examples:
\"A quotation ending without punctuation\" [cite:@org21].
\"A quotation ending with a period\"[cite:@org21].
Notwithstanding the above, a space always appear before the citation when it
is to become anything else than a note.
NUMBER is the desired location of the note number with regards to the
quotation mark, if any. It may be `inside', `outside', or `same'. When set
to `same', the number appears on the same side as the punctuation, unless
there is punctuation on both sides or on none.
ORDER is the relative position of the citation with regards to the closest
punctuation. It may be `after' or `before'.
For example (adaptive same before) corresponds to French typography.
When the locale is unknown to this variable, the default rule is:
(adaptive outside after)
This roughly follows the Oxford Guide to Style recommendations."
:group 'org-cite
:package-version '(Org . "9.5")
:type
'(repeat
(list :tag "Typographic rule"
(string :tag "Language code")
(choice :tag "Location of punctuation"
(const :tag "Punctuation inside quotation" inside)
(const :tag "Punctuation outside quotation" outside)
(const :tag "Location depends on spacing" adaptive))
(choice :tag "Location of citation"
(const :tag "Citation inside quotation" inside)
(const :tag "Citation outside quotation" outside)
(const :tag "Citation next to punctuation" same))
(choice :tag "Order of citation and punctuation"
(const :tag "Citation first" before)
(const :tag "Citation last" after)))))