From b9e377e328e9c1d2d5c8a9fcb016654ba3a05a61 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Sat, 24 Jul 2010 10:13:09 -0700 Subject: [PATCH] Revised format of changelog to match release announcement. --- changelog | 277 ++++++++++++++++--------------------- relann1.6 | 403 ++++++++++++++++++++---------------------------------- 2 files changed, 271 insertions(+), 409 deletions(-) diff --git a/changelog b/changelog index 8a05b35ed..b998f7641 100644 --- a/changelog +++ b/changelog @@ -2,193 +2,158 @@ pandoc (1.6) [ John MacFarlane ] - * Added a slidy writer. Resolves Issue #122. + * New EPUB and HTML Slidy writers. (Issue #122) - * Made a proper ODT writer. - + Transformed the old Text.Pandoc.ODT module into a proper - writer module, Text.Pandoc.Writers.ODT. - + Instead of saveOpenDocumentAsODT, we now have writeODT, which - takes a Pandoc document and produces a bytestring. - saveOpenDocumentAsODT has been removed. - + To extract the images and insert them into the ODT, we now use - processPandocM on the Pandoc document rather than a custom XML parser. - + Handle the case where the image is remote (or not found) by - converting the Image element into an Emph with the label. - + Plumbing in pandoc.hs changed slightly to accomodate this, and to - allow other writers that live in the IO monad. + - EPUB is a standard ebook format, used in Apple's iBooks for + the iPad and iPhone, Barnes and Noble's nook reader, the Sony + reader, and many other devices. + - Slidy, like S5, is a system for producing HTML+javascript slide + shows. - * Added an EPUB writer. - + New writer module Text.Pandoc.Writers.EPUB - + Stylesheet in epub.css - + --epub-stylesheet command-line option. - + New utility module Text.Pandoc.UUID to generate - random UUIDs for EPUBs. - + Added writerEPUBMetadata field and --epub-metadata option. + * All input is assumed to be UTF-8, no matter what the locale and ghc + version, and all output is UTF-8. This reverts to pre-1.5 behavior. + Also, a BOM, if present, is stripped from the input. - * Moved Pandoc prettyprinting code from Shared to new Native writer. - + Text.Pandoc.Writers.Native - + The function prettyPandoc is now gone. Use writeNative instead. + * Markdown now supports grid tables, whose cells can contain + arbitrary block elements. (Issue #43) - * Added --section-divs option. Header identifiers now get attached to - the headers, unless --section-divs is specified, in which case they - are added to enclosing divs. By default, the divs are not added. - Resolves Issue #230, #239. + * Sequentially numbered example lists in markdown with `@` marker. - * Added --webtex option for HTML math. - + Added --webtex command-line option, with optional parameter. - (Defaults to using google charts API.) - + Added WebTeX HTMLMathMethod. - + Removed MimeTeX HTMLMathMethod. (WebTeX is generic and subsumes it.) - + Modified --mimetex option to use WebTeX. - + Thanks to lpeterse for the idea and some of the code. + * Markdown table captions can begin with a bare colon and no longer need + to include the English word "table." Also, a caption can now occur + either before or after the table. (Issue #227) - * Made spacing at end of output more consistent. Previously some - of the writers added spurious whitespace. This has been removed, - resolving Issue #232. + * New command-line options: - NOTE: If your application combines pandoc's output with other - text, for example in a template, you may need to add spacing. - For example, a pandoc-generated markdown file will not have - a blank line after the final block element. If you are inserting - it into another markdown file, you will need to make sure there - is a blank line between it and the next block element. + - `--epub-stylesheet` allows you to specify a CSS file that will + be used to style your ebook. + - `--epub-metadata` allows you to specify metadata for the ebook. + - `--offline` causes the generated HTML slideshow to include all + needed scripts and stylesheets. + - `--webtex` causes TeX math to be converted to images using the + Google Charts API (unless a different URL is specified). + - `--section-divs` causes div tags to be added around each section + in an HTML document. (Issue #230, 239) - * Added Text.Pandoc.UTF8 for portable UTF8 string IO. - + Pandoc no longer respects locale, even when compiled by GHC 6.12. - + Use new UTF8 module in Shared, ODT, and the executables. - + Modified readFile and getContents to strip BOM if present. + * Default behavior of S5 writer in standalone mode has changed: + previously, it would include all needed scripts and stylesheets + in the generated HTML; now, only links are included unless + the `--offline` option is used. - * Removed Text.Pandoc.Writers.S5 and writeS5 function. - Moved s5Includes to new module, Text.Pandoc.S5. - (Now s5 is handled in more or less the same way as slidy; - to write S5, you use writeHtml with writerSlideVariant set - to S5Slides or SlidySlides.) + * Default behavior of HTML writer has changed. Between 1.2 and 1.5, + pandoc would enclose sections in div tags with identifiers on the + div tags, so that the sections can be manipulated in javascript. + This caused undesirable interactions with raw HTML div tags. So, + starting with 1.6, the default is to put the identifiers directly + on the header tags, and not to include the divs. The `--section-divs` + option selects the 1.2-1.5 behavior. - * Added new --offline option for slidy and S5. - + The default for both is now to include links, rather than a full - copy of scripts and stylesheets. If you are relying on pandoc - to produce a self-contained slide show, you should specify - '--offline'. - + Added slidy/slidy.min.{css,js}. + * API changes: - * Cause horizontal rules to start a new slide in s5 and slidy. + - `HTMLMathMethod`: Added `WebTeX`, removed `MimeTeX`. + - `WriterOptions`: Added `writerUserDataDir`, `writerSourceDirectory`, + `writerEPUBMetadata` fields. Removed `writerIncludeBefore`, + `writerIncludeAfter`. + - Added `headerShift` to `Text.Pandoc.Shared`. + - Moved parsing code and `ParserState` from `Text.Pandoc.Shared` + to a new module, `Text.Pandoc.Parsing`. + - Added `stateHasChapters` to `ParserState`. + - Added `HTMLSlideVariant`. + - Made `KeyTable` a map instead of an association list. + - Added accessors for `Meta` fields (`docTitle`, `docAuthors`, + `docDate`). + - `Pandoc`, `Meta`, `Inline`, and `Block` have been given `Ord` + instances. + - Reference keys now have a type of their own (`Key`), with its + own `Ord` instance for case-insensitive comparison. + - Added `Text.Pandoc.Writers.EPUB`. + - Added `Text.Pandoc.UUID`. + - Removed `Text.Pandoc.ODT`, added `Text.Pandoc.Writers.ODT`. + Removed `saveOpenDocumentAsODT`, added `writeODT`. + - Added `Text.Pandoc.Writers.Native` and `writeNative`. + Removed `prettyPandoc`. + - Added `Text.Pandoc.UTF8` for portable UTF8 string IO. + - Removed `Text.Pandoc.Writers.S5` and the `writeS5` function. + Moved `s5Includes` to a new module, `Text.Pandoc.S5`. + To write S5, you now use `writeHtml` with `writerSlideVariant` + set to `S5Slides` or `SlidySlides`. - * Added grid tables for markdown. - + Moved generic grid table functions from RST reader -> Parsing. - Here they can be used by the Markdown reader as well. - + Resolves Issue #43. + * Template changes. If you use custom templates, please update them, + particularly if you use syntax highlighting with pandoc. The old HTML + templates hardcoded highlighting CSS that will no longer work with + the most recent version of highlighting-kate. - * Allow language-neutral table captions. - + Captions may now begin simply with ':', instead of 'Table:' - + Captions may now appear either above or below the table. - + Resolves Issue #227. + - HTML template: avoid empty meta tag if no date. + - HTML template: Use default highlighting CSS from highlighting-kate + instead of hard-coding the CSS into the template. + - HTML template: insert-before text goes before the title, and + immediately after the tag, as documented. (Issue #241) + - Added slidy and s5 templates. + - Added amssymb to preamble of latex template. (github Issue 1) - * Added sequentially numbered example lists in markdown, using - (@) list markers. These are documented in README under - "Numbered examples." + * Removed excess newlines at the end of output. Note: because output + will not contain an extra newline, you may need to make adjustments + if you are inserting pandoc's output into a template. - * Changes to WriterOptions: - + Added writerUserDataDir. - + Added writerSourceDirectory. - + Removed writerIncludeBefore & writerIncludeAfter (no - longer used with the new templating system). + * In S5 and slidy, horizontal rules now cause a new slide, so you + are no longer limited to one slide per section. - * Added HTMLSlideVariant (Text.Pandoc.Parsing). + * Improved handling of code in man writer. Inline code is now monospace, + not bold, and code blocks now use .nf (no fill) and .IP (indented para). - * Made KeyTable a map instead of an association list. - + This affects the RST and Markdown readers. - + The type for stateKeys in ParserState has also changed. - + Pandoc, Meta, Inline, and Block have been given Ord instances. - + Reference keys now have a type of their own (Key), with its - own Ord instance for case-insensitive comparison. + * HTML reader parses `` as Code. (Issue #247) - * Moved headerShift from pandoc.hs to Text.Pandoc.Shared. + * html+lhs output now contains bird tracks, even when compiled without + highlighting support. (Issue #242) - * Moved parsing functions from Text.Pandoc.Shared to new module, - Text.Pandoc.Parsing. + * Colons are now no longer allowed in autogenerated XML/HTML identifiers, + since they have a special meaning in XML. - * Added amssymb to default latex template. - Resolves github Issue 1. + * Code improvements in ODT writer. Remote images are now replaced with + their alt text rather than a broken link. - * Use default highlighting CSS rather than embedding CSS in templates. + * LaTeX reader improvements: - * Updated pandoc to use highlighting-kate 0.2.7. - NOTE: Update any custom CSS or templates accordingly. + - Made latex `\section`, `\chapter` parsers more forgiving of + whitespace. + - Parse `\chapter{}` in latex. + - Changed `rawLaTeXInline` to accept `\section`, `\begin`, etc. + - Use new `rawLaTeXInline'` in LaTeX reader, and export `rawLaTeXInline` + for use in markdown reader. + - Fixes bug wherein `\section{foo}` was not recognized as raw TeX + in markdown document. - * Improved handling of code in man writer. - + Inline code is now in monoscpace, not bold. - + Code blocks now use .nf (no fill) and .IP (indented paragraph). - + Resolves Issue #247. + * LaTeX writer: images are automatically shrunk if they would extend + beyond the page margin. - * HTML reader: parse as Code. Partially resolves Issue #247. + * Plain, markdown, RST writers now use unicode for smart punctuation. - * HTML writer: - + Made inclusion of date meta tag conditional. - + Put insert-before text before the title h1 in HTML. - This is the documented behavior; the insert-before text - comes after the tag. Resolves Issue #241. + * Man writer converts math to unicode when possible, as in other writers. - * Add bird tracks to lhs in HTML when compiled wo -fhighlighting. - Resolves Issue #242. Previously the bird tracks would be stripped - off when pandoc was not compiled with highlighting support, even if - -t html+lhs was specified. Thanks to Nicholas Wu for pointing out - the problem. + * `markdown2pdf` can now recognize citeproc options. - * Don't allow colon in autogenerated XML/HTML identifiers. - They have a special meaning in XML (e.g. in EPUB). + * Command-line arguments are converted to UTF-8. (Issue #234) - * LaTeX reader: - + Made latex \section, \chapter parsers more forgiving of whitespace. - + Added stateHasChapters to ParserState. - + Parse \chapter{} in latex. If a \chapter command is encountered, - this is set to True and subsequent \section commands (etc.) will - be bumped up one level. - + Changed rawLaTeXInline to accept '\section', '\begin', etc. - + Use new rawLaTeXInline' in LaTeX reader, and export rawLaTeXInline - for use in markdown reader. - + Fixes bug wherein '\section{foo}' was not recognized as raw TeX - in markdown document. + * `Text.Pandoc.TeXMath` has been rewritten to use texmath's parser. + This allows it to handle a wider range of formulas. Also, if a formula + cannot be converted, it is left in raw TeX; formulas are no longer + partially converted. - * LaTeX writer: Give images a maximum width using the prelude only. + * Unicode curly quotes are left alone when parsing smart quotes. (Issue + #143) - * Plain, markdown, RST writers: Use unicode for smart punctuation. + * Cabal file changes: - * Man writer: convert math to unicode when possible, as in other - writers. + - Removed parsec < 3 restriction. + - Added 'threaded' flag for architectures where GHC lacks a threaded + runtime. + - Use 'threaded' only for markdown2pdf; it is not needed for pandoc. + - Require highlighting-kate 0.2.7. - * Allow markdown2pdf to recognize citeproc options. + * Use explicit imports from `Data.Generics`. Otherwise we have a + conflict with the 'empty' symbol, introduced in syb >= 0.2. (Issue #237) - * Use explicit imports from Data.Generics. Otherwise we have a - conflict with the 'empty' symbol, introduced in syb >= 0.2. Thanks - to ddssff for pointing out the problem. Resolves Issue #237. - - * Convert command-line arguments to UTF8. Resolves Issue #234. - - * Use texmath's parser in TexMath module. - + This replaces a lot of custom parser code, and expands - the tex -> unicode conversion. - + The behavior has also changed: if the whole formula can't - be converted, the whole formula is left in raw TeX. - + Previously, pandoc converted parts of the formula to unicode - and left other parts in raw TeX. - + Added (but not yet exported) readTeXMath', which returns a Maybe. - + Updated tests - - * In parsing smart quotes, leave unicode curly quotes alone. - Resolves Issue #143. - - * Removed obsolete markdown2pdf script. - - * Removed parsec < 3 restriction. - - * Require texmath >= 0.3, highlighting-kate >= 0.2.7.1. - - * Added 'threaded' cabal flag. - + GHC lacks a threaded runtime on some architectures. - Provide a 'threaded' flag that can be disabled for compiling - on these architectures. - + Removed '-threaded' from pandoc's ghc-options. '-threaded' - is only needed for markdown2pdf, due to its use of readProcess. + * New data files: slidy/slidy.min.js, slidy/slidy.min.css, epub.css. pandoc (1.5.1.1) @@ -208,9 +173,9 @@ pandoc (1.5.1) parsed text and the escaped URI (in the latter case, with the mailto: prefix). + HTML reader: unsanitaryURI has been modified to allow unicode - high characters in a URI. + high characters in a URI. + Readers: All link and image URIs are now escaped using - escapeURI. + escapeURI. + Markdown and RST writers: unescapeURI is used so that URIs in these formats are human-readable. diff --git a/relann1.6 b/relann1.6 index 2574098e3..38911ab15 100644 --- a/relann1.6 +++ b/relann1.6 @@ -7,266 +7,163 @@ also use 'cabal install' to get the latest version from HackageDB: cabal update cabal install pandoc -Here is a summary of the major changes in this version. +Thanks to everyone who contributed, either by filing bug reports or by +contributing patches. Here is a summary of the major changes in this +version: -New writers ------------ ++ New EPUB and HTML Slidy writers. (Issue #122) -Two new output formats are supported: [EPUB] and [Slidy]. + - [EPUB] is a standard ebook format, used in Apple's iBooks for + the iPad and iPhone, Barnes and Noble's nook reader, the Sony + reader, and many other devices, and by online ebook readers like + [bookworm]. (Amazon's Kindle uses a different format, MobiPocket, + but EPUB books can easily be converted to Kindle format.) Now you + can write your book in markdown and produce an ebook with a single + command! I've put up a short [tutorial here]. + - [Slidy], like S5, is a system for producing HTML+javascript slide shows. -EPUB is a standard ebook format, used in Apple's iBooks for the iPad -and iPhone, Barnes and Noble's nook reader, the Sony reader, and many -other devices, and by online ebook readers like [bookworm]. (Amazon's -Kindle uses a different format, MobiPocket, but EPUB books can easily be -converted to Kindle format.) Now you can write your book in markdown and -produce an ebook with a single command! I've put up a short -[tutorial here]. ++ All input is assumed to be UTF-8, no matter what the locale and ghc + version, and all output is UTF-8. This reverts to pre-1.5 behavior. + Also, a BOM, if present, is stripped from the input. -Slidy, like S5, is a system for producing HTML+javascript slide shows. ++ Markdown now supports grid tables, whose cells can contain + arbitrary block elements. (Issue #43) + ++ Sequentially numbered example lists in markdown with `@` marker. + ++ Markdown table captions can begin with a bare colon and no longer need + to include the English word "table." Also, a caption can now occur + either before or after the table. (Issue #227) + ++ New command-line options: + + - `--epub-stylesheet` allows you to specify a CSS file that will + be used to style your ebook. + - `--epub-metadata` allows you to specify metadata for the ebook. + - `--offline` causes the generated HTML slideshow to include all + needed scripts and stylesheets. + - `--webtex` causes TeX math to be converted to images using the + Google Charts API (unless a different URL is specified). + - `--section-divs` causes div tags to be added around each section + in an HTML document. (Issue #230, 239) + ++ Default behavior of S5 writer in standalone mode has changed: + previously, it would include all needed scripts and stylesheets + in the generated HTML; now, only links are included unless + the `--offline` option is used. + ++ Default behavior of HTML writer has changed. Between 1.2 and 1.5, + pandoc would enclose sections in div tags with identifiers on the + div tags, so that the sections can be manipulated in javascript. + This caused undesirable interactions with raw HTML div tags. So, + starting with 1.6, the default is to put the identifiers directly + on the header tags, and not to include the divs. The `--section-divs` + option selects the 1.2-1.5 behavior. + ++ API changes: + + - `HTMLMathMethod`: Added `WebTeX`, removed `MimeTeX`. + - `WriterOptions`: Added `writerUserDataDir`, `writerSourceDirectory`, + `writerEPUBMetadata` fields. Removed `writerIncludeBefore`, + `writerIncludeAfter`. + - Added `headerShift` to `Text.Pandoc.Shared`. + - Moved parsing code and `ParserState` from `Text.Pandoc.Shared` + to a new module, `Text.Pandoc.Parsing`. + - Added `stateHasChapters` to `ParserState`. + - Added `HTMLSlideVariant`. + - Made `KeyTable` a map instead of an association list. + - Added accessors for `Meta` fields (`docTitle`, `docAuthors`, `docDate`). + - `Pandoc`, `Meta`, `Inline`, and `Block` have been given `Ord` instances. + - Reference keys now have a type of their own (`Key`), with its + own `Ord` instance for case-insensitive comparison. + - Added `Text.Pandoc.Writers.EPUB`. + - Added `Text.Pandoc.UUID`. + - Removed `Text.Pandoc.ODT`, added `Text.Pandoc.Writers.ODT`. + Removed `saveOpenDocumentAsODT`, added `writeODT`. + - Added `Text.Pandoc.Writers.Native` and `writeNative`. + Removed `prettyPandoc`. + - Added `Text.Pandoc.UTF8` for portable UTF8 string IO. + - Removed `Text.Pandoc.Writers.S5` and the `writeS5` function. + Moved `s5Includes` to a new module, `Text.Pandoc.S5`. + To write S5, you now use `writeHtml` with `writerSlideVariant` + set to `S5Slides` or `SlidySlides`. + ++ Template changes. If you use custom templates, please update them, + particularly if you use syntax highlighting with pandoc. The old HTML + templates hardcoded highlighting CSS that will no longer work with + the most recent version of highlighting-kate. + + - HTML template: avoid empty meta tag if no date. + - HTML template: Use default highlighting CSS from highlighting-kate + instead of hard-coding the CSS into the template. + - HTML template: insert-before text goes before the title, and + immediately after the tag, as documented. (Issue #241) + - Added slidy and s5 templates. + - Added amssymb to preamble of latex template. (github Issue 1) + ++ Removed excess newlines at the end of output. Note: because output + will not contain an extra newline, you may need to make adjustments + if you are inserting pandoc's output into a template. + ++ In S5 and slidy, horizontal rules now cause a new slide, so you + are no longer limited to one slide per section. + ++ Improved handling of code in man writer. Inline code is now monospace, + not bold, and code blocks now use .nf (no fill) and .IP (indented para). + ++ HTML reader parses `` as Code. (Issue #247) + ++ html+lhs output now contains bird tracks, even when compiled without + highlighting support. (Issue #242) + ++ Colons are now no longer allowed in autogenerated XML/HTML identifiers, + since they have a special meaning in XML. + ++ Code improvements in ODT writer. Remote images are now replaced with + their alt text rather than a broken link. + ++ LaTeX reader improvements: + - Made latex `\section`, `\chapter` parsers more forgiving of whitespace. + - Parse `\chapter{}` in latex. + - Changed `rawLaTeXInline` to accept `\section`, `\begin`, etc. + - Use new `rawLaTeXInline'` in LaTeX reader, and export `rawLaTeXInline` + for use in markdown reader. + - Fixes bug wherein `\section{foo}` was not recognized as raw TeX + in markdown document. + ++ LaTeX writer: images are automatically shrunk if they would extend + beyond the page margin. + ++ Plain, markdown, RST writers now use unicode for smart punctuation. + ++ Man writer converts math to unicode when possible, as in other writers. + ++ `markdown2pdf` can now recognize citeproc options. + ++ Command-line arguments are converted to UTF-8. (Issue #234) + ++ `Text.Pandoc.TeXMath` has been rewritten to use texmath's parser. + This allows it to handle a wider range of formulas. Also, if a formula + cannot be converted, it is left in raw TeX; formulas are no longer + partially converted. + ++ Unicode curly quotes are left alone when parsing smart quotes. (Issue #143) + ++ Cabal file changes: + + - Removed parsec < 3 restriction. + - Added 'threaded' flag for architectures where GHC lacks a threaded + runtime. + - Use 'threaded' only for markdown2pdf; it is not needed for pandoc. + - Require highlighting-kate 0.2.7. + ++ Use explicit imports from `Data.Generics`. Otherwise we have a + conflict with the 'empty' symbol, introduced in syb >= 0.2. (Issue #237) + ++ New data files: slidy/slidy.min.js, slidy/slidy.min.css, epub.css. [EPUB]: http://en.wikipedia.org/wiki/EPUB [Slidy]: http://www.w3.org/Talks/Tools/Slidy [bookworm]: http://bookworm.oreilly.com/ [tutorial here]: http://johnmacfarlane.net/pandoc/epub.html -New Command-line Options ------------------------- - -For EPUB output: - - * `--epub-stylesheet` allows you to specify a CSS file that will - be used to style your ebook. - - * `--epub-metadata` allows you to specify a file containing metadata - besides the title and authors, which are automatically included. - -For Slidy and S5 output: - - * `--offline` causes the javascript and stylesheets needed for - S5 or Slidy slide shows to be included directly in the generated - HTML. (By default, only links are included.) - -Note that this option goes with a change in the default behavior of the -S5 writer, which used to include the javascript and stylesheets whenever -`--standalone` was specified. If you are relying on pandoc to produce a -self-contained slide show, you should specify `--offline`. - -For HTML output: - - * `--webtex` causes TeX math to be converted to images using the Google - Charts API (unless a different URL is specified). (Thanks to - lpeterse.) - - * Added `--section-divs` option. Causes div tags to be added around - each section in an HTML document. - -This last change requires a bit of explanation. Before version 1.2, -pandoc would put section identifiers directly on headers: - -

My Section

- ...blah blah... - -Someone wanted to be able to manipulate whole sections in javascript, -so, starting with 1.2, I changed pandoc to put sections inside divs, -with the identifiers on the divs: - -
-

My Section

- ...blah blah... -
- -Recently several people have pointed out to me that the divs can -produce bad interaction effects when combined with raw HTML. -http://code.google.com/p/pandoc/issues/detail?id=230 - -So in 1.6, I have reverted to the old behavior (no divs, identifiers -directly on section headers) as a default, adding a `--section-divs` -option that will select the 1.2-1.5 behavior, with divs around sections -and identifiers on the divs. - -Markdown extensions -------------------- - -You can now use "grid tables" in markdown. (Most of the code -is from Eric Kowey's grid tables patch to the RST reader, from -the last release.) - -Table captions need no longer begin with the English word -`Table:`, a bare colon is sufficient. Also, captions may appear -above a table instead of below it. - -A new type of list marker, `@`, has been added. A list with items -numbered `@` is sequentially numbered, like a list with items numbered -`#`. The difference is that with `@`, the number sequence continues -across a list boundary. `@` list items may also be labeled and referred -to elsewhere in the document. An example will illustrate their use: - - Here is my first list: - - (@) first example, numbered 1 - (@) second example, numeber 2 - - Some commentary here. - - (@) third example, numbered 3 - (@special) fourth example, numbered 4 - (@) fifth example, numbered 5 - - Some commentary about (@special) (will appear as 4). - -This feature allows easy construction of a running list of -sequentially numbered examples. For documentation, see README under -"Numbered examples." - -API Changes ------------ - -There are quite a few API changes in this release. If you use pandoc -as a library, please review these carefully. - - * Text.Pandoc.Shared: - + HTMLMathMethod: Added WebTeX, removed MimeTeX. (WebTeX is - generic enough to subsume MimeTeX.) - + WriterOptions: Added writerUserDataDir, writerSourceDirectory, - writerEPUBMetadata fields. Removed unused fields - writerIncludeBefore, writerIncludeAfter. - + Moved all the parsing-related functions and definitions - to a new module, Text.Pandoc.Parsing. - + Moved headerShift from pandoc.hs. - - * New module, Text.Pandoc.Parsing, for shared parsing functions - and ParserState. - + Added HTMLSlideVariant. - + Made KeyTable a map instead of an association list. - This affects the RST and Markdown readers. - + The type for stateKeys in ParserState has changed. - - * Text.Pandoc.Definition: - + Pandoc, Meta, Inline, and Block have been given Ord instances. - + Reference keys now have a type of their own (Key), with its - own Ord instance for case-insensitive comparison. - - * New module, Text.Pandoc.Writers.EPUB. - - * New utility module, Text.Pandoc.UUID, for generating random UUIDs for - EPUBs. - - * Removed Text.Pandoc.ODT, added Text.Pandoc.Writers.ODT. - Instead of saveOpenDocumentAsODT, we now have writeODT, which takes - a Pandoc document and produces a bytestring. saveOpenDocumentAsODT - has been removed. - - * Added Text.Pandoc.Writers.Native. This contains the prettyprinting - code from Text.Pandoc.Shared. prettyPandoc has been removed; - use the new writeNative instead. - - * Added Text.Pandoc.UTF8 for portable UTF8 string IO. - - * Removed Text.Pandoc.Writers.S5 and writeS5 function. - Moved s5Includes to new module, Text.Pandoc.S5. - (Now S5 is handled in more or less the same way as slidy; - to write s5, you use writeHtml with writerSlideVariant set - to S5Slides or SlidySlides.) - -Template Changes ----------------- - -There have been some changes to the default templates; please update -your templates. - - * HTML template: avoid empty meta tag if no date. - - * Added S5 and Slidy templates. - - * Added amssymb to the preamble in the default latex template. - - * Use default highlighting CSS rather than embedding CSS in templates. - Note: if you use an older template, you'll have the wrong CSS for - recent versions of highlighting-kate. - -Other Changes -------------- - - * All input is assumed to be UTF-8, and all output is UTF-8. Pandoc no - longer respects locale, even when compiled by GHC 6.12. - - * Made spacing at end of output more consistent. Previously some - of the writers added spurious whitespace. This has been removed. - Note: If your application combines pandoc's output with other - text, for example in a template, you may need to add spacing. - For example, a pandoc-generated markdown file will not have - a blank line after the final block element. If you are inserting - it into another markdown file, you will need to make sure there - is a blank line between it and the next block element. - - * In S5 (and Slidy), horizontal rules now cause a "slide break," - so you are no longer limited to one slide per level-one - section. - - * Improved handling of code in man writer. - + Inline code is now in monoscpace, not bold. - + Code blocks now use .nf (no fill) and .IP (indented paragraph). - - * HTML reader: parse as Code. - - * HTML writer: Put insert-before text before the title h1 in HTML. - This is the documented behavior; the insert-before text - comes after the tag. - - * Add bird tracks to lhs in HTML when compiled wo -fhighlighting. - Previously the bird tracks would be stripped off when pandoc was - not compiled with highlighting support, even if -t html+lhs was - specified. Thanks to Nicholas Wu for pointing out the problem. - - * Don't allow colon in autogenerated XML/HTML identifiers. - They have a special meaning in XML (e.g. in EPUB). - - * LaTeX reader: - + Made latex \section, \chapter parsers more forgiving of whitespace. - + Added stateHasChapters to ParserState. - + Parse \chapter{} in latex. If a \chapter command is encountered, - this is set to True and subsequent \section commands (etc.) will - be bumped up one level. - + Changed rawLaTeXInline to accept '\section', '\begin', etc. - + Use new rawLaTeXInline' in LaTeX reader, and export rawLaTeXInline - for use in markdown reader. - + Fixes bug wherein '\section{foo}' was not recognized as raw TeX - in markdown document. - - * LaTeX writer: Give images a maximum width using the prelude only. - - * Plain, markdown, RST writers: Use unicode for smart punctuation. - - * Man writer: convert math to unicode when possible, as in other - writers. - - * Allow markdown2pdf to recognize citeproc options. - - * Convert command-line arguments to UTF8. - - * Use texmath's parser in TexMath module. This replaces a lot of - custom parser code, and expands the tex -> unicode conversion. The - behavior has also changed: if the whole formula can't be converted, - the whole formula is left in raw TeX. Previously, pandoc converted - parts of the formula to unicode and left other parts in raw TeX. - - * In parsing smart quotes, leave unicode curly quotes alone. - - * Removed obsolete markdown2pdf script. - - * Removed parsec < 3 restriction. - - * ODT: Handle the case where the image is remote (or not found) by - converting the Image element into an Emph with the label. - - * Added 'threaded' cabal flag. - + GHC lacks a threaded runtime on some architectures. - Provide a 'threaded' flag that can be disabled for compiling - on these architectures. - + Removed '-threaded' from pandoc's ghc-options. '-threaded' - is only needed for markdown2pdf, due to its use of readProcess. - - * Modified readFile and getContents to strip BOM if present. - - * Updated pandoc to use highlighting-kate 0.2.7. -