git.iko.soy/typeable/pandoc
on 1.10.1 help sign in
typeable/pandoc/relann1.6
170 lines 7.6 kB history raw
1I'm pleased to announce the release of pandoc 1.6.
3As usual, a source tarball and Windows installer are available
4at <http://code.google.com/p/pandoc/downloads/list>. You can
5also use 'cabal install' to get the latest version from HackageDB:
7 cabal update
8 cabal install pandoc
10Thanks to everyone who contributed, either by filing bug reports or by
11contributing patches. Here is a summary of the major changes in this
12version:
14+ New EPUB and HTML Slidy writers. (Issue #122)
16 - [EPUB] is a standard ebook format, used in Apple's iBooks for
17 the iPad and iPhone, Barnes and Noble's nook reader, the Sony
18 reader, and many other devices, and by online ebook readers like
19 [bookworm]. (Amazon's Kindle uses a different format, MobiPocket,
20 but EPUB books can easily be converted to Kindle format.) Now you
21 can write your book in markdown and produce an ebook with a single
22 command! I've put up a short [tutorial here].
23 - [Slidy], like S5, is a system for producing HTML+javascript slide shows.
25+ All input is assumed to be UTF-8, no matter what the locale and ghc
26 version, and all output is UTF-8. This reverts to pre-1.5 behavior.
27 Also, a BOM, if present, is stripped from the input.
29+ Markdown now supports grid tables, whose cells can contain
30 arbitrary block elements. (Issue #43)
32+ Sequentially numbered example lists in markdown with `@` marker.
34+ Markdown table captions can begin with a bare colon and no longer need
35 to include the English word "table." Also, a caption can now occur
36 either before or after the table. (Issue #227)
38+ New command-line options:
40 - `--epub-stylesheet` allows you to specify a CSS file that will
41 be used to style your ebook.
42 - `--epub-metadata` allows you to specify metadata for the ebook.
43 - `--offline` causes the generated HTML slideshow to include all
44 needed scripts and stylesheets.
45 - `--webtex` causes TeX math to be converted to images using the
46 Google Charts API (unless a different URL is specified).
47 - `--section-divs` causes div tags to be added around each section
48 in an HTML document. (Issue #230, 239)
50+ Default behavior of S5 writer in standalone mode has changed:
51 previously, it would include all needed scripts and stylesheets
52 in the generated HTML; now, only links are included unless
53 the `--offline` option is used.
55+ Default behavior of HTML writer has changed. Between 1.2 and 1.5,
56 pandoc would enclose sections in div tags with identifiers on the
57 div tags, so that the sections can be manipulated in javascript.
58 This caused undesirable interactions with raw HTML div tags. So,
59 starting with 1.6, the default is to put the identifiers directly
60 on the header tags, and not to include the divs. The `--section-divs`
61 option selects the 1.2-1.5 behavior.
63+ API changes:
65 - `HTMLMathMethod`: Added `WebTeX`, removed `MimeTeX`.
66 - `WriterOptions`: Added `writerUserDataDir`, `writerSourceDirectory`,
67 `writerEPUBMetadata` fields. Removed `writerIncludeBefore`,
68 `writerIncludeAfter`.
69 - Added `headerShift` to `Text.Pandoc.Shared`.
70 - Moved parsing code and `ParserState` from `Text.Pandoc.Shared`
71 to a new module, `Text.Pandoc.Parsing`.
72 - Added `stateHasChapters` to `ParserState`.
73 - Added `HTMLSlideVariant`.
74 - Made `KeyTable` a map instead of an association list.
75 - Added accessors for `Meta` fields (`docTitle`, `docAuthors`, `docDate`).
76 - `Pandoc`, `Meta`, `Inline`, and `Block` have been given `Ord` instances.
77 - Reference keys now have a type of their own (`Key`), with its
78 own `Ord` instance for case-insensitive comparison.
79 - Added `Text.Pandoc.Writers.EPUB`.
80 - Added `Text.Pandoc.UUID`.
81 - Removed `Text.Pandoc.ODT`, added `Text.Pandoc.Writers.ODT`.
82 Removed `saveOpenDocumentAsODT`, added `writeODT`.
83 - Added `Text.Pandoc.Writers.Native` and `writeNative`.
84 Removed `prettyPandoc`.
85 - Added `Text.Pandoc.UTF8` for portable UTF8 string IO.
86 - Removed `Text.Pandoc.Writers.S5` and the `writeS5` function.
87 Moved `s5Includes` to a new module, `Text.Pandoc.S5`.
88 To write S5, you now use `writeHtml` with `writerSlideVariant`
89 set to `S5Slides` or `SlidySlides`.
91+ Template changes. If you use custom templates, please update them,
92 particularly if you use syntax highlighting with pandoc. The old HTML
93 templates hardcoded highlighting CSS that will no longer work with
94 the most recent version of highlighting-kate.
96 - HTML template: avoid empty meta tag if no date.
97 - HTML template: Use default highlighting CSS from highlighting-kate
98 instead of hard-coding the CSS into the template.
99 - HTML template: insert-before text goes before the title, and
100 immediately after the <body> tag, as documented. (Issue #241)
101 - Added slidy and s5 templates.
102 - Added amssymb to preamble of latex template. (github Issue 1)
104+ Removed excess newlines at the end of output. Note: because output
105 will not contain an extra newline, you may need to make adjustments
106 if you are inserting pandoc's output into a template.
108+ In S5 and slidy, horizontal rules now cause a new slide, so you
109 are no longer limited to one slide per section.
111+ Improved handling of code in man writer. Inline code is now monospace,
112 not bold, and code blocks now use .nf (no fill) and .IP (indented para).
114+ HTML reader parses `<tt>` as Code. (Issue #247)
116+ html+lhs output now contains bird tracks, even when compiled without
117 highlighting support. (Issue #242)
119+ Colons are now no longer allowed in autogenerated XML/HTML identifiers,
120 since they have a special meaning in XML.
122+ Code improvements in ODT writer. Remote images are now replaced with
123 their alt text rather than a broken link.
125+ LaTeX reader improvements:
127 - Made latex `\section`, `\chapter` parsers more forgiving of whitespace.
128 - Parse `\chapter{}` in latex.
129 - Changed `rawLaTeXInline` to accept `\section`, `\begin`, etc.
130 - Use new `rawLaTeXInline'` in LaTeX reader, and export `rawLaTeXInline`
131 for use in markdown reader.
132 - Fixes bug wherein `\section{foo}` was not recognized as raw TeX
133 in markdown document.
135+ LaTeX writer: images are automatically shrunk if they would extend
136 beyond the page margin.
138+ Plain, markdown, RST writers now use unicode for smart punctuation.
140+ Man writer converts math to unicode when possible, as in other writers.
142+ `markdown2pdf` can now recognize citeproc options.
144+ Command-line arguments are converted to UTF-8. (Issue #234)
146+ `Text.Pandoc.TeXMath` has been rewritten to use texmath's parser.
147 This allows it to handle a wider range of formulas. Also, if a formula
148 cannot be converted, it is left in raw TeX; formulas are no longer
149 partially converted.
151+ Unicode curly quotes are left alone when parsing smart quotes. (Issue #143)
153+ Cabal file changes:
155 - Removed parsec < 3 restriction.
156 - Added 'threaded' flag for architectures where GHC lacks a threaded
157 runtime.
158 - Use 'threaded' only for markdown2pdf; it is not needed for pandoc.
159 - Require highlighting-kate 0.2.7.
161+ Use explicit imports from `Data.Generics`. Otherwise we have a
162 conflict with the 'empty' symbol, introduced in syb >= 0.2. (Issue #237)
164+ New data files: slidy/slidy.min.js, slidy/slidy.min.css, epub.css.
166[EPUB]: http://en.wikipedia.org/wiki/EPUB
167[Slidy]: http://www.w3.org/Talks/Tools/Slidy
168[bookworm]: http://bookworm.oreilly.com/
169[tutorial here]: http://johnmacfarlane.net/pandoc/epub.html