Merge branch 'bugfix'

This commit is contained in:
Nicolas Goaziou 2021-10-08 22:42:49 +02:00
commit 08e9d34907
1 changed files with 20 additions and 19 deletions

View File

@ -16523,16 +16523,16 @@ keywords.
:END: :END:
#+cindex: citation #+cindex: citation
As of Org 9.5, a new library =oc.el= provides tooling to handle The =oc.el= library provides tooling to handle citations in Org via
citations in Org via "citation processors" that offer some or all of "citation processors" that offer some or all of the following
the following capabilities: capabilities:
- "activate" :: Fontification, tooltip preview, etc. - activate :: Fontification, tooltip preview, etc.
- "follow" :: At-point actions on citations via ~org-open-at-point~. - follow :: At-point actions on citations via ~org-open-at-point~.
- "insert" :: Add and edit citations via ~org-cite-insert~. - insert :: Add and edit citations via ~org-cite-insert~.
- "export" :: Via different libraries for different target formats. - export :: Via different libraries for different target formats.
The user can configure these with ~org-cite-active-processor~, The user can configure these with ~org-cite-activate-processor~,
~org-cite-follow-processor~, ~org-cite-insert-processor~, and ~org-cite-follow-processor~, ~org-cite-insert-processor~, and
~org-cite-export-processors~ respectively. ~org-cite-export-processors~ respectively.
@ -16550,8 +16550,10 @@ more "bibliography" keywords.
#+bibliography: "/some/file/with spaces/in its name.bib" #+bibliography: "/some/file/with spaces/in its name.bib"
#+end_example #+end_example
#+kindex: C-c C-x @
#+findex: org-cite-insert
One can then insert and edit citations using ~org-cite-insert~, called One can then insert and edit citations using ~org-cite-insert~, called
with {{{kbd(M-x org-cite-insert)}}}. with {{{kbd(C-c C-x @)}}}.
A /citation/ requires one or more citation /key(s)/, elements A /citation/ requires one or more citation /key(s)/, elements
identifying a reference in the bibliography. identifying a reference in the bibliography.
@ -16560,9 +16562,10 @@ identifying a reference in the bibliography.
- Each key starts with the character =@=. - Each key starts with the character =@=.
- Each key can be qualified by a /prefix/ (e.g. "see ") and/or a - Each key can be qualified by a /prefix/ (e.g.\nbsp{}"see ") and/or
/suffix/ (e.g. "p. 123"), giving informations useful or necessary fo a /suffix/ (e.g.\nbsp{}"p.\nbsp{}123"), giving informations useful or necessary
the comprehension of the citation but not included in the reference. fo the comprehension of the citation but not included in the
reference.
- A single citation can cite more than one reference ; the keys are - A single citation can cite more than one reference ; the keys are
separated by semicolons ; the formatting of such citation groups is separated by semicolons ; the formatting of such citation groups is
@ -16570,11 +16573,9 @@ identifying a reference in the bibliography.
- One can also specify a stylistic variation for the citations by - One can also specify a stylistic variation for the citations by
inserting a =/= and a style name between the =cite= keyword and the inserting a =/= and a style name between the =cite= keyword and the
colon ; this usially makes sense only for the author-year styles. colon; this usually makes sense only for the author-year styles.
#+begin_example : [cite/style:common prefix ;prefix @key suffix; ... ; common suffix]
[cite/style:common prefix ;prefix @key suffix; ... ; common suffix]
#+end_example
The only mandatory elements are: The only mandatory elements are:
@ -16603,13 +16604,13 @@ Org currently includes the following export processors:
bibliographic processor used with LaTeX, thus allowing the use of bibliographic processor used with LaTeX, thus allowing the use of
data and style files compatible with this processor (including data and style files compatible with this processor (including
a large number of publishers' styles). It uses citation commands a large number of publishers' styles). It uses citation commands
implemented in the LaTeX package ~natbib~, allowing more stylistic implemented in the LaTeX package =natbib=, allowing more stylistic
variants that LaTeX's ~\cite~ command. variants that LaTeX's =\cite= command.
- biblatex :: this backend allows the use of data and formats - biblatex :: this backend allows the use of data and formats
prepared for BibLaTeX, an alternate bibliographic processor used prepared for BibLaTeX, an alternate bibliographic processor used
with LaTeX, which overcomes some serious BibTeX limitations, but with LaTeX, which overcomes some serious BibTeX limitations, but
has not (yet?) been widely adopted by publishers. has not (yet?)\nbsp{}been widely adopted by publishers.
The =CITE_EXPORT= keyword specifies the export processor and the The =CITE_EXPORT= keyword specifies the export processor and the
citation (and possibly reference) style(s); for example (all arguments citation (and possibly reference) style(s); for example (all arguments