@@ -1,5 +1,164 @@
11# Revision history for pandoc
22
3+## pandoc 2.10.1 (2020-07-23)
4+
5+ * Add `commonmark_x` output format. This is `commonmark` with a number
6+ of useful pandoc extensions enabled.
7+
8+ * Many more extensions now work with `commonmark` and `gfm`.
9+
10+ * Add generic `attributes` extension. This allows attributes to
11+ be added to any block or inline element in a uniform way. Since
12+ the Pandoc AST doesn't include attributes on each element type,
13+ the attributes will sometimes be added by creating a surrounding
14+ Div or Span container. Currently this extension is only
15+ compatible with the `commonmark` and `gfm` readers.
16+
17+ To add an attribute to a block-level element, e.g. a paragraph,
18+ put it before the block:
19+ ```
20+ {#mypara}
21+ This is a paragraph.
22+ ```
23+ Multiple attributes may be used and will be combined:
24+ ```
25+ {#mypara}
26+ {.blue .warning key="val"}
27+ This is a paragraph.
28+ ```
29+ To add an attribute to an inline-level element, put it
30+ immediately after the element:
31+ ```
32+ *emphasized text*{.special}
33+ ```
34+
35+ * Support `--number-sections` for docx output (#1413).
36+
37+ * LaTeX reader:
38+
39+ + Support `\SIRange` reader (#6418, Emerson Harkin).
40+ + Support table col-span and row-span (#6311, Laurent P. René de Cotret).
41+ Supports `\multirow` and `\multicolumn`.
42+ + Support amsthm: `\newtheorem`, `\theoremstyle`, and theorem and
43+ proof environments, including labels and references. The only thing
44+ that is unsupported is the second optional argument, which causes
45+ numbering to be reset after the specified series is incremented.
46+ + Moved some code to T.P.LaTeX.Parsing. We need to reduce the size
47+ of the LaTeX reader to ease compilation on resource-limited systems.
48+
49+ * RST reader:
50+
51+ + Fix csv tables with multiline cells (#6549).
52+ + Fix spurious newlines in some attributes from directives.
53+ + Avoid extra newline in included code blocks.
54+
55+ * Commonmark reader:
56+
57+ + Switch from cmark-gfm to commonmark-hs for commonmark and gfm
58+ parsing. This avoids depending on a C library
59+ and allows us to support more pandoc extensions for
60+ `commonmark` and `gfm`.
61+
62+ * DocBook reader:
63+
64+ + Parse releaseinfo as metadata (#6542).
65+
66+ * Docx reader:
67+
68+ + Only use `bCs/iCs` on runs with `rtl` or `cs` property (#6514, Nikolay
69+ Yakimov).
70+ + Code cleanup/refactoring (Nikolay Yakimov).
71+
72+ * Org reader (Albert Krewinkel):
73+
74+ + Respect export setting which disables entities
75+ MathML-like entities, e.g., `\alpha`, can be disabled with the
76+ `#+OPTION: e:nil` export setting (Albert Krewinkel).
77+ + Respect export setting disabling footnotes. Footnotes can be removed
78+ from the final document with the `#+OPTION: f:nil` export setting.
79+ + Respect tables-excluding export setting. Tables can be removed from
80+ the final document with the `#+OPTION: |:nil` export setting.
81+
82+ * Markdown writer:
83+
84+ + Move `asciify` out of `escapeString`. Otherwise `unsmartify`
85+ doesn't catch quotes that have already been turned to entities.
86+ + Add `writeCommonmark` (new exported function, API change).
87+ + Use unicode super/subscript characters when possible if the
88+ `superscript` or `subscript` extension or `raw_html` aren't available.
89+ + Render caption as following paragraph when `table_caption` extension
90+ is not enabled.
91+
92+ * Commonmark writer:
93+
94+ + Instead of using cmark-gfm, use `writeCommonmark` from the
95+ Markdown writer. This function calls the markdown writer
96+ with appropriate extensions and a few small modifications
97+ (e.g. not requiring backslashes before spaces inside
98+ super/subscripts). With this change `comonmark` and
99+ `gfm` output can be used with a wider selection of
100+ extensions.
101+
102+ * Jira writer: keep image caption as alt attribute (#6529, Albert
103+ Krewinkel).
104+
105+ * HTML writer:
106+
107+ + Improve alt-text/caption handling for HTML5 (#6491, Albert Krewinkel).
108+ Screen readers read an image's `alt` attribute and the figure caption,
109+ both of which come from the same source in pandoc. The figure caption is
110+ hidden from screen readers with the `aria-hidden` attribute. This
111+ improves accessibility. For HTML4, where `aria-hidden` is not allowed,
112+ pandoc still uses an empty `alt` attribute to avoid duplicate contents.
113+
114+ * Ms writer:
115+
116+ + Fix code highlighting with blank lines. Previously blank lines
117+ were simply omitted from highligted code.
118+ + Escape starting periods in ms writer code blocks (#6505, Michael
119+ Hoffmann). If a line of ms code block output starts with a period (.),
120+ it should be prepended by `\&` so that it is not interpreted as a roff
121+ command.
122+
123+ * Text.Pandoc.Extensions:
124+
125+ + Trim down `githubMarkdownExtensions`.
126+ Previously it included all of the following, which make
127+ sense for the legacy `markdown_github` but not for `gfm`,
128+ since they are part of base commonmark and thus
129+ can't be turned off in `gfm`:
130+
131+ - `Ext_all_symbols_escapable`
132+ - `Ext_backtick_code_blocks`
133+ - `Ext_fenced_code_blocks`
134+ - `Ext_space_in_atx_header`
135+ - `Ext_intraword_underscores`
136+ - `Ext_lists_without_preceding_blankline`
137+ - `Ext_shortcut_reference_links`
138+
139+ These have been removed from `githubMarkdownExtensions`, though
140+ they're still turned on for legacy `markdown_github`.
141+
142+ + Add `Ext_attributes` constructor for `Extension` [API change].
143+
144+ * LaTeX template: use selnolig to selectively suppress ligatures with
145+ lualatex (#6534).
146+
147+ * Benchmark bytestring readers (Nikolay Yakimov).
148+
149+ * Documentation:
150+
151+ + Update using-the-pandoc-api.md (favonia).
152+ + Fix Typos in lua-filters.md (tajmone).
153+ + Rewrite Raw HTML/TeX section in MANUAL.txt to avoid duplicate
154+ headings for the extensions.
155+ + Fix typo in MANUAL.txt (Benjamin Wuethrich).
156+ + Remove duplicate 'titlepage' in MANUAL.txt (Blake Eryx).
157+ + CONTRIBUTING.md: Advertise the official nightlies in GitHub actions.
158+ Replaces #6500, thanks to @ickc.
159+
160+
161+
3162## pandoc 2.10 (2020-06-29)
4163
5164 * Use pandoc-types 1.21. This adds two things: