org-manual: Typography fixes

* doc/org-manual.org (Citation export processors): Use fixed-with
areas for single-line examples.  Upcase keywords.  External commands
or symbols use code instead of verbatim.  Remove indentation when
appropriate.
This commit is contained in:
Nicolas Goaziou 2021-10-08 22:36:59 +02:00
parent 89968077cf
commit b06c6c7e78
1 changed files with 17 additions and 20 deletions

View File

@ -16582,7 +16582,7 @@ Org currently includes the following export processors:
- Two processors can export to a variety of formats, including =latex= - Two processors can export to a variety of formats, including =latex=
(and therefore =pdf=), =html=, =odt= and plain (UTF8) text: (and therefore =pdf=), =html=, =odt= and plain (UTF8) text:
- basic :: a basic export processors, well adapted to situations - basic :: a basic export processor, well adapted to situations
where backward compatibility is not a requirement and formatting where backward compatibility is not a requirement and formatting
needs are minimal; needs are minimal;
@ -16592,45 +16592,42 @@ Org currently includes the following export processors:
- In contrast, two other processors target LaTeX and LaTeX-derived - In contrast, two other processors target LaTeX and LaTeX-derived
formats exclusively: formats exclusively:
- natbib :: this export processor uses =bibtex=, the historical - natbib :: this export processor uses BibTeX, the historical
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 a data and style files compatible with this processor (including
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?) 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
are optional) are optional)
#+begin_example : #+cite_export: basic author author-year
#+cite_export: basic author author-year
#+end_example
#+texinfo: @noindent
specifies the "basic" export processor with citations inserted as specifies the "basic" export processor with citations inserted as
author's name and references indexed by author's names and year; author's name and references indexed by author's names and year;
#+begin_example : #+cite_export: csl /some/path/to/vancouver-brackets.csl
#+cite_export: csl /some/path/to/vancouver-brackets.csl
#+end_example
#+texinfo: @noindent
specifies the "csl" processor and CSL style, which in this case specifies the "csl" processor and CSL style, which in this case
defines numeric citations and numeric references according to the defines numeric citations and numeric references according to the
=Vancouver= specification (as style used in many medical journals), =Vancouver= specification (as style used in many medical journals),
following a typesetting variation putting citations between brackets; following a typesetting variation putting citations between brackets;
#+begin_example : #+cite_export: natbib kluwer
#+cite_export: natbib kluwer
#+end_example
specifies the "natbib" export processor with a label citation style #+texinfo: @noindent
specifies the =natbib= export processor with a label citation style
conformant to the Harvard style and the specification of the conformant to the Harvard style and the specification of the
Wolkers-Kluwer publisher; since it relies on the =bibtex= processor of Wolkers-Kluwer publisher; since it relies on the ~bibtex~ processor of
your LaTeX installation, it won't export to anything but PDF. your LaTeX installation, it won't export to anything but PDF.
* Working with Source Code * Working with Source Code