aboutsummaryrefslogtreecommitdiff
path: root/relann1.6
blob: 131625d5cae488a09445305f6f0ae674096ec37b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
I'm pleased to announce the release of pandoc 1.6.

As usual, a source tarball and Windows installer are available
at <http://code.google.com/p/pandoc/downloads/list>.  You can
also use 'cabal install' to get the latest version from HackageDB:

    cabal update
    cabal install pandoc

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 EPUB and HTML Slidy writers. (Issue #122)

    - [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.

+ 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.

+ 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
[Slidy]: http://www.w3.org/Talks/Tools/Slidy
[bookworm]: http://bookworm.oreilly.com/
[tutorial here]: http://johnmacfarlane.net/pandoc/epub.html