@@ -1,3 +1,261 @@
1+pandoc (1.17.2)
2+
3+ * Added Zim Wiki writer, template and tests. `zimwiki` is now
4+ a valid output format. (Alex Ivkin)
5+
6+ * Changed email-obfuscation default to no obfuscation (#2988).
7+ + `writerEmailObfuscation` in `defaultWriterOptions` is now
8+ `NoObfuscation`.
9+ + the default for the command-line `--email-obfuscation` option is
10+ now `none`.
11+
12+ * Docbook writer: Declare xlink namespace in Docbook5 output (Ivo Clarysse).
13+
14+ * Org writer:
15+
16+ + Support arbitrary raw inlines (Albert Krewinkel).
17+ Org mode allows arbitrary raw inlines ("export snippets" in Emacs
18+ parlance) to be included as `@@format:raw foreign format text@@`.
19+ + Improve Div handling (Albert Krewinkel). Div blocks handling is
20+ changed to make the output look more like idiomatic org mode:
21+ - Div-wrapped content is output as-is if the div's attribute is the
22+ null attribute.
23+ - Div containers with an id but neither classes nor key-value pairs
24+ are unwrapped and the id is added as an anchor.
25+ - Divs with classes associated with greater block elements are
26+ wrapped in a `#+BEGIN`...`#+END` block.
27+ - The old behavior for Divs with more complex attributes is kept.
28+
29+ * HTML writer: Better support for raw LaTeX environments (#2758).
30+ Previously we just passed all raw TeX through when MathJax
31+ was used for HTML math. This passed through too much.
32+ With this patch, only raw LaTeX environments that MathJax
33+ can handle get passed through.
34+ This patch also causes raw LaTeX environments to be treated
35+ as math, when possible, with MathML and WebTeX output.
36+
37+ * Markdown writer: use raw HTML for simple, pipe tables with linebreaks
38+ (#2993). Markdown line breaks involve a newline, and simple and pipe
39+ tables can't contain one.
40+
41+ * Make --webtex work with the Markdown writer (#1177).
42+ This is a convenient option for people using
43+ websites whose Markdown flavors don't provide for math.
44+
45+ * Docx writer:
46+
47+ + Set paragraph to FirstPara after display math (Jesse Rosenthal).
48+ We treat display math like block quotes, and apply FirstParagraph style
49+ to paragraphs that follow them. These can be styled as the user
50+ wishes. (But, when the user is using indentation, this allows for
51+ paragraphs to continue after display math without indentation.)
52+ + Use actual creation time as doc prop (Jesse Rosenthal).
53+ Previously, we had used the user-supplied date, if available, for Word's
54+ document creation metadata. This could lead to weird results, as in
55+ cases where the user post-dates a document (so the modification might be
56+ prior to the creation). Here we use the actual computer time to set the
57+ document creation.
58+
59+ * LaTeX writer:
60+
61+ + Don't URI-escape image source (#2825). Usually this is a local file,
62+ and replacing spaces with `%20` ruins things.
63+ + Allow 'standout' as a beamer frame option (#3007).
64+ `## Slide title {.standout}`.
65+
66+ * RST reader: Fixed links with no explicit link text. The link
67+ `` `<foo>`_ `` should have `foo` as both its link text and its URL.
68+ See RST spec at <http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#embedded-uris-and-aliases>
69+ Closes Debian #828167 -- reported by Christian Heller.
70+
71+ * Textile reader:
72+
73+ + Fixed attributes (#2984). Attributes can't be followed by
74+ a space. So, `_(class)emph_` but `_(noclass) emph_`.
75+ + Fixed exponential parsing bug (#3020).
76+ + Fix overly aggressive interpretation as images (#2998).
77+ Spaces are not allowed in the image URL in textile.
78+
79+ * LaTeX reader:
80+
81+ + Fix `\cite` so it is a NormalCitation not AuthorInText.
82+ + Strip off double quotes around image source if present (#2825).
83+ Avoids interpreting these as part of the literal filename.
84+
85+ * Org reader:
86+
87+ + Add semicolon to list of special chars (Albert Krewinkel)
88+ Semicolons are used as special characters in citations syntax. This
89+ ensures the correct parsing of Pandoc-style citations: `[prefix; @key;
90+ suffix]`. Previously, parsing would have failed unless there was a space
91+ or other special character as the last <prefix> character.
92+ + Add support for "Berkeley-style" cites (Albert Krewinkel, #1978).
93+ A specification for an official Org-mode citation syntax was drafted by
94+ Richard Lawrence and enhanced with the help of others on the orgmode
95+ mailing list. Basic support for this citation style is added to the
96+ reader.
97+ + Support arbitrary raw inlines (Albert Krewinkel).
98+ Org mode allows arbitrary raw inlines ("export snippets" in Emacs
99+ parlance) to be included as `@@format:raw foreign format text@@`.
100+ + Remove partial functions (Albert Krewinkel, #2991).
101+ Partial functions like `head` lead to avoidable errors and should be
102+ avoided. They are replaced with total functions.
103+ + Support figure labels (Albert Krewinkel, #2496, #2999).
104+ Figure labels given as `#+LABEL: thelabel` are used as the ID of the
105+ respective image. This allows e.g. the LaTeX to add proper `\label`
106+ markup.
107+ + Improve tag and properties type safety (Albert Krewinkel).
108+ Specific newtype definitions are used to replace stringly typing of tags
109+ and properties. Type safety is increased while readability is improved.
110+ + Parse as headlines, convert to blocks (Albert Krewinkel).
111+ Emacs org-mode is based on outline-mode, which treats documents as trees
112+ with headlines are nodes. The reader is refactored to parse into a
113+ similar tree structure. This simplifies transformations acting on
114+ document (sub-)trees.
115+ * Refactor comment tree handling (Albert Krewinkel).
116+ Comment trees were handled after parsing, as pattern matching on lists
117+ is easier than matching on sequences. The new method of reading
118+ documents as trees allows for more elegant subtree removal.
119+ * Support archived trees export options (Albert Krewinkel).
120+ Handling of archived trees can be modified using the `arch` option.
121+ Archived trees are either dropped, exported completely, or collapsed to
122+ include just the header when the `arch` option is nil, non-nil, or
123+ `headline`, respectively.
124+ * Put export setting parser into module (Albert Krewinkel).
125+ Export option parsing is distinct enough from general block parsing to
126+ justify putting it into a separate module.
127+ * Support headline levels export setting (Albert Krewinkel).
128+ The depths of headlines can be modified using the `H` option. Deeper
129+ headlines will be converted to lists.
130+ * Replace ugly code with view pattern (Albert Krewinkel).
131+ Some less-than-smart code required a pragma switching of overlapping
132+ pattern warnings in order to compile seamlessly. Using view patterns
133+ makes the code easier to read and also doesn't require overlapping
134+ pattern checks to be disabled.
135+ * Fix parsing of verbatim inlines (Albert Krewinkel, #3016).
136+ Org rules for allowed characters before or after markup chars were not
137+ checked for verbatim text. This resultet in wrong parsing outcomes of
138+ if the verbatim text contained e.g. space enclosed markup characters as
139+ part of the text (`=is_substr = True=`). Forcing the parser to update
140+ the positions of allowed/forbidden markup border characters fixes this.
141+
142+ * LaTeX template: fix for obscure hyperref/xelatex issue.
143+ Here's a minimal case:
144+
145+ \documentclass[]{article}
146+ \usepackage{hyperref}
147+ \begin{document}
148+ \section{\%á}
149+ \end{document}
150+
151+ Without this change, this fails on the second invocation of xelatex.
152+ This affects inputs this like `# %á` with pdf output via xelatex.
153+
154+ * trypandoc: call results 'html' instead of 'result'.
155+ This is for better compatibility with babelmark2.
156+
157+ * Document MultiMarkdown as input/output format (Albert Krewinkel, #2973).
158+ MultiMarkdown was only mentioned as a supported Markdown dialect but not
159+ as a possible input or output format. A brief mention is added
160+ everywhere the other supported markdown dialects are mentioned.
161+
162+ * Document Org mode as a format containing raw HTML (Albert Krewinkel)
163+ Raw HTML is kept when the output format is Emacs Org mode.
164+
165+ * Implement `RawInline` and `RawBlock` in sample lua custom writer (#2985).
166+
167+ * Text.Pandoc.Shared:
168+
169+ + Introduce blocksToInlines function (Jesse Rosenthal).
170+ This is a lossy function for converting `[Block] -> [Inline]`. Its main
171+ use, at the moment, is for docx comments, which can contain arbitrary
172+ blocks (except for footnotes), but which will be converted to spans.
173+ This is, at the moment, pretty useless for everything but the basic
174+ `Para` and `Plain` comments. It can be improved, but the docx reader
175+ should probably emit a warning if the comment contains more than this.
176+ + Add BlockQuote to blocksToInlines (Jesse Rosenthal).
177+ + Add further formats for `normalizeDate` (Jesse Rosenthal).
178+ We want to avoid illegal dates -- in particular years with greater than
179+ four digits. We attempt to parse series of digits first as `%Y%m%d`, then
180+ `%Y%m`, and finally `%Y`.
181+ + `normalizeDate` should reject illegal years (Jesse Rosenthal).
182+ We only allow years between 1601 and 9999, inclusive. The ISO 8601
183+ actually says that years are supposed to start with 1583, but MS Word
184+ only allows 1601-9999. This should stop corrupted word files if the date
185+ is out of that range, or is parsed incorrectly.
186+ + Improve year sanity check in normalizeDate (Jesse Rosenthal).
187+ Previously we parsed a list of dates, took the first one, and then
188+ tested its year range. That meant that if the first one failed, we
189+ returned nothing, regardless of what the others did. Now we test for
190+ sanity before running `msum` over the list of Maybe values. Anything
191+ failing the test will be Nothing, so will not be a candidate.
192+
193+ * Docx reader:
194+
195+ + Add simple comment functionality. (Jesse Rosenthal).
196+ This adds simple track-changes comment parsing to the docx reader. It is
197+ turned on with `--track-changes=all`. All comments are converted to
198+ inlines, which can list some information. In the future a warning will be
199+ added for comments with formatting that seems like it will be excessively
200+ denatured. Note that comments can extend across blocks. For that reason
201+ there are two spans: `comment-start` and `comment-end`. `comment-start`
202+ will contain the comment. `comment-end` will always be empty. The two
203+ will be associated by a numeric id.
204+ + Enable warnings in top-level reader (Jesse Rosenthal).
205+ Previously we had only allowed for warnings in the parser. Now we allow
206+ for them in the `Docx.hs` as well. The warnings are simply concatenated.
207+ + Add warning for advanced comment formatting. (Jesse Rosenthal).
208+ We can't guarantee we'll convert every comment correctly, though we'll
209+ do the best we can. This warns if the comment includes something other
210+ than Para or Plain.
211+ + Add tests for warnings. (Jesse Rosenthal).
212+ + Add tests for comments (Jesse Rosenthal).
213+ We test for comments, using all track-changes options. Note that we
214+ should only output comments if `--track-changes=all`. We also test for
215+ emitting warnings if there is complicated formatting.
216+
217+ * README: update to include track-changes comments. (Jesse Rosenthal)
218+
219+ * Improved Windows installer - don't ignore properties set on command-line.
220+ See #2708. Needs testing to see if this resolves the issue.
221+ Thanks to @nkalvi.
222+
223+ * Process markdown extensions on command line in L->R order (#2995).
224+ Previously they were processed, very unintuitively, in R->L
225+ order, so that `markdown-tex_math_dollars+tex_math_dollars`
226+ had `tex_math_dollars` disabled.
227+
228+ * Added `secnumdepth` variable to LaTeX template (#2920).
229+
230+ * Include table of contents in README.html in Windows package.
231+
232+ * Writers: treat SoftBreak as space for stripping (Jesse Rosenthal)
233+ In Writers.Shared, we strip leading and trailing spaces for display
234+ math. Since SoftBreak's are treated as spaces, we should strip those
235+ too.
236+
237+ * beamer, latex templates: pass biblatexoptions directly in package load.
238+ This allows runtime optinos to be used. Fixes jgm/pandoc-citeproc#201
239+
240+ * CPP workaround for deprecation of `parseUrl` in http-client.
241+
242+ * Removed some redundant class constraints.
243+
244+ * make_oxs_package.sh - use OSX env variable.
245+
246+ * Added `winpkg` target to Makefile. This downloads the windows package
247+ from appveyor and signs it using the key.
248+
249+ * Document Org mode as a format containing raw TeX (Albert Krewinkel).
250+ Raw TeX is kept verbatim when the output format is Emacs Org mode.
251+
252+ * Support math with haddock-library >= 1.4.
253+
254+ * Removed `-rtsopts` from library stanza. It has no effect, and Hackage
255+ wouldn't accept the package.
256+
257+ * Update library dependency versions.
258+
1259pandoc (1.17.1)
2260
3261 * New output format: `docbook5` (Ivo Clarysse).