@@ -1,5 +1,296 @@
11# Revision history for pandoc
22
3+## pandoc 2.11.3 (2020-12-17)
4+
5+ * With `--bibliography` (or `bibliography` in metadata), a
6+ URL may now be provided, and pandoc will fetch the resource.
7+ In addition, if a file path is provided and it is not
8+ found relative to the working directory, the resource
9+ path will be searched (#6940).
10+
11+ * Add `sourcepos` extension for `commonmark`, `gfm`, `commonmark_x`
12+ (#4565). With the `sourcepos` extension set set, `data-pos`
13+ attributes are added to the AST by the commonmark reader. No other
14+ readers are affected. The `data-pos` attributes are put on elements
15+ that accept attributes; for other elements, an enlosing Div or Span
16+ is added to hold the attributes.
17+
18+ * Change extensions for `commonmark_x`: replace `auto_identifiers`
19+ with `gfm_auto_identifiers` (#6863). `commonmark_x` never actually
20+ supported `auto_identifiers` (it didn't do anything), because the
21+ underlying library implements gfm-style identifiers only. Attempts
22+ to add the `auto_identifiers` extension to `commonmark` will now
23+ fail with an error.
24+
25+ * HTML reader:
26+
27+ + Split module into several submodules (Albert Krewinkel). Reducing
28+ module size should reduce memory use during compilation.
29+ + Support advanced table features (Albert Krewinkel):
30+ block level content in captions, row and colspans,
31+ body headers, row head columns, footers, attributes.
32+ + Disable round-trip testing for tables. Information for cell
33+ alignment in a column is not preserved during round-trips (Albert
34+ Krewinkel).
35+ + Allow finer grained options for tag omission (Albert Krewinkel).
36+ + Simplify list attribute handling (Albert Krewinkel).
37+ + Pay attention to `lang` attributes on body element (#6938).
38+ These (as well as `lang` attributes on the html element) should update
39+ lang in metadata.
40+ + Retain attribute prefixes and avoid duplicates (#6938).
41+ Previously we stripped attribute prefixes, reading `xml:lang` as
42+ `lang` for example. This resulted in two duplicate `lang`
43+ attributes when `xml:lang` and `lang` were both used. This commit
44+ causes the prefixes to be retained, and also avoids invald
45+ duplicate attributes.
46+
47+ * Commonmark reader:
48+
49+ + Refactor `specFor`.
50+ + Set input name to `""` to avoid clutter in sourcepos output.
51+
52+ * Org reader:
53+
54+ + Parse `#+LANGUAGE` into `lang` metadata field (#6845, Albert
55+ Krewinkel).
56+ + Preserve targets of spurious links (#6916, Albert
57+ Krewinkel). Links with (internal) targets that the reader doesn't
58+ know about are converted into emphasized text. Information on the
59+ link target is now preserved by wrapping the text in a Span of class
60+ `spurious-link`, with an attribute `target` set to the link's
61+ original target. This allows to recover and fix broken or unknown
62+ links with filters.
63+
64+ * DocBook reader:
65+
66+ + Table text width support (#6791, Nils Carlson).
67+ Table width in relation to text width is not natively supported
68+ by docbook but is by the docbook `fo` stylesheets through an XML
69+ processing instruction, `<?dbfo table-width="50%"?>`.
70+
71+ * LaTeX reader:
72+
73+ + Improve parsing of command options (#6869, #6873).
74+ In cases where we run into trouble parsing inlines til the
75+ closing `]`, e.g. quotes, we return a plain string with the
76+ option contents. Previously we mistakenly included the brackets
77+ in this string.
78+ + Preserve center environment (#6852, Igor Pashev).
79+ The contents of the `center` environment are put in a `Div`
80+ with class `center`.
81+ + Don't parse `\rule` with width 0 as horizontal rule. These are
82+ sometimes used as spacers in LaTeX.
83+ + Don't apply theorem default styling to a figure inside (#6925).
84+ If we put an image in italics, then when rendering to Markdown
85+ we no longer get an implicit figure.
86+
87+ * Dokuwiki reader:
88+
89+ + Handle unknown interwiki links better (#6932).
90+ DokuWiki lets the user define his own Interwiki links. Previously
91+ pandoc reacted to these by emitting a google search link, which is
92+ not helpful. Instead, we now just emit the full URL including the
93+ wikilink prefix, e.g. `faquk>FAQ-mathml`. This at least gives users
94+ the ability to modify the links using filters.
95+
96+ * Markdown writer:
97+
98+ + Properly handle boolean values in writing YAML metadata (#6388).
99+ + Ensure that a new csl-block begins on a new line (#6921).
100+ This just looks better and doesn't affect the semantics.
101+
102+ * RST writer:
103+
104+ + Better image handling (#6948). An image alone in its paragraph
105+ (but not a figure) is now rendered as an independent image, with an
106+ `alt` attribute if a description is supplied. An inline image that
107+ is not alone in its paragraph will be rendered, as before, using a
108+ substitution. Such an image cannot have a "center", "left", or
109+ "right" alignment, so the classes `align-center`, `align-left`, or
110+ `align-right` are ignored. However, `align-top`, `align-middle`,
111+ `align-bottom` will generate a corresponding `align` attribute.
112+
113+ * Docx writer:
114+
115+ + Keep raw openxml strings verbatim (#6933, Albert Krewinkel).
116+ + Use Content instead of Element. This allows us to inject
117+ raw OpenXML into the document without reparsing it into an
118+ Element, which is necessary if you want to inject an open
119+ tag or close tag.
120+ + Fix bullets/lists indentation, so that the first level is slightly
121+ indented to the right instead of right on the margin (cholonam).
122+ + Support bold and italic in "complex script" (#6911).
123+ Previously bold and italics didn't work properly in LTR
124+ text. This commit causes the w:bCs and w:iCs attributes
125+ to be used, in addition to w:b and w:i, for bold and
126+ italics respectively.
127+
128+ * ICML writer:
129+
130+ + Fix image bounding box for custom widths/heighta (Mauro Bieg, #6936).
131+
132+ * LaTeX writer:
133+
134+ + Improve table spacing (#6842, #6860).
135+ Remove the `\strut` that was added at the end of minipage
136+ environments in cells. Replace `\tabularnewline` with
137+ `\\ \addlinespace`.
138+ + Improve calculation of column spacing (#6883).
139+ + Extract table handling into separate module (Albert Krewinkel).
140+ + Fix bug with nested `csl-` display Spans (#6921).
141+ + Improve longtable output (#6883). Don't create minipages for
142+ regular paragraphs. Put width and alignment information in the
143+ longtable column descriptors.
144+
145+ * OpenDocument writer:
146+
147+ + Support for table width as a percentage of text width
148+ (#6792, Nils Carson).
149+ + Implement Div and Span ident support (#6755, Nils Carson).
150+ Spans and Divs containing an ident in the Attr will become bookmarks
151+ or sections with idents in OpenDocument format.
152+ + Add two extensions, `xrefs_name` and `xrefs_number` (#6774, Nils
153+ Carlson). Links to headings, figures and tables inside the
154+ document are substituted with cross-references that will use the
155+ name or caption of the referenced item for `xrefs_name` or the
156+ number for `xrefs_number`. For the `xrefs_number` to be useful
157+ heading numbers must be enabled in the generated document and
158+ table and figure captions must be enabled using for example the
159+ `native_numbering` extension. In order for numbers and reference
160+ text to be updated the generated document must be refreshed.
161+
162+ * JATS writer:
163+
164+ + Support advanced table features (Albert Krewinkel).
165+ + Support author affiliations (#6687, Albert Krewinkel).
166+
167+ * Docbook writer:
168+
169+ + Use correct id attribute consistently (Jan Tojnar).
170+ DocBook5 should always use `xml:id` instead of `id`.
171+ + Handle admonition titles better (Jan Tojnar).
172+ Docbook reader produces a `Div` with `title` class for `<title>`
173+ element within an “admonition” element. Markdown writer then turns
174+ this into a fenced div with `title` class attribute. Since fenced
175+ divs are block elements, their content is recognized as a
176+ paragraph by the Markdown reader. This is an issue for Docbook
177+ writer because it would produce an invalid DocBook document from
178+ such AST – the `<title>` element can only contain “inline”
179+ elements. Handle this special case separately by unwrapping
180+ the paragraph before creating the `<title>` element.
181+ + Add XML namespaces to top-level elements (#6923, Jan Tojnar).
182+ Previously, we only added `xmlns` attributes to chapter
183+ elements, even when running with `--top-level-division=section`.
184+ These namespaces are now added to part and section elements too,
185+ when they are the selected top-level divisions.
186+ We do not need to add namespaces to documents produced with
187+ `--standalone` flag, since those will already have xmlns attribute on
188+ the root element in the template.
189+
190+ * HTML writer:
191+
192+ + Fix handling of nested `csl-` display spans (#6921).
193+ Previously inner Spans used to represent CSL display attributes were
194+ not rendered as div tags as intended.
195+
196+ * EPUB writer:
197+
198+ + Include title page in landmarks (#6919).
199+ Note that the toc is also included if `--toc` is specified.
200+ + Add frontmatter type on body element for nav.xhtml (#6918).
201+
202+ * EPUB templates: use preserveAspectRatio="xMidYMid" for cover image (#6895,
203+ Shin Sang-jae). This change affects both the epub2 and the epub3
204+ templates. It avoids distortion of the cover image by requiring that the
205+ aspect ratio be preserved.
206+
207+ * LaTeX template:
208+
209+ + Include `csquotes` package if `csquotes` variable set.
210+ + Put back `amssymb`. We need it for checkboxes in todo lists,
211+ and maybe for other things. In this location it seems compatible
212+ with the cases that prompted #6469 and PR #6762.
213+ + Disable language-specific shorthands in babel (#6817, #6887).
214+ Babel defines "shorthands" for some languages, and these can
215+ produce unexpected results. For example, in Spanish, `1.22`
216+ gets rendered as `122`, and `et~al.` as `etal`.
217+ One would think that babel's `shorthands=off` option (which
218+ we were using) would disable these, but it doesn't. So we
219+ remove `shorthands=off` and add some code that redefines
220+ the shorthands macro. Eventually this will be fixed in babel,
221+ I hope, and we can revert to something simpler.
222+
223+ * JATS template: allow array of persistent institute ids in `pid`
224+ (Albert Krewinkel).
225+
226+ * Text.Pandoc.Parsing: minor code and efficiency improvements.
227+
228+ * Text.Pandoc.Extension:
229+
230+ + Add `Ext_sourcepos` constructor for `Extension` [API change].
231+ + Add `Ext_xrefs_name` and `Ext_xrefs_number` constructors for
232+ `Extension` (Nils Carson) [API change].
233+
234+ * Text.Pandoc.Citeproc:
235+
236+ + Fix truncation of `[Citation]` list in `Cite` inside footnotes (#6890).
237+ This affected author-in-text citations in footnotes. It didn't cause
238+ problems for the printed output, but for filters that expected the
239+ citation id and other information.
240+ + Allow the use of both inline and external references (#6951),
241+ as with pandoc-citeproc. References defined in the document's
242+ metadata take priority over references with the same id defined in
243+ an external bibliography.
244+ + Use `fetchItem` to get external bibliography (#6940).
245+ + Ensure that BCP47 lang codes can be used. We ignore the variants
246+ and just use the base lang code and country code when passing off
247+ to citeproc.
248+ + Citeproc BibTeX parser: revert change in `getRawField`
249+ which was made (for reasons forgotten) when transferring
250+ this code from pandoc-citeproc. The change led to `--` in
251+ URLs being interpreted as en-dashes, which is unwanted (#6874).
252+
253+ * Text.Pandoc.ImageSize:
254+
255+ + Default to DPI 72 if the format specifies DPI of 0 (#6880).
256+ This shouldn't happen, in general, but it can happen with
257+ JPEGs that don't conform to the spec. Having a DPI of 0
258+ will blow up size calculations (division by 0).
259+ + ImageSize: use JuicyPixels to determine size for png, jpeg, and
260+ gif, instead of doing our own binary parsing (#6936). This
261+ gives more reliable results.
262+
263+ * Text.Pandoc.CSS:
264+
265+ + Remove `foldOrElse` (internal module) (Albert Krewinkel).
266+
267+ * Use skylighting 0.10.2 (#6625).
268+
269+ * Use citeproc 0.3. This fixes issues with references with
270+ duplicate ids (jgm/citeproc#36).
271+
272+ * Use doctemplates 0.9. This fixes issues with boolean
273+ metadata values in the Markdown writer (#6388)
274+ and in `meta-json` (#6650). It also fixes
275+ issues with nested for loops in templates.
276+
277+ * Add translations zh-Hans.yaml and zh-Hant.yaml (#6904, #6909,
278+ Kolen Cheung, taotieren).
279+
280+ * Add tests: True to cabal.project.
281+ This fixes some CI failures for cabal.
282+
283+ * Normalize test/tables/*.native (#6888, Kolen Cheung).
284+
285+ * Move executable to `app` directory to avoid problems with cabal repl.
286+
287+ * CONTRIBUTING: add section "How can I help?" (#6892, Albert Krewinkel).
288+ Also adds a paragraph aimed at highlighting the importance of feature
289+ maintenance.
290+
291+ * MANUAL: Document that --number-sections works in `ms` (#6935).
292+
293+
3294## pandoc 2.11.2 (2020-11-19)
4295
5296 * Default to using ATX (`##`-style) headings for Markdown output