[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/org 08e9d34 3/4: Merge branch 'bugfix'
From: |
ELPA Syncer |
Subject: |
[elpa] externals/org 08e9d34 3/4: Merge branch 'bugfix' |
Date: |
Fri, 8 Oct 2021 16:57:39 -0400 (EDT) |
branch: externals/org
commit 08e9d34907e8c50da22f2981b3965a7b3fedda3a
Merge: 002a07b f7fb7a3
Author: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Commit: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Merge branch 'bugfix'
---
doc/org-manual.org | 39 ++++++++++++++++++++-------------------
1 file changed, 20 insertions(+), 19 deletions(-)
diff --git a/doc/org-manual.org b/doc/org-manual.org
index d29c531..2cb5389 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