@@ -1,3 +1,342 @@
1+[pending release 1.12]
2+
3+ * `--toc-level` no longer implies `--toc`.
4+ Reason: EPUB users who don't want a visible TOC may still want
5+ to set the TOC level for in the book navigation.
6+
7+ * `--help` now prints in and out formats in alphabetical order, and
8+ says something about PDF output. Closes #720.
9+
10+ * Less verbose output from `--self-contained`.
11+ Now one gets "Fetching [URL]..." for each URL fetched, but not
12+ the full header.
13+
14+ * All slide formats: Support incremental slide view for definition lists.
15+
16+ * Added syntax for "pauses" in beamer or reaveljs slide shows.
17+
18+ This gives
19+
20+ . . .
21+
22+ a pause.
23+
24+ [note - no longer seems to work in recente revealjs - perhaps
25+ this should be reverted]
26+
27+ * Slidy: Use slidy.js rather than slidy.js.gz.
28+ Reason: some browsers have trouble with the gzipped js file,
29+ at least on the local file system. Closes #795.
30+
31+ * Added `revealjs` output format, for reveal.js HTML 5 slide shows.
32+ Thanks to Jamie F. Olson for the initial patch.
33+ Nested vertical stacks are used for hierarchical structure.
34+ Results for more than one level of nesting may be odd.
35+
36+ * Use new flexible metadata type.
37+
38+ + Depend on `pandoc-types` 1.12. This changes the type of
39+ `Meta` to allow structured metadata. (API change: existing
40+ code that pattern-matches on `Meta` will have to be revised.)
41+ + Revised readers and writers to use the new `Meta` type.
42+ + Variables completely shadow metadata.
43+ If many variables with the same name are set, a list is created.
44+
45+ * `Text.Pandoc.Shared`
46+
47+ + `openURL` now follows redirects. Closes #701.
48+ + `readDefaultDataFile`: normalize the paths.
49+ This fixes bugs in `--self-contained` on pandoc compiled with
50+ `embed_data_files`. Closes #833.
51+ + Fixed `readDefaultDataFile` so it works on Windows.
52+ + URL-escape pipe characters.
53+ Even though these are legal, `Network.URI` doesn't regard them
54+ as legal in URLs. So we escape them first. Closes #535.
55+ + `openURL`: Print diagnostic output to stderr, not stdout.
56+ + `openURL`: Properly handle `data:` URIs.
57+
58+ * New module `Text.Pandoc.Writers.Shared` for shared functions used
59+ only in writers.
60+
61+ + Added `metaToJSON`. This is used in writers to create a
62+ JSON object for use in the templates from the pandoc metadata
63+ and variables.
64+ + Added `getField`, `setField`, `defField` for working with JSON
65+ template contexts.
66+
67+ * Added `Text.Pandoc.Asciify` utility module.
68+ This exports functions to create ASCII-only versions of identifiers.
69+
70+ * `Text.Pandoc.SelfContained`
71+
72+ + Strip off fragment, query of relative URL before treating as
73+ a filename. This fixes `--self-contained` when used with CSS
74+ files that include web fonts using the method described here:
75+ <http://paulirish.com/2009/bulletproof-font-face-implementation-syntax/>
76+ Closes #739.
77+ + Handle `src` in `embed`, `audio`, `source`, `input` tags.
78+
79+ * Added `Text.Pandoc.Writers.Custom` and custom output formats.
80+
81+ pandoc -t data/sample.lua
82+
83+ will load the script sample.lua and use it as a custom writer.
84+ `data/sample.lua` is provided as an example. (This can be printed
85+ with the new `--print-custom-lua-writer` option.
86+
87+ * Added OPML reader and writer.
88+
89+ + New module `Text.Pandoc.Readers.OPML`.
90+ The `_note` attribute is supported. This is unofficial, but
91+ used e.g. in OmniOutliner and supported by multimarkdown.
92+ We treat the contents as markdown blocks under a section
93+ header.
94+ + New module `Text.Pandoc.Writers.OPML`.
95+
96+ * Added Haddock reader.
97+
98+ + New module `Text.Pandoc.Readers.Haddock` (David Lazar).
99+ This is based on Haddock's own lexer/parser.
100+
101+ * Markdown reader
102+
103+ + Properly handle blank line at beginning of input. Closes #882.
104+ + Fixed bug in unmatched reference links. The input
105+ `[*infile*] [*outfile*]` was getting improperly parsed:
106+ "infile" was emphasized, but "*outfile*" was literal. Closes #883.
107+ + Check for blank lines first in blocks. (And skip them. This
108+ might speed things up in some cases.)
109+ + Implemented `Ext_ascii_identifiers`. Closes #807.
110+ + Allow internal `+` in citation identifiers. Closes #856.
111+ + Added support for YAML metadata block at the beginning of document.
112+
113+ * RST reader
114+
115+ + Don't insert paragraphs where docutils doesn't.
116+ `rst2html` doesn't add `<p>` tags to list items (even when they are
117+ separated by blank lines) unless there are multiple paragraphs in the
118+ list. This commit changes the RST reader to conform more closely to
119+ what docutils does. Closes #880.
120+ + Improved metadata. Treat initial field list as metadata when
121+ standalone specified. Previously ALL fields "title", "author",
122+ "date" in field lists were treated as metadata, even if not at
123+ the beginning. Use `subtitle` metadata field for subtitle.
124+ + Fixed 'authors' metadata parsing in reST. Semicolons separate
125+ different authors.
126+
127+ * Textile reader
128+
129+ + Correctly handle entities.
130+
131+ * LaTeX reader
132+
133+ + Support alltt environment. Closes #892.
134+ + Support `\textasciitilde`, `\textasciicircum`. Closes #810.
135+ + Treat `\textsl` as emphasized text reader. Closes #850.
136+ + Skip positional options after `\begin{figure}`.
137+
138+ * LaTeX writer
139+
140+ + Don't use ligatures in escaping inline code.
141+ + Fixed footnote numbers in LaTeX/PDF tables. This fixes a bug
142+ wherein notes were numbered incorrectly in tables. Closes #827.
143+ + Always create labels for sections. Previously the labels were only
144+ created when there were links to the section in the document.
145+ Closes #871.
146+ + Stop escaping `|` in LaTeX math.
147+ This caused problems with array environments. Closes #891.
148+
149+ * ConTeXt writer
150+
151+ + Properly handle tables without captions. The old output only
152+ worked in MkII. This should work in MkIV as well. Closes #837.
153+
154+ * MediaWiki reader
155+
156+ + Allow space before table rows.
157+ + Fixed regression for `<ref>URL</ref>`.
158+ `<` is no longer allowed in URLs, according to the uri parser
159+ in `Text.Pandoc.Parsing`. Added a test case.
160+ + Correctly handle indented preformatted text without preceding
161+ or following blank line.
162+ + Fixed `|` links inside table cells. Improved attribute parsing.
163+ + Skip attributes on table rows. Previously we just crashed if
164+ rows had attributes, now we ignore them.
165+ + Ignore attributes on headers.
166+
167+ * HTML writer
168+
169+ + Fixed `--no-highlight` (Alexander Kondratskiy).
170+ + Don't convert to lowercase in email obfuscation. Closes #839.
171+
172+ * Man writer
173+
174+ + Offer more fine-grained control in template.
175+ Now the `title`, `section`, `header`, and `footer` can all be set
176+ individually in metadata. The `description` variable has been
177+ removed. Quotes have been added so that spaces are allowed in the title.
178+ If you have a title that begins
179+
180+ COMMAND(1) footer here | header here
181+
182+ pandoc will parse it as before into a title, section, header, and
183+ footer. But you can also specify these elements explicitly.
184+ Closes #885.
185+
186+ * AsciiDoc writer
187+
188+ + Support `--atx-headers` (Max Rydahl Andersen).
189+ + Don't print empty identifier blocks `([[]])` on headers (Max
190+ Rydahl Andersen).
191+
192+ * ODT writer
193+
194+ + Fixing wrong numbered-list indentation in open document format
195+ (Alexander Kondratskiy). Closes #369.
196+
197+ * Docx writer
198+
199+ + Fixed rendering of display math in lists.
200+ In 1.11 and 1.11.1, display math in lists rendered as a new list
201+ item. Now it always appears centered, just as outside of lists,
202+ and in proper display math style, no matter how far indented the
203+ containing list item is. Closes #784.
204+ + Use `w:br` with `w:type` `textWrapping` for linebreaks.
205+ Previously we used `w:cr`. Closes #873.
206+ + Use Compact style for Plain block elements.
207+ This differentiates between tight and loose lists. Closes #775.
208+ + Ignore most components of `reference.docx`.
209+ We take the `word/styles.xml`, `docProps/app.xml`,
210+ `word/theme/theme1.xml`, and `word/fontTable.xml` from
211+ `reference.docx`, ignoring everything else. This should help
212+ with the corruption problems caused when different versions of
213+ Word resave the reference.docx and reorganize things.
214+ + Made `--no-highlight` work properly.
215+
216+ * EPUB writer
217+
218+ + Don't add `dc:creator` tags if present in EPUB metadata.
219+ + Add `id="toc-title"` to `h1` in `nav.xhtml`. Closes #799.
220+ + Don't put blank title page in reading sequence.
221+ Set `linear="no"` if no title block. Addresses #797.
222+ + Download webtex images and include as data URLs.
223+ This allows you to use `--webtex` in creating EPUBs.
224+ Math with `--webtex` is automatically made self-contained.
225+ + In `data/epub.css`, removed highlighting styles (which
226+ are no longer needed, since styles are added by the HTML
227+ writer according to `--highlighting-style`). Simplified
228+ margin fields.
229+
230+ * Markdown writer
231+
232+ + Allow simple tables to be printed as grid tables,
233+ if other table options are disabled. This means you can do
234+ `pandoc -t markdown-pipe_tables-simple_tables-multiline_tables`
235+ and all tables will render as grid tables.
236+ + Put multiple authors on separate lines in pandoc titleblock.
237+ Also, don't wrap long author entries, as new lines get treated
238+ as new authors.
239+ + Only autolink absolute URIs. This fixes a regression, #830.
240+ + Don't wrap attributes in fenced code blocks.
241+ + Support YAML title block (render fields in alphabetical order
242+ to make output predictable).
243+ + Write full metadata in MMD style title blocks.
244+
245+ * RTF writer
246+
247+ + Properly handle characters above the 0000-FFFF range.
248+ Uses surrogate pairs. Thanks to Hiromi Ishii for the patch.
249+ + Fixed regression with RTF table of contents.
250+ + Only autolink absolute URIs. This fixes a regression, #830.
251+
252+ * `Text.Pandoc.PDF`
253+
254+ + On Windows, create temdir in working directory.
255+ Reason: the path to the system temp directory may contain tildes,
256+ which causes problems in LaTeX when the username is more than
257+ eight characters. Closes #777.
258+
259+ * `Text.Pandoc.UTF8`
260+
261+ + Use strict bytestrings in reading. The use of lazy bytestrings seemed
262+ to cause problems using pandoc on 64-bit Windows 7/8. Closes #874.
263+
264+ * `Text.Pandoc.Parsing`
265+
266+ + Further improvements to URI parser.
267+ Don't treat punctuation before percent-encoding as final punctuation.
268+ Don't treat '+' as final punctuation.
269+ + Generalized state type on `readWith` (API change).
270+ + Specialize readWith to `String` input.
271+ + Better error reporting in `readWith`: On error have it print the line
272+ in which the error occurred, with a caret pointing to the column.
273+ + In `ParserState`, replace `stateTitle`, `stateAuthors`, `stateDate`
274+ with `stateMeta`.
275+
276+ * `Text.Pandoc.XML`
277+
278+ + Removed `stripTags`. (API change.)
279+
280+ * `Text.Pandoc.Options`
281+
282+ + Added `Ext_yaml_metadata_block`. (API change.)
283+ + Added `Ext_ascii_identifiers`. (API change.)
284+ This will force `Ext_auto_identifiers` to use ASCII only.
285+ Set as default for github markdown.
286+
287+ * `Text.Pandoc.Templates`
288+
289+ + Changed type of `renderTemplate`: it now takes a JSON context
290+ and a compiled template. (API change.)
291+ + Export `compileTemplate`. (API change.)
292+ + Export `renderTemplate'` that takes a string instead of a compiled
293+ template. (API change.)
294+ + Export `varListToJSON`. (API change.)
295+ + Removed `Empty`.
296+ + Simplified `Template` type to a newtype.
297+ + Templates can now contain "record lookups" in variables;
298+ for example, `author.institution` will retrieve the `institution`
299+ field of the `author` variable.
300+ + Fixed bug retrieving default template for markdown variants.
301+
302+ * Default template changes
303+
304+ + DocBook: Use DocBook 4.5 doctype.
305+ + Org: '#+TITLE:' is inserted before the title.
306+ Previously the writer did this.
307+ + LaTeX: Changes to make mathfont work with xelatex.
308+ We need the mathspec library, not just fontspec, for this.
309+ We also need to set options for setmathfont. Closes #734.
310+ + LaTeX: Use `tex-ansi` mapping for `monofont`.
311+ This ensures that straight quotes appear as straight, rather than
312+ being treated as curly. See #889.
313+ + Made `\includegraphics` more flexible in LaTeX template.
314+ Now it can be used with options, if needed. Thanks to Bernhard Weichel.
315+ + DZSlides: title attribute on title section.
316+
317+ * Removed `blaze_html_0_5` flag, require `blaze-html` >= 0.5.
318+ Reason: < 0.5 does not provide a monoid instance for Attribute,
319+ which is now needed by the HTML writer.
320+ Closes #803.
321+
322+ * Added `http-conduit` flag, which allows fetching https resources.
323+ It also brings in a large number of dependencies (`http-conduit`
324+ and its dependencies), which is why for now it is an optional flag.
325+ Closes #820.
326+
327+ * Added CONTRIBUTING.md.
328+
329+ * Use latest `chicago-author-date.csl` as `default.csl`.
330+
331+ * `make-windows-installer.bat`: Removed explicit paths for executables.
332+
333+ * `aeson` is now used instead of `json` for JSON.
334+
335+ * Set default stack size to 16M. This is needed for some large
336+ conversions, esp. if pandoc is compiled with 64-bit ghc.
337+
338+
339+
1340pandoc (1.11.1)
2341
3342 * Markdown reader: