@@ -10,12 +10,25 @@ pandoc (2.7)
1010 `$HOME/.pandoc` to `$HOME/.local/share/pandoc`. On Windows the
1111 default user data directory remains the same.
1212
13+ * Slide show formats behavior change: content under headers
14+ less than slide level is no longer ignored, but included in
15+ the title slide (for HTML slide shows) or in a slide after
16+ the title slide (for beamer). This change makes possible
17+ 2D reveal.js slideshows with content in the top slide on
18+ each stack (#4317, #5237).
19+
1320 * Add command line option `--ipynb-output=all|none|best` (#5339).
21+ Output cells in ipynb notebooks often contain several different
22+ versions of an output, with different MIME types, e.g. an HTML
23+ table and a plain-text fallback. Specifying `--ipynb-output=best`
24+ (the default) ensures that the best version for the output format
25+ is used. `all` includes all versions, and `none` suppresses them
26+ all, leaving output cells empty.
1427
1528 * `asciidoctor` is now an output format separate from `asciidoc`,
1629 to accommodate some minor implementation-specific differences
1730 (currently just in the treatment of display math).
18−
31+
1932 * Add `latexmk` as an option for `--pdf-engine` (#3195).
2033 Note that you can use `--pdf-engine-opt=-outdir=bar` to specify
2134 a persistent temp directory.
@@ -25,10 +38,10 @@ pandoc (2.7)
2538 + Improve tight/loose list handling (#5285). Previously the
2639 algorithm allowed list items with a mix of Para and Plain, which
2740 is never wanted.
28− + Add newline when parsing blocks in YAML (#5271).
29− Otherwise last block gets parsed as a Plain rather than
30− a Para. This is a regression in pandoc 2.x. This patch restores
31− pandoc 1.19 behavior.
41+ + Add newline when parsing blocks in YAML (#5271). Otherwise last
42+ block gets parsed as a Plain rather than a Para. This is a
43+ regression in pandoc 2.x. This patch restores pandoc 1.19
44+ behavior.
3245 + Make `yamlToMeta` respect extensions (#5272, Mauro Bieg).
3346 This adds a `ReaderOptions` parameter to `yamlToMeta` [API change].
3447 + Fix bug parsing fenced code blocks (#5304). Previously parsing
@@ -60,25 +73,24 @@ pandoc (2.7)
6073 + Unwrap sdt elements in footnotes and comments (#5302).
6174
6275 * Muse reader (Alexander Krotov):
63−
76+
6477 + Test that block level markup does not break `<verbatim>`.
6578 + Add secondary note support.
6679
67− * ipynb reader: handle images referring to attachments.
68− Previously we didn't strip off the attachment: prefix,
69− so even though the attachment is available in the mediabag,
70− pandoc couldn't find it.
80+ * ipynb reader: handle images referring to attachments. Previously
81+ we didn't strip off the attachment: prefix, so even though the
82+ attachment was available in the mediabag, pandoc couldn't find it.
7183
7284 * JATS reader:
73−
85+
7486 + Fix parsing of figures (#5321). This ensures that a figure
7587 containing a single image is parsed as a pandoc "implicit
7688 figure" (i.e., a Para with a single Image whose title attribute
7789 begins with `fig:`). More complex figures will still be parsed
7890 as divs.
7991 + Support `fig-group` block element (#5317).
80− + Handle citations with multiple references (#5310).
81− The `rid` attribute can have a space-separated list of ids.
92+ + Handle citations with multiple references (#5310). The `rid`
93+ attribute can have a space-separated list of ids.
8294
8395 * AsciiDoc Writer: Add `writeAsciiDoctor` [API change, Tarik Graba].
8496 Handle display math appropriately for Asciidoctor.
@@ -88,14 +100,11 @@ pandoc (2.7)
88100
89101 * HTML writer:
90102
91− + Implement WAI-ARIA roles for (end)notes, citations,
92− and bibliography (#4213). Note that doc-biblioref is only used when
103+ + Implement WAI-ARIA roles for (end)notes, citations, and
104+ bibliography (#4213). Note that doc-biblioref is only used when
93105 link-citations produces links, since it belongs on links.
94− + Include content under title slides (#4317, #5237). This
95− facilitates real 2D revealjs slideshows, with content under the
96− top-level slide in each stack. It also enables notes on title slides.
97− Behavior change: content above slide level is no longer ignored; it
98− now gets added to the title slide.
106+ + Include content (including speaker notes) in title slides
107+ (#4317, #5237).
99108
100109 * ipynb writer:
101110
@@ -105,7 +114,8 @@ pandoc (2.7)
105114 including data: URIs (#5303).
106115 + Keep plain text fallbacks in output even if a richer format is
107116 included (#5293). We don't know what output format will be needed.
108− The fallback can always be weeded out using a filter.
117+ See the `--ipynb-output` command line option for a way to control
118+ what formats are included in the output.
109119
110120 * Markdown writer: use `markdown="1"` when appropriate for Divs:
111121 when `native_divs` and `markdown_in_html_blocks` are disabled
@@ -124,17 +134,15 @@ pandoc (2.7)
124134 + For beamer, include contents under headers superordinate to
125135 slidelevel (#4317). Currently we keep the fancy title slide, and
126136 add a new slide with the same title and whatever content was
127− under the header. This changes behavior of slides, but is
128− consistent with the new behavior of the revealjs and other HTML
129− slide show writers.
137+ under the header.
130138
131139 * Powerpoint writer (Jesse Rosenthal): support underlines.
132140 Use span with single class "underline" as in docx writer.
133141
134142 * Muse writer: escape secondary notes (Alexander Krotov).
135−
143+
136144 * FB2 writer: add section identifiers support (#5229, John KetzerX).
137−
145+
138146 * Make `--fail-if-warnings` work for PDF output (#5343).
139147
140148 * Lua filters (Albert Krewinkel):
@@ -143,14 +151,13 @@ pandoc (2.7)
143151 `init.lua` in pandoc's data directory is run as part of pandoc's
144152 Lua initialization process. Previously, the `pandoc` module was
145153 loaded in `init.lua`, and the structure for marshaling was
146− set-up after. This allowed simple patching of element
154+ set up after. This allowed simple patching of element
147155 marshaling, but made using `init.lua` more difficult. Now, all
148156 required modules are now loaded before calling `init.lua`. The
149157 file can be used entirely for user customization. Patching
150158 marshaling functions, while discouraged, is still possible via
151159 the `debug` module.
152− + Re-export all bundled modules (Albert Krewinkel).
153− All Lua modules bundled with pandoc, i.e., `pandoc.List`,
160+ + All Lua modules bundled with pandoc, i.e., `pandoc.List`,
154161 `pandoc.mediabag`, `pandoc.utils`, and `text` are re-exported from the
155162 `pandoc` module. They are assigned to the fields `List`, `mediabag`,
156163 `utils`, and `text`, respectively.
@@ -160,20 +167,20 @@ pandoc (2.7)
160167 + Split `StackInstances` into smaller Marshaling modules.
161168 + Get `CommonState` from Lua global. This allows more control over
162169 the common state from within Lua scripts.
163−
170+
164171 * LaTeX template:
165−
172+
166173 + Support the `subject` metadata variable (#5289, Pascal Wagler).
167174 + Add \frontmatter, \mainmatter, \backmatter for book classes (#5306).
168175
169176 * epub3 template: Add titlepage class to section (#5269).
170177
171− * HTML5 template: Add role with ARIA doc-toc for table of contents (#4213).
178+ * HTML5 template: Add ARIA role `doc-toc` for table of contents (#4213).
172179
173180 * Make --metadata-file use pandoc-markdown (#5279, #5272, Mauro Bieg).
174181
175182 * Text.Pandoc.Shared:
176−
183+
177184 + Remove `withTempDir` [API change].
178185 + Add new exported function `defaultUserDataDirs` [API change].
179186 + Add `filterIpynbOutput` [API change].
@@ -189,7 +196,7 @@ pandoc (2.7)
189196 + Add `all_symbols_escapable` to `githubMarkdownExtensions`.
190197
191198 * Text.Pandoc.PDF:
192−
199+
193200 + Use system temp directory when possible (#1192). Previously we
194201 created temp dirs in the working directory, partly (a) because
195202 there were problems using the system temp directory on Windows,
@@ -197,10 +204,10 @@ pandoc (2.7)
197204 programs like `epstopdf.pl` would not be allowed to write to
198205 directories outside the working directory in restricted mode. We
199206 now (a) use the system temp dir except when the path includes
200− tildes, and (b) set TEXMFOUTPUT when creating the PDF, so that
207+ tildes, and (b) set `TEXMFOUTPUT` when creating the PDF, so that
201208 subsidiary programs can use the system temp directory. This
202209 addresses problems that occurred when pandoc was used in a
203− synced directory.
210+ synced directory (such as Dropbox).
204211 + Change types of subsidiary functions to PandocIO, to allow
205212 warnings to be threaded through (#5343).
206213
@@ -212,7 +219,8 @@ pandoc (2.7)
212219
213220 * Added simple ipynb reader/writer tests (#5274).
214221
215− * Rearrange `--help` output in a more rational way (#5336).
222+ * Rearrange `--help` output in a more rational way, with common
223+ options at the beginning and options grouped by function (#5336).
216224
217225 * trypandoc: Add JATS and other missing formats (Arfon Smith, #5291).
218226
@@ -221,14 +229,15 @@ pandoc (2.7)
221229
222230 * Use latest basement/foundation on 32bit windows.
223231
224− * Use latest skylighting (#5328).
232+ * Use latest skylighting (#5328). Custom syntax definitions no
233+ longer try to load `language.dtd`.
225234
226235 * Require texmath 0.11.2.1
227236
228237 * Use latest pandoc-citeproc (0.16.1).
229−
238+
230239 * MANUAL.txt:
231−
240+
232241 + Clarify variable substitution indentation in templates (#5338,
233242 Agustín Martín Barbero).
234243 + Reorder custom-styles section (#5324, Mauro Bieg).