@@ -1,5 +1,374 @@
11# Revision history for pandoc
22
3+## pandoc 2.10 (YYYY-MM-DD)
4+
5+ * Use pandoc-types 1.21. This adds two things:
6+
7+ + A native Underline constructor for Inline (#6277, Vaibhav Sagar).
8+ + More expressive types for tables (#1024, Christian Despres).
9+ Tables can now take attributes; and rowspans and colspans,
10+ column headers, multiple row headers, table head and foot
11+ can all be represented. (Note, however, that reader and
12+ writer support for these features is still lacking, so
13+ most users won't see any differences in table conversion
14+ yet. These changes just lay the foundation for further
15+ improvements.)
16+
17+ * Support new Underline element in readers and writers (#6277,
18+ Vaibhav Sagar).
19+
20+ * Support new Table type (Christian Despres).
21+ The Builder.simpleTable now only adds a row to the TableHead
22+ when the given header row is not null. This uncovered an
23+ inconsistency in the readers: some would unconditionally
24+ emit a header filled with empty cells, even if the header
25+ was not present. Now every reader has the conditional
26+ behaviour. Only the XWiki writer depended on the header row
27+ being always present; it now pads its head as necessary.
28+
29+ * Add an option to disable certificate validation (#6156, Cédric Couralet,
30+ Cécile Chemin, Juliette Fourcot). This commit adds the option
31+ `--no-check-certificate`, which disables certificate checking when
32+ resources are fetched by HTTP.
33+
34+ * Docbook reader:
35+
36+ + Implement `<procedure>` (#6442, Mathieu Boespflug).
37+ + Implement `<phrase>` (#6438, Mathieu Boespflug).
38+ + Treat envar and systemitem like code (#6435, Mathieu Boespflug).
39+ + Implement `<replaceable>` (#6437, Mathieu Boespflug)
40+ + Map `<simplesect>` to unnumbered section (#6436, Mathieu Boespflug).
41+
42+ * JATS reader: handle "label" element in section title (#6288).
43+
44+ * Jira reader (Albert Krewinkel):
45+
46+ + Resolve multiple parsing problems, including issues with empty
47+ table cells, faulty recognition of closing emphasis characters, and
48+ parsing of image attributes (#6212, #6219, #6220).
49+ + Require jira-wiki-markup 1.3.1 or later.
50+ This solves the following problems: Two consecutive markup
51+ chars are now parsed verbatim (#6343); styled text must
52+ not be empty. Styled text may not contain newlines
53+ (#6325). Links to anchors are now parsed as links
54+ (#6407).
55+ + Retain image attributes (#6234). Jira images attributes as in
56+ `!image.jpg|align=right!` are retained as key-value pairs. Thumbnail
57+ images, such as `!example.gif|thumbnail!`, are marked by a
58+ `thumbnail` class in their attributes.
59+ + Read `(?)` icon as "small questionmark" character (#6236).
60+ + Use Underline for inserted text (#6237). Previously, the
61+ span was marked with the non-standard class `inserted`.
62+ Closes: #6237
63+ + Improve icon conversion for `(/)`, `(x)`, `(!)`,
64+ `(+)`, `(-)`, `(off)`, `(*)`. (#6264).
65+ + Support citations, attachment links, and user links (#6231, #6238,
66+ #6239).
67+ + Resolve parsing issues of blockquote, color (#6233, #6235).
68+
69+ * HTML reader:
70+
71+ + Parse attributes into table attributes.
72+ + Support `<bdo>` (#5794, Tristan de Cacqueray).
73+ + Add `summary` to list of block-level HTML tags (#6385).
74+ This improves support for summary/details inside Markdown.
75+ NOTE: you need to include a blank line before the closing
76+ `</details>`, if you want the last part of the content to
77+ be parsed as a paragraph.
78+ + Fix parsing unclosed th elements in a table (#6247).
79+
80+ * Commonmark reader: Implement `implicit_figures` extension (#6350).
81+
82+ * Markdown Reader:
83+
84+ + Fix inline code in lists (#6284, Nikolay Yakimov).
85+ Previously inline code containing list markers was sometimes
86+ parsed incorrectly.
87+
88+ * LaTeX reader:
89+
90+ + Don't parse beyond `\end{document}` (#6380).
91+ This required some internal changes to `\subfile` handling.
92+ + Better handling of `\lettrine`. SmallCaps instead of Span
93+ for the part after the initial capital. Ensure that both
94+ arguments are parsed, so that in Markdown both
95+ are treated as raw LateX. (Closes #6258.)
96+ + Don't put surrounding Div around Table.
97+ This reverts a change in the last release; the Div is
98+ no longer needed, because we can now put the id right in
99+ the Table's attributes. However, writers may still need
100+ to be modified to do something with the id in a Table
101+ (e.g. create an anchor), so in the short term we may lose
102+ the ability to link to tables in some writers.
103+
104+ * Org reader (Albert Krewinkel):
105+
106+ + Recognize images with uppercase extensions (#6472).
107+
108+ * RST reader:
109+
110+ + Pass arbitrary attributes through in code blocks (#6465).
111+ Exceptions: name (which becomes the id), class (which becomes the
112+ classes), and number-lines (which is treated specially to fit
113+ with pandoc highlighting).
114+ + Handle `date::` directive (#6276).
115+
116+ * Textile reader: support `pre.` for code blocks (#6454).
117+
118+ * Ipynb reader:
119+
120+ + Handle application/pdf output as image (#6430).
121+ + Properly handle image/svg+xml as an image (#6430).
122+
123+ * Docx reader:
124+
125+ + Distinguish between docx parsing and docx container unpacking errors.
126+
127+ * MediaWiki reader:
128+
129+ + Fix `gfm_auto_identifiers` so that `-` is not replaced by `_` (#6335).
130+
131+ * Vimwiki reader:
132+
133+ + Add nested syntax highlighting (#6256, Vlad Hanciuta).
134+ Nested syntaxes are specified like this:
135+ ```
136+ {{{sql
137+ SELECT * FROM table
138+ }}}
139+ ```
140+ The preformatted code block parser has been extended to check if the
141+ first attribute of the block is not a `key=value` pair, and in that
142+ case it will be considered as a class.
143+
144+
145+ * Jira writer (Albert Krewinkel):
146+
147+ + Always escape braces (#6478). Braces are now always escaped, even
148+ within words or when surrounded by whitespace. Jira and
149+ Confluence treat braces specially.
150+ + Convert Underline to inserted text (`+inserted+`).
151+ + Add image attributes (#6234). Image attributes are added
152+ to the output as image parameters. If the image has a
153+ class "thumbnail", then a thumbnail image is generated;
154+ all other attributes are discarded in this case.
155+
156+ * LaTeX writer:
157+
158+ + Ensure that `-M csquotes` works even in fragment mode (#6265).
159+ + Escape `^` specially for listings (#6460).
160+ + Create hypertarget for links with identifier (#6360).
161+ + Distinguish between single and double quotes when using enquote
162+ package (#6457, dbecher-ito).
163+ + Add support for customizable alignment of columns in beamer (#6331,
164+ andrebauer).
165+ + Add support for customizable alignment of columns in beamer
166+ (#4805, #4150, andrebauer).
167+
168+ * HTML writer:
169+
170+ + Use CSS in favor of `<br>` for display math (#6372)
171+ Some CSS to ensure that display math is
172+ displayed centered and on a new line is now included
173+ in the default HTML-based templates; this may be
174+ overridden if the user wants a different behavior.
175+
176+ * Org writer:
177+
178+ + Clean-up Div handling (Albert Krewinkel).
179+
180+ * Docx writer:
181+
182+ + Enable column and row bands for tables (#6371).
183+ This change will not have any effect with the default style.
184+ However, it enables users to use a style (via a reference.docx)
185+ that turns on row and/or column bands.
186+
187+ * OpenDocument (and ODT) writer:
188+
189+ + Add custom-style "Abstract" in metadata abstract.
190+ This ensures that the abstract is rendered with style Abstract.
191+ + Enable custom-style attribute on a Div.
192+ This allows you to apply a custom style to contained paragraphs.
193+
194+ * DocBook writer:
195+
196+ + Add id of figure to enclosed image.
197+ + Add personname element to docbook author (#6244).
198+
199+ * FB2 writer:
200+
201+ + Properly handle cover-image containing spaces (#6391).
202+
203+ * Markdown writer:
204+
205+ + Ensure consistent padding for pipe tables (#6240).
206+ + Avoid unnecessary escapes before intraword `_` when
207+ `intraword_underscores` extension is enabled (#6296).
208+
209+ * RST writer:
210+
211+ + Properly handle images with same alt text (#6194).
212+ Previously we created duplicate references for these in rendering RST.
213+
214+ * AsciiDoc writer:
215+
216+ + Add blank line after Div (#6308).
217+
218+ * Haddock Writer:
219+
220+ + Support Haddock tables (Joe Hermaszewski).
221+ See this PR on Haddock for details on the table format:
222+ <https://github.com/haskell/haddock/pull/718>.
223+
224+ * PowerPoint writer (Jesse Rosenthal):
225+
226+ + Write math input verbatim in speaker notes (#6301).
227+ OMML in speaker notes would lead to corrupt PowerPoint output. We now
228+ output the OMML verbatim as LaTeX in the speaker notes.
229+
230+ * LaTeX template: Make polyglossia package options list-aware
231+ (#6444, Frederik Elwert).
232+
233+ * Reveal.js template:
234+
235+ + Update template for reveal.js 4.0.0 (#6390, Salim B).
236+ + Update template with newly available options (#6347, Jake Zimmerman).
237+ + Use CDN version of revealjs v4 by default (#6408).
238+
239+ * opendocument template: Add abstract and subtitle to opendocument
240+ template (#6369).
241+
242+ * reference.odt: clean up styles. Add Abstract.
243+ Change Author, Date to centered paragraphs with no character
244+ styling.
245+
246+ * epub.css: wrap overlong lines in highlighted code blocks (#6242).
247+ This fixes a problem in iBooks v2.4 with our earlier
248+ horizontally scrolling code blocks. The problem seems to
249+ be a bug in iBooks, not pandoc, but since iBooks is a major
250+ target we're changing pandoc's default behavior so that
251+ pandoc-produced epubs work on that platform.
252+
253+ * Text.Pandoc.PDF:
254+
255+ + Use `--enable-local-file-access` in invoking `wkhtmltopdf` (#6474).
256+ `wkhtmltopdf` changed in recent versions to require this for
257+ access to local files. This fixes PDF via HTML5 with `--css`.
258+
259+ * Text.Pandoc.MIME: Fix MIME type for TrueType fonts in EPUBs
260+ (#6464, Michael Reed).
261+
262+ * Text.Pandoc.Shared:
263+
264+ + `makeSections`: omit number attribute when unnumbered class
265+ is present (#6339). Previously the attribute was included but given
266+ an empty value, and this caused the table of contents creation
267+ functions in Text.Pandoc.Writers.Shared to think these items had
268+ numbers, which meant that they were included in the TOC even if the
269+ `unlisted` class was used.
270+ + Deprecate `underlineSpan` in Shared in favor of
271+ `Text.Pandoc.Builder.underline` (Vaibhav Sagar).
272+ + `renderTags'`: use self-closing tag for col element (#6295).
273+
274+ * Text.Pandoc.UUID: Fix `getRandomUUID`, which previously would
275+ return the same value twice in a row. Make `getRandomUUID`
276+ polymorphic in PandocMonad. Remove `getUUID` (#6228, Joseph C. Sible).
277+
278+ * Text.Pandoc.Class: Generalize `PandocIO` functions to `MonadIO`.
279+
280+ * Fixed Katex standalone script (#6399, Lucas Escot).
281+ Global macros are now persistent when using the HTML Writer with the
282+ `--katex` option.
283+
284+ * Lua subsystem (Albert Krewinkel):
285+
286+ + Fix regression in package searcher (#6361).
287+ This caused `require 'module'` to fail for third party packages.
288+ + Use new type PandocLua for all pandoc Lua operations (API change).
289+ The new type `PandocLua` is an instance of the `PandocMonad` typeclass
290+ and can thus be used in a way similar to `PandocIO`.
291+ + Use PandocError for exceptions in Lua subsystem (API change).
292+ The PandocError type is used throughout the Lua subsystem. All Lua
293+ functions throw an exception of this type if an error occurs. The
294+ `LuaException` type is removed and no longer exported from
295+ `Text.Pandoc.Lua`. In its place, a new constructor `PandocLuaError`
296+ is added to PandocError.
297+
298+ * Lua filters: improve error messages for failing filters (#6332,
299+ Albert Krewinkel). Print the Lua error properly instead of
300+ displaying their `show` string.
301+
302+ * Use latest skylighting. This fixes a bug with lua multiline
303+ comments (and may improve handling of other syntaxes as well).
304+ IT also adds `aria-hidden="true"` to the empty a elements, which
305+ helps people who use screen readers.
306+
307+ * Use latest texmath.
308+
309+ * Require latest doctemplates 0.8.2.
310+ This adds support for template pipes `first`, `rest`,
311+ `last`, `allbutlast`.
312+
313+ * Revert 0e48a02 and dependency on base-noprelude, which hasn't
314+ been updated for ghc 8.10 (see #6187).
315+
316+ * Dependency adjustments:
317+
318+ + Allow haddock-library 1.9.x.
319+ + Allow hslua 1.1 (#6243, Felix Yan).
320+ + Allow base64-bytestring 1.1.
321+ + Use latest jira-wiki-markup.
322+ + Allow http-client 0.7.
323+ + Allow tasty 1.3.x.
324+ + Allow aeson 1.5 (#6400, Felix Yan).
325+ + Remove unused dependency `vector` (#6462, Laurent P. René de Cotret).
326+ + Bump QuickCheck upper bound.
327+
328+ * Significant code cleanup and simplification (Joseph C. Sible, #6223,
329+ #6209, #6225, #6229, #6226, #6340).
330+
331+ * Remove unnecessary hlint ignores (#6341, Joseph C. Sible).
332+
333+ * trypandoc improvements (Mike Tzou):
334+
335+ + Add standalone option to the command text (#6210).
336+ + Update third party libraries.
337+
338+ * MANUAL.txt:
339+
340+ + Clarify template partial naming (#6476, Mauro Bieg).
341+ + Describe `jira` as "Jira/Confluence wiki markup" (#6351, Albert
342+ Krewinkel). In the past, Jira's wiki markup was also used by -- and
343+ could be imported into -- Atlassian Confluence.
344+ + Add link to print-css.rocks (#6272, Mauro Bieg).
345+ + Clarify pipe table column width adjustment (#6254).
346+ + Fix ATX header syntax.
347+ + Fix misleading note about image size conversions (#6353).
348+ + Update links to reveal.js documentation (#6386, Salim B).
349+ + Separate adjacent verbatim code blocks (#6307, tom-audm).
350+
351+ * lua-filters.md:
352+
353+ + Fix description of BulletList Lua type (Levi Gruspe).
354+ + Use pandoc.system module in TikZ example (Albert
355+ Krewinkel). Showcase temporary directory handling with
356+ `with_temporary_directory` and `with_working_directory`.
357+
358+ * INSTALL.md: fix FreeBSD port link (#6422, Mo).
359+ The FreeBSD port was renamed from pandoc to hs-pandoc in 2010.
360+ The old pandoc port is still at version 1.5.1.1
361+
362+ * Propagate `(DY)LD_LIBRARY_PATH` in tests (#6376, Lila).
363+
364+ * Bump `cabal-version` to 2.2 (#6377).
365+
366+ * Make it possible to compile using Stack on NixOS (#6439, Mathieu
367+ Boespflug).
368+
369+ * CI action to check for commit messsage length (Nikolay Yakimov, #6398).
370+
371+
3372## pandoc 2.9.2.1 (2020-03-23)
4373
5374 * Markdown reader: Fix table alignment when heading begins with t (#6153).