pandoc 3.9.0.1

[jgm]

I'm pleased to announce the release of pandoc 3.9.0.1,
available in the usual places:

Binary packages & changelog:
https://github.com/jgm/pandoc/releases/tag/3.9.0.1

Source & API documentation:
http://hackage.haskell.org/package/pandoc-3.9.0.1

This is a bug-fix release, with no major new features or
API changes, but lots of small improvements. See the
changelog for details.

Thanks to all who contributed, especially new contributors
Agriya Khetarpal, Peter Briggs, Sidney Mau, and λx.x.

Click to expand changelog

• WASM GUI:

  • Don’t block everything while pandoc.wasm loads.
  • Fix bug with Unicode filenames (pandoc.org/app produces error with non-ascii filenames #11447).
  • Catch errors loading pandoc.

• Docx reader:

  • Recognize media inside textboxes (Docx --> LaTeX: --extract-media omits certain figures #11053, Raymond Berger).
  • Properly handle media stored with packaged-rooted paths such as /media (DOCX --extract-media falls back to SHA1 filenames for package-rooted image targets #11518). This can be produced by the online version of Word. With this change, media stored at an absolute path will be stored with its original name and not given a SHA1-based name.
  • Preserve non-textbox content when unwrapping textboxes (docx -> typst silently failing to extract media when shape present #11510, docx to latex: images and captions are not being converted properly #6893, Images with caption + number are not extracted when converting .docx to Markdown #11412, Docx conversion ignoring inside of AlternateContent tag #5394, Regression when image is in a Shape Format #9633). Treat text inside a textbox containing an image as a figure caption.

• Typst reader:

  • Handle bibliography command (Bibliography list for typst input #11460). If this is present, a bibliography section is added to the document and the bibliography paths are added to bibliography in the metadata. This sets things up for using --citeproc.

• Textile reader:

  • Handle block content in cells (Textile reader drops list inside table cell #11455).

• Docx reader:

  • Support w:gridBefore table row property (readers/docx: Support w:gridBefore #11464, Jan Tojnar).

• LaTeX reader:

  • Support \footnotemark and \footnotetext (\footnotemark and \footnottext skipped from tex document #11450). These commands allow separating the footnote mark from its content, useful in tables, minipages, and other contexts where \footnote cannot be used directly.
  • Support supertabular environment (LaTeX reader: support supertabular environment #11523, bodigrim).

• ODT Reader:

  • Fix relative linked images (In odt to docx conversion, pandoc fails to find relative linked images #11369, Tuong Nguyen Manh).
  • Recognize Preformatted_20_Text style Jan Tojnar This is used by LibreOffice, and we will switch to that as well.
  • Add block smushing logic (Jan Tojnar).
  • Support Preformatted Text style (Better code conversion from ODT #4841, Jan Tojnar).

• Markdown reader:

  • Fix bug with lists_without_preceding_blankline (Inconsistent behaviour of the Markdown reader when processing GitHub-style alerts #11534).

• Typst writer:

  • Don’t add a carriage return after \ for hard break (Line breaks in headings break Typst headings #11446). They are not necessary. Note that they can still be included if you use --wrap=preserve and add a newline in your source document.
  • Improve handling of data: URIs in images. Instead of using an SVG with a link containing the data URI (the solution of Convert base64 inline image to typst #10460), we can now simply produce a bytes object with the requisite bytes. Typst figures out the format automatically.
  • Fix escaping of quotes (.docx to .typ conversion and vice versa messes up curly quotes #11463).
  • Include alt attributes on images (mcanouil).
  • Properly escape . after bracketed argument (Typst writer generates invalid code when punctuation directly follows a link #11511).

• Docx writer:

  • Don’t depend on extractTarget from Docx reader.
  • Fix section breaks with --top-level-division (Cannot get docx to insert section breaks #11482, Avoid DOCX section break with initial heading using --top-level-division #10578).

• EPUB writer:

  • Add cover metadata for EPUB3 (docbook > gfm: broken formatting of admonition boxes with lists and no preceding para #11479). This allows file managers to show cover thumbnails for EPUB3 files as well.
  • Update allowed values for EPUB3 metadata identifier.scheme (EPUB 3: update allowed values for metadataidentifier.scheme (ONIX codelist issue 72) #11481, Pascal Wagler).

• ODT writer:

  • Rename inline source class to match LibreOffice (Inline Verbatim text isn't given a specific style in ODT output #3390, Jan Tojnar). Rename the text style we use to represent Code inlines from Source_20_Text to Source_Text. This is the same name LibreOffice Writer uses so it will be recognized by the Character Styles section of the Styles menu.
  • Remove font size from inline source class (Jan Tojnar). This matches what LibreOffice Writer is doing. Also fixes literals inside headings being too small.
  • Modernize Preformatted Text & Source Text styles (Jan Tojnar). Presumably, font-family-generic and font-pitch will allow to find a replacement on systems that do not have Courier New.

• Markdown writer:

  • Fix rendering of alerts (docbook > gfm: broken formatting of admonition boxes with lists and no preceding para #11479). We only properly handled the case where the alert started with a paragraph, but it can start with a list or other block type.
  • Escape literal & that would trigger entity (Incorrect markdown_strict output #11490).

• HTML writer:

  • For revealjs, default scrollProgress to auto (Christophe Dervieux).

• PPTX writer:

  • Register content type for embedded fonts (PPTX writer: embedded fonts from reference doc produce corrupt output #11492).

• MediaWiki writer:

  • Use appropriate syntax for external images (Mediawiki writer generates incorrect output for external images #11494). Note that they will only be rendered as images if an option $wgAllowExternalImages is enabled in the MediaWiki instance.

• ICML writer:

  • Support for image object styles (ICML writer support for image object styles #11498, massifrg). This change allows users to style images in InDesign bysetting the object-style attribute in a pandoc Image, which is mapped to the AppliedObjectStyle attribute in the Rectangle element around an Image element in the resulting ICML.

• JATS writer:

  • Improve representation of Divs (Albert Krewinkel). The writer now checks if the element used to represent (non-special) Divs has any <boxed-text> specific attributes. If it does, the writer keeps wrapping the Div contents in a <boxed-text>, as it did before. Otherwise, the writer falls back to the more appropriate <p> element or simply unwraps the Div if the wrapping element wouldn’t have any attributes. The new behavior gives better semantic results in most cases, as <boxed-text> should be used for text that “is outside the flow of the narrative text”, which doesn’t apply to most divs. “Special” divs, like those used to mark sections, are not affected by this change.

• Text.Pandoc.Writers.GridTable:

  • Normalize tables (Docx writer crashes on invalid tables #8102). Previously, if an invalid table was passed to toTable, an array index error could be raised. Normalizing the table forces it into a shape that won’t allow this error.

• Lua subsystem (Albert Krewinkel):

  • Add new function pandoc.types.Sources (Describe the Lua Source type in the docs #11441).

• LaTeX template: properly handle keywords with commas. These need to be put in an \xmpquote{..} command. Closes keywords are enumerated wrongly in PDF #11528.

• HTML styles template: avoid duplicate code selector. Consolidate two clauses. Closes Duplicated code selector in CSS for standalone HTML #11484.

• Revealjs template: fix type rendering of scroll-view options (Christophe Dervieux, Revealjs template: type issues in scroll-view config options #11486).

• Typst template:

  • Use both place and block for title (Gordon Woodhull). Otherwise the title will be confined to the left column
  • Put title block in a conditional (Typst template: unconditional title wrapper causes blank first page when body contains #set page() #11529). This avoids an empty block for documents that lack metadata information. The empty block causes problems if #set page is used, as it will cause a page break.

• Beamer template: add logooption variable (Support Beamer logo graphic options #11452, Sidney Mau).

• Text.Pandoc.ImageSize:

  • Correctly handle percentage width, height on SVG (svg silently dropped during typst to docx conversion but not typst to pdf #11530). Previously we were getting image size of 0 when a percentage was specified for width or height on SVG. With this change, we simply ignore these percentages (becaues ImageSize doesn’t know the size of the containing element).

• Re-add -threaded to compile options in pandoc-cli.

• Use released djot, asciidoc, texmath, typst.

• Allow crypton 1.1, tls 2.2, http-client-tls 0.4.

• Require auto-update >= 0.2.6 to fix server on macOS (pandoc server 3.9 errors on macOS #11488).

• pandoc-cli.cabal: bump base min bound to 4.18 (same as pandoc).

• MANUAL.txt:

  • Note that JSON may be used in YAML metadata blocks (Feature request: Native TOML frontmatter blocks in addition to YAML — revisiting #2425 and #10295 with modern context #11525).
  • Update link for ICML in manual.
  • Fix outdated OPML spec URL in MANUAL.txt (Fix outdated OPML spec URL in readme #11504, Peter Briggs).

---

This discussion was created from the release pandoc 3.9.0.1.

[benz0li]

Unofficial Linux/RISC-V (64-bit, linux/riscv64) release assets are available at https://gitlab.b-data.ch/jgm/pandoc/-/releases/3.9.0.1.