diff options
author | John MacFarlane <jgm@berkeley.edu> | 2019-07-26 12:00:44 -0700 |
---|---|---|
committer | John MacFarlane <jgm@berkeley.edu> | 2019-07-28 19:25:45 -0700 |
commit | b35fae651145482f1218d32dbea5fffff60e0b0b (patch) | |
tree | 02175f056c40aee4329b8f944ada9c9cd6ac1284 /MANUAL.txt | |
parent | 99e24cf18337b0b460005bf77e367783c34b75e7 (diff) | |
download | pandoc-b35fae651145482f1218d32dbea5fffff60e0b0b.tar.gz |
Use doctemplates 0.3, change type of writerTemplate.
* Require recent doctemplates. It is more flexible and
supports partials.
* Changed type of writerTemplate to Maybe Template instead
of Maybe String.
* Remove code from the LaTeX, Docbook, and JATS writers that looked in
the template for strings to determine whether it is a book or an
article, or whether csquotes is used. This was always kludgy and
unreliable. To use csquotes for LaTeX, set `csquotes` in your
variables or metadata. It is no longer sufficient to put
`\usepackage{csquotes}` in your template or header includes.
To specify a book style, use the `documentclass` variable or
`--top-level-division`.
* Change template code to use new API for doctemplates.
Diffstat (limited to 'MANUAL.txt')
-rw-r--r-- | MANUAL.txt | 25 |
1 files changed, 12 insertions, 13 deletions
diff --git a/MANUAL.txt b/MANUAL.txt index 1422224d5..4ac7b3f29 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -152,18 +152,17 @@ the PDF engine requires [`fontspec`]. `xelatex` uses `xelatex` will use [`mathspec`] instead of [`unicode-math`]. The [`upquote`] and [`microtype`] packages are used if available, and [`csquotes`] will be used for [typography] -if `\usepackage{csquotes}` is present in the template or -included via `/H/--include-in-header`. The [`natbib`], -[`biblatex`], [`bibtex`], and [`biber`] packages can optionally -be used for [citation rendering]. The following packages -will be used to improve output quality if present, but -pandoc does not require them to be present: -[`upquote`] (for straight quotes in verbatim environments), -[`microtype`] (for better spacing adjustments), -[`parskip`] (for better inter-paragraph spaces), -[`xurl`] (for better line breaks in URLs), -[`bookmark`] (for better PDF bookmarks), -and [`footnotehyper`] or [`footnote`] (to allow footnotes in tables). +if the `csquotes` variable or metadata field is set to a +true value. The [`natbib`], [`biblatex`], [`bibtex`], and +[`biber`] packages can optionally be used for [citation +rendering]. The following packages will be used to improve +output quality if present, but pandoc does not require them to +be present: [`upquote`] (for straight quotes in verbatim +environments), [`microtype`] (for better spacing adjustments), +[`parskip`] (for better inter-paragraph spaces), [`xurl`] (for +better line breaks in URLs), [`bookmark`] (for better PDF +bookmarks), and [`footnotehyper`] or [`footnote`] (to allow +footnotes in tables). [TeX Live]: http://www.tug.org/texlive/ [`amsfonts`]: https://ctan.org/pkg/amsfonts @@ -927,7 +926,7 @@ Options affecting specific writers {.options} all headings are shifted such that the top-level heading becomes the specified type. The default behavior is to determine the best division type via heuristics: unless other conditions apply, `section` is chosen. When the - LaTeX document class is set to `report`, `book`, or `memoir` (unless the + `documentclass` variable is set to `report`, `book`, or `memoir` (unless the `article` option is specified), `chapter` is implied as the setting for this option. If `beamer` is the output format, specifying either `chapter` or `part` will cause top-level headings to become `\part{..}`, while |