mirror of
https://git.savannah.gnu.org/git/emacs/org-mode.git
synced 2024-11-22 07:09:47 +00:00
manual: Additional fixes to citations
* doc/org-manual.org (Citations): Mention binding for `org-cite-insert'. Fix spacing using non-breaking spaces. Revert some code uses introduced in the previous commit.
This commit is contained in:
parent
b06c6c7e78
commit
f7fb7a3cf2
@ -16516,16 +16516,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.
|
||||
|
||||
@ -16543,8 +16543,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.
|
||||
@ -16553,9 +16555,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
|
||||
@ -16563,11 +16566,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:
|
||||
|
||||
@ -16596,13 +16597,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
|
||||
|
Loading…
Reference in New Issue
Block a user