@@ -1,11 +1,63 @@
11pandoc (1.17.3)
22
3+ * Added `--reference-location=block|section|document` option
4+ (Jesse Rosenthal). This determines whether Markdown link references
5+ and footnotes are placed at the end of the document, the end of the
6+ section, or the end of the top-level block.
7+
8+ * Added `--top-level-division=section|chapter|part` (Albert Krewinkel).
9+ This determines what a level-1 header corresponds to in LaTeX,
10+ ConTeXt, DocBook, and TEI output. The default is `section`.
11+ The `--chapters` option has been deprecated in favor of
12+ `--top-level-division=chapter`.
13+
14+ * Added `LineBlock` constructor for `Block` (Albert Krewinkel). This
15+ is now used in parsing RST and Markdown line blocks, DocBook
16+ `linegroup`/`line` combinations, and Org-mode `VERSE` blocks.
17+ Previously `Para` blocks with hard linebreaks were used. `LineBlock`s
18+ are handled specially in the following ouput formats: AsciiDoc
19+ (as `[verse]` blocks), ConTeXt (`\startlines`/`\endlines`),
20+ HTML (`div` with a style), Markdown (line blocks if `line_blocks`
21+ is enabled), Org-mode (`VERSE` blocks), RST (line blocks). In
22+ other output formats, a paragraph with hard linebreaks is emitted.
23+
24+ * Changed JSON output format (Jesse Rosenthal). Previously we used
25+ generically generated JSON, but this was subject to change depending
26+ on the version of aeson pandoc was compiled with. To ensure stability,
27+ we switched to using manually written ToJSON and FromJSON
28+ instances, and encoding the API version. **Note:** pandoc filter
29+ libraries will need to be revised to handle the format change.
30+ Here is a summary of the essential changes:
31+
32+ + The toplevel JSON format is now `{"pandoc-api-version" :
33+ [MAJ, MIN, REV], "meta" : META, "blocks": BLOCKS}`
34+ instead of `[{"unMeta": META}, [BLOCKS]]`.
35+ Decoding fails if the major and minor version numbers don't
36+ match.
37+ + Leaf nodes no longer have an empty array for their "c" value.
38+ Thus, for example, a `Space` is encoded as `{"t":"Space"}`
39+ rather than `{"t":"Space","c":[]}` as before.
40+
41+ * Removed `tests/Tests/Arbitrary.hs` and added a `Text.Pandoc.Arbitrary`
42+ module to pandoc-types (Jesse Rosenthal). This makes it easier
43+ to use QuickCheck with pandoc types outside of pandoc itself.
44+
345 * Add `bracketed_spans` Markdown extension, enabled by default
446 in pandoc `markdown`. This allows you to create a native span
547 using this syntax: `[Here is my span]{#id .class key="val"}`.
648
7− * `Text.Pandoc.Options.Extension` has a new constructor
8− `Ext_brackted_spans` [API change].
49+ * Added `angle_brackets_escapable` Markdown extension (#2846).
50+ This is needed because github flavored Markdown has a slightly
51+ different set of escapable symbols than original Markdown;
52+ it includes angle brackets.
53+
54+ * `Text.Pandoc.Options`:
55+
56+ + `Extension` has new constructors `Ext_brackted_spans` and
57+ `Ext_angle_brackets_escapable` [API change].
58+ + Added `ReferenceLocation` type [API change] (Jesse Rosenthal).
59+ + Added `writerReferenceLocation` field to `WriterOptions` (Jesse
60+ Rosenthal).
961
1062 * `--filter`: we now check `$DATADIR/filters` for filters before
1163 looking in the path (#3127, Jesse Rosenthal, thanks to Jakob
@@ -13,6 +65,13 @@ pandoc (1.17.3)
1365 be executable; if the extension is `.hs`, `.php`, `.pl`, `.js`,
1466 or `.rb`, pandoc will run the right interpreter.
1567
68+ * For `--webtex`, replace deprecated Google Chart API by CodeCogs as
69+ default (Kolen Cheung).
70+
71+ * Removed `raw_tex` extension from `markdown_mmd` defaults (Kolen Cheung).
72+
73+ * Execute .js filters with node (Jakob Voß).
74+
1675 * Textile reader:
1776
1877 + Support `bc..` extended code blocks (#3037). Also, remove trailing
@@ -38,6 +97,15 @@ pandoc (1.17.3)
3897 the rendering of some RST documents! The word ("Warning", "Attention",
3998 etc.) is no longer added; that must be done with CSS or a filter.
4099 + A Div is now used for `sidebar` as well.
100+ + Skip whitespace before note (Jesse Rosenthal, #3163). RST requires a
101+ space before a footnote marker. We discard those spaces so that footnotes
102+ will be adjacent to the text that comes before it. This is in line with
103+ what rst2latex does.
104+ + Allow empty lines when parsing line blocks (Albert Krewinkel).
105+
106+ * Markdown reader:
107+
108+ + Allow empty lines when parsing line blocks (Albert Krewinkel).
41109
42110 * LaTeX reader:
43111
@@ -60,6 +128,9 @@ pandoc (1.17.3)
60128 + Properly interpret XML tags in pre environments (#3042). They are meant
61129 to be interpreted as literal text.
62130
131+ * EPUB reader: don't add root path to data: URIs (#3150).
132+ Thanks to @lep for the bug report and patch.
133+
63134 * Org reader (Albert Krewinkel):
64135
65136 + Preserve indentation of verse lines (#3064). Leading spaces in verse
@@ -68,18 +139,20 @@ pandoc (1.17.3)
68139 images, image links, or figures, must be proper URIs or relative file
69140 paths to be recognized as images. This restriction is now enforced
70141 for all image sources. This also fixes the reader's usage of uncleaned
71− image sources, leading to `file:` prefixes not being deleted from figure
72− images. Thanks to @bsag for noticing this bug.
142+ image sources, leading to `file:` prefixes not being deleted from
143+ figure images. Thanks to @bsag for noticing this bug.
144+ + Trim verse lines properly (Albert Krewinkel).
73145 + Extract meta parsing code to module. Parsing of meta-data is well
74− separable from other block parsing tasks. Moving into new module to get
75− small files and clearly arranged code.
146+ separable from other block parsing tasks. Moving into new module to
147+ get small files and clearly arranged code.
76148 + Read markup only for special meta keys. Most meta-keys should be read
77149 as normal string values, only a few are interpreted as marked-up text.
78− + Allow multiple, comma-separated authors. Multiple authors can be specified
79− in the `#+AUTHOR` meta line if they are given as a comma-separated list.
80− + Give precedence to later meta lines. The last meta-line of any given type
81− is the significant line. Previously the value of the first line was kept,
82− even if more lines of the same type were encounterd.
150+ + Allow multiple, comma-separated authors. Multiple authors can be
151+ specified in the `#+AUTHOR` meta line if they are given as a
152+ comma-separated list.
153+ + Give precedence to later meta lines. The last meta-line of any given
154+ type is the significant line. Previously the value of the first line
155+ was kept, even if more lines of the same type were encounterd.
83156 + Read LaTeX_header as header-includes. LaTeX-specific header commands
84157 can be defined in `#+LaTeX_header` lines. They are parsed as
85158 format-specific inlines to ensure that they will only show up in LaTeX
@@ -89,38 +162,44 @@ pandoc (1.17.3)
89162 + Read HTML_head as header-includes. HTML-specific head content can be
90163 defined in `#+HTML_head` lines. They are parsed as format-specific
91164 inlines to ensure that they will only show up in HTML output.
92− + Respect `author` export option. The `author` option controls whether the
93− author should be included in the final markup. Setting
165+ + Respect `author` export option. The `author` option controls whether
166+ the author should be included in the final markup. Setting
94167 `#+OPTIONS: author:nil` will drop the author from the final meta-data
95168 output.
96169 + Respect `email` export option. The `email` option controls whether the
97170 email meta-field should be included in the final markup. Setting
98− `#+OPTIONS: email:nil` will drop the email field from the final meta-data
99− output.
171+ `#+OPTIONS: email:nil` will drop the email field from the final
172+ meta-data output.
100173 + Respect `creator` export option. The `creator` option controls whether
101174 the creator meta-field should be included in the final markup. Setting
102175 `#+OPTIONS: creator:nil` will drop the creator field from the final
103176 meta-data output. Org-mode recognizes the special value `comment` for
104177 this field, causing the creator to be included in a comment. This is
105178 difficult to translate to Pandoc internals and is hence interpreted the
106− same as other truish values (i.e. the meta field is kept if it's present).
179+ same as other truish values (i.e. the meta field is kept if it's
180+ present).
107181 + Respect unnumbered header property (#3095). Sections the `unnumbered`
108182 property should, as the name implies, be excluded from the automatic
109183 numbering of section provided by some output formats. The Pandoc
110184 convention for this is to add an "unnumbered" class to the header. The
111185 reader treats properties as key-value pairs per default, so a special
112186 case is added to translate the above property to a class instead.
187+ + Allow figure with empty caption (Albert Krewinkel, #3161).
188+ A `#+CAPTION` attribute before an image is enough to turn an image into
189+ a figure. This wasn't the case because the `parseFromString` function,
190+ which processes the caption value, would fail on empty values. Adding
191+ a newline character to the caption value fixes this.
113192
114193 * Docx reader:
115194
116195 + Use XML convenience functions (Jesse Rosenthal).
117− The functions `isElem` and `elemName` (defined in Docx/Util.hs) make the
118− code a lot cleaner than the original XML.Light functions, but they had
119− been used inconsistently. This puts them in wherever applicable.
196+ The functions `isElem` and `elemName` (defined in Docx/Util.hs) make
197+ the code a lot cleaner than the original XML.Light functions, but they
198+ had been used inconsistently. This puts them in wherever applicable.
120199 + Handle anchor spans with content in headers. Previously, we would only
121− be able to figure out internal links to a header in a docx if the anchor
122− span was empty. We change that to read the inlines out of the first
123− anchor span in a header.
200+ be able to figure out internal links to a header in a docx if the
201+ anchor span was empty. We change that to read the inlines out of the
202+ first anchor span in a header.
124203 + Let headers use exisiting id. Previously we always generated an id for
125204 headers (since they wouldn't bring one from Docx). Now we let it use an
126205 existing one if possible. This should allow us to recurs through anchor
@@ -132,6 +211,21 @@ pandoc (1.17.3)
132211 in header with content (or with other anchor spans inside) will resolve
133212 to links to a header id properly.
134213
214+ * ODT reader (Hubert Plociniczak)
215+
216+ + Include list's starting value. Previously the starting value of
217+ the lists' items has been hardcoded to 1. In reality ODT's list
218+ style definition can provide a new starting value in one of its
219+ attributes.
220+ + Infer caption from the text following the image.
221+ Frame can contain other frames with the text boxes.
222+ + Add `fig:` to title for Image with a caption (as expected
223+ by pandoc's writers).
224+ + Basic support for images in ODT documents.
225+ + Don't duplicate text for anchors (#3143). When creating an anchor
226+ element we were adding its representation as well as the original
227+ content, leading to text duplication.
228+
135229 * DocBook writer:
136230
137231 + Include an anchor element when a div or span has an id (#3102).
@@ -140,9 +234,10 @@ pandoc (1.17.3)
140234
141235 * LaTeX writer:
142236
143− + Don't use * for unnumbered paragraph, subparagraph. The starred variants
144− don't exist. This helps with part of #3058...it gets rid of the spurious
145− `*`s. But we still have numbers on the 4th and 5th level headers.
237+ + Don't use * for unnumbered paragraph, subparagraph. The starred
238+ variants don't exist. This helps with part of #3058...it gets rid of
239+ the spurious `*`s. But we still have numbers on the 4th and 5th level
240+ headers.
146241 + Properly escape backticks in verbatim (#3121, Jesse Rosenthal).
147242 Otherwise they can cause unintended ligatures like `` ?` ``.
148243 + Handle NARRAOW NO-BREAK SPACE into LaTeX (Vaclav Zeman) as `\,`.
@@ -150,19 +245,38 @@ pandoc (1.17.3)
150245 This allows figure placement defaults to be changed by the user
151246 in the template.
152247
153− * Text.Pandoc.Error: Fix out of index error in `handleError`
154− (Matthew Pickering). The fix is to not try to show the exact line when it
155− would cause an out-of-bounds error as a result of included files.
248+ * TEI writer: remove heuristic to detect book template (Albert Krewinkel).
249+ TEI doesn't have `<book>` elements but only generic `<divN>` division
250+ elements. Checking the template for a trailing `</book>` is nonsensical.
251+
252+ * MediaWiki writer: transform filename with underscores in images (#3052).
253+ `foo bar.jpg` becomes `foo_bar.jpg`. This was already done
254+ for internal links, but it also needs to happen for images.
156255
157256 * Man writer:
158257
159258 + Allow section numbers that are not a single digit (#3089).
160259
260+ * AsciiDoc writer: avoid unnecessary use of "unconstrained" emphasis
261+ (#3068). In AsciiDoc, you must use a special form of emphasis
262+ (double `__`) for intraword emphasis. Pandoc was previously using
263+ this more than necessary.
264+
265+ * EPUB writer: use stringify instead of plain writer for metadata
266+ (#3066). This means that underscores won't be used for emphasis,
267+ or CAPS for bold. The metadata fields will just have unadorned
268+ text.
269+
161270 * Docx Writer:
162271
163272 + Implement user-defined styles (Jesse Rosenthal). Divs and Spans
164273 with a `custom-style` key in the attributes will apply the corresponding
165274 key to the contained blocks or inlines.
275+ + Add ReaderT env to the docx writer (Jesse Rosenthal).
276+ + Clean up and streamline RTL behavior (Jesse Rosenthal, #3140).
277+ You can set `dir: rtl` in YAML metadata, or use `-M dir=rtl`
278+ on the command line. For finer-grained control, you can set
279+ the `dir` attribute in Div or Span elements.
166280
167281 * Org writer (Albert Krewinkel):
168282
@@ -181,13 +295,24 @@ pandoc (1.17.3)
181295 those identifiers is added to avoid unexpected behavior. This fixes a
182296 problem where language specific source code would sometimes be output
183297 as example code.
298+ + Drop space before footnote markers (Albert Krewinkel, #3162).
299+ The writer no longer adds an extra space before footnote markers.
300+
301+ * Markdown writer:
302+
303+ + Don't emit HTML for tables unless `raw_html` extension is set (#3154).
304+ Emit `[TABLE]` if no suitable table formats are enabled and raw HTML
305+ is disabled.
306+ + Check for the `raw_html` extension before emiting a raw HTML block.
307+ + Abstract out note/ref function (Jesse Rosenthal).
308+ + Add ReaderT monad for environment variables (Jesse Rosenthal).
184309
185310 * HTML, EPUB, slidy, revealjs templates: Use `<p>` instead of `<h1>` for
186311 subtitle, author, date (#3119). Note that, as a result of this change,
187312 authors may need to update CSS.
188313
189− * revealjs template: Added `notes-server` option (jgm/pandoc-templates#212,
190− Yoan Blanc).
314+ * revealjs template: Added `notes-server` option
315+ (jgm/pandoc-templates#212, Yoan Blanc).
191316
192317 * Beamer template:
193318
@@ -195,8 +320,8 @@ pandoc (1.17.3)
195320 a regression in the last release (jgm/pandoc-templates#207).
196321 + Added `themeoptions` variable (Carsten Gips).
197322 + Added `beamerarticle` variable. This causes the `beamerarticle`
198− package to be loaded in beamer, to produce an article from beamer slides.
199− (Carsten Gips)
323+ package to be loaded in beamer, to produce an article from beamer
324+ slides. (Carsten Gips)
200325 + Added support for `fontfamilies` structured variable
201326 (Artem Klevtsov).
202327
@@ -211,6 +336,16 @@ pandoc (1.17.3)
211336 + Use footnote package to fix notes in tables (jgm/pandoc-templates#208,
212337 Václav Haisman).
213338
339+ * Moved template compiling/rendering code to a separate library.
340+ `doctemplates`. This allows the pandoc templating system to be
341+ used independently.
342+
343+ * Text.Pandoc.Error: Fix out of index error in `handleError`
344+ (Matthew Pickering). The fix is to not try to show the exact line when
345+ it would cause an out-of-bounds error as a result of included files.
346+
347+ * Text.Pandoc.Shared: Add `linesToBlock` function (Albert Krewinkel).
348+
214349 * Text.Pandoc.PDF: Don't crash with nonexistent image (#3100). Instead,
215350 emit the alt text, emphasized. This accords with what the ODT writer
216351 currently does. The user will still get a warning about a nonexistent
@@ -219,7 +354,9 @@ pandoc (1.17.3)
219354 * Tell where to get tarball in INSTALL (#3062).
220355
221356 * Rename README to MANUAL.txt and add GitHub-friendly README.md
222− (Albert Krewinkel).
357+ (Albert Krewinkel, Kolen Cheung).
358+
359+ * Replace COPYING with Markdown version COPYING.md from GNU (Kolen Cheung).
223360
224361 * MANUAL.txt:
225362
@@ -228,12 +365,19 @@ pandoc (1.17.3)
228365 custom template
229366 + Note that `--katex` works best with `html5` (#3077).
230367 + Fix the LaTeX and EPUB links in manual (Morton Fox).
368+ + Document `biblio-title` variable.
231369
232370 * Improve spacing of footnotes in `--help` output (Waldir Pimenta).
233371
234− * Allow aeson 1.0.*.
372+ * Update KaTeX to v0.6.0 (Kolen Cheung).
373+
374+ * Allow latest dependencies.
375+
376+ * Use texmath 0.8.6.6 (#3040).
235377
236− * Use texmath 0.8.6.5 (#3040).
378+ * Allow http-client 0.4.30, which is the version in stackage lts.
379+ Previously we required 0.5.
380+ Remove CPP conditionals for earlier versions.
237381
238382 * Remove support for GHC < 7.8 (Jesse Rosenthal).
239383
@@ -251,9 +395,9 @@ pandoc (1.17.3)
251395 + Remove TagSoup compat.
252396 + Add EOL note to time compat module. Because time 1.4 is a boot library
253397 for GHC 7.8, we will support the compatibility module as long as we
254− support 7.8. But we should be clear about when we will no longer need it.
398+ support 7.8. But we should be clear about when we will no longer need
399+ it.
255400 + Remove blaze-html CPP conditional.
256− + Remove http-client CPP conditionals.
257401 + Remove unnecessary CPP in custom Prelude.
258402
259403pandoc (1.17.2)