@@ -1,3 +1,318 @@
1+pandoc (2.7.3)
2+
3+ PROVISIONAL - NEEDS EDITING
4+
5+ * Roll back automatic figure/table numbering in ODT/OpenDocument
6+ (#5474). This was added in pandoc 2.7.2, but it makes it impossible
7+ to use pandoc-crossref. So this has been rolled back for now,
8+ until we find a good solution to make this behavior optional
9+ (or a creative way to let pandoc-crossref and this feature
10+ to coexist).
11+
12+ * LaTeX reader: pass through unknown listings language as class (#5540).
13+ Previously if the language was not in the list of languages supported
14+ by listings, it would not be added as a class, so highlighting
15+ would not be triggered.
16+
17+ * PDF via ms/pdfroff: make TOC appear at beginning and in PDF bookmarks
18+ (#5553). Previously the TOC appeared at the end of the document, and
19+ was not bookmarked. To keep it at the end, add
20+ `--pdf-engine-opt=--no-toc-relocation` to your command line.
21+
22+ * LaTeX writer: Include inline code attributes with `--listings` (#5420).
23+
24+ * Add jira writer (#2497, Albert Krewinkel). This adds support for Atlassian's
25+ jira markup.
26+
27+ * Fix typo in lua documentation (#5552).
28+
29+ * Include trailing `{}`s in raw latex commands (#5439).
30+ Change is in `rawLaTeXInline` in LaTeX reader, but it affects the markdown
31+ reader and other readers that allow raw LaTeX. Previously, trailing `{}`
32+ would be included for unknown commands, but not for known commands.
33+ However, they are sometimes used to avoid a trailing space after the
34+ command. The chances that a `{}` after a LaTeX command is not part of
35+ the command are very small.
36+
37+ * Docx reader: Add support for `w:rtl` (#5545). Elements with this
38+ property are put into Span inlines with `dir="rtl"`.
39+
40+ * Fix document section assignments in EPUB writer (#5546).
41+ For example, introduction should go in bodymatter, not frontmatter, and
42+ epigraph, conclusion, and afterward should go in bodymatter, not
43+ backmatter. For the full list of assignments, see the manual.
44+
45+ * Update pandoc-citeproc and skylighting versions.
46+
47+ * Markdown reader: don't create implicit reference for empty header (#5549).
48+
49+ * Markdown writer: Add backslashes to avoid unwanted interpretation of
50+ definition list terms as other kinds of block (#554).
51+
52+ * Textile writer: fix closing tag for math output (Albert Krewinkel).
53+ Opening and closing tag for math output match now.
54+
55+ * Add unicode code point in "Missing character" warning (#5538).
56+ If the character isn't in the console font, the message is pretty useless,
57+ so we show the code point for anything non-ASCII.
58+
59+ * pandoc.mediabag lua module (Albert Krewinkel):
60+
61+ + Add function `delete` for deleting a single item.
62+ + Add function `empty` for removing all entries.
63+ + Add function `items` for iterating over mediabag.
64+
65+ * HTML reader: epub related fixes.
66+
67+ + With epub extensions, check for `epub:type` in addition to `type`.
68+ + Fix problem with noteref parsing which caused block-level
69+ content to be eaten with the noteref.
70+ + Rename `pAnyTag` to `pAny`.
71+ + Refactor note resolution.
72+
73+ * Lua: add Version type to simplify comparisons (Albert Krewinkel).
74+ Version specifiers like `PANDOC_VERSION` and `PANDOC_API_VERSION` are
75+ turned into `Version` objects. The objects simplify version-appropriate
76+ comparisons while maintaining backward-compatibility.
77+ A function `pandoc.types.Version` is added as part of the newly
78+ introduced module `pandoc.types`, allowing users to create version
79+ objects in scripts.
80+
81+ * HTML writer: output video and audio elements depending on file
82+ extension of the image path (Mauro Bieg).
83+
84+ * Text.Pandoc.MIME: add `mediaCategory` [API change] (Mauro Bieg).
85+
86+ * HTML writer: emit empty alt tag in figures (#5518, Mauro Bieg).
87+ The same text is already in the <figcaption> and
88+ screen-readers would read it twice, see #4737.
89+
90+ * MANUAL: add note about `title-meta`, `author-meta`, `date-meta`
91+ (#5486).
92+
93+ * Fix handling of `file:` URL scheme in `downloadOrRead` (#5517, Mauro Bieg).
94+ Previously `file:/` URLs were handled wrongly and pandoc attempted
95+ to make HTTP requests, which failed.
96+
97+ * EPUB writer: don't include 'landmarks' if there aren't any.
98+ Previously we could get an empty ol element, which caused
99+ validation errors with epubcheck.
100+
101+ * Consolidate simple-table detection (#5524, Mauro Bieg).
102+ Add `onlySimpleTableCells` to `Text.Pandoc.Shared` [API change].
103+ This fixes an inconsistency in the HTML reader, which did not treat
104+ tables with `<p>` inside cells as simple.
105+
106+ * Muse reader: allow images inside link descriptions (Alexander Krotov).
107+
108+ * HTML reader: trim definition list terms (Alexander Krotov).
109+
110+ * Muse writer: do not escape empty line after `<br>` (Alexander Krotov).
111+
112+ * Disable missing-home-modules warning in `stack.yaml`.
113+ Otherwise `stack ghci` fails.
114+
115+ * Markdown writer: Ensure the code fence is long enough (#5519).
116+ Previously too few backticks were used when the code block
117+ contained an indented line of backticks. (Ditto tildes.)
118+
119+ * Makefile: remove `--resolver=` from targets.
120+ This causes unnecessary recompilation.
121+
122+ * Markdown writer: Handle labels with integer names (Jesse Rosenthal,
123+ #5495). Previously if labels had integer names, it could produce a
124+ conflict with auto-labeled reference links. Now we test for a conflict
125+ and find the next available integer. This involves adding a new state
126+ variable `stPrevRefs` to keep track of refs used in other document
127+ parts when using `--reference-location=block|section`
128+
129+ * Improve output of Lua tests (#5499, Albert Krewinkel).
130+ This makes use of tasty-lua, a package to write tests in Lua
131+ and integrate the results into Tasty output. Test output becomes
132+ more informative: individual tests and test groups become visible
133+ in test output. Failures are reported with helpful error messages.
134+
135+ * Add `tex_math_dollars` to `multimarkdownExtensions` (#5512).
136+ This form is now supported in multimarkdown,
137+ in addition to `tex_math_double_backslash`.
138+
139+ * JATS writer: properly handle footnotes (#5511).
140+ "Best Practice: When footnotes are grouped at the end of an article,
141+ wrap them in a `<fn-group>` and use an `<xref>` element in the text, as
142+ usual, to tie each footnote in the list to a particular location in the
143+ text."
144+
145+ * FB2 writer: do not wrap note references into `<sup>` and brackets
146+ (Alexander Krotov). Existing FB2 readers, such as FBReader, already
147+ display links with type="note" as a superscript.
148+
149+ * Fix using Beamer with geometry (#5505, Daniel Maslowski).
150+ Beamer already loads geometry, so we need to use the `\geometry`
151+ command to set geometry options.
152+
153+ * Org reader: fix planning elements in headers level 3 and higher
154+ (#5494, Albert Krewinkel). Planning info is now always placed before
155+ the subtree contents. Previously, the planning info was placed after
156+ the content if the header's subtree was converted to a list, which
157+ happens with headers of level 3 and higher per default.
158+
159+ * Org reader: omit, but warn about unknown export options (Albert
160+ Krewinkel). Unknown export options are properly ignored and omitted
161+ from the output.
162+
163+ * add test/tables.xwiki to git and pandoc.cabal (#5498, Mauro Bieg).
164+
165+ * Org writer: always indent src blocks content by 2 spaces (#5440, Albert
166+ Krewinkel). Emacs always uses two spaces when indenting the content of
167+ src blocks, e.g., when exiting a `C-c '` edit-buffer. Pandoc used to
168+ indent contents by the space-equivalent of one tab, but now always uses
169+ two spaces, too.
170+
171+ * FB2 reader: parse notes (#5493, Alexander Krotov).
172+
173+ * FB2 reader: use XML.Light.Input.parseXMLDoc to parse the root element
174+ (Alexander Krotov).
175+
176+ * Reduce the amount of state in FB2 reader (Alexander Krotov).
177+
178+ * FB2 reader: use Text.XML.Light.unqual where possible (Alexander Krotov).
179+
180+ * MANUAL.txt: removes double 'inside' (#5489, Christian Krause).
181+
182+ * Asciidoc writer: use `` `+...+` `` form for inline code.
183+ The old `` `a__b__c` `` yields emphasis inside code in asciidoc.
184+ To get a pure literal code span, use `` `+a__b__c+` ``.
185+
186+ * Asciidoc writer: use proper smart quotes with asciidoctor (#5487).
187+ Asciidoctor has a different format for smart quotes.
188+
189+ * LaTeX writer: don't produce columns environment unless beamer (#5485).
190+ The environment is beamer-only and as far as I'm aware there's no latex
191+ package that provides it for non-beamer use.
192+
193+ * Org reader: prefer plain symbols over math symbols (#5483, Albert
194+ Krewinkel). Symbols like `\alpha` are output plain and unemphasized,
195+ not as math.
196+
197+ * Org reader: recognize emphasis after TODO/DONE keyword (#5484,
198+ Albert Krewinkel).
199+
200+ * HTML writer: don't add variation selector if it's already there.
201+ This fixes round-trip failures.
202+
203+ * Add template variable `curdir` with working directory
204+ from which pandoc is run (#5464).
205+
206+ * FB2 writer: use genre metadata field (#5478).
207+
208+ * JATS writer: fix citations with PMID so they validate (#5481).
209+ This includes an update to data/jats.csl.
210+
211+ * metaToJSON: treat digits starting with 0 as a string, not a number
212+ (#5479).
213+
214+ * EPUB2/3 templates: Move inline styles to default epub.css (#5466).
215+ Those who use a custom CSS stylesheet with EPUB should
216+ add these lines:
217+ ```css
218+ code{ white-space: pre-wrap; }
219+ span.smallcaps{ font-variant: small-caps; }
220+ span.underline{ text-decoration: underline; }
221+ q { quotes: "“" "”" "‘" "’"; }
222+ div.column{ display: inline-block; vertical-align: top; width: 50%; }
223+ ```
224+
225+ * Epub3 stylesheet link compatible with kindlegen (#5466,
226+ Eric Schrijver). Pandoc omitted `type="text/css"` from both `<style>`
227+ and `<rel="stylesheet">` elements in all templates, which is
228+ valid according to the spec. However, Amazon’s kindlegen software
229+ relies on this attribute on `<link>` elements when detecting
230+ stylesheets to include.
231+
232+ * Lua: add `pandoc.system` module (#5468, Albert Krewinkel).
233+ The `system` Lua module provides utility functions to interact with the
234+ operating- and file system. E.g.
235+ `print(pandoc.system.get_current_directory())`
236+ or
237+ ```lua
238+ pandoc.system.with_temporary_directory('tikz', function (dir)
239+ -- write and compile a TikZ file with pdflatex
240+ end)
241+ ```
242+
243+ * LaTeX reader: Allow newlines in `\mintinline`.
244+
245+ * MediaWiki reader: handle multiple attributes in table row (#5471,
246+ chinapedia).
247+
248+ * Fix broken links in documents (#5473, Shim Myeongseob).
249+ Fix broken links in doc/epub.md, doc/getting-started.md,
250+ doc/customizing-pandoc.md, doc/using-the-pandoc-api.md.
251+ Also, use absolute links to pandoc.org when possible, so that
252+ the links can be followed by people viewing these documents
253+ on GitHub.
254+
255+ * LaTeX writer: Fix footnote in image caption. Regression:
256+ the fix for #4683 broke this case.
257+
258+ * reveal.js template: remove reference to head.min.js (#5448,
259+ Winnie Hellmann).
260+ This file has been removed in 3.8.0.
261+ NOTE: users will need to update reveal.js to at least 3.8.0
262+ for their presentations generated with this version of pandoc
263+ to work correctly.
264+
265+ * HTML writer: prevent gratuitious emojification on iOS (#5469).
266+ iOS chooses to render a number of Unicode entities,
267+ including '↩', as big colorful emoji. This can be defeated by appending
268+ Unicode VARIATION SELECTOR-15'/'VARIATION SELECTOR-16'. So we now append
269+ this character when escaping strings, for both '↩' and '↔'. If other
270+ characters prove problematic, they can simply be added to
271+ `needsVariationSelector`.
272+
273+ * Fix `--self-contained` so it works when output format has extensions.
274+ Previously if you used `--self-contained` with `html-smart` or
275+ `html+smart`, it wouldn't work.
276+
277+ * Allow use of `-output-directory` in `--pdf-engine-opt` (#5462).
278+ This is currently possible with `mklatex` and `-outdir`, but
279+ was not yet possible with xelatex and `-output-directory`.
280+
281+ * EPUB writer: Ensure unique ids for styleesheets in content.opf (#5463).
282+
283+ * HTML writer: Add `class="heading"` to level 7+ Headers
284+ rendered as `<p>` elements (#5457).
285+
286+ * Text.Pandoc.PDF: replace `</>` with literal `/` (#5451).
287+ We use forward-slash for a directory separator in tmpDir,
288+ even on Windows (because that's what tex likes). So we
289+ should not put a backslash between the tmpDir and the
290+ filename on Windows. This is harmless enough in normal
291+ Windows setups, but it breaks on Cygwin.
292+ Thanks to @cc2x for noticing and diagnosing the problem.
293+
294+ * Improved sample lua tikz filter in lua-filters docs (#5445,
295+ Matthew Doty). There are three changes:
296+
297+ + It only processes elements which begin with `\begin{tikzpicture}`
298+ + It uses pdf2svg instead of imagemagick to preserve fidelity
299+ + The images produced have transparent backgrounds
300+
301+ * RST writer: treat Span with no attributes as transparent (#5446).
302+ Previously an Emph inside a Span was being treated as
303+ nested markup and ignored. With this patch, the Span
304+ is just ignored.
305+
306+ * LaTeX template: Add pdflang to hypersetup if lang is set (#5443).
307+
308+ * LaTeX reader: add braces when resolving `\DeclareMathOperator`
309+ (#5441). These seem to be needed for xelatex but not pdflatex.
310+
311+ * reveal.js template: updates for revealjs 3.8.0 (#5435, ebiim).
312+
313+ * Asciify.hs: add Turkish undotted-i (#5433, Mauro Bieg).
314+
315+
1316pandoc (2.7.2)
2317
3318 * Add XWiki writer (#1800, Derek Chen-Becker).