@@ -1,5 +1,209 @@
11# Revision history for pandoc
22
3+## pandoc 2.9.2 (2020-02-15)
4+
5+ * Add `csv` as an input format (#6100). The CSV table is converted into a
6+ pandoc simple table. A new module Text.Pandoc.Readers.CSV
7+ exports `readCSV` [API change].
8+
9+ * Introduce new format variants for JATS writer (#6014, Albert Krewinkel):
10+
11+ - `jats_archiving` for the "Archiving and Interchange Tag Set",
12+ - `jats_publishing` for the "Journal Publishing Tag Set", and
13+ - `jats_articleauthoring` for the "Article Authoring Tag Set."
14+
15+ The `jats` output format is now an alias for `jats_archiving`.
16+ The module Text.Pandoc.Writers.JATS now exports
17+ `writeJatsArchiving`, `writeJatsPublishing`, and
18+ `writeJatsArticleAuthoring`, as well as the legacy
19+ `writeJATS` [API change].
20+
21+ * `--defaults`: Support `bibliography` and `csl` fields.
22+ Move `addMeta` from Text.Pandoc.App.CommandLineOptions to
23+ Text.Pandoc.App.Opt (internal change).
24+
25+ * Add timing info for filters in `--verbose` mode (#6112).
26+ When verbose mode is specified (verbosity == INFO), print a
27+ notice when running a filter and when a filter completes (including
28+ timing).
29+
30+ * LaTeX reader:
31+
32+ + Allow `&` in LaTeX citation keys (#6110).
33+ + Improve caption and label parsing.
34+ + Don't emit empty Span elements for labels.
35+ + Put tables with labels in a surrounding Div.
36+ + Resolve `\ref` to table numbers (#6137).
37+ + Skip comments in more places where this is needed (#6114).
38+ + Allow beamer overlays for all commands in all raw tex (#6043).
39+ This affects parsing of raw tex in LaTeX and in Markdown and
40+ other formats.
41+ + Improve parsing of raw environments (#6034). If parsing fails
42+ in a raw environment (e.g. due to special characters like unescaped
43+ `_`), try again as a verbatim environment, which is less sensitive to
44+ special characters. This allows us to capture special environments
45+ that change catcodes as raw tex when `-f latex+raw_tex` is used.
46+
47+ * RST reader:
48+
49+ + Add highlight directive (#6140, Lucas Escot).
50+
51+ * MediaWiki writer:
52+
53+ + Prevent triple `[[[` which confuses MediaWiki (#6119).
54+
55+ * HTML reader:
56+
57+ + Don't parse `data-id` as `id` attribute. And similarly don't
58+ parse any `data-X` as `X` when `X` is a valid HTML attribute.
59+
60+ * Org reader:
61+
62+ + Simplify parsing of sub- and superscripts (#6127, Albert Krewinkel).
63+ Speeds up parsing of single-word, markup-less sub- and superscripts.
64+
65+ * LaTeX writer:
66+
67+ + Group biblatex citations even with prefix and suffix (#5849, Ethan
68+ Riley). Previously biblatex citations were only grouped if there
69+ was no prefix. This patch allows them to be grouped in subgroups split
70+ by prefixes and suffixes, which allows better citation sorting.
71+ + Fix regression in handling of columns in beamer slides (#6033).
72+ Columns in title slides were causing problems with
73+ slide division.
74+ + Fix duplicate frame classes in LaTeX/Beamer output (#6107).
75+
76+ * HTML writer:
77+
78+ + Fix duplicate attributes on headings (#6062), regression from 2.7.x.
79+ + Fix `--number-offset` with HTML TOC. Eventually it would be worth
80+ adding a parameter to `makeSections` so this could be done at that
81+ level; then it would also affect other writers that construct
82+ TOC manually.
83+ + reveal.js: restore old behavior for 2D nesting (#6032).
84+ The fix to #6030 actually changed behavior, so that the
85+ 2D nesting occurred at slide level N-1 and N, instead of
86+ at the top-level section. This commit restores the v2.7.3 behavior.
87+ If there are more than 2 levels, the top level is horizontal
88+ and the rest are collapsed to vertical.
89+ + reveal.js: ensure that pauses work even in title slides (#5819).
90+
91+ * Markdown writer:
92+
93+ + Fix regression: spurious dots in markdown_mmd metadata output (#6133).
94+
95+ * Docx writer:
96+
97+ + Fix regression with Compact style on tight lists (#6072).
98+ Starting in 2.8, the docx writer no longer distinguishes between tight
99+ and loose lists, since the Compact style is omitted. This is a
100+ side-effect of the fix to #5670, as explained in the changelog. This
101+ patch fixes the problem by extending the exception currently offered to
102+ Plain blocks inside tables to Plain blocks inside list items.
103+
104+ * Jira writer:
105+
106+ + Fix output of table headers (Albert Krewinkel, #6035).
107+
108+ * Add Text.Pandoc.Image with unexported svgToPng.
109+
110+ * Moved html5Attributes, html4Attributes, rdfaAttributes
111+ from T.P.Writers.HTML (where they were unexported) to
112+ T.P.XML (where they are now exported).
113+ [API change: new exported functions]
114+ This allows these sets to be used elsewhere, e.g.
115+ in the HTML reader.
116+
117+ * Text.Pandoc.Shared: Export a new function `findM` (#6125,
118+ Joseph C. Sible).
119+
120+ * Text.Pandoc.Logging: Add `RunningFilter`, `FilterCompleted`
121+ constructors to LogMessage [API change].
122+
123+ * Text.Pandoc.CSV: fix bug in CSV parser; previously an extra blank record
124+ would sometimes be inserted at the end.
125+
126+ * LaTeX template: add space option to xeCJK with PassOptionsToPackage
127+ (#6002). Otherwise we can get a clash with documentclasses that
128+ already load the package.
129+
130+ * Lua filters:
131+
132+ + Allow filtering of element lists (#6038, Albert Krewinkel). Lists of
133+ Inline and Block elements can now be filtered via `Inlines` and
134+ `Blocks` functions, respectively. This is helpful if a filter
135+ conversion depends on the order of elements rather than a single
136+ element. For example, the following filter can be used to remove all
137+ spaces before a citation:
138+
139+ function isSpaceBeforeCite (spc, cite)
140+ return spc and spc.t == 'Space'
141+ and cite and cite.t == 'Cite'
142+ end
143+
144+ function Inlines (inlines)
145+ for i = #inlines-1,1,-1 do
146+ if isSpaceBeforeCite(inlines[i], inlines[i+1]) then
147+ inlines:remove(i)
148+ end
149+ end
150+ return inlines
151+ end
152+
153+ + Add methods `insert`, `remove`, and `sort` to pandoc.List
154+ (Albert Krewinkel). Example of use:
155+
156+ local numbers = pandoc.List {2, 3, 1}
157+ numbers:sort() -- numbers is now {1, 2, 3}
158+ + Make `pandoc.List` a callable constructor (Albert Krewinkel).
159+ It is now possible to construct a new List via
160+ `pandoc.List()` instead of `pandoc.List:new()`.
161+ + Add tests for pandoc.List module (Albert Krewinkel).
162+
163+ * Text.Pandoc.App.CommandLineOptions: Change `setVariable` to use `Text`
164+ instead of `String`. This avoids some unnecessary unpacking.
165+
166+ * Use versioned directory for windows release zipfile.
167+ Also remove old `make-windows-installer.bat`, superseded by GitHub
168+ actions workflow, and modify `pandoc.wxs` for new paths.
169+
170+ * Extensive code cleanup (#6141, #6128, #6129, #6130, #6123,
171+ #6105, 6102, #6117, #6124, #6115, #6116, #6111, Joseph C. Sible).
172+
173+ * Fix hlint warnings (Albert Krewinkel).
174+
175+ * Use latest doclayout, doctemplates (#6031). The new version of
176+ doclayout fixes a memory leak that affected `--include-in-header` with
177+ large files (and possibly other cases involving extremely long lines).
178+
179+ * Use latest texmath.
180+
181+ * Use latest skylighting and fix test suite (#6086).
182+
183+ * sample.lua: Fix typo in descriptive comments (#6136, Caleb Maclennan).
184+ Fix typo in error message (#6135).
185+
186+ * Add Docker and GH Actions instructions/links to INSTALL.md.
187+
188+ * Update filter documentation (#6065). Improve cabal v2 instructions.
189+ Remove example using pandoc API directly (we have other
190+ docs for that and it was outdated).
191+
192+ * Lua filter docs:
193+
194+ + Cross-link constructors and types (Albert Krewinkel).
195+ Thanks to @bpj for the idea.
196+ + Sort pandoc.List methods alphabetically (Albert Krewinkel).
197+ + Unify, fix anchors and internal links (#6061, Albert Krewinkel).
198+ Links and anchors now follow consistent conventions, like
199+ lowercase-only anchor names. This breaks some links to specific
200+ sections in the document, but will make it much easier to link
201+ documentation in the future.
202+ + Clarify filter function execution order (#6059, Albert Krewinkel).
203+
204+ * In docs, update URLs and use `https:` wherever possible (#6090,
205+ Salim B).
206+
3207## pandoc 2.9.1.1 (2020-01-05)
4208
5209 * Markdown reader: