diff --git a/doc/org-manual.org b/doc/org-manual.org index d29c5314d..2cb538975 100644 --- a/doc/org-manual.org +++ b/doc/org-manual.org @@ -16523,16 +16523,16 @@ keywords. :END: #+cindex: citation -As of Org 9.5, a new library =oc.el= provides tooling to handle -citations in Org via "citation processors" that offer some or all of -the following capabilities: +The =oc.el= library provides tooling to handle citations in Org via +"citation processors" that offer some or all of the following +capabilities: -- "activate" :: Fontification, tooltip preview, etc. -- "follow" :: At-point actions on citations via ~org-open-at-point~. -- "insert" :: Add and edit citations via ~org-cite-insert~. -- "export" :: Via different libraries for different target formats. +- activate :: Fontification, tooltip preview, etc. +- follow :: At-point actions on citations via ~org-open-at-point~. +- insert :: Add and edit citations via ~org-cite-insert~. +- 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-export-processors~ respectively. @@ -16550,8 +16550,10 @@ more "bibliography" keywords. #+bibliography: "/some/file/with spaces/in its name.bib" #+end_example +#+kindex: C-c C-x @ +#+findex: org-cite-insert 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 identifying a reference in the bibliography. @@ -16560,9 +16562,10 @@ identifying a reference in the bibliography. - Each key starts with the character =@=. -- Each key can be qualified by a /prefix/ (e.g. "see ") and/or a - /suffix/ (e.g. "p. 123"), giving informations useful or necessary fo - the comprehension of the citation but not included in the reference. +- Each key can be qualified by a /prefix/ (e.g.\nbsp{}"see ") and/or + a /suffix/ (e.g.\nbsp{}"p.\nbsp{}123"), giving informations useful or necessary + fo the comprehension of the citation but not included in the + reference. - A single citation can cite more than one reference ; the keys are 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 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] -#+end_example +: [cite/style:common prefix ;prefix @key suffix; ... ; common suffix] 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 data and style files compatible with this processor (including a large number of publishers' styles). It uses citation commands - implemented in the LaTeX package ~natbib~, allowing more stylistic - variants that LaTeX's ~\cite~ command. + implemented in the LaTeX package =natbib=, allowing more stylistic + variants that LaTeX's =\cite= command. - biblatex :: this backend allows the use of data and formats prepared for BibLaTeX, an alternate bibliographic processor used 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 citation (and possibly reference) style(s); for example (all arguments