Tissevert/pandoc
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

Revised format of changelog to match release announcement.

Browse source
This commit is contained in:
John MacFarlane 2010-07-24 10:13:09 -07:00
parent c21319f950
commit b9e377e328
2 changed files with 271 additions and 409 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

269
changelog
View file

@ -2,193 +2,158 @@ pandoc (1.6)
[ John MacFarlane ] [ John MacFarlane ]
* Added a slidy writer. Resolves Issue #122. * New EPUB and HTML Slidy writers. (Issue #122)
* Made a proper ODT writer. - EPUB is a standard ebook format, used in Apple's iBooks for
+ Transformed the old Text.Pandoc.ODT module into a proper the iPad and iPhone, Barnes and Noble's nook reader, the Sony
writer module, Text.Pandoc.Writers.ODT. reader, and many other devices.
+ Instead of saveOpenDocumentAsODT, we now have writeODT, which - Slidy, like S5, is a system for producing HTML+javascript slide
takes a Pandoc document and produces a bytestring. shows.
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.
* Added an EPUB writer. * All input is assumed to be UTF-8, no matter what the locale and ghc
+ New writer module Text.Pandoc.Writers.EPUB version, and all output is UTF-8. This reverts to pre-1.5 behavior.
+ Stylesheet in epub.css Also, a BOM, if present, is stripped from the input.
+ --epub-stylesheet command-line option.
+ New utility module Text.Pandoc.UUID to generate
random UUIDs for EPUBs.
+ Added writerEPUBMetadata field and --epub-metadata option.
* Moved Pandoc prettyprinting code from Shared to new Native writer. * Markdown now supports grid tables, whose cells can contain
+ Text.Pandoc.Writers.Native arbitrary block elements. (Issue #43)
+ The function prettyPandoc is now gone. Use writeNative instead.
* Added --section-divs option. Header identifiers now get attached to * Sequentially numbered example lists in markdown with `@` marker.
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.
* Added --webtex option for HTML math. * Markdown table captions can begin with a bare colon and no longer need
+ Added --webtex command-line option, with optional parameter. to include the English word "table." Also, a caption can now occur
(Defaults to using google charts API.) either before or after the table. (Issue #227)
+ 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.
* Made spacing at end of output more consistent. Previously some * New command-line options:
of the writers added spurious whitespace. This has been removed,
resolving Issue #232.
NOTE: If your application combines pandoc's output with other - `--epub-stylesheet` allows you to specify a CSS file that will
text, for example in a template, you may need to add spacing. be used to style your ebook.
For example, a pandoc-generated markdown file will not have - `--epub-metadata` allows you to specify metadata for the ebook.
a blank line after the final block element. If you are inserting - `--offline` causes the generated HTML slideshow to include all
it into another markdown file, you will need to make sure there needed scripts and stylesheets.
is a blank line between it and the next block element. - `--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. * Default behavior of S5 writer in standalone mode has changed:
+ Pandoc no longer respects locale, even when compiled by GHC 6.12. previously, it would include all needed scripts and stylesheets
+ Use new UTF8 module in Shared, ODT, and the executables. in the generated HTML; now, only links are included unless
+ Modified readFile and getContents to strip BOM if present. the `--offline` option is used.
* Removed Text.Pandoc.Writers.S5 and writeS5 function. * Default behavior of HTML writer has changed. Between 1.2 and 1.5,
Moved s5Includes to new module, Text.Pandoc.S5. pandoc would enclose sections in div tags with identifiers on the
(Now s5 is handled in more or less the same way as slidy; div tags, so that the sections can be manipulated in javascript.
to write S5, you use writeHtml with writerSlideVariant set This caused undesirable interactions with raw HTML div tags. So,
to S5Slides or SlidySlides.) 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. * API changes:
+ 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}.
* 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. * Template changes. If you use custom templates, please update them,
+ Moved generic grid table functions from RST reader -> Parsing. particularly if you use syntax highlighting with pandoc. The old HTML
Here they can be used by the Markdown reader as well. templates hardcoded highlighting CSS that will no longer work with
+ Resolves Issue #43. the most recent version of highlighting-kate.
* Allow language-neutral table captions. - HTML template: avoid empty meta tag if no date.
+ Captions may now begin simply with ':', instead of 'Table:' - HTML template: Use default highlighting CSS from highlighting-kate
+ Captions may now appear either above or below the table. instead of hard-coding the CSS into the template.
+ Resolves Issue #227. - HTML template: insert-before text goes before the title, and
immediately after the <body> 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 * Removed excess newlines at the end of output. Note: because output
(@) list markers. These are documented in README under will not contain an extra newline, you may need to make adjustments
"Numbered examples." if you are inserting pandoc's output into a template.
* Changes to WriterOptions: * In S5 and slidy, horizontal rules now cause a new slide, so you
+ Added writerUserDataDir. are no longer limited to one slide per section.
+ Added writerSourceDirectory.
+ Removed writerIncludeBefore & writerIncludeAfter (no
longer used with the new templating system).
* 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. * HTML reader parses `<tt>` as Code. (Issue #247)
+ 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.
* 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, * Colons are now no longer allowed in autogenerated XML/HTML identifiers,
Text.Pandoc.Parsing. since they have a special meaning in XML.
* Added amssymb to default latex template. * Code improvements in ODT writer. Remote images are now replaced with
Resolves github Issue 1. 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. - Made latex `\section`, `\chapter` parsers more forgiving of
NOTE: Update any custom CSS or templates accordingly. whitespace.
- Parse `\chapter{}` in latex.
* Improved handling of code in man writer. - Changed `rawLaTeXInline` to accept `\section`, `\begin`, etc.
+ Inline code is now in monoscpace, not bold. - Use new `rawLaTeXInline'` in LaTeX reader, and export `rawLaTeXInline`
+ Code blocks now use .nf (no fill) and .IP (indented paragraph).
+ Resolves Issue #247.
* HTML reader: parse <tt> as Code. Partially resolves Issue #247.
* 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 <body> tag. Resolves Issue #241.
* 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.
* 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. for use in markdown reader.
+ Fixes bug wherein '\section{foo}' was not recognized as raw TeX - Fixes bug wherein `\section{foo}` was not recognized as raw TeX
in markdown document. in markdown document.
* LaTeX writer: Give images a maximum width using the prelude only. * LaTeX writer: images are automatically shrunk if they would extend
beyond the page margin.
* Plain, markdown, RST writers: Use unicode for smart punctuation. * Plain, markdown, RST writers now use unicode for smart punctuation.
* Man writer: convert math to unicode when possible, as in other * Man writer converts math to unicode when possible, as in other writers.
writers.
* Allow markdown2pdf to recognize citeproc options. * `markdown2pdf` can now recognize citeproc options.
* Use explicit imports from Data.Generics. Otherwise we have a * Command-line arguments are converted to UTF-8. (Issue #234)
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. * `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.
* Use texmath's parser in TexMath module. * Unicode curly quotes are left alone when parsing smart quotes. (Issue
+ This replaces a lot of custom parser code, and expands #143)
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. * Cabal file changes:
Resolves Issue #143.
* Removed obsolete markdown2pdf script. - 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.
* Removed parsec < 3 restriction. * Use explicit imports from `Data.Generics`. Otherwise we have a
conflict with the 'empty' symbol, introduced in syb >= 0.2. (Issue #237)
* Require texmath >= 0.3, highlighting-kate >= 0.2.7.1. * New data files: slidy/slidy.min.js, slidy/slidy.min.css, epub.css.
* 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.
pandoc (1.5.1.1) pandoc (1.5.1.1)

403
relann1.6
View file

@ -7,266 +7,163 @@ also use 'cabal install' to get the latest version from HackageDB:
cabal update cabal update
cabal install pandoc 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 + All input is assumed to be UTF-8, no matter what the locale and ghc
and iPhone, Barnes and Noble's nook reader, the Sony reader, and many version, and all output is UTF-8. This reverts to pre-1.5 behavior.
other devices, and by online ebook readers like [bookworm]. (Amazon's Also, a BOM, if present, is stripped from the input.
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. + 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 <body> 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 `<tt>` 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 [EPUB]: http://en.wikipedia.org/wiki/EPUB
[Slidy]: http://www.w3.org/Talks/Tools/Slidy [Slidy]: http://www.w3.org/Talks/Tools/Slidy
[bookworm]: http://bookworm.oreilly.com/ [bookworm]: http://bookworm.oreilly.com/
[tutorial here]: http://johnmacfarlane.net/pandoc/epub.html [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:
<h1 id="my-section">My Section</h1>
...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:
<div id="my-section">
<h1>My Section</h1>
...blah blah...
</div>
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 <tt> 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 <body> 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.