forked from jgm/pandoc
-
Notifications
You must be signed in to change notification settings - Fork 1
/
changelog
9300 lines (7031 loc) · 378 KB
/
changelog
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
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
pandoc (1.16)
* Implemented SoftBreak and new `--wrap` option (#1701).
Added threefold wrapping option.
+ Command line option: deprecated `--no-wrap`, added
`--wrap=[auto|none|preserve]`
+ Added WrapOption, exported from Text.Pandoc.Options
+ Changed type of writerWrapText in WriterOptions from
Bool to WrapOption.
+ Modified Text.Pandoc.Shared functions for SoftBreak.
+ Supported SoftBreak in writers.
+ Updated tests.
+ Updated README.
* Added `--dpi` command-line option (Mauro Bieg).
* Removed deprecated options `--offline` and `--html5`.
* Fixed language code for Czech (cs not cz) (#2597).
* Added Attr field to Link and Image (Mauro Bieg, #261, API change).
+ Added syntax for link and image attributes to pandoc's Markdown
(Mauro Bieg).
+ Updated readers and writers to use link and image attributes
when appropriate (Mauro Bieg).
+ Support image attributes in Docx, Textile, RST readers (Mauro
Bieg).
* Text.Pandoc.Options: Added `writerDpi` to `WriterOptions` (API
change, Mauro Bieg).
* Implemented `east_asian_line_breaks` extension (#2586).
In Text.Pandoc.Options, added `Ext_east_asian_line_breaks` constructor
to `Extension` (API change). This extension is like
`ignore_line_breaks`, but smarter -- it only ignores line breaks
between two East Asian wide characters. This makes it better suited
for writing with a mix of East Asian and non-East Asian scripts.
* Fixed cite key parsing regression (jgm/pandoc-citeproc#201).
We were capturing final colons as in [@foo: bar]; the citation id
was being parsed as "@foo:".
* ICML writer:
+ Fixed image syntax for local files (#2589).
+ Changed type of `writeICML` (Mauro Bieg).
API change: It is now `WriterOptions -> Pandoc -> IO String`.
Also handle new image attributes.
+ Intersperse line breaks instead of appending them to
every ParagraphStyleRange (Mauro Bieg, #2501).
+ Add Cite style to citations (Mauro Bieg).
+ Added figure handling (#2590, Mauro Bieg).
+ Better handling of math. Instead of just printing the raw tex,
we now try to fake it with unicode characters.
* HTML writer: Include `example` class for example lists (#2524).
* ODT/OpenDocument writer: improved image attributes (Mauro Bieg).
+ Support for percentage widths/heights
+ Use `Attr` instead of title to get dimensions from ODT walker
to `writeOpenDocument`.
* AsciiDoc writer:
+ Support anchors in spans and divs with id elements
(jgm/pandoc-citeproc#143).
+ Fixed code blocks (#1861).
* Haddock writer: omit formatting inside links, which isn't supported
by Haddock (#2515).
* Beamer writer: mark frame as fragile when it contains verbatim (#1613).
* LaTeX writer:
+ Add support for GAP highlighting using listings (Raniere Silva).
+ Consider `header-includes` content as well as templates
when determining whether to use csquotes (Andreas Lööw).
* Docx writer: better handling of PDF images. Previously we tried
to get the image size from the image even if an explicit size was
specified. Since we still can't get image size for PDFs, this made
it impossible to use PDF images in docx. Now we don't try to get
the image size when a size is already explicitly specified.
* Markdown writer: use raw HTML for link/image attributes when
the `link_attributes` extension is unset and `raw_html` is set (#2554).
* LaTeX reader:
+ Improved smart quote parsing (#2555). This fixes redering of
unmatched quotes.
+ LaTeX reader: Use curly quotes for unmatched ` (#2555).
* Markdown reader:
+ Improved pipe table relative widths. Previously pipe table
columns got relative widths (based on the header underscore lines)
when the source of one of the rows was greater in width than the
column width. This gave bad results in some cases where much of
the width of the row was due to nonprinting material (e.g. link
URLs). Now pandoc only looks at printable width (the width of a
plain string version of the source), which should give better results.
Thanks to John Muccigrosso for bringing up the issue.
+ Fixed parsing bug with macros. Previously macro definitions in
indented code blocks were being parsed as macro definitions, not code.
* Textile reader: skip over attribute in image source (#2515).
We don't have a place yet for styles or sizes on images, but
we can skip the attributes rather than incorrectly taking them
to be part of the filename.
* Docx reader: Handle dummy list items (Jesse Rosenthal).
These come up when people create a list item and then delete the
bullet. It doesn't refer to any real list item, and we used to ignore
it.
* Renamed link attribute extensions. The old `link_attributes` is
now `mmd_link_attributes`, and `link_attributes` now enables the
new pandoc-style link and image attributes (API change).
Note: this change could break some existing workflows.
* Rationalized behavior of `--no-tex-ligatures` and `--smart` (#2541).
This change makes `--no-tex-ligatures` affect the LaTeX reader
as well as the LaTeX and ConTeXt writers. If it is used,
the LaTeX reader will parse characters `` ` ``, `'`, and `-`
literally, rather than parsing ligatures for quotation marks
and dashes. And the LaTeX writer will print unicode quotation
mark and dash characters literally, rather than converting
them to the standard ASCII ligatures. Note that `--smart` has
no effect on the LaTeX reader. `--smart` is still the default
for all input formats when LaTeX or ConTeXt is the output format,
*unless* `--no-tex-ligatures` is used.
Some examples to illustrate the logic:
```
% echo "'hi'" | pandoc -t latex
`hi'
% echo "'hi'" | pandoc -t latex --no-tex-ligatures
'hi'
% echo "'hi'" | pandoc -t latex --no-tex-ligatures --smart
‘hi’
% echo "'hi'" | pandoc -f latex --no-tex-ligatures
<p>'hi'</p>
% echo "'hi'" | pandoc -f latex
<p>’hi’</p>
```
* Fixed Emoji character definitions (#2523). There were many bugs in the
definitions.
* Text.Pandoc.CSS:
+ Added `pickStylesToKVs` function to extract multiple properties at
once (API change, Mauro Bieg).
+ Parse CSS that doesn't contain the optional semicolon (Mauro Bieg).
* trypandoc: sort drop-down lists.
* Beamer template:
+ Made `\euro` conditional on presence of character.
for xelatex and lualatex, as it is for pdflatex (Andrew Dunning).
+ Moved `header-includes` before setting of title (Thomas Hodgson),
to match the LaTeX template (jgm/pandoc-templates#168).
+ Added `section-titles` variable (defaults to true)
to enable/suppress section title pages in beamer
slide shows (Thomas Hodgson).
+ Moved beamer themes after fonts, so that themes can
change fonts. (Previously the fonts set were being
clobbered by lmodern.sty.) (Thomas Hodgson).
* Beamer/LaTeX template changes (Thomas Hodgson):
+ Added `thanks` variable
+ Use `parskip.sty` when `indent` isn't set (fall back to using
`setlength` as before if `parskip.sty` isn't available).
+ Use `biblio-style` with biblatex.
+ Added `biblatexoptions` variable.
* LaTeX template changes:
+ Only pass options to color package if `colorlinks` is set
(Andrew Dunning).
+ Make definition of `\euro` conditional in xelatex/lualatex,
as it is already for pdflatex (Andrew Dunning).
+ Removed setting of `subject` in PDF metadata.
This used to be set to the subtitle, but really the subtitle
need not give the subject. Also, `subtitle` can contain formatting,
so we'd need, at least, a plain text version for this.
+ Moved `header-includes` before setting of `\title`, `\author`,
etc. This allows these macros to be redefined.
+ Use `\subtitle` command for `subtitle`, instead of tacking it
on to the title as before. We give a no-op fallback definition if it
is not defined. This change should produce much better results
in classes that support `\subtitle`. With the default article
class, which does not define `\subtitle`, subtitles will no
longer be printed unless the user defines `\subtitle` and
redefines `\maketitle`.
+ Moved redefinitions of `\paragraph` and `\subparagraph` to
before header-includes.
* Context template:
+ Use simplefonts for font loading (Paolo Rodríguez). This is
needed for things to work on ConTeXt stable from TeXLive 2015.
+ Revert use of `\setuphead` in title block (Andrew Dunning,
Rik Kabel).
* Update LaTeX/ConTeXt link colour usage (Andrew Dunning).
* Fixed man template so disabling hyphenation actually works.
The command needs to come after .TH.
* Added 'navigation' variable to beamer template (#2543).
Valid values are `empty` (the default), `horizontal`, `vertical`,
and `frame`. Note that this changes the default behavior from
`horizontal` to `empty`. Closes #2543.
* Added `stack.full.yaml` to build `pandoc-citeproc` as well.
* Allow pipe tables with no body rows (#2556).
Previously this raised a runtime error.
* Shared: Improved `fetchItem` so that `C:/Blah/Blah.jpg` isn't treated
as URL. The Haskell URI parsing routines will accept "C:" as a
scheme, so we rule that out manually. This helps with
`--self-contained` and absolute Windows paths.
* Define a `meta-json` variable for all writers (#2019). This contains
a JSON version of all the metadata, in the format selected for the
writer. So, for example, to get just the YAML metadata, you can run
pandoc with the following custom template: `$meta-json$`. The intent
is to make it easier for static site generators and other tools to get
at the metadata.
* Document limitations of --self-contained (#2553).
* Improved Citations section of README (#2551). Added information
about `link-citations` and a link to the pandoc-citeproc man page.
* `ImageSize`: use `safeRead` instead of `readMaybe`, which isn't
in base < 4.6.
* Allow .adoc file extension for AsciiDoc (Andrew Dunning).
* Improved implicit pandoc-citeproc inclusion.
The filter pandoc-citeproc is automatically used when
`--bibliography` is specified on the command line, unless
`--natbib` or `--biblatex` is used. However, previously this
only worked if `--bibliography` was spelled out in full, and not
if `--biblio` was used.
* reveal.js: Interpret pauses correctly for all headers (#2530).
Previously, when using headers below the slide level, pauses are left
uninterpreted into pauses. In my opinion, unexpected behavior but
intentional looking at the code.
* Remove redundant `center` variable for reveal.js (Andrew Dunning).
* Parsing: Add `extractIdClass`, modified type of `KeyTable` (Mauro
Bieg, API change).
* ImageSize: Added functions for converting between image dimensions
(Mauro Bieg).
* Use lts-3.18 in stack.yaml. This avoids Windows build
issues with the HTTP library.
pandoc (1.15.2.1)
* Added two missing test files, and `stack.yaml`, to
`extra-source-files` so they're included in the source tarball.
* reveal.js template: Fixed parallaxBackground options.
`parallaxBackgroundHorizontal` and `parallaxBackgroundVertical`
need integer values, not strings. (Vaughn Iverson)
pandoc (1.15.2)
* `pandoc my.md -t context -o my.pdf` will now create a PDF using
ConTeXt rather than LaTeX (#2463).
* Fixed omitted `url(...)` in CSS data-uri with `--self-contained` (#2489).
* Added `emoji` Markdown extension, enabled by default in `markdown_github`
(#2523). Added `Ext_emoji` to `Extension` in `Text.Pandoc.Options`
(API change).
* `Text.Pandoc.Readers.HTML.parseTags`: Fixed over-eager raw HTML inline
parsing (#2469). Tightened up the inline HTML parser so it disallows
TagWarnings.
* Derive `Generic` instances for the types in `Text.Pandoc.Options`.
* Org reader:
+ Fix paragraph/list interaction (Albert Krewinkel, #2464).
Paragraphs can be followed by lists, even if there is no blank line
between the two blocks. However, this should only be true if the
paragraph is not within a list, were the preceding block should be
parsed as a plain instead of paragraph (to allow for compact lists).
Thanks to @rgaiacs for bringing this up.
+ Allow toggling header args (Albert Krewinkel, #2269).
Org-mode allows to skip the argument of a code block header argument if
it's toggling a value. Argument-less headers are now recognized,
avoiding weird parsing errors.
+ Fix markup parsing in headers (Albert Krewinkel, #2504).
Markup as the very first item in a header wasn't recognized. This was
caused by an incorrect parser state: positions at which inline markup
can start need to be marked explicitly by changing the parser state.
This wasn't done for headers. The proper function to update the state
is now called at the beginning of the header parser, fixing this issue.
+ Fix emphasis rules for smart parsing (Albert Krewinkel, #2513).
Smart quotes, ellipses, and dashes should behave like normal quotes,
single dashes, and dots with respect to text markup parsing.
+ Require whitespace around definition list markers (#2518).
This rule was not checked before, resulting in bugs with footnotes
and some link types.
* Markdown reader:
+ Pipe tables with long lines now get relative cell widths (#2471).
If a pipe table contains a line longer than the column width (as set by
`--columns` or 80 by default), relative widths are computed based on the
widths of the separator lines relative to the column width. This should
solve persistent problems with long pipe tables in LaTeX/PDF output, and
give more flexibility for determining relative column widths in other
formats, too. For narrower pipe tables, column widths of 0 are used,
telling pandoc not to specify widths explicitly in output formats that
permit this.
+ Improved parser for `mmd_title_block`. We now allow blank metadata
fields. These were explicitly disallowed before.
+ Citation keys can now contain `://`, so URLs and DOIs can be used
as citation keys (jgm/pandoc-citeproc#166).
* Beamer template: fix incompatibility of section slides with natbib.
Natbib (and presumably biblatex) bibliography commands create
their own section. Since these are in frame environments,
we have an incompatibility with the `\AtBeginSection` macro
which creates a special frame when a new section occurs.
(We can't have a frame inside another frame.) This change disables
`\AtBeginSection` inside bibliography slides. Thinks to Yihui Xie for
bringing the problem to my attention. This supersedes #145. See
discussion there.
* Textile reader: don't do smart punctuation unless explicitly asked
(#2480). Note that although smart punctuation is part of the textile
spec, it's not always wanted when converting from textile
to, say, Markdown. So it seems better to make this an option.
* LaTeX reader: Handle `comment` environment (Arata Mizuki).
The `comment` environment is handled in a similar way to the
`verbatim` environment, except that its content is discarded.
* Docx reader: Follow relationships correctly in foot/endnotes (#2258,
Jesse Rosenthal). This fixes a problem with links in notes.
* LaTeX and ConTeXt writers: support `lang` attribute on divs and spans
(Mauro Bieg). For LaTeX, also collect `lang` and `dir` attributes on
spans and divs to set the `lang`, `otherlangs` and `dir` variables if
they aren’t set already. See #895.
* LaTeX writer:
+ Use proper command for `\textarabic` (Mauro Bieg).
+ Added `de-CH-1901`, fixed `el-polyton` in `toPloyglossia` (Nick Bart).
+ Use `\hypertarget` and `\hyperlink` for links. This works correctly
to link to Div or Span elements. We now don't bother defining `\label`
for Div or Span elements. Closes jgm/pandoc-citeproc#174.
+ Avoid footnotes in list of figures (#1506).
+ Properly handle footnotes in captions (#1506).
+ Add `\protect` to `\hyperlink` (#2490). Thanks to Hadrien Mary.
+ Set `colorlinks` if `linkcolor`, `urlcolor`, `citecolor`, or
`toccolor` is set (#2508).
* Textile writer: support start number in ordered lists (#2465).
* OpenDocument writer: Allow customization of opendocument
automatic styles. Automatic styles can now be inserted in the
template, which now provides the enclosing `<office:automatic-styles>`
tags (#2520).
* Docx writer: insert space between footnote reference and note (#2527).
This matches Word's default behavior.
* EPUB writer: don't download linked media when `data-external` attribute
set (#2473). By default pandoc downloads all linked media and includes it
in the EPUB container. This can be disabled by setting `data-external` on
the tags linking to media that should not be downloaded. Example:
<audio controls="1">
<source src="http://example.com/music/toccata.mp3"
data-external="1" type="audio/mpeg">
</source>
</audio>
* HTML writer: use width on whole table if col widths sum to < 100%.
Otherwise some browsers display the table with the columns
separated far apart.
* AsciiDoc template: Fix `author` and `date`; add `keywords`,
`abstract` (Andrew Dunning).
* HTML-based templates (Andrew Dunning):
+ Use en dash instead of hyphen between title prefix and title.
+ Add `keywords` to metadata.
+ Add `lang`, `dir`, `quotes` where missing.
+ Always make author and date display conditional.
+ Updated dzslides template from source.
* Man template: make "generated by" comment conditional.
* LaTeX, Beamer templates:
+ Add `babel-otherlangs` for language divs/spans; `babel-newcommands`,
filled by commands that make babel understand the polyglossia-style
language directives (Mauro Bieg, #137).
+ Improved formatting of conditionals; `$for$` is always provided to allow
multiple options (Andrew Dunning, #141).
+ Use `Ligatures=TeX` rather than `Mapping=tex-text` with `fontspec`
to improve support for LuaTeX (Andrew Dunning, #135).
+ Revise `hyperref` usage (Andrew Dunning, #139, #141):
- use same options for all LaTeX engines;
- add `subtitle` and `keywords` to PDF metadata;
- do not override `hyperref` link coloring without user input, effectively making
the `hidelinks` option the default (removed as a separate variable);
- link colors can be enabled (using a slightly darker version of the old
defaults) using a new `colorlinks` variable, automatically used by
the LaTeX writer when custom colors are specified;
- `pdfborder={0 0 0}` is automatically set by `hyperref` with
`colorlinks`, and is only applied if `colorlinks` is disabled.
* ConTeXt template (Andrew Dunning):
+ New variables for controlling styles: `linkstyle`, `linkcolor`,
`linkcontrastcolor`, `layout`, `pagenumbering`, `whitespace`, `indenting`,
`interlinespace`, `headertext`, `footertext`, `mainfont`, `sansfont`,
`monofont`, `mathfont`, `fontsize`.
+ Default template no longer supports MkII.
+ Improve writing of title block (suppressing numbering of first page).
+ Add `title` `subtitle`, `author`, `date`, `keywords` to PDF metadata.
+ Support `subtitle`, `abstract`.
+ Support list of figures (`lof`), list of tables (`lot`).
+ Disable link styling by default.
+ Define styles for all section types.
+ Enable microtype.
+ Improved formatting of conditionals.
* Beamer template: added code to prevent slide breaks inside paragraphs
(#2422, thanks to Nick Bart). This will matter, in practice, only when
`allowframebreaks` is used. It is especially helpful for bibliography
slides.
* OpenDocument template: Add `<office:automatic-styles>` tag around
automatic styles. The writer now longer provides this (see #2520).
* Restored Text.Pandoc.Compat.Monoid.
* Do not export (<>) from custom Prelude. The Prelude now matches
base 4.8 Prelude's API.
* Don't use custom prelude with ghc 7.10. Use the custom prelude
only for earlier versions. This change makes `stack ghci` and
`cabal repl` work (#2503), at least with ghc 7.10.
* Changed § to % in operators from Odt.Arrows.Utils (#2457).
This prevents problems building haddocks with "C" locale.
* Change default for old-locale flag to False.
* Use stack in deb, osx, and Windows package generators.
* Added Vagrantfile for building deb in vm.
This should help in automating binary package creation. 'make package'
will make the package. 'make package COMMIT=blah' will make the package
from commit blah.
* README:
+ Consistent capitalization for pandoc and Markdown.
+ Fixed `auto_identifiers` examples (Benoit Schweblin).
+ Improved documentation of template variables (Andrew Dunning).
pandoc (1.15.1.1)
* `Text.Pandoc.Data`: store paths in dataFiles using posix separators.
This way we have uniform separators, whether on Windows or Linux.
This should solve a problem where on some Windows versions
the data files weren't being found (#2459).
pandoc (1.15.1)
* `pandocVersion` is now defined in `Text.Pandoc.Shared`
and reexported from `Text.Pandoc` (Alex Vong). This allows
writers to access it. (Alex Vong) (API change)
* For `markdown_mmd`, add: `implicit_figures`, `superscripts`,
`subscripts` (#2401).
* Added `odt` as input format (Martin Linnemann). Added new module
`Text.Pandoc.Reader.ODT` (API change). Fully implemented features:
Paragraphs, Headers, Basic styling, Unordered lists, Ordered lists,
External Links, Internal Links, Footnotes, Endnotes, Blockquotes.
Partly implemented features: Citations, Tables.
* Markdown Reader:
+ Add basic tests for each header style (Ophir Lifshitz).
+ Add implicit header ref tests for headers with spaces (Ophir Lifshitz).
+ Skip spaces in headers (Ophir Lifshitz).
+ Handle 'id' and 'class' in parsing key/value attributes (#2396).
`# Header {id="myid" class="foo bar"}`
is now equivalent to `# Header {#myid .foo .bar}`.
+ Use '=' instead of '#' for atx-style headers in markdown+lhs.
(Kristof Bastiaensen)
+ Pipe tables: allow indented columns. Previously the left-hand column
could not start with 4 or more spaces indent. This was inconvenient
for right-aligned left columns. Note that the first (header column)
must still have 3 or fewer spaces indentation, or the table will be
treated as an indented code block.
+ Fix regression: allow HTML comments containing `--`.
Technically this isn't allowed in an HTML comment, but
we've always allowed it, and so do most other implementations.
It is handy if e.g. you want to put command line arguments
in HTML comments.
* LaTeX reader:
+ Don't eat excess whitespace after macros with only optional
arguments (#2446).
+ Support longtable (#2411).
+ Implement `\Cite` (#2335).
+ Support abstract environment. The abstract populates an
`abstract` metadata field.
+ Properly handle booktabs lines. Lines aren't part of the
pandoc table model, so we just ignore them (#2307).
* HTML reader:
+ Handle type attribute on ol, e.g. `<ol type="i">` (#2313).
+ Updated for new automatic header attributes.
+ Add auto identifiers if not present on headers. This makes
TOC linking work properly.
+ Detect `font-variant` with `pickStyleAttrProps` (Ophir Lifshitz).
+ Test `<ol>` type, class, and inline list-style(-type) CSS
(Ophir Lifshitz).
+ Better handling of "section" elements (#2438). Previously
`<section>` tags were just parsed as raw HTML blocks. With
this change, section elements are parsed as Div elements with
the class "section".
* MediaWiki reader: handle unquoted table attributes (#2355).
* DocBook reader:
+ Added proper support for DocBook `xref` elements (Frerich Raabe).
Added `dbContent` field to reader state, so we can lookup
cross refs.
+ Handle `informalexample` (#2319).
* Docx Reader:
+ Create special punctuation test (Ophir Lifshitz).
+ Parse soft, no-break hyphen elements (Ophir Lifshitz).
+ Updated headers test (Ophir Lifshitz). Replaced `styles.xml`
in `headers.docx` with pandoc's current `styles.xml`, which
contains styles for Heading 1 through 6. Added Heading 4
through 7 to the test document. Note that Heading 7 is not
parsed as a Heading because there is no Heading 7 style.
* RST reader: better handling of indirect roles.
Previously the parser failed on this kind of case
.. role:: indirect(code)
.. role:: py(indirect)
:language: python
:py:`hi`
Now it correctly recognizes `:py:` as a code role.
* Org reader:
+ Add auto identifiers if not present on headers
(#2354, Juliusz Gonera).
+ Allow verse blocks to contain empty lines (#2402,
Albert Krewinkel).
* EPUB reader: stop mangling external URLs (#2284).
* RST writer:
+ Don't insert `\ ` when complex expression in matched pairs.
E.g. `` [:sup:`3`] `` is okay; you don't need `` [:sup:`3`\ ] ``.
+ Ensure that `\ ` is inserted when needed before Cite and Span
elements that begin with a "complex" element (jgm/pandoc-citeproc#157).
+ Normalize headers only in "standalone" mode (#2394).
* Haddock writer: escape `*` and `^` (G. Bataille).
* Markdown writer:
+ In TOC, add links to headers (#829).
+ Use unicode super/subscripts for digits in plain output
(when the `superscripts` and `subscripts` extensions are
not enabled).
* Docx writer:
+ Moved invalid character stripping to `formattedString`.
This avoids an inefficient generic traversal (#2356).
+ Use user data directory for `reference.docx` archive.
This allows the test suite to work without installing pandoc first.
It also brings the docx writer in line with the odt writer.
+ Tests: docx writer tests now use `../data` for data directory.
This allows tests to be run without installing first.
+ Tests: Use real jpg (not empty) for docx tests to avoid warning.
* LaTeX writer:
+ Fixed detection of 'chapters' from template.
If a documentclass isn't specified in metadata, but the
template has a hardwired bookish documentclass, act as if
`--chapters` was used. This was the default in earlier
versions, but it has been broken for a little while.
+ Correctly recognize book documentclass in metadata (#2395).
+ Set language-related variables automatically, depending
on the value of the `lang` field, which is now always
assumed to be in BCP47 format (Mauro Bieg, #1614, #2437).
+ Add `\protect` to `\hyperdef` in inline context. This way we
don't get an error when this is used as a moveable argument (#2136).
+ Support all frame attributes in Beamer.
+ Percent-encode more special characters in URLs (#1640, #2377).
The special characters are '<','>','|','"','{','}','[',']','^', '`'.
* HTML writer:
+ Update KaTeX JS and CSS versions (Emily Eisenberg).
+ For dzslides, add `role="note"` for speaker notes (#1693).
+ Percent-encode more special characters in URLs (#1640, #2377).
The special characters are '<','>','|','"','{','}','[',']','^', '`'.
+ Render Div with class `section` as `<section>` in HTML5.
* EPUB writer:
+ In TOC, replace literal `<br/>` with space (#2105).
+ With `--webtex`, include image file rather than `data:` URI (#2363).
* Native writer: format Div properly, with blocks separated.
* Support bidirectional text output with XeLaTeX, ConTeXt and HTML
(#2191, Mauro Bieg).
* Reference Docx:
+ Add missing Header 6 style (steel blue) (Ophir Lifshitz).
+ Correct `outlineLvl` for Header styles (Ophir Lifshitz).
* Templates
+ Beamer: Add `innertheme`, `outertheme` variables
(Guilhem Bonnefille, #121). Add space after colon in figure caption.
Integrate recent font and language updates from LaTeX template;
allow use of `mainfont` variable for changing the slide text
in XeTeX and LuaTeX (Andrew Dunning, #131).
+ LaTeX: Add `mainfontoptions`, `sansfontoptions`,
`monofontoptions`, `mathfontoptions`, `fontfamilyoptions`
(Andrew Dunning, #122). Support handling of bidirectional
text (Mauro Bieg, #120). Improve reliability of superscripts/subscripts
under XeTeX and prevent letters and numbers from appearing on a
different baseline by removing use of the `realscripts` package
(via `xltxtra`). To restore use of OpenType characters for these
features under XeTeX or LuaTeX, add `\usepackage{realscripts}` to
`header-includes` (Andrew Dunning, #130). Remove redundant
reference to `xunicode` (Andrew Dunning, #130). Add `fontenc`,
`indent`, `subparagraph` variables (Andrew Dunning).
Allow use of `hidelinks` variable for `hyperref` package (Hugo Roy,
#113). Prevent package clash with `tufte-latex` and other classes that
include `hyperref` or `color` (Xavier Olive, #115).
+ ConTeXt: Support handling of bidirectional text (Mauro Bieg, #120).
+ LaTeX and ConTeXt: Use more specific language variables.
Instead of directly using `lang`, we now use `babel-lang` and
`polyglossia-lang` and `context-lang`. These variables are set by
the writers to the necessary values, based on the `lang` variable
(which now always takes a value in BCP47 format). (Mauro Bieg, #114,
#129).
+ HTML: Support handling of bidirectional text (Mauro Bieg, #120).
Move HTML5 shiv after CSS and fix URL (Andrew Dunning).
Add dir attribute in html5 (Andrew Dunning).
+ reveal.js: Add `controls`, `progress` variables (Grégoire Pineau, #127).
Add `width`, `height` variables (Andrew Dunning). Update template
from 3.1 source (Andrew Dunning). All configuration options are now
available as variables, but are only be included if set (reveal.js
uses defaults otherwise).
+ man: Added comment stating that the page is autogenerated by pandoc,
giving version. Added `adjusting` and `hyphenate` variables
(Alex Vong, #123).
* epub.css: added selectors for nested emphasis (Pablo Rodriguez).
* MediaBag: ensure that `/` is always used as path separator.
* `sample.lua`: define `CaptionedImage`, add newline at end (#2393).
* Added `--bash-completion` option. This generates a bash completion
script. To use: `eval "$(pandoc --bash-completion)"`.
* Text.Pandoc.Error: Define Typeable and Exception instances
for PandocError (#2386).
* Text.Pandoc.Parsing: `toKey`: strip off outer brackets.
This makes keys with extra space at the beginning and end
work: e.g.
[foo]: bar
[ foo ]
will now be a link to bar (it wasn't before).
* Text.Pandoc: disable `auto_identifiers` for epub.
The epub writer inserts its own auto identifiers;
this is more complex due to splitting into "chapter" files.
* Renamed Text.Pandoc.Compat.Locale -> Text.Pandoc.Compat.Time.
It now reexports Data.Time.
* Use custom Prelude to avoid compiler warnings.
+ The (non-exported) prelude is in prelude/Prelude.hs.
+ It exports Monoid and Applicative, like base 4.8 prelude,
but works with older base versions.
+ It exports (<>) for mappend.
+ It hides 'catch' on older base versions.
* Added a `stack.ymal` and stack install instructions to INSTALL.
* Clarified what is "out of scope" in README and CONTRIBUTING.md.
* Added note to CONTRIBUTING.md about ghc versions and travis.
* Clarify docs on block quotes. The space after `>` is optional (#2346).
* Removed obsolete reference to default.csl (#2372).
* List all styles in manual for `--reference-docx` (Chris Black)
* Don't capitalize header links in man page.
* Added section on repl to CONTRIBUTING.md.
* README: Added space after backslash in image example (#2329).
* Document details of citation locator terms (Nick Bart).
* Fixed some internal links in README (#2309).
* Improve CSL documentation, variables documentations,
links, and cross-references in README. (Andrew Dunning)
* Fix build failure with `--flags=-https` (Sergei Trofimovich).
* Use `newManager` instead of `withManager` in recent `http-client`.
This avoids a deprecation warning.
* Allow building with latest versions of http-types,
HUnit, criterion, syb, aeson.
* Updated benchmark program for new criterion API.
* Setup.hs: rewrite so as not to use process, directory, filepath.
Using anything outside base is dangerous, since older
versions of ghc may link against two different versions.
* Added appveyor (Windows continuous integration) builds.
* New `.travis.yml`. Autgenerated using `make_travis_yml.hs`.
This script has been modified in a few ways, e.g. to add `GHCOPTS`.
`make .travis.yml` regenerates it based on the tested-with
field of the cabal file.
pandoc (1.15.0.6)
* `--self-contained`: Fixed overaggressive CSS minimization (#2301, 2286).
Previously `--self-contained` wiped out all spaces in CSS,
including semantically significant spaces. This was a regression
from 1.14.x.
* Markdown reader: don't allow bare URI links or autolinks in link
label (#2300). Added test cases.
* `Text.Pandoc.Parsing`, `uri`: Improved bare autolink detection (#2299).
Previously we disallowed `-` at the end of an autolink,
and disallowed the combination `=-`. This commit liberalizes the
rules for allowing punctuation in a bare URI, and adds test cases.
One potential drawback is that you can no longer put a bare
URI in em dashes like this:
`this uri---http://example.com---is an example.`
But in this respect we now match github's treatment of bare URIs.
* HTML writer: support speaker notes in dzslides.
With this change `<div class="notes">` and also `<div class="notes"
role="note">` will be output if `-t dzslides` is used. So we can
have speaker notes in dzslides too. Thanks to maybegeek.
* Updated dzslides template.
* Improved documentation of options to print system default files (#2298).
`--print-default-data-file` and `--print-default-template`.
* DokuWiki writer: use `$..$` for Math instead of `<math>..</math>`
(Tiziano Müller). MathJax seems currently to be the only maintained
math rendering extension for DokuWiki.
* `Text.Pandoc.Shared`: Changed `hierarchicalize` so it treats references
div as top-level header (#2294). This fixes a bug with `--section-divs`,
where the final references section added by pandoc-citeproc, enclosed in
its own div, got nested in the div for the section previous to it.
* Allow vector 0.11.
* Require cmark > 0.4.
pandoc (1.15.0.5)
* HTML writer: Fixed email javascript obfuscation with `mailto:`
URLs (#2280). This fixes a potential security issue. Because
single quotes weren't being escaped in the link portion, a
specially crafted email address could allow javascript code injection.
* Markdown/HTML readers: Avoid parsing partial URLs like
`<www.pandoc.org/blah#foo>` as HTML tags (#2277).
* RST reader: allow inline formatting in definition list field
names (Lars-Dominik Braun).
* PDF: Make sure `--latex-engine-opt` goes before the filename
on the command line. LaTeX needs the argument to come after
the options (#1779).
* CommonMark writer: fixed tags used for super/subscript.
* ConTeXt template: activate hanging indent for definition lists
(Mauro Bieg).
* Make cabal require `hsb2hs` >= 0.3.1 if `embed_data_files` specified.
This is done by adding `hookedPrograms` in `Setup.hs`, which allows us
to include `hsb2hs` in Build-Tools in cabal.
* Improved Windows installer (thanks to nkalvi).
+ When per-machine installation is chosen, the system path
is updated instead of the user's.
+ An appropriate default is used for per-machine installation
directory.
+ Admin privileges are no longer required for a per-user install
* Travis: unpack sdist for build to catch packaging bugs.
* Improved documentation on where user templates go (#2272).
pandoc (1.15.0.4)
* Added pandoc.1 man page to the repository. It is no longer
built as part of the cabal build process. (This proved too
fragile.) pandoc.1 can be regenerated (`make man/pandoc.1`)
when `README` is changed.
* Copying of the man page now respects `--destdir` (#2262).
* Improved error messages for filters. User is now informed if
the filter requires an interpreter that isn't found in the path,
or if the filter returns an error status.
pandoc (1.15.0.3)
* Ensure target directory is created when installing man page.
pandoc (1.15.0.2)
* Added files needed for building man page to Extra-Source-Files.
pandoc (1.15.0.1)
* Man page is now built and installed as part of the cabal build
process. Removed Makefile target for man page.
pandoc (1.15)
* Man page changes:
+ Removed `--man1`, `--man5` options (breaking change).
+ Removed `Text.Pandoc.ManPages` module (breaking API change).
+ Makefile target for `man/man1/pandoc.1`. This uses pandoc to
create the man page from README using a custom template and filters.
+ Added `man/` directory with template and filters needed to build
man page.
+ We no longer have two man pages: `pandoc.1` and `pandoc_markdown.5`.
Now there is just pandoc.1, which has all the content from README.
This change was needed because of the extensive cross-references
between parts of the README.
+ Removed old `data/pandoc.1.template` and
`data/pandoc_markdown.5.template`.
* OpenDocument writer: Do not add a carriage return after a hard
line break (Michael Chladek).
* ConTeXt writer:
+ use `\goto` for internal links.
+ Added a `%` at end for `\reference` to avoid spurious space.
* Ignore sandbox on 'make quick'
pandoc (1.14.1)
* Added `--man1` and `--man5` options to pandoc, allowing pandoc
to generate its own man pages. Man pages are no longer automatically
generated in the build process (the process for this was too complex
and prone to failure, #2190). The `make-pandoc-man-pages` executable
has been removed. The `man/` directory has been removed, and man page
templates have been moved to `data/`. NOTE TO PACKAGERS: You will no
longer find pandoc's man pages in `man/`, but you can generate them using
`pandoc --man1 > pandoc.1` and `pandoc --man5 > pandoc_markdown.5`.
* Added new unexported module: `Text.Pandoc.ManPages`.
* `README` now acts like a data file (even though it isn't in
`data/`). So, for example, `pandoc --print-default-data-file README`
will produce the README.) This change was required for the `--man1`
and `--man5` options, since the man pages are produced from the
README, but it may be useful for other purposes as well.
* Allow `reference.docx` and `reference.odt` to be used with
`--print-default-data-file` and to shadow defaults if placed in
the user data directory. Note that as of 1.14, we no longer
include these files as data files; instead, we include their
components. This change causes pandoc to behave as if it has
these data files; they are constructed on demand when needed
using `getDefaultReferenceDocx` and `getDefaultReferenceODT`.
* Fixed regression in CSS parsing with `--self-contained` (#2224).
Pandoc 1.14.0.x used css-text to parse the CSS, but its parser
silently drops big sections of CSS. This commit replaces the
use of css-text with a small but principled CSS preprocessor,
which removes whitespace and comments and replaces `url()` with
base 64 data when possible.
* Use `https://` instead of `//` for MathJax and KaTeX CDN URLs (#1920).
This will allow math to work when pages are being viewed locally.
* `Text.Pandoc.Options`: Export `plainExtensions`.
These are the extensions used in `plain` output.
* LaTeX reader: Don't parse `_` and `^` as sub/superscript outside of
math mode; treat them as regular inline text. Normally these will
cause an error in LaTeX, but there are contexts (e.g. `alltt`
environments) where they are allowed.
* HTML reader: allow `<body>` to close `<head>`.
* DocBook reader: support `mediaobject`s and `figures` (#2184, Mauro Bieg).
* RST reader: Fix reference names with special characters
(Lars-Dominik Braun).
* Textile writer: escape `+` and `-` as entities (#2225).
* DokuWiki writer: Use proper `<code>` tags for code blocks (#2213).
* Plain writer: don't use symbols for super/subscript (#2237).
Simplified code by using `plainExtensions`.
* InDesign writer: Properly escape URLs containing more than one
colon character (gohai).
* Docx writer: Make sure we use dist version of `reference.docx`
(and not the user's version) for certain settings. Taking some
settings values from a user-supplied reference.docx can lead to
corruption. This fixes a regression from the last release (#2249).
* `Text.Pandoc.Shared`: exports `getDefaultReferenceDocx` and
`getDefaultReferenceODT` (API change). These functions have been
removed from the Docx and ODT writers.
* LaTeX template (Xavier Olive):
+ Added `CJKmainfont` and `CJKoptions` variables.
+ Allow dvipsnames (e.g. `MidnightBlue`) for colors (Xavier Olive).
* Epub templates: use `author.role`, not `author.type`.
* Bump cmark version to >= 0.3.4.