git.iko.soy/typeable/pandoc
on master help sign in
Bump to 2.14.0.2, update chaneglog and manual.
commit67b3c36a9338364a0a7aa95b20dffafd16f6c36a authorJohn MacFarlane <jgm@berkeley.edu> dateThu 10 Jun 2021, 22:47 (5 years ago) parent3776e82
4 files changed+122−14
MANUAL.txt+1−1 changelog.md+101 man/pandoc.1+19−12 pandoc.cabal+1−1
MANUAL.txt+1−1
@@ -1,7 +1,7 @@
11---
22title: Pandoc User's Guide
33author: John MacFarlane
4−date: May 31, 2021
4+date: June 11, 2021
55---
66
77# Synopsis
changelog.md+101
@@ -1,5 +1,106 @@
11# Revision history for pandoc
22
3+## pandoc 2.14.0.2 (2021-06-11)
4+
5+ * Fix MediaBag regressions (#7345). iIn the 2.14 release `--extract-media`
6+ stopped working as before; there could be mismatches between the
7+ paths in the rendered document and the extracted media.
8+ This patch makes several changes that restore the earlier behavior
9+ (while keeping the same API). The `mediaPath` in 2.14 was always
10+ constructed from the SHA1 hash of the media contents. Now, we
11+ preserve the original path unless it's an absolute path or contains
12+ `..` segments (in that case we use a path based on the SHA1 hash of
13+ the contents).
14+
15+ In Text.Pandoc.MediaBag, `mediaDirectory` and `mediaItems` now use the
16+ `mediaPath`, rather than the mediabag key, for the first component of the
17+ tuple. This makes more sense, I think, and fits with the documentation of
18+ these functions; eventually, though, we should rework the API so that
19+ `mediaItems` returns both the keys and the MediaItems.
20+
21+ In Text.Pandoc.Class.IO, rewriting of source paths in `extractMedia` has
22+ been fixed.
23+
24+ In Text.Pandoc.Class.PandocMonad, `fillMediaBag` has been modified so that
25+ it doesn't modify image paths (that was part of the problem in #7345).
26+
27+ We now do path normalization (e.g. `\` separators on Windows) in
28+ writing the media.
29+
30+ * Text.Pandoc.PDF:
31+
32+ + Text.Pandoc.PDF: Fix regression in 2.14 for generation of PDFs with
33+ SVGs (#7344).
34+ + Only print relevant part of environment on `--verbose`. Since
35+ `--verbose` output might be put in an issue, we want to avoid
36+ spilling out secrets in environment variables.
37+
38+ * Markdown reader: fix pipe table regression in 2.11.4 (#7343).
39+ Previously pipe tables with empty headers (that is, a header
40+ line with all empty cells) would be rendered as headerless
41+ tables. This broke in 2.11.4. The fix here is to produce an
42+ AST with an empty table head when a pipe table has all empty
43+ header cells.
44+
45+ * LaTeX reader: don't allow optional `*` on symbol control sequences
46+ (#7340). Generally we allow optional starred variants of LaTeX commands
47+ (since many allow them, and if we don't accept these explicitly,
48+ ignoring the star usually gives acceptable results). But we
49+ don't want to do this for `\(*\)` and similar cases.
50+
51+ * Docx writer: fix handling of empty table headers (Albert Krewinkel,
52+ #7369). A table header which does not contain any cells is now treated as
53+ an empty header.
54+
55+ * LaTeX writer: Fix regression in table header position (#7347).
56+ In recent versions the table headers were no longer bottom-aligned
57+ (if more than one line). This patch fixes that by using minipages
58+ for table headers in non-simple tables.
59+
60+ * CommonMark writer:
61+
62+ + Do not use simple class for fenced-divs (Jan Tojnar, amends #7242.)
63+ + Do not throw away attributes when `Ext_attributes` is enabled.
64+ `Ext_attributes` covers at least the following:
65+ `Ext_fenced_code_attributes`, `Ext_header_attributes`,
66+ `Ext_inline_code_attributes`, `Ext_link_attributes`.
67+
68+ * Markdown writer: re-use functions from Text.Pandoc.Markdown.Inline (Jan
69+ Tojnar).
70+
71+ * DocBook writer: Remove non-existent admonitions (Jan Tojnar).
72+ `attention`, `error` and `hint` are reStructuredText specific.
73+
74+ * HTML writer: Don't omit width attribute on div (#7342).
75+
76+ * Text.Pandoc.MIME, `extensionFromMimeType`: add a few special cases.
77+ When we do a reverse lookup in the MIME table, we just get the
78+ last match, so when the same mime type is associated with several
79+ different extensions, we sometimes got weird results, e.g. `.vs`
80+ for `text/plain`. These special cases help us get the most standard
81+ extensions for mime types like `text/plain`.
82+
83+ * Lua utils: fix handling of table headers in `from_simple_table` (Albert
84+ Krewinkel, #7369). Passing an empty list of header cells now results
85+ in an empty table header.
86+
87+ * Text.Pandoc.Citeproc: avoid duplicate classes and attributes on
88+ references div.
89+
90+ * Require citeproc 0.4.0.1. This fixes a bug which led to doubled
91+ "et al." in some (rare) circumstances.
92+
93+ * MANUAL.txt:
94+
95+ + Mention GladTeX for EPUB export (Sebastian Humenda).
96+ This updates the manual and the web site about the GladTeX usage.
97+ + More details and a useful link for YAML syntax.
98+
99+ * CONTRIBUTING.md: update modules overview (Albert Krewinkel).
100+
101+ * using-the-pandoc-api.md: switch from String to Text (Albert Krewinkel).
102+
103+
3104## pandoc 2.14.0.1 (2021-06-01)
4105
5106 * Commonmark reader: Fix regression in 2.14 with YAML metdata block parsing,
man/pandoc.1+19−12
@@ -1,7 +1,7 @@
11'\" t
2−.\" Automatically generated by Pandoc 2.14
2+.\" Automatically generated by Pandoc 2.14.0.1
33.\"
4−.TH "Pandoc User\[cq]s Guide" "" "May 31, 2021" "pandoc 2.14.0.1" ""
4+.TH "Pandoc User\[cq]s Guide" "" "June 11, 2021" "pandoc 2.14.0.2" ""
55.hy
66.SH NAME
77pandoc - general markup converter
@@ -716,11 +716,11 @@ Extract images and other media contained in or linked from the source
716716document to the path \f[I]DIR\f[R], creating it if necessary, and adjust
717717the images references in the document so they point to the extracted
718718files.
719−If the source format is a binary container (docx, epub, or odt), the
720−media is extracted from the container and the original filenames are
721−used.
722−Otherwise the media is read from the file system or downloaded, and new
723−filenames are constructed based on SHA1 hashes of the contents.
719+Media are downloaded, read from the file system, or extracted from a
720+binary container (e.g.\ docx), as needed.
721+The original file paths are used if they are relative paths not
722+containing \f[C]..\f[R].
723+Otherwise filenames are constructed from the SHA1 hash of the contents.
724724.TP
725725\f[B]\f[CB]--abbreviations=\f[B]\f[R]\f[I]FILE\f[R]
726726Specifies a custom abbreviations file, with abbreviations one to a line.
@@ -1504,16 +1504,16 @@ inserted.
15041504.TP
15051505\f[B]\f[CB]--gladtex\f[B]\f[R]
15061506Enclose TeX math in \f[C]<eq>\f[R] tags in HTML output.
1507−The resulting HTML can then be processed by GladTeX to produce images of
1508−the typeset formulas and an HTML file with links to these images.
1509−So, the procedure is:
1507+The resulting HTML can then be processed by GladTeX to produce SVG
1508+images of the typeset formulas and an HTML file with these images
1509+embedded.
15101510.RS
15111511.IP
15121512.nf
15131513\f[C]
15141514pandoc -s --gladtex input.md -o myfile.htex
1515−gladtex -d myfile-images myfile.htex
1516−# produces myfile.html and images in myfile-images
1515+gladtex -d image_dir myfile.htex
1516+# produces myfile.html and images in image_dir
15171517\f[R]
15181518.fi
15191519.RE
@@ -4820,6 +4820,13 @@ abstract: |
48204820\f[R]
48214821.fi
48224822.PP
4823+The literal block after the \f[C]|\f[R] must be indented relative to the
4824+line containing the \f[C]|\f[R].
4825+If it is not, the YAML will be invalid and pandoc will not interpret it
4826+as metadata.
4827+For an overview of the complex rules governing YAML, see the Wikipedia
4828+entry on YAML syntax.
4829+.PP
48234830Template variables will be set automatically from the metadata.
48244831Thus, for example, in writing HTML, the variable \f[C]abstract\f[R] will
48254832be set to the HTML equivalent of the Markdown in the \f[C]abstract\f[R]
pandoc.cabal+1−1
@@ -1,6 +1,6 @@
11cabal-version: 2.2
22name: pandoc
3−version: 2.14.0.1
3+version: 2.14.0.2
44build-type: Simple
55license: GPL-2.0-or-later
66license-file: COPYING.md