From 359ce379cc7f96c185275f7532914459edf72827 Mon Sep 17 00:00:00 2001 From: John MacFarlane <fiddlosopher@gmail.com> Date: Sun, 14 Jul 2013 16:12:28 -0700 Subject: [PATCH] Updated changelog for pending release. --- changelog | 339 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 339 insertions(+) diff --git a/changelog b/changelog index 1f96011cd..6585c3dd3 100644 --- a/changelog +++ b/changelog @@ -1,3 +1,342 @@ +[pending release 1.12] + + * `--toc-level` no longer implies `--toc`. + Reason: EPUB users who don't want a visible TOC may still want + to set the TOC level for in the book navigation. + + * `--help` now prints in and out formats in alphabetical order, and + says something about PDF output. Closes #720. + + * Less verbose output from `--self-contained`. + Now one gets "Fetching [URL]..." for each URL fetched, but not + the full header. + + * All slide formats: Support incremental slide view for definition lists. + + * Added syntax for "pauses" in beamer or reaveljs slide shows. + + This gives + + . . . + + a pause. + + [note - no longer seems to work in recente revealjs - perhaps + this should be reverted] + + * Slidy: Use slidy.js rather than slidy.js.gz. + Reason: some browsers have trouble with the gzipped js file, + at least on the local file system. Closes #795. + + * Added `revealjs` output format, for reveal.js HTML 5 slide shows. + Thanks to Jamie F. Olson for the initial patch. + Nested vertical stacks are used for hierarchical structure. + Results for more than one level of nesting may be odd. + + * Use new flexible metadata type. + + + Depend on `pandoc-types` 1.12. This changes the type of + `Meta` to allow structured metadata. (API change: existing + code that pattern-matches on `Meta` will have to be revised.) + + Revised readers and writers to use the new `Meta` type. + + Variables completely shadow metadata. + If many variables with the same name are set, a list is created. + + * `Text.Pandoc.Shared` + + + `openURL` now follows redirects. Closes #701. + + `readDefaultDataFile`: normalize the paths. + This fixes bugs in `--self-contained` on pandoc compiled with + `embed_data_files`. Closes #833. + + Fixed `readDefaultDataFile` so it works on Windows. + + URL-escape pipe characters. + Even though these are legal, `Network.URI` doesn't regard them + as legal in URLs. So we escape them first. Closes #535. + + `openURL`: Print diagnostic output to stderr, not stdout. + + `openURL`: Properly handle `data:` URIs. + + * New module `Text.Pandoc.Writers.Shared` for shared functions used + only in writers. + + + Added `metaToJSON`. This is used in writers to create a + JSON object for use in the templates from the pandoc metadata + and variables. + + Added `getField`, `setField`, `defField` for working with JSON + template contexts. + + * Added `Text.Pandoc.Asciify` utility module. + This exports functions to create ASCII-only versions of identifiers. + + * `Text.Pandoc.SelfContained` + + + Strip off fragment, query of relative URL before treating as + a filename. This fixes `--self-contained` when used with CSS + files that include web fonts using the method described here: + <http://paulirish.com/2009/bulletproof-font-face-implementation-syntax/> + Closes #739. + + Handle `src` in `embed`, `audio`, `source`, `input` tags. + + * Added `Text.Pandoc.Writers.Custom` and custom output formats. + + pandoc -t data/sample.lua + + will load the script sample.lua and use it as a custom writer. + `data/sample.lua` is provided as an example. (This can be printed + with the new `--print-custom-lua-writer` option. + + * Added OPML reader and writer. + + + New module `Text.Pandoc.Readers.OPML`. + The `_note` attribute is supported. This is unofficial, but + used e.g. in OmniOutliner and supported by multimarkdown. + We treat the contents as markdown blocks under a section + header. + + New module `Text.Pandoc.Writers.OPML`. + + * Added Haddock reader. + + + New module `Text.Pandoc.Readers.Haddock` (David Lazar). + This is based on Haddock's own lexer/parser. + + * Markdown reader + + + Properly handle blank line at beginning of input. Closes #882. + + Fixed bug in unmatched reference links. The input + `[*infile*] [*outfile*]` was getting improperly parsed: + "infile" was emphasized, but "*outfile*" was literal. Closes #883. + + Check for blank lines first in blocks. (And skip them. This + might speed things up in some cases.) + + Implemented `Ext_ascii_identifiers`. Closes #807. + + Allow internal `+` in citation identifiers. Closes #856. + + Added support for YAML metadata block at the beginning of document. + + * RST reader + + + Don't insert paragraphs where docutils doesn't. + `rst2html` doesn't add `<p>` tags to list items (even when they are + separated by blank lines) unless there are multiple paragraphs in the + list. This commit changes the RST reader to conform more closely to + what docutils does. Closes #880. + + Improved metadata. Treat initial field list as metadata when + standalone specified. Previously ALL fields "title", "author", + "date" in field lists were treated as metadata, even if not at + the beginning. Use `subtitle` metadata field for subtitle. + + Fixed 'authors' metadata parsing in reST. Semicolons separate + different authors. + + * Textile reader + + + Correctly handle entities. + + * LaTeX reader + + + Support alltt environment. Closes #892. + + Support `\textasciitilde`, `\textasciicircum`. Closes #810. + + Treat `\textsl` as emphasized text reader. Closes #850. + + Skip positional options after `\begin{figure}`. + + * LaTeX writer + + + Don't use ligatures in escaping inline code. + + Fixed footnote numbers in LaTeX/PDF tables. This fixes a bug + wherein notes were numbered incorrectly in tables. Closes #827. + + Always create labels for sections. Previously the labels were only + created when there were links to the section in the document. + Closes #871. + + Stop escaping `|` in LaTeX math. + This caused problems with array environments. Closes #891. + + * ConTeXt writer + + + Properly handle tables without captions. The old output only + worked in MkII. This should work in MkIV as well. Closes #837. + + * MediaWiki reader + + + Allow space before table rows. + + Fixed regression for `<ref>URL</ref>`. + `<` is no longer allowed in URLs, according to the uri parser + in `Text.Pandoc.Parsing`. Added a test case. + + Correctly handle indented preformatted text without preceding + or following blank line. + + Fixed `|` links inside table cells. Improved attribute parsing. + + Skip attributes on table rows. Previously we just crashed if + rows had attributes, now we ignore them. + + Ignore attributes on headers. + + * HTML writer + + + Fixed `--no-highlight` (Alexander Kondratskiy). + + Don't convert to lowercase in email obfuscation. Closes #839. + + * Man writer + + + Offer more fine-grained control in template. + Now the `title`, `section`, `header`, and `footer` can all be set + individually in metadata. The `description` variable has been + removed. Quotes have been added so that spaces are allowed in the title. + If you have a title that begins + + COMMAND(1) footer here | header here + + pandoc will parse it as before into a title, section, header, and + footer. But you can also specify these elements explicitly. + Closes #885. + + * AsciiDoc writer + + + Support `--atx-headers` (Max Rydahl Andersen). + + Don't print empty identifier blocks `([[]])` on headers (Max + Rydahl Andersen). + + * ODT writer + + + Fixing wrong numbered-list indentation in open document format + (Alexander Kondratskiy). Closes #369. + + * Docx writer + + + Fixed rendering of display math in lists. + In 1.11 and 1.11.1, display math in lists rendered as a new list + item. Now it always appears centered, just as outside of lists, + and in proper display math style, no matter how far indented the + containing list item is. Closes #784. + + Use `w:br` with `w:type` `textWrapping` for linebreaks. + Previously we used `w:cr`. Closes #873. + + Use Compact style for Plain block elements. + This differentiates between tight and loose lists. Closes #775. + + Ignore most components of `reference.docx`. + We take the `word/styles.xml`, `docProps/app.xml`, + `word/theme/theme1.xml`, and `word/fontTable.xml` from + `reference.docx`, ignoring everything else. This should help + with the corruption problems caused when different versions of + Word resave the reference.docx and reorganize things. + + Made `--no-highlight` work properly. + + * EPUB writer + + + Don't add `dc:creator` tags if present in EPUB metadata. + + Add `id="toc-title"` to `h1` in `nav.xhtml`. Closes #799. + + Don't put blank title page in reading sequence. + Set `linear="no"` if no title block. Addresses #797. + + Download webtex images and include as data URLs. + This allows you to use `--webtex` in creating EPUBs. + Math with `--webtex` is automatically made self-contained. + + In `data/epub.css`, removed highlighting styles (which + are no longer needed, since styles are added by the HTML + writer according to `--highlighting-style`). Simplified + margin fields. + + * Markdown writer + + + Allow simple tables to be printed as grid tables, + if other table options are disabled. This means you can do + `pandoc -t markdown-pipe_tables-simple_tables-multiline_tables` + and all tables will render as grid tables. + + Put multiple authors on separate lines in pandoc titleblock. + Also, don't wrap long author entries, as new lines get treated + as new authors. + + Only autolink absolute URIs. This fixes a regression, #830. + + Don't wrap attributes in fenced code blocks. + + Support YAML title block (render fields in alphabetical order + to make output predictable). + + Write full metadata in MMD style title blocks. + + * RTF writer + + + Properly handle characters above the 0000-FFFF range. + Uses surrogate pairs. Thanks to Hiromi Ishii for the patch. + + Fixed regression with RTF table of contents. + + Only autolink absolute URIs. This fixes a regression, #830. + + * `Text.Pandoc.PDF` + + + On Windows, create temdir in working directory. + Reason: the path to the system temp directory may contain tildes, + which causes problems in LaTeX when the username is more than + eight characters. Closes #777. + + * `Text.Pandoc.UTF8` + + + Use strict bytestrings in reading. The use of lazy bytestrings seemed + to cause problems using pandoc on 64-bit Windows 7/8. Closes #874. + + * `Text.Pandoc.Parsing` + + + Further improvements to URI parser. + Don't treat punctuation before percent-encoding as final punctuation. + Don't treat '+' as final punctuation. + + Generalized state type on `readWith` (API change). + + Specialize readWith to `String` input. + + Better error reporting in `readWith`: On error have it print the line + in which the error occurred, with a caret pointing to the column. + + In `ParserState`, replace `stateTitle`, `stateAuthors`, `stateDate` + with `stateMeta`. + + * `Text.Pandoc.XML` + + + Removed `stripTags`. (API change.) + + * `Text.Pandoc.Options` + + + Added `Ext_yaml_metadata_block`. (API change.) + + Added `Ext_ascii_identifiers`. (API change.) + This will force `Ext_auto_identifiers` to use ASCII only. + Set as default for github markdown. + + * `Text.Pandoc.Templates` + + + Changed type of `renderTemplate`: it now takes a JSON context + and a compiled template. (API change.) + + Export `compileTemplate`. (API change.) + + Export `renderTemplate'` that takes a string instead of a compiled + template. (API change.) + + Export `varListToJSON`. (API change.) + + Removed `Empty`. + + Simplified `Template` type to a newtype. + + Templates can now contain "record lookups" in variables; + for example, `author.institution` will retrieve the `institution` + field of the `author` variable. + + Fixed bug retrieving default template for markdown variants. + + * Default template changes + + + DocBook: Use DocBook 4.5 doctype. + + Org: '#+TITLE:' is inserted before the title. + Previously the writer did this. + + LaTeX: Changes to make mathfont work with xelatex. + We need the mathspec library, not just fontspec, for this. + We also need to set options for setmathfont. Closes #734. + + LaTeX: Use `tex-ansi` mapping for `monofont`. + This ensures that straight quotes appear as straight, rather than + being treated as curly. See #889. + + Made `\includegraphics` more flexible in LaTeX template. + Now it can be used with options, if needed. Thanks to Bernhard Weichel. + + DZSlides: title attribute on title section. + + * Removed `blaze_html_0_5` flag, require `blaze-html` >= 0.5. + Reason: < 0.5 does not provide a monoid instance for Attribute, + which is now needed by the HTML writer. + Closes #803. + + * Added `http-conduit` flag, which allows fetching https resources. + It also brings in a large number of dependencies (`http-conduit` + and its dependencies), which is why for now it is an optional flag. + Closes #820. + + * Added CONTRIBUTING.md. + + * Use latest `chicago-author-date.csl` as `default.csl`. + + * `make-windows-installer.bat`: Removed explicit paths for executables. + + * `aeson` is now used instead of `json` for JSON. + + * Set default stack size to 16M. This is needed for some large + conversions, esp. if pandoc is compiled with 64-bit ghc. + + + pandoc (1.11.1) * Markdown reader: