From e1cc5479c07b400b6ed5efb1ef005ab53800601e Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Fri, 8 Aug 2014 20:26:38 -0700 Subject: Updated changelog. --- changelog | 165 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 158 insertions(+), 7 deletions(-) (limited to 'changelog') diff --git a/changelog b/changelog index 045378d5c..2c030a9e5 100644 --- a/changelog +++ b/changelog @@ -1,9 +1,38 @@ pandoc (1.13) - * Added Docx reader (API change) (Jesse Rosenthal). + * Added Docx reader (API change) (Jesse Rosenthal). Includes conversion + of Word equations to latex in pandoc `Math` elements. Note that metadata + is taken from paragraphs at the beginning styled with `Author`, + `Title`, `Subtitle`, `Date`, and `Abstract`. + + * Added EPUB reader (API change) (Matthew Pickering). Includes conversion + of MathML math to latex in pandoc `Math` elements. + + * Added txt2tags reader (Matthew Pickering). Txt2tags is a lightweight + markup format described at . + + * Added `--extract-media` option to extract media contained in a zip + container (docx or epub) while adjusting image paths to point to the + extracted images. + + * Added module `Text.Pandoc.MediaBag`, exporting `MediaBag`, `lookupMedia`, + `insertMedia`, `mediaDirectory`, `extractMediaBag`. The docx and epub + readers return a pair of a `Pandoc` document and a `MediaBag` with + the media resources they contain. This can be extracted using + `--extract-media`. Writers that incorporate media (PDF, Docx, + ODT, EPUB, RTF, or HTML formats with `--self-contained`) will look + for resources in the `MediaBag` generated by the reader, in addition to + the file system or web. * Markdown reader: + + Changed behavior of the `markdown_attribute` extension, to bring + it in line with PHP markdown extra and multimarkdown. Setting + `markdown="1"` on an outer tag affects all contained tags, + recursively, until it is reversed with `markdown="0"` (#1378). + + Fixed small bug in HTML parsing with `markdown_attribute`, which + caused incorrect tag nesting for input like + ``. + Fixed regression with intraword underscores (#1121). + Slight rewrite of `enclosure`/`emphOrStrong` code. + Revamped raw HTML block parsing in markdown (#1330). @@ -58,6 +87,12 @@ pandoc (1.13) * HTML reader: adjust `blockTags` and `eitherBlockOrInline`. + + Parse `div` and `span` elements even without `--parse-raw`. + Motivation: these now generate native pandoc Div and Span + elements, not raw HTML. + + Parse EPUB-specific elements if the `epub_html_exts` + extension is enabled. These include `switch`, `footnote`, + `rearnote`, `noteref`. + Added `audio` and `source` in `eitherBlockOrInline`. + Moved `video`, `svg`, `progress`, `script`, `noscript`, `svg` from `blockTags` to `eitherBlockOrInline`. @@ -69,6 +104,7 @@ pandoc (1.13) We let a `` tag close an open `` or `` (#1167). + Support `--trace`. + Allow space between `` and ``. + + Ignore `DOCTYPE` and `xml` declarations. * Rewrote Haddock reader to use `haddock-library` (#1346). @@ -79,13 +115,18 @@ pandoc (1.13) * MediaWiki reader: + + Don't parse backslash escapes inside `` (#1445). + Tightened up template parsing. The opening `{{` must be followed by an alphanumeric or `:`. This prevents the exponential slowdown in #1033. + Support `--trace`. + + Support "Bild" for images. * DocBook reader: + + Better handle elements inside code environments. Pandoc's document + model does not allow structure inside code blocks, but at least this way + we preserve the text (#1449). + Support `` (#1236). Note, this is a bit of a kludge, to work around the fact that xml-light doesn't parse `` correctly. We preprocess the input, @@ -121,6 +162,8 @@ pandoc (1.13) * EPUB writer: + + Avoid excess whitespace in `nav.xhtml`. This should improve + TOC view in iBooks (#1392). + Fixed regression on cover image. In 1.12.4 and 1.12.4.2, the cover image would not appear properly, because the metadata id was not correct. Now we derive the id from the @@ -138,6 +181,7 @@ pandoc (1.13) * LaTeX writer: + + Use `\(..\)` instead of `$..$` for inline math (#1464). + Use `\nolinkurl` in email autolinks. This allows them to be styled using `\urlstyle{tt}`. Thanks to Ulrike Fischer for the solution. + Use `\textquotesingle` for `'` in inline code. Otherwise we get @@ -149,7 +193,11 @@ pandoc (1.13) + Put table captions above tables, to match the conventional standard. (Previously they appeared below tables.) - * RTF writer: Avoid extra paragraph tags in metadata (#1421). + * RTF writer: + + + Improved image embedding: `fetchItem'` is now used to get the + images, and calculated image sizes are indicated in the RTF. + + Avoid extra paragraph tags in metadata (#1421). * HTML writer: @@ -166,15 +214,38 @@ pandoc (1.13) * Markdown writer: + + Updated definition lists, so they match the current markdown reader's + behavior. (Thus, they match PHP markdown extra, and a blank line is + always used between items.) The old behavior + can be activated with the `compact_definition_lists` extension. + + Horizontal rules are now a line across the whole page. + + Avoid wrapping that might start a list, blockquote, or header (#1013). + Use span with style for `SmallCaps` (#1360). + Use Span instead of (hackish) `SmallCaps` in `plainify`. + Don't use braced attributes for fenced code (#1416). If `Ext_fenced_code_attributes` is not set, the first class attribute will be printed after the opening fence as a bare word. + Prettier pipe tables. Columns are now aligned (#1323). + + Respect the `raw_html` extension. `pandoc -t markdown-raw_html` + no longer emits any raw HTML, including span and div tags + generated by Span and Div elements. + + Separate adjacent lists of the same kind with an HTML comment (#1458). + + * Plain writer: Revised output, largely following the style of Project + Gutenberg. + + + Emphasis is rendered with `_underscores_`, strong emphasis + with ALL CAPS. + + Headings are rendered differently, with space to set them off, + not with setext style underlines. Level 1 headers are ALL CAPS. + + Math is rendered using unicode when possible, but without the + distracting emphasis markers around variables. + + Footnotes use a regular `[n]` style. + + Added tests. * PDF writer: + + Moved `withTempDir` to `Text.Pandoc.Shared`, which now exports it. + Fixed treatment of data uris for images (#1062). * Docx writer: @@ -197,6 +268,14 @@ pandoc (1.13) + Section numbering carries over from reference.docx (#1305). + Simplified `abstractNumId` numbering. Instead of sequential numbering, we assign numbers based on the list marker styles. + + Include abstract (if present) with `Abstract` style (#1451). + + Include subtitle (if present) with `Subtitle` style, rather + than tacking it on to the title (#1451). + + * Org writer: + + + Write empty span elements with an id attribute as org anchors. + For example `Span ("uid",[],[]) []` becomes `<>`. * Custom lua writers: @@ -215,14 +294,30 @@ pandoc (1.13) * `Text.Pandoc.Highlighting`: Let `.numberLines` work even if no language is given (#1287, jgm/highlighting-kate#40). + * `Text.Pandoc.Pretty`: Added `blanklines`, which guarantees a certain + number of blank lines (and no more). * `Text.Pandoc.Shared`: + + Added `fetchItem'`, which works like `fetchItem` but searches + a `MediaBag` before looking on the net or file system. + + Added `withTempDir` (API change). + `fetchItem`: unescape URI encoding before reading local file (#1427). + + `fetchItem`: strip a fragment like `?#iefix` from the extension before + doing mime lookup, to improve mime type guessing. + + Improved log of `fetchItem`: absolute URIs are fetched from the net; + other things are treated as relative URIs if `sourceURL` is `Just _`, + otherwise as file paths on the local file system. + + `fetchItem` now properly handles links without a protocol (#1477). + + `fetchItem` now escapes characters not allowed in URIs before trying + to parse the URIs. + Added `removeFormatting` (API change). + Added `extractSpaces` (from HTML reader) and generalized its type so that it can be used by the docx reader (Matthew Pickering). + Added `ordNub` (API change). + + Fixed runtime error with `compactify'DL` on certain lists (#1452). + + Added `capitalize` (Artyom Kazak), and replaced uses of + `map toUpper` (which give bad results for many languages). * `Text.Pandoc.Templates`: @@ -235,18 +330,41 @@ pandoc (1.13) * `Text.Pandoc.Options`: + + Added `writerMediaBag` to `WriterOptions` (API change). + + Removed deprecated and no longer used `readerStrict` in + `ReaderOptions`. This is handled by `readerExtensions` now + (API change). + Removed `Ext_fenced_code_attributes` from `markdown_github` - extensions. - + Added `Ext_compact_definition_lists`. + extensions (API change)`. + + Added `Ext_compact_definition_lists` (API change). + + Added `Ext_epub_html_exts` (API change). * `Text.Pandoc.Parsing` + + Generalized `readWith` to `readWithM` (Matthew Pickering) (API change). + + Export `runParserT` and `Stream` (Matthew Pickering). + + Added `HasQuoteContext` type class (Matthew Pickering). + + Generalized types of `mathInline`, `smartPunctuation`, `quoted`, + `singleQuoted`, `doubleQuoted`, `failIfInQuoteContext`, + `applyMacros` (Matthew Pickering). + + Added custom `token` (Matthew Pickering). + Simplified `dash` and `ellipsis` (#1419). + Removed `(>>~)` in favor of the equivalent `(<*)` (Matthew Pickering). + Generalized functions to use `ParsecT` (Matthew Pickering). + Added `stateInHtmlBlock` to `ParserState`. This is used to keep track of the ending tag we're waiting for when we're parsing inside HTML block tags. (API change.) + + Added `stateMarkdownAttribute` to `ParserState`. This is used + to keep track of whether the markdown attribute has been set in + an enclosing tag. (API change.) + + Added `isbn` and `pmid` to list of recognized schemes (Matthew + Pickering). + + * Added `Text.Pandoc.Compat.Directory` to allow building against + different versions of the `directory` library. + + + Added `Text.Pandoc.Compat.Except` to allow building against + different verions of `mtl`. * Templates: @@ -255,6 +373,10 @@ pandoc (1.13) be "advisory" in HTML5, but kindlegen seems to require them. + LaTeX: Made `\subtitle` work properly (#1327). + LaTeX/Beamer: remove conditional around date (#1321). + + LaTeX: Added `lot` and `lof` variables, which can be set to + get `\listoftables` and `\listoffigures` (#1407). Note that + these variables can be set at the command line with `-Vlot -Vlof` + or in YAML metadata. * Code cleanup in some writers, using Reader monad to avoid passing options parameter around (Matej Kollar). @@ -280,8 +402,13 @@ pandoc (1.13) * Avoid `import Prelude hiding (catch)` (#1309, thanks to Michael Thompson). + * Don't strip path off of `writerSourceURL`: the path is needed to + resolve relative URLs when we fetch resources (#750). + * README: + + Made headers for all extensions so they have IDs and can be linked + to (Beni Cherniavsky-Paskin). + Fixed typos (Phillip Alday). + Fixed documentation of attributes (#1315). + Clarified documentation on small caps (#1360). @@ -300,10 +427,24 @@ pandoc (1.13) ocaml and fsharp. * Require latest `texmath`. This fixes `\tilde{E}` and allows - `\left` to be used with `]`, `)` etc. (#1319). + `\left` to be used with `]`, `)` etc. (#1319), among many other + improvements. + + * Improved readability in `pandoc.hs`. + + * Miscellaneous code cleanups (Artyom Kazak). * Require latest `zip-archive`. This has fixes for unicode path names. + * Benchmarks: + + + Made benchmarks compile again (Artyom Kazak). + + Fixed so that the failure of one benchmark does not prevent others + from running (Artyom Kazak). + + Use `nfIO` instead of the `getLength` trick to force full evaluation. + + Changed benchmark to use only the test suite, so that benchmarks + run more quickly. + * Windows build script: + Add `-windows` to file name. @@ -425,6 +566,10 @@ pandoc (1.12.4) + Implemented correct parsing rules for inline markup (#1175, Matthew Pickering). + Use Builder (Matthew Pickering). + + Fixed list parsing bug (#1500). + + Don't allow inline formatting to extend over newlines. + This matches the behavior of RedCarpet, avoids some ugly bugs, + and improves performance. * DocBook reader: @@ -570,8 +715,14 @@ pandoc (1.12.4) in your template, the word `true` will appear, which may be unexpected. (Previously nothing would appear.) - * `Text.Pandoc.SelfContained`: Handle `poster` attribute in `video` - tags (#1188). + * `Text.Pandoc.SelfContained`: + + + `mkSelfContained` now takes just two arguments, `WriterOptions` and + the string. + * It no longer looks in data files. This only made sense when we + had copies of slidy and S5 code there. + * `fetchItem'` is used instead of the nearly duplicate `getItem`. + + Handle `poster` attribute in `video` tags (#1188). * `Text.Pandoc.Parsing`: -- cgit v1.2.3