* Sat Oct 05 2024 Peter Simons <psimons@suse.com>
- Update pandoc to version 3.5.
Upstream has edited the change log file since the last release in
a non-trivial way, i.e. they did more than just add a new entry
at the top. You can review the file at:
http://hackage.haskell.org/package/pandoc-3.5/src/changelog.md
* Tue Sep 10 2024 Peter Simons <psimons@suse.com>
- Update pandoc to version 3.4.
[#]# pandoc 3.4 (2024-09-09)
* New output format: `ansi` (for formatted console output) (Evan Silberman).
Most Pandoc elements are supported and printed in a reasonable way, if
not always ideally. This version does no detection of terminal
capabilities, nor does it fall back to different output styles for
less-capable terminals.
* Add command line options `--table-caption-position` and
`--figure-caption-position`. These allow the user to specify whether
to put captions above or below tables and figures, respectively.
The following output formats are supported: HTML (and related such
as EPUB), LaTeX (and Beamer), Docx, ODT/OpenDocument, Typst.
* Change default `--pdf-engine` via HTML to WeasyPrint (#10142).
`wkhtmltopdf` is deprecated. `weasyprint` is the easiest-to-install,
maintained alternative. For better results, one might prefer
`pagedjs-cli`.
* Org reader:
+ Fix parsing of src blocks with an `-i` flag (#10071, Albert Krewinkel).
Tabs are now preserved in the contents of *src* blocks if the the block
has the `-i` flag.
* RTF reader:
+ Handle images inside `shp` contexts (#10145).
* RST reader:
+ Improve simple table support (#10093). Multiline rows occur
only when the *first* cell is empty; we were previously treating
lines with *any* empty cell as row continuations. In addition, we
no longer wrap multiline cells in Para if they can be represented
as Plain. This is consistent with docutils behavior.
* LaTeX reader:
+ Math environments don't have bracketed options (#10160).
+ Parse nested tabular environments (#4746).
* Typst reader:
+ Change how "block" elements are handled. Previously they were
always parsed as divs. But actually they can occur in some "inline"
contexts. Now we first try to parse them as inlines, and only as
blocks if that fails. A surrounding Div or Span element is added
only if there is an identifier.
* HTML reader:
+ Only parse main element's contents (if present) (#10140).
If main has an id or class, we include a div with that id or class;
otherwise just the contents.
+ Read TeX annotation in MathML content if present (#9971).
+ Better handle KaTeX-generated math (#9971). KaTeX emits the mathml
followed by a span with an HTML fallback. Previously pandoc was
converting both. We now ignore the HTML fallback span, marked
with class `katex-html`.
* New module: Text.Pandoc.Writers.ANSI [API change] (Evan Silberman).
* Docx writer:
+ Add "SuppressAuthor" and "AuthorOnly" to citationMode
when `+citations` is used (thomjur).
+ Support `custom-style` attribute for docx table (Sebbones).
+ Support `--number-offsets`.
+ Make table/figure rendering sensitive to caption position settings.
* OpenDocument writer:
+ Make table/figure rendering sensitive to caption position settings.
* Typst writer/template:
+ Implement figure caption positions by triggering a show rule in
the default template, which determines caption positions for
figures and tables globally.
+ Don't include trailing semicolon after `@` style citations with suffixes
(#10148).
+ Template: move header-includes before show doc (#9996, Gordon Woodhull).
* LaTeX writer:
+ Make table/figure rendering sensitive to caption position settings (#5116).
+ Preserve locator labels with `--natbib` (#10057).
* HTML writer/template:
+ Make `<figcaption>` placement sensitive to caption position
settings. For tables, `<caption>` must be the first element, and
positioning is determined by CSS, for here we set a variable
which the default template is sensitive to.
+ Use `makeSectionsWithOffsets` for `writerNumberOffsets`,
instead of the old, inefficient code.
+ Don't add doc-biblioref role to every link in a citation;
only to links to the bibliography (#10156).
+ Add `data-` when rendering `label` attribute (#10048).
* Markdown writer:
+ Avoid emitting markdown caption if table has fallen back to raw HTML,
which will then contain a `<caption>` tag (#10094).
+ Make math sensitive to `tex_math_gfm` extension (#9121).
This means that in GFM output, the "new style" math will be used
by default, e.g.
$`x=y`$
```math
x = y
```
To defeat this and get the older behavior, namely
$x=y$
$$x=y$$
one could use `-t gfm-tex_math_gfm`.
* AsciiDoc writer:
+ Add `link:` prefix when needed (#10105). AsciiDoc requires it
except for `http`, `https`, `irc`, `mailto`, `ftp` schemes (#10105).
+ Preserve original base level (#10062). We used to normalize so
that the base level is always 1, but asciidoc no longer seems
to care about that, and the behavior creates difficulties when
we are converting fragments.
+ Don't emit empty figure caption (#10047).
* ODT writer:
+ Add TableCaption to styles.xml (#10058, Ian Max Andolina).
* LaTeX template:
+ Fix wrong beamer color in (sub)section page (Jonathan).
* Text.Pandoc.Options:
+ Add `CaptionPosition` and new `WriterOptions` fields
`writerFigureCaptionPosition` and `writerTableCaptionPosition`
[API change].
* Text.Pandoc.Opt:
+ Change default for optNumberOffset to `[]`. This behaves the same as
`[0,0,0,0,0]`.
+ Add `Opt` fields `optFigureCaptionPosition` and
`optTableCaptionPosition` [API change].
* Text.Pandoc.Format: change `formatFromFilePaths` so that it is
smarter about URLs. URLs are parsed, and we take the format from
the path component, if present (#10141). This means that
`https://emacs.org/` will be treated as HTML, while
`https://emacs.org/sample.org` will be treated as Org.
* Text.Pandoc.URI:
+ Add unofficial `gemini:` to list of URI schemes (Pau RE).
* Text.Pandoc.Shared:
+ Add `makeSectionsWithOffsets` [API change].
+ Remove `stripEmptyParagraphs [API change] (Albert Krewinkel).
This function is no longer used.
* Text.Pandoc.Highlighting: Expose `formatANSI` [API change]
(Evan Silberman).
* Text.Pandoc.Writers.Shared: export `to{Sub,Super}scriptInline`
[API change] (Evan Silberman).
* Remove use of partial functions (e.g. `head`) in code.
* Use latest skylighting-core, skylighting, doclayout, texmath, typst.
* pandoc-lua-engine: Add accessors for several writer options, including
some that were added in previous releases.
* pandoc-server: Initialize some missing fields in WriterOptions:
`writerEpubTitlePage`, `writerChunkTemplate`, `writerListTables`,
`writerFigureCaptionPosition`, `writerTableCaptionPosition`.
* CONTRIBUTING.md: Summarize steps for adding a new cli option.
* MANUAL.txt:
+ Clarify that the `--number-offset` option should only
directly affect numbering of the first section heading in
a document; subsequent headings will increment normally.
+ Fix asciidoc link (#10039).
+ Fix CSL Docs broken link (#10100, Tristano Ajmone).
+ Document the use of `luatexja` when CJKmainfont is used with lualatex
(#3873, Kolen Cheung).
+ Add a `citations` (typst) section to the manual (#9127).
+ Clarify that `citations` affects both input and output for `org`.
+ Add note on `--citeproc` that you may need to disable `citations`
extension on the output format (e.g., `-t markdown-citations`) to
see the rendered citation (#9127, #10012).
* INSTALL.md — reorganise info on static binaries and add conda-forge
install options (#10098, #10069, Ian Max Andolina).
* Mon Jul 29 2024 Peter Simons <psimons@suse.com>
- Update pandoc to version 3.3.
Upstream has edited the change log file since the last release in
a non-trivial way, i.e. they did more than just add a new entry
at the top. You can review the file at:
http://hackage.haskell.org/package/pandoc-3.3/src/changelog.md
* Mon Jun 24 2024 Peter Simons <psimons@suse.com>
- Update pandoc to version 3.2.1.
[#]# pandoc 3.2.1 (2024-06-24)
* Fix `gfm_auto_identifiers` to replace emojis with their aliases,
as documented (#9876).
* CSV reader:
+ Turn line breaks into LineBreaks not SoftBreaks (#9797).
* Docx reader:
+ Support task lists (#8211).
+ Fix a small bug in parsing delimiters in numbered lists,
which led to the default delimiter being used wrongly in some cases.
+ Improve handling of captions.
- Turn captioned images into Figure elements. Closes #9391.
- Improve the logic for associating elements with captions (#9358).
- Ensure that captions that can't be associated with an
element aren't just silently dropped (#9610).
+ Support HorizontalRule. We support both pandoc-style and the style
described on a Microsoft support page, an empty paragraph with
a bottom border (#6285).
+ React to `"left"` value on `jc` attribute.
+ Handle column and cell alignments (#8551). We take the column alignments
from the first body row.
+ Fix a bug that caused comments inside insertions or deletions
to be ignored (#9833).
* HTML reader:
+ Better handle non-`li` elements in `ul` and `ol` (#9809).
For example, a `p` after a closed `li` will be incorporated into
the previous `li`. This mirrors what browsers do with this
invalid HTML.
* LaTeX reader:
+ Fix parsing of dimensions beginning with `.`, e.g. `\kern.1pt` (#9902).
* Markdown reader:
+ Allow author-only textual citations (#7219). E.g. `-@reese2002`
outside of brackets.
* RST reader:
+ Tighten up rules for when emphasis can start (#9805).
+ Support `:cite:` role with citeproc (#9904). A subset of the
functionality of the sphinxcontrib-bibtex extension to Sphinx
is supported.
* Textile reader:
+ Don't let spans begin right after a symbol (#9878).
* Texinfo writer:
+ Ensure proper escaping in all node/link contexts.
+ Target node rather than anchor when possible in internal links.
+ Remove illegal characters from internal link anchors (#6177).
+ Use two commas not one in `@ref`.
+ Don't add anchors to headings. We don't need them, now that we
make internal links use the node.
+ Avoid duplicate node names.
+ Improve menus. Properly handle the case where the node name is
different from the descriptive title.
* Texinfo template: add variables for filename and version.
* Typst reader:
+ Fix an incomplete pattern match (#9807).
+ Handle inline bodies ending in a parbreak. E.g.
```
`#strong[
test
]
```
* ConTeXt template: remove `\setupbackend[export=yes]` (#9820).
* Docx writer:
+ Omit `jc` attribute on table cells with AlignDefault (#5662).
+ Better formatting for task lists. Task lists are now properly
formatted, with no bullet (#5198).
+ Replace an expensive generic traverse to remove Space elements,
for better performance.
+ The new OpenXML template had spaces for metadata that need
to be filled with OpenXML fragments with the proper shape.
This patch ensures that everything is the right shape.
+ Wrap figures with `id` in a bookmark (#8662).
+ Add eastAsia font hints to `w:r` (#9817). We do this when the text
in the run contains any CJK characters. This ensures that ambiguous
code points (e.g. quotation marks) will be represented as "wide"
characters when together with CJK characters.
+ Clean up Abstract Title and Subtitle in default reference docx.
Center Subtitle, remove color.
+ Allow OpenXML templates to be used with `docx` (#8338, #9069, #7256,
[#2928]). The `--reference-doc` option allows customization of styles in
docx output, but it does not allow one to adjust the content of the output
(e.g., changing the order in which metadata, the table of contents,
and the body of the document are displayed), or adding boilerplate
text before or after the document body. For these changes, one can
now use `--template` with an OpenXML template. (See the default
`openxml` template for a sample.) `--include-before-body` and
`--include-after-body` can also now be used with `docx` output.
The included files must be OpenXML fragments suitable for
inclusion in the document body.
+ New unexported module Text.Pandoc.Writers.Docx.OpenXML.
* HTML writer:
+ Ensure URI escaping needed for `html4` (#9905).
Unicode characters need not be escaped for html5, and still won't be.
+ Don't emit unnecessary classes in HTML tables (#9325, Thomas Soeiro).
Pandoc used to emit a `header` class on the `tr` element that forms
the table header. This is no longer needed, because `head > tr` will
do the same thing. Similarly, pandoc used to emit `even` and `odd`
classes on `tr`s, allowing striped styling. This is no longer needed,
because one can use e.g. `tbody tr:nth-child(2n)`.
Compatibility warning: users who relied on these classes to style
tables may need to adjust their CSS.
* JATS writer:
+ Support `supplementary-material` in metadata for `jats_articlepublishing`
(#9818).
* LaTeX writer:
+ New method for ensuring images don't overflow (#9660).
Previously we relied on graphicx internals and made global
changes to Gin to force images to be resized if they exceed
textwidth. This approach is brittle and caused problems
with `\includesvg` (see #9660). The new approach uses a new macro
`\pandocbounded` that is now defined in the LaTeX template.
(Thanks here to Falk Hanisch in https://github.com/mrpiggi/svg/issues/60.)
The LaTeX writer has been changed to enclose `\includegraphics`
and `\includesvg` commands in this macro when they don't explicitly
specify a width or height. In addition, the writer now adds
`keepaspectratio` to the `\includegraphics` or `\includesvg`
options if `height` is specified without width, or vice versa.
Previously, this was set in the preamble as a global option.
Users should attend to the following compatibility issues:
- If custom templates are used with the new LaTeX writer, they will have
to be updated to include the new `\pandocbounded` macro, or an error
will be raised because of the undefined macro.
- Documents that specify explicit dimensions for an image may render
differently, if the dimensions are greater than the line width or
page height. Previously pandoc would shrink these images to fit,
but the new behavior takes the specified dimensions literally.
In addition, pandoc previously always enforced `keepaspectratio`,
even when width and height were both specified, so images with
width and height specified that do not conform to their intrinsic
aspect ratio will appear differently.
+ Task lists must be unordered (#9185).
+ Specify language option for `selnolig` and only include it if
`english` or `german` is used (#9863). (This includes changes to the
LaTeX template.) This should restore proper ligature suppression when
lualatex is used.
+ Fix `--toc-depth` with beamer output (#9861). Previously only top-level
sections were ever included in the TOC, regardless of the setting of
`--toc-depth`.
+ Use `\linewidth` instead of `\columnwidth` or `\textwidth`
for resizing figures, table cells, etc. in LaTeX (#9775).
`\linewidth`, unlike the others, is sensitive to indented environments
like lists.
* LaTeX template: put `babel-lang` in options to beamer (#9868).
This is required to make beamer use proper localized terms for
things like "Section."
* Markdown writer:
+ Don't print extra caption when using `implicit_figures`.
+ Ensure blank line after HTML blocks in commonmark-based formats (#9792).
+ Fix bug rendering block quotes in lists (#9908).
* Typst writer:
+ Support '.typst:no-figure' and 'typst:figure:kind=kind' attributes
(#9778, Carlos Scheidegger). This extends support for fine-grained
properties in Typst. If the `typst:no-figure` class is present on a
Table, the table will not be placed in a figure. If the
`typst:figure:kind` attribute is present, its value will be used
for the figure's `kind` (#9777). These features are documented in
`doc/typst-property-output.md`.
* Typst template:
+ Add subtitle (#9747, Mickaël Canouil).
+ Use content rather than string for title, author, date, email (#9823).
This allows formatting in title, author, date, and email fields.
Since the PDF metadata requires a string, and typst only
converts the title to a string (not the authors), we use
* Textile writer:
+ Get rid of header, odd, even classes on `tr` (#9376).
* Text.Pandoc.Class:
+ `fillMediaBag`: Convert IOErrors to warnings when fetching absolute
paths (#9859, Albert Krewinkel). This will allow many conversions that
would have failed with an error to succeed (albeit without images or
other needed resources).
* Text.Pandoc.ImageSize:
+ Don't prefer exif width/height when they conflict with image
width/height (#9871). That was a mistaken call in #6936.
Usually when these values disagree, it is because the image
has been resized by a tool that leaves the original exif values
the same, so the width/height metadata are more likely to be
correct that exif width/height.
* Text.Pandoc.SelfContained:
+ Strip CRs from XML before base64 encoding for data URI
(so tests can work on Windows).
+ Only create `<svg>` elements for SVG images when the image has
the class `inline-svg`. Otherwise just use a `data` URI as we do
with other images (#9787).
* Lua subsystem (Albert Krewinkel):
+ Split Init module into more modules. The module has grown unwieldy and
is therefore split into three internal Haskell modules, `Init`,
`Module`, and `Run`.
+ Add function `pandoc.utils.run_lua_filter` (#9803).
+ Add function `pandoc.template.get` (#9854, co-authored by Carsten Gips).
The function allows to specify a template with the same argument value
that would be used with the `--template` command line parameter.
+ Keep CommonState object in the registry. The state is an internal
value and should be treated as such. The `PANDOC_STATE` global is
merely a copy; unsetting the global no longer breaks the Lua engine.
+ Allow passing an environment to `run_lua_filter`.
The default is now to use a *copy* of the global environment when running
a filter; this ensures better separation when `run_lua_filter` is used
multiple times. A custom environment can be specified via the
optional third parameter.
+ Set `pandoc.List` as default metatable for JSON lists (#9834).
Lists created by `pandoc.json.decode` now behave like lists generated
via `pandoc.List`. This also ensures that `pandoc.List` tables are
encoded as JSON arrays when passed to `pandoc.json.encode`.
* Text.Pandoc.Writers.Shared: export `toTaskListItem` [API change].
* Add unexported module Text.Pandoc.Char. This exports `isCJK`.
Use this instead of locally defined `isCJK` in T.P.Readers.MediaWiki.
* MANUAL.txt:
+ Remove false claim that Lua mode does not support `-i` (#9757,
Ian Max Andolina).
+ Use level-3 headings for extensions (to avoid gaps).
+ Add anchor for tagging extension.
+ Remove explicit referencess to generate anchors.
These will be linkified automatically.
+ Fixed links to `option--reference-doc`.
+ Add a note that column widths aren't supported in pptx for Divs
with class `columns` (#9890).
+ Fix alerts example (#9826, Ian Max Andolina).
+ Fix markup of `babelfonts` example code (Albert Krewinkel).
* `doc/custom-writers.md`:
+ Fix usage of Template in example (Albert Krewinkel).
+ Document the separator arg of `Writer.Blocks` (Albert Krewinkel).
* `doc/lua-filters.md` (Albert Krewinkel):
+ Fix outdated documentation for math and quoting functions and fields.
+ Autogenerate docs for module `pandoc.template` and `pandoc.layout`.
+ Document operators of the "Doc" type.
* pandoc-lua-engine: depend on pandoc >= 3.2 (see #9755).
* Allow crypton-connection 0.4, time 1.14.
* Allow tasty-quickcheck 0.11.
* Use latest emojis, skylighting, skylighting-core, citeproc, djot,
commonmark-extensions, typst-hs
* Sat May 11 2024 Peter Simons <psimons@suse.com>
- Update pandoc to version 3.2.
Upstream has edited the change log file since the last release in
a non-trivial way, i.e. they did more than just add a new entry
at the top. You can review the file at:
http://hackage.haskell.org/package/pandoc-3.2/src/changelog.md
* Sun Apr 07 2024 Peter Simons <psimons@suse.com>
- Update pandoc to version 3.1.13.
Upstream has edited the change log file since the last release in
a non-trivial way, i.e. they did more than just add a new entry
at the top. You can review the file at:
http://hackage.haskell.org/package/pandoc-3.1.13/src/changelog.md
* Mon Mar 18 2024 Peter Simons <psimons@suse.com>
- Update pandoc to version 3.1.12.3.
[#]# pandoc 3.1.12.3 (2024-03-17)
* Markdown reader: Fix bug with footnotes at end of fenced div (#9576).
* LaTeX reader:
+ Improve tokenization of `@` (#9555). Make tokenization sensitive to
`\makeatletter`/`\makeatother`. Previously we just always treated
`@` as a letter. This led to bad results, e.g. with the sequence `\@`.
E.g., `a\@ b` would parse as "ab" and `a\@b` as "a".
+ Make `withRaw` work inside `parseFromToks` (#9517).
This is needed for raw environments to work inside table cells.
+ Better handling of table colwidths (#9579). Previously the parser just
failed if the column width specified in `p{}` wasn't a multiple of
`\linewidth`. This led to cases where content was skipped.
* Typst writer:
+ Add 'kind' parameter to figures with tables (#9574).
+ Avoid unnecessary box around image in figure (#9236).
+ Omit width/height in images unless explicitly specified (#9236).
Previously we computed width/heigth for images that didn't have
size information, because otherwise typst would expand the image
to fit page width. This typst behavior has changed in 0.11.
This change fixes a bug in which images would sometimes overflow
page margins, depending on their intrinsic size.
+ Don't add hard-coded `inset` to tables (#9580). Instead, set this
globally in the default template, allowing it to be customized.
* LaTeX template: Fix block headings support for unnumbered paragraphs
(#9542, #6018, Oliver Fabel).
* HTML templates: Replace polyfill provider (#2384, @SukkaW).
Replace polyfill.io with cdnjs.cloudflare.com/polyfill.
polyfill.io has been acquired by Funnull, and the service has
become unstable.
* Korean translations: delete colon in translation for 'to'.
This was invalid YAML, and not desired anyway, since a colon
is added.
* Use latest commonmark, commonmark-extensions.
This fixes a 3.12 regression in parsing of commonmark/gfm autolinks
(jgm/commonmark-hs#151).
* Depend on djot 0.1.1.3, which fixes a serious parsing bug affecting
regular paragraphs after lists.
* Depend on latest skylighting, skylighting-core, typst-hs, texmath.
* MANUAL.txt: Change broken link to IDML cookbook (#9563).
* Fri Mar 01 2024 Peter Simons <psimons@suse.com>
- Update pandoc to version 3.1.12.2.
[#]# pandoc 3.1.12.2 (2024-02-29)
* Docx reader:
+ Ensure that table captions are counted (#9518).
+ Detect caption by style name not id (#9518).
The styleId can change depending on the localization.
+ Avoid emitting empty paragraph where caption was.
* Markdown reader: fix regression in link parsing with wikilinks extensions
(#9481). This fixes a regression introduced in 3.1.12.
* Org reader/writer: support admonitions (#9475).
* Org writer: omit extra blank line at end of quote block.
* Typst writer: ensure that `-`, `+`, etc. are escaped at beginning of block
(#9478). Our recent relaxing of escaping (#9386) caused problems for
things like emphasized `-` characters that were rendered using
`#strong[-]#`. This now gets rendered as `#strong[\-]`.
* LaTeX writer: fix bug when a language is specified in two different ways
(#9472). If you used `lang: de-DE` but then had a span or div with
`lang=de`, the preamble would try to load `ngerman` twice, leading
to an error. This fix ensures that a language is only loaded once.
* Docx writer: Don't copy over `footnotePr` in `settings.xml`
from reference.docx (#9522).
* EPUB writer: omit EPUB2-specific meta tag on EPUB3 (#9493).
This caused a validation failure in epubs with cover images.
* Lua: avoid crashing when an error message is not valid UTF-8 (Albert
Krewinkel).
* Text.Pandoc.SelfContained:
+ Add `role="img"` to svgs.
+ Add `aria-label` to svg elements with `alt` text if present.
Screen readers ignore `alt` attributes on svg elements but do
pay attention to `aria-label` (#9525).
* Text.Pandoc.Shared: Fix regression in section numbering in
`makeSections` (#9516). Starting with pandoc 3.1.12, unnumbered
sections incremented the section number.
* Text.Pandoc.Class: fix `openUrl` TLS negotiation (#9483).
With the release of TLS 2.0.0, the TLS library started requiring
Extended Main Secret for the TLS handshake. This caused problems
connecting to zotero's server and others that do not support TLS 1.3.
This commit relaxes this requirement.
* Depend on djot 0.1.1.0 (fixes rendering on multiline block attributes).
* Use new releases of skylighting-format-blaze-html (#9520).
Fixes auto-wrapping of long source lines in HTML print media.
* Use new commonmark-extensions (fixes issue with the
`rebase_relative_paths` extension when used with commonmark/gfm.
* Makefile: improve epub-validation target (#9493).
Use `--epub-cover-image` to catch issues that only arise with that.
* Fri Feb 23 2024 Andreas Schwab <schwab@suse.de>
- Reduce memory constraints
* Sun Feb 18 2024 Peter Simons <psimons@suse.com>
- Update pandoc to version 3.1.12.1.
Upstream has edited the change log file since the last release in
a non-trivial way, i.e. they did more than just add a new entry
at the top. You can review the file at:
http://hackage.haskell.org/package/pandoc-3.1.12.1/src/changelog.md
Version: 3.1.11.1-150500.11.3.1
* Sat Jan 06 2024 psimons@suse.com
- Update pandoc to version 3.1.11.1.
[#]# pandoc 3.1.11.1 (2023-01-05)
* Docx reader:
+ Fix HYPERLINK with only switch and no argument (#9246).
* Org reader:
+ Parse caption and label for grid tables (#9279).
* MediaWiki reader:
+ Handle multiline math in list items (#9293).
* OPML writer:
+ Respect `--wrap` options & `--columns` in contents of notes (#9297).
* ODT/OpenDocument writers:
+ Properly handle highlighting styles (#9287). These styles were
going into an `office:styles` element in `content.xml`, but this
is invalid. Instead they must go in `styles.xml`. The variable
`highlighting-styles` no longer has any effect on the default
opendocument template, and highlighting styles are not included
in `opendocument` output.
* Markdown writer:
+ Add table identifier at end of caption if present (#9279).
* Text.Pandoc.PDF:
+ Expand list of environment variables to display in verbose output
(#9303).
+ Ensure that we find all the LaTeX warnings requiring a rerun (#9284).
This should fix a regression from 3.1.9 that led to incorrect
alignments in tables (and possibly other issues).
* Docx writer:
+ Ensure that pandoc's output validates (Edwin Török, #9273, #9269,
John MacFarlane, #9265, #9266, #9264).
+ Don't emit empty table rows, which seem to cause problems for
Word (#9224).
* LaTeX writer:
+ Omit superfluous page locator label when used with `--natbib` or
`--biblatex` (#9275). These will treat a bare number as a
page locator, and they will be able to localize it. Note that the
recognition of the locator label is locale-sensitive; if `lang` is
`de`, then `S. 33` is a page reference, and `p. 33` is not!
* Text.Pandoc.Chunks: Fine tune `makeChunks` (#9281).
+ Ensure that chunks not based on sections (those with the
"preamble" class) get unique identifiers, by appending chunk number.
+ This will also ensure that they get unique path names when
the path is generated from the identifier.
* Default HTML5 template: remove html5shiv (and support for IE < 9).
* Makefile:
+ Fix `make quick-stack`: `j` was expecting a number (Edwin Török).
+ Run built pandoc (instead of pandoc in path).
+ Add `validate-epub` target, using `epubcheck` to test the golden files.
+ Add `validate-docx-golden-tests` target.
[#]# pandoc 3.1.11 (2023-12-15)
* Typst writer:
+ Emit `;` after typst code, unless followed by space (#9252).
Otherwise there's the potential that the typst code will swallow
up a following character.
* Text.Pandoc.Logging:
+ Add `MakePDFWarning` constructor to LogMessage [API change].
+ Add `MakePDFInfo` constructor to LogMessage [API change].
* Text.Pandoc.PDF:
+ LaTeX warnings are passed on to the user as warnings.
+ Use `report` with `MakePDFWarning` and `MakePDFInfo` to relay
verbose information and warnings, instead of writing directly
to stderr.
+ Parse logs to determine whether additional runs needed, instead of
running a fixed number of times (#9255). (The number of times
that was appropriate given pandoc's default templates didn't
always work for custom templates, and thus pandoc 3.1.10's
change in the number of runs led to some regressions in PDF
production.)
* Makefile: in `make prelease`, add checks that pandoc-cli and
pandoc have the same version, that pandoc-cli depends on this
exact version of pandoc, that there is an entry for this version
in the changelog, and that the version numbers in the
generated man pages are correct.
* Regenerate man pages with pandoc 3.1.10. This properly escapes hyphens
and fixes version numbers in man pages for `pandoc-server` and
`pandoc-lua`.
* Depend on texmath 0.12.8.6. This omits unneeded `lr`s in typst
math output.
* Depend on typst 0.5. This allows the typst reader to support
multiline strings, the version type, and the `as`
keyword with `import`.
[#]# pandoc 3.1.10 (2023-12-12)
* Link pandoc-cli version to pandoc version. Henceforth pandoc-cli's
version will be synchronized with pandoc's, and pandoc-cli will
depend on an exact pandoc version. This will avoid confusion by
ensuring that `cabal install pandoc-cli-X.Y.Z` installs pandoc
version X.Y.Z. It will make things more straightforward for
upstream packagers (see #9232). This scheme does not follow the
Haskell PVP, but that should cause no harm, because this package
does not expose a library.
* Add `alerts` markdown extension. This enables GitHub style markdown
alerts as a commonmark extension. This extension is now default for
`gfm`. It can't be used with `markdown`, only with `commonmark` and
variants.
* Markdown reader:
+ Preserve newlines in math instead of changing to spaces.
Otherwise we can get unwanted results if there's
a `%` comment (#9193).
+ Make attributes work with reference links (#9171).
* HTML reader:
+ Improve handling of invalidly nested sublists (#9187, cf. #8150).
* MediaWiki reader:
+ Allow attribute keys with hyphens (#9178).
* ODT reader:
+ Support attr `text:continue-numbering` (#8979, Stephan Meijer).
* Typst reader:
+ Allow references (e.g. `@foo`) to become citations
if there is no corresponding label in the document.
+ Collapse adjacent `cite` elements.
+ Handle supplements in `cite`.
+ Change `cite` (only one key allowed, a label) (typst 0.9 breaking change).
+ Support `quote` element (typst 0.9).
* LaTeX reader:
+ Handle otherlanguage environment and language-name environments like
`\begin{french}...\end{french}` (#9202).
+ Fix theorem label parsing (#8872, Hikaru Ibayashi).
* Docx reader:
+ Unwrap content of shaped textboxes (Stephan Meijer, #9214).
+ Improve handling of `w:sym` (#9220). We now look up symbols in symbol
fonts using the table defined at Text.Pandoc.Readers.Docx.Symbols.
+ Add unexported module Text.Pandoc.Readers.Docx.Symbols. This gives us a
table to use to resolve characters included in docx via `w:sym` element.
* Man reader:
+ Properly handle `.sp` macro inside lists and block quotes (#9201).
* LaTeX writer:
+ Fix bug with big footnotes inside emphasis (#8982, Hikaru Ibayashi).
+ Handle identifiers inside heading contents. `\phantomsection` can't
be used in this case, so we need `\hypertarget` (#9209).
* LaTeX template:
+ Include `bookmark` package unconditionally. This package
produces better PDF bookmarks than `hyperref` and does it on the
first pass.
* Typst writer:
+ Use `quote` for block quotes.
+ Support `--toc-depth` as in other writers (#9242).
+ Put inline image dimensions on enclosing box, not image (#9104).
+ Better handling of tables with captions (#9194).
We now put these in a figure with a caption argument.
+ Update typst writer to typst 0.9 citation format (#9188).
* Typst template:
+ Remove custom definition of `blockquote` in default template.
(We now use built-in `quote`.)
+ Support table of contents.
+ Support csl (#9186, Ian Max Andolina). Typst now supports CSL for its
native citation engine, so pandoc should use a specified `csl`
style in the template, falling back to `bibliographystyle` if
`csl` is not specified.
* Docx writer:
+ Use different style for block quotes in notes (#9243).
Using "Footnote Block Text" for the style name, so it can be
given a different font size if footnotes are.
+ Allow embedded fonts to be used in reference.docx (#6728).
* HTML5 writer:
+ To conform to validator's expectations, `doc-footnote` role is used
with `aside` and `doc-endnotes` with `section`.
+ `aside` is used only for notes at ends of sections or blocks;
if all the notes come at the end of the document, `section` is
used so we can have the `doc-endnotes` role.
* JATS writer:
+ Handle case where there is material after refs div (#9166). Previously in
such cases the references were not being moved to back matter.
* Ms writer:
+ Don't do normal escapes in filename arguments for PSPIC etc.
* T.P.RoffChar: escape `-` as `\-`. The `groff_man (7)` man page indicates
that `-` characters will be treated as typographic hyphens and are not
appropriate for cases where the output should be copy-pasteable as an
ASCII hyphen-minus character. (E.g. in command line options.)
However, until a recent update groff man did not actually do this;
it treated `-` and `\-` the same. With the new update (1.23.0)
the two are distinguished (see https://lwn.net/Articles/947941/
for background), so now it is important that pandoc escape `-`.
* Text.Pandoc.Extension: add `Ext_alerts` constructor [API change].
* Text.Pandoc.PDF: We now default to running LaTeX only
once in producing a PDF (instead of twice). This is made possible by the
shift to the `bookmark` package, which does not require a second pass for
PDF bookmarks. If a table of contents is present, we still have to run
three times to get the page numbers, and if beamer is used we still do a
minimum of two runs.
* Text.Pandoc.Shared:
+ `renderTags'`: use minimized tag for `rect`.
+ Allow svg `path` element to be minimized.
+ Export `combineAttr` [API change].
+ Improve `isTightList` so that it recognizes an item containing only a list
which is itself tight as potentially an item in a tight list (#9161).
* Text.Pandoc.MIME: Ensure we use `.svg` not `.svgz` as extension
for `image/svg+xml` mime type. This fixes issues with embedded
SVG images in docx output, among other things (#9195).
* Text.Pandoc.Class: `openURL` improvements for data uris.
Only treat data URI as `base64` if ';base64' is specified.
Otherwise treat as UTF-8 (not 100% reliable but should cover most
other cases). Strip off `;base64` (or `;charset=...` or whatever)
from mime type (#9195).
* Text.Pandoc.SelfContained: Improve treatment of embedded SVGs
(#9206, #8948).
+ Ensure unique ids for elements by prefixing SVG id.
+ Ensure SVG `id` attribute except when `use` element is used.
+ Remove `width`, `height` attributes from svg element when `use`
element is used. Instead, add `width` and `height` 100% to the
`use` element. This seems to get the sizing right.
* Text.Pandoc.Citeproc: Don't link citations if
`suppress-bibliography` specified, for there will be nothing to
link to (#9163).
* epub.css: add styling for sup and sub (#9160).
* Switch from `base64` to `base64-bytestring` (#9233).
* Use newest versions of commonmark, commonmark-extensions,
commonmark-pandoc, texmath, typst, skylighting, skylighting-core.
* Benchmark: use standalone documents for reader tests.
Otherwise typst reader benchmark fails. Note: this means that we are now
parsing longer documents, so bench results on readers won't be comparable
to before.
* MANUAL.txt: update defaults file docs for bibliography fields (#9173).
Recommend using top-level `bibliography` `csl`, etc. instead
of a nested `metadata` field. Reason: `${USERDATA}` and `${HOME}`
are only expanded in these contexts, not in `metadata`.
* Move man pages to pandoc-cli package (#9245).
* Sat Oct 28 2023 psimons@suse.com
- Add pandoc at version 3.1.9.