diff options
| -rw-r--r-- | MANUAL.txt | 2 | ||||
| -rw-r--r-- | changelog | 86 | ||||
| -rw-r--r-- | man/pandoc.1 | 37 | ||||
| -rw-r--r-- | pandoc.cabal | 2 |
4 files changed, 110 insertions, 17 deletions
diff --git a/MANUAL.txt b/MANUAL.txt index 759050023..acbf62e1f 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -1,6 +1,6 @@ % Pandoc User's Guide % John MacFarlane -% July 19, 2018 +% August 5, 2018 Synopsis ======== @@ -1,3 +1,89 @@ +pandoc (2.2.3) + + * RST reader: improve parsing of inline interpreted text roles (#4811). + + + Use a Span with class "title-reference" for the default + title-reference role. + + Use `B.text` to split up contents into `Space`s, `SoftBreak`s, + and `Str`s for `title-reference`. + + Use Code with class "interpreted-text" instead of Span and Str for + unknown roles. (The RST writer has also been modified to round-trip + this properly.) + + Disallow blank lines in interpreted text. + + Backslash-escape now works in interpreted text. + + Backticks followed by alphanumerics no longer end interpreted text. + + Remove support for nested inlines (Francesco Occhipinti). + RST does not allow nested emphasis, links, or other inline + constructs. This fixes several bugs (#4581, #4561, #4792). + + * Org reader: fix parsers relying on `parseFromString` (#4784, Albert + Krewinkel). Emphasis was not parsed when it followed directly after + some block types (e.g., lists). + + * Markdown reader: Allow unquoted numbers and booleans as YAML mapping + keys. Previously in 2.2.2 you could not do + ``` + --- + 0: bar + ... + ``` + but only + ``` + --- + '0': bar + ... + ``` + With this change, both forms work. + + * DocBook reader: metadata handling improvements. + Now we properly parse title and subtitle elements that are direct + children of book and article (as well as children of bookinfo, + articleinfo, or info). We also now use the `subtitle` metadata + field for subtitles, rather than tacking the subtitle on to the + title. + + * RST writer: + + + Allow images to be directly nested within links (#4810, Francesco + Occhipinti). + + Use `titleblock` instead of `title` variable for title block (#4803, + Francesco Occhipinti). `titleblock` contains a properly formatted + title and subtitle (using top-level headers). `title` and + `subtitle` variables are still available and just contain the + title and subtitle text. Note that this change will require an + update to custom rst templates. + + Render Code with class "interpreted-text" as interpreted text role. + + * MediaWiki writer: Avoid extra blank line in tables with empty cells + (#4794). Note that the old output is semantically identical, but the + new output looks better. + + * Lua Utils module: add function `blocks_to_inlines` (#4799, Albert + Krewinkel). Exposes a function converting which flattenes a list of + blocks into a list of inlines. An example use case would be the + conversion of Note elements into other inlines. + + * RST template: use `titleblock` instead of `title`. Users of + custom RST templates will want to update this. + + * LaTeX template: Moved some beamer code in default.latex template. + This change allows beamer themes to change the template and font (as + Metropolis does) (#4450). + + * Better error message on `-t pdf -o out.pdf` (#1155, Mauro Bieg). + + * Added test case for #4669 to repository. + + * INSTALL.md: Fix broken link for cabal-install (#4806, ChanHoHo). + + * MANUAL.txt: + + + Add beamer info for slide backgrounds (#4802, John Muccigrosso). + + Clarify when `csquotes` is used in LaTeX writer (#4514). + + Add `commonmark` to list of output formats where `raw_tex` has an + effect (see #4527). + + pandoc (2.2.2.1) * Fix regression finding templates in user data directory (#4777). diff --git a/man/pandoc.1 b/man/pandoc.1 index 8034512c3..51cc168b2 100644 --- a/man/pandoc.1 +++ b/man/pandoc.1 @@ -1,5 +1,5 @@ .\"t -.TH PANDOC 1 "July 19, 2018" "pandoc 2.2.2.1" +.TH PANDOC 1 "August 5, 2018" "pandoc 2.2.3" .SH NAME pandoc - general markup converter .SH SYNOPSIS @@ -187,8 +187,9 @@ requires \f[C]fontspec\f[]. If the \f[C]mathspec\f[] variable is set, \f[C]xelatex\f[] will use \f[C]mathspec\f[] instead of \f[C]unicode\-math\f[]. The \f[C]upquote\f[] and \f[C]microtype\f[] packages are used if -available, and \f[C]csquotes\f[] will be used for typography if added to -the template or included in any header file. +available, and \f[C]csquotes\f[] will be used for typography if +\f[C]\\usepackage{csquotes}\f[] is present in the template or included +via \f[C]/H/\-\-include\-in\-header\f[]. The \f[C]natbib\f[], \f[C]biblatex\f[], \f[C]bibtex\f[], and \f[C]biber\f[] packages can optionally be used for citation rendering. .SS Reading from the Web @@ -2364,7 +2365,7 @@ addition to \f[C]markdown\f[]): .RE .TP .B output formats -\f[C]textile\f[] +\f[C]textile\f[], \f[C]commonmark\f[] .RS .RE .SS Extension: \f[C]native_divs\f[] @@ -5562,32 +5563,38 @@ User\[aq]s Guide may also be used: \f[C]allowdisplaybreaks\f[], \f[C]allowframebreaks\f[], \f[C]b\f[], \f[C]c\f[], \f[C]t\f[], \f[C]environment\f[], \f[C]label\f[], \f[C]plain\f[], \f[C]shrink\f[], \f[C]standout\f[], \f[C]noframenumbering\f[]. -.SS Background in reveal.js +.SS Background in reveal.js and beamer +.PP +Background images can be added to self\-contained reveal.js slideshows +and to beamer slideshows. .PP -Background images can be added to self\-contained reveal.js slideshows. +For the same image on every slide, use the configuration option +\f[C]background\-image\f[] either in the YAML metadata block or as a +command\-line variable. +(There are no other options in beamer and the rest of this section +concerns reveal.js slideshows.) .PP -For the same image on every slide, use the reveal.js configuration -option \f[C]parallaxBackgroundImage\f[] either in the YAML metadata -block or as a command\-line variable. +For reveal.js, you can instead use the reveal.js\-native option +\f[C]parallaxBackgroundImage\f[]. You can also set \f[C]parallaxBackgroundHorizontal\f[] and \f[C]parallaxBackgroundVertical\f[] the same way and must also set \f[C]parallaxBackgroundSize\f[] to have your values take effect. .PP -To set an image for a particular slide, add +To set an image for a particular reveal.js slide, add \f[C]{data\-background\-image="/path/to/image"}\f[] to the first slide\-level header on the slide (which may even be empty). .PP In reveal.js\[aq]s overview mode, the parallaxBackgroundImage will show up only on the first slide. .PP -Other background settings also work on individual slides, including -\f[C]data\-background\-size\f[], \f[C]data\-background\-repeat\f[], -\f[C]data\-background\-color\f[], \f[C]data\-transition\f[], and -\f[C]data\-transition\-speed\f[]. +Other reveal.js background settings also work on individual slides, +including \f[C]data\-background\-size\f[], +\f[C]data\-background\-repeat\f[], \f[C]data\-background\-color\f[], +\f[C]data\-transition\f[], and \f[C]data\-transition\-speed\f[]. .PP See the reveal.js documentation for more details. .PP -For example: +For example in reveal.js: .IP .nf \f[C] diff --git a/pandoc.cabal b/pandoc.cabal index 355670312..92f2fb2ca 100644 --- a/pandoc.cabal +++ b/pandoc.cabal @@ -1,5 +1,5 @@ name: pandoc -version: 2.2.2.1 +version: 2.2.3 cabal-version: 2.0 build-type: Custom license: GPL-2 |