@@ -1,9 +1,38 @@
11pandoc (1.13)
22
3− * Added Docx reader (API change) (Jesse Rosenthal).
3+ * Added Docx reader (API change) (Jesse Rosenthal). Includes conversion
4+ of Word equations to latex in pandoc `Math` elements. Note that metadata
5+ is taken from paragraphs at the beginning styled with `Author`,
6+ `Title`, `Subtitle`, `Date`, and `Abstract`.
7+
8+ * Added EPUB reader (API change) (Matthew Pickering). Includes conversion
9+ of MathML math to latex in pandoc `Math` elements.
10+
11+ * Added txt2tags reader (Matthew Pickering). Txt2tags is a lightweight
12+ markup format described at <http://txt2tags.org/>.
13+
14+ * Added `--extract-media` option to extract media contained in a zip
15+ container (docx or epub) while adjusting image paths to point to the
16+ extracted images.
17+
18+ * Added module `Text.Pandoc.MediaBag`, exporting `MediaBag`, `lookupMedia`,
19+ `insertMedia`, `mediaDirectory`, `extractMediaBag`. The docx and epub
20+ readers return a pair of a `Pandoc` document and a `MediaBag` with
21+ the media resources they contain. This can be extracted using
22+ `--extract-media`. Writers that incorporate media (PDF, Docx,
23+ ODT, EPUB, RTF, or HTML formats with `--self-contained`) will look
24+ for resources in the `MediaBag` generated by the reader, in addition to
25+ the file system or web.
426
527 * Markdown reader:
628
29+ + Changed behavior of the `markdown_attribute` extension, to bring
30+ it in line with PHP markdown extra and multimarkdown. Setting
31+ `markdown="1"` on an outer tag affects all contained tags,
32+ recursively, until it is reversed with `markdown="0"` (#1378).
33+ + Fixed small bug in HTML parsing with `markdown_attribute`, which
34+ caused incorrect tag nesting for input like
35+ `<aside markdown="1">*hi*</aside>`.
736 + Fixed regression with intraword underscores (#1121).
837 + Slight rewrite of `enclosure`/`emphOrStrong` code.
938 + Revamped raw HTML block parsing in markdown (#1330).
@@ -58,6 +87,12 @@ pandoc (1.13)
5887
5988 * HTML reader: adjust `blockTags` and `eitherBlockOrInline`.
6089
90+ + Parse `div` and `span` elements even without `--parse-raw`.
91+ Motivation: these now generate native pandoc Div and Span
92+ elements, not raw HTML.
93+ + Parse EPUB-specific elements if the `epub_html_exts`
94+ extension is enabled. These include `switch`, `footnote`,
95+ `rearnote`, `noteref`.
6196 + Added `audio` and `source` in `eitherBlockOrInline`.
6297 + Moved `video`, `svg`, `progress`, `script`, `noscript`, `svg` from
6398 `blockTags` to `eitherBlockOrInline`.
@@ -69,6 +104,7 @@ pandoc (1.13)
69104 We let a `</table>` tag close an open `<tr>` or `<td>` (#1167).
70105 + Support `--trace`.
71106 + Allow space between `<col>` and `</col>`.
107+ + Ignore `DOCTYPE` and `xml` declarations.
72108
73109 * Rewrote Haddock reader to use `haddock-library` (#1346).
74110
@@ -79,13 +115,18 @@ pandoc (1.13)
79115
80116 * MediaWiki reader:
81117
118+ + Don't parse backslash escapes inside `<source>` (#1445).
82119 + Tightened up template parsing.
83120 The opening `{{` must be followed by an alphanumeric or `:`.
84121 This prevents the exponential slowdown in #1033.
85122 + Support `--trace`.
123+ + Support "Bild" for images.
86124
87125 * DocBook reader:
88126
127+ + Better handle elements inside code environments. Pandoc's document
128+ model does not allow structure inside code blocks, but at least this way
129+ we preserve the text (#1449).
89130 + Support `<?asciidoc-br?>` (#1236).
90131 Note, this is a bit of a kludge, to work around the fact that xml-light
91132 doesn't parse `<?asciidoc-br?>` correctly. We preprocess the input,
@@ -121,6 +162,8 @@ pandoc (1.13)
121162
122163 * EPUB writer:
123164
165+ + Avoid excess whitespace in `nav.xhtml`. This should improve
166+ TOC view in iBooks (#1392).
124167 + Fixed regression on cover image.
125168 In 1.12.4 and 1.12.4.2, the cover image would not appear properly,
126169 because the metadata id was not correct. Now we derive the id from the
@@ -138,6 +181,7 @@ pandoc (1.13)
138181
139182 * LaTeX writer:
140183
184+ + Use `\(..\)` instead of `$..$` for inline math (#1464).
141185 + Use `\nolinkurl` in email autolinks. This allows them to be styled
142186 using `\urlstyle{tt}`. Thanks to Ulrike Fischer for the solution.
143187 + Use `\textquotesingle` for `'` in inline code. Otherwise we get
@@ -149,7 +193,11 @@ pandoc (1.13)
149193 + Put table captions above tables, to match the conventional
150194 standard. (Previously they appeared below tables.)
151195
152− * RTF writer: Avoid extra paragraph tags in metadata (#1421).
196+ * RTF writer:
197+
198+ + Improved image embedding: `fetchItem'` is now used to get the
199+ images, and calculated image sizes are indicated in the RTF.
200+ + Avoid extra paragraph tags in metadata (#1421).
153201
154202 * HTML writer:
155203
@@ -166,15 +214,38 @@ pandoc (1.13)
166214
167215 * Markdown writer:
168216
217+ + Updated definition lists, so they match the current markdown reader's
218+ behavior. (Thus, they match PHP markdown extra, and a blank line is
219+ always used between items.) The old behavior
220+ can be activated with the `compact_definition_lists` extension.
221+ + Horizontal rules are now a line across the whole page.
222+ + Avoid wrapping that might start a list, blockquote, or header (#1013).
169223 + Use span with style for `SmallCaps` (#1360).
170224 + Use Span instead of (hackish) `SmallCaps` in `plainify`.
171225 + Don't use braced attributes for fenced code (#1416).
172226 If `Ext_fenced_code_attributes` is not set, the first class
173227 attribute will be printed after the opening fence as a bare word.
174228 + Prettier pipe tables. Columns are now aligned (#1323).
229+ + Respect the `raw_html` extension. `pandoc -t markdown-raw_html`
230+ no longer emits any raw HTML, including span and div tags
231+ generated by Span and Div elements.
232+ + Separate adjacent lists of the same kind with an HTML comment (#1458).
233+
234+ * Plain writer: Revised output, largely following the style of Project
235+ Gutenberg.
236+
237+ + Emphasis is rendered with `_underscores_`, strong emphasis
238+ with ALL CAPS.
239+ + Headings are rendered differently, with space to set them off,
240+ not with setext style underlines. Level 1 headers are ALL CAPS.
241+ + Math is rendered using unicode when possible, but without the
242+ distracting emphasis markers around variables.
243+ + Footnotes use a regular `[n]` style.
244+ + Added tests.
175245
176246 * PDF writer:
177247
248+ + Moved `withTempDir` to `Text.Pandoc.Shared`, which now exports it.
178249 + Fixed treatment of data uris for images (#1062).
179250
180251 * Docx writer:
@@ -197,6 +268,14 @@ pandoc (1.13)
197268 + Section numbering carries over from reference.docx (#1305).
198269 + Simplified `abstractNumId` numbering. Instead of sequential numbering,
199270 we assign numbers based on the list marker styles.
271+ + Include abstract (if present) with `Abstract` style (#1451).
272+ + Include subtitle (if present) with `Subtitle` style, rather
273+ than tacking it on to the title (#1451).
274+
275+ * Org writer:
276+
277+ + Write empty span elements with an id attribute as org anchors.
278+ For example `Span ("uid",[],[]) []` becomes `<<uid>>`.
200279
201280 * Custom lua writers:
202281
@@ -215,14 +294,30 @@ pandoc (1.13)
215294 * `Text.Pandoc.Highlighting`: Let `.numberLines` work even if no language
216295 is given (#1287, jgm/highlighting-kate#40).
217296
297+ * `Text.Pandoc.Pretty`: Added `blanklines`, which guarantees a certain
298+ number of blank lines (and no more).
218299
219300 * `Text.Pandoc.Shared`:
220301
302+ + Added `fetchItem'`, which works like `fetchItem` but searches
303+ a `MediaBag` before looking on the net or file system.
304+ + Added `withTempDir` (API change).
221305 + `fetchItem`: unescape URI encoding before reading local file (#1427).
306+ + `fetchItem`: strip a fragment like `?#iefix` from the extension before
307+ doing mime lookup, to improve mime type guessing.
308+ + Improved log of `fetchItem`: absolute URIs are fetched from the net;
309+ other things are treated as relative URIs if `sourceURL` is `Just _`,
310+ otherwise as file paths on the local file system.
311+ + `fetchItem` now properly handles links without a protocol (#1477).
312+ + `fetchItem` now escapes characters not allowed in URIs before trying
313+ to parse the URIs.
222314 + Added `removeFormatting` (API change).
223315 + Added `extractSpaces` (from HTML reader) and generalized its type
224316 so that it can be used by the docx reader (Matthew Pickering).
225317 + Added `ordNub` (API change).
318+ + Fixed runtime error with `compactify'DL` on certain lists (#1452).
319+ + Added `capitalize` (Artyom Kazak), and replaced uses of
320+ `map toUpper` (which give bad results for many languages).
226321
227322 * `Text.Pandoc.Templates`:
228323
@@ -235,18 +330,41 @@ pandoc (1.13)
235330
236331 * `Text.Pandoc.Options`:
237332
333+ + Added `writerMediaBag` to `WriterOptions` (API change).
334+ + Removed deprecated and no longer used `readerStrict` in
335+ `ReaderOptions`. This is handled by `readerExtensions` now
336+ (API change).
238337 + Removed `Ext_fenced_code_attributes` from `markdown_github`
239− extensions.
240− + Added `Ext_compact_definition_lists`.
338+ extensions (API change)`.
339+ + Added `Ext_compact_definition_lists` (API change).
340+ + Added `Ext_epub_html_exts` (API change).
241341
242342 * `Text.Pandoc.Parsing`
243343
344+ + Generalized `readWith` to `readWithM` (Matthew Pickering) (API change).
345+ + Export `runParserT` and `Stream` (Matthew Pickering).
346+ + Added `HasQuoteContext` type class (Matthew Pickering).
347+ + Generalized types of `mathInline`, `smartPunctuation`, `quoted`,
348+ `singleQuoted`, `doubleQuoted`, `failIfInQuoteContext`,
349+ `applyMacros` (Matthew Pickering).
350+ + Added custom `token` (Matthew Pickering).
244351 + Simplified `dash` and `ellipsis` (#1419).
245352 + Removed `(>>~)` in favor of the equivalent `(<*)` (Matthew Pickering).
246353 + Generalized functions to use `ParsecT` (Matthew Pickering).
247354 + Added `stateInHtmlBlock` to `ParserState`. This is used to keep
248355 track of the ending tag we're waiting for when we're parsing inside
249356 HTML block tags. (API change.)
357+ + Added `stateMarkdownAttribute` to `ParserState`. This is used
358+ to keep track of whether the markdown attribute has been set in
359+ an enclosing tag. (API change.)
360+ + Added `isbn` and `pmid` to list of recognized schemes (Matthew
361+ Pickering).
362+
363+ * Added `Text.Pandoc.Compat.Directory` to allow building against
364+ different versions of the `directory` library.
365+
366+ + Added `Text.Pandoc.Compat.Except` to allow building against
367+ different verions of `mtl`.
250368
251369 * Templates:
252370
@@ -255,6 +373,10 @@ pandoc (1.13)
255373 be "advisory" in HTML5, but kindlegen seems to require them.
256374 + LaTeX: Made `\subtitle` work properly (#1327).
257375 + LaTeX/Beamer: remove conditional around date (#1321).
376+ + LaTeX: Added `lot` and `lof` variables, which can be set to
377+ get `\listoftables` and `\listoffigures` (#1407). Note that
378+ these variables can be set at the command line with `-Vlot -Vlof`
379+ or in YAML metadata.
258380
259381 * Code cleanup in some writers, using Reader monad to avoid
260382 passing options parameter around (Matej Kollar).
@@ -280,8 +402,13 @@ pandoc (1.13)
280402
281403 * Avoid `import Prelude hiding (catch)` (#1309, thanks to Michael Thompson).
282404
405+ * Don't strip path off of `writerSourceURL`: the path is needed to
406+ resolve relative URLs when we fetch resources (#750).
407+
283408 * README:
284409
410+ + Made headers for all extensions so they have IDs and can be linked
411+ to (Beni Cherniavsky-Paskin).
285412 + Fixed typos (Phillip Alday).
286413 + Fixed documentation of attributes (#1315).
287414 + Clarified documentation on small caps (#1360).
@@ -300,10 +427,24 @@ pandoc (1.13)
300427 ocaml and fsharp.
301428
302429 * Require latest `texmath`. This fixes `\tilde{E}` and allows
303− `\left` to be used with `]`, `)` etc. (#1319).
430+ `\left` to be used with `]`, `)` etc. (#1319), among many other
431+ improvements.
432+
433+ * Improved readability in `pandoc.hs`.
434+
435+ * Miscellaneous code cleanups (Artyom Kazak).
304436
305437 * Require latest `zip-archive`. This has fixes for unicode path names.
306438
439+ * Benchmarks:
440+
441+ + Made benchmarks compile again (Artyom Kazak).
442+ + Fixed so that the failure of one benchmark does not prevent others
443+ from running (Artyom Kazak).
444+ + Use `nfIO` instead of the `getLength` trick to force full evaluation.
445+ + Changed benchmark to use only the test suite, so that benchmarks
446+ run more quickly.
447+
307448 * Windows build script:
308449
309450 + Add `-windows` to file name.
@@ -425,6 +566,10 @@ pandoc (1.12.4)
425566 + Implemented correct parsing rules for inline markup (#1175, Matthew
426567 Pickering).
427568 + Use Builder (Matthew Pickering).
569+ + Fixed list parsing bug (#1500).
570+ + Don't allow inline formatting to extend over newlines.
571+ This matches the behavior of RedCarpet, avoids some ugly bugs,
572+ and improves performance.
428573
429574 * DocBook reader:
430575
@@ -570,8 +715,14 @@ pandoc (1.12.4)
570715 in your template, the word `true` will appear, which may be
571716 unexpected. (Previously nothing would appear.)
572717
573− * `Text.Pandoc.SelfContained`: Handle `poster` attribute in `video`
574− tags (#1188).
718+ * `Text.Pandoc.SelfContained`:
719+
720+ + `mkSelfContained` now takes just two arguments, `WriterOptions` and
721+ the string.
722+ * It no longer looks in data files. This only made sense when we
723+ had copies of slidy and S5 code there.
724+ * `fetchItem'` is used instead of the nearly duplicate `getItem`.
725+ + Handle `poster` attribute in `video` tags (#1188).
575726
576727 * `Text.Pandoc.Parsing`:
577728