3.8.3

[jgm]

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

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

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

This release adds three new input formats (asciidoc, pptx, and
xlsx) and one new output format (bbcode + variants).

It fixes a number of bugs (including some regressions in 3.8).
See the changelog for full details.

API changes:

  + New exported module Text.Pandoc.Readers.AsciiDoc,
    exporting readAsciiDoc.
  + New module Text.Pandoc.Readers.Pptx, exporting readPptx.
  + New module Text.Pandoc.Readers.Xlsx, exporting readXlsx.
  + Text.Pandoc.Readers: Export readAsciiDoc, readXlsx, readPptx.
  + New module Text.Pandoc.Writers.BBCode, exporting
    writeBBCode,  writeBBCodeSteam, writeBBCodeFluxBB,
    writeBBCodePhpBB, writeBBCodeHubzilla, writeBBCodeXenforo.
  + Text.Pandoc.Writers: Export writeBBCode,
    writeBBCodeSteam, writeBBCodeFluxBB, writeBBCodePhpBB,
    writeBBCodeHubzilla, writeBBCodeXenforo .
  + Text.Pandoc.Writers.Shared: Export insertCurrentSpansAtColumn,
    takePreviousSpansAtColumn and decrementTrailingRowSpans.
  + Text.Pandoc.Shared: Export allRowsEmpty and
    tableBodiesToRows.

Thanks to all who contributed, especially new contributors
Anton Antich, and Asliddinbek Azizovich, and James Barlow.

Click to expand changelog

• Add asciidoc as an input format (Add AsciiDoc Reader / AsciiDoc input support #1456).

• Add xlsx (Microsoft Excel) as an input format (Anton Antich). Each worksheet turns into a section containing a table.

• Add pptx (PowerPoint) as new input format (Anton Antich).

• Add bbcode as a new output format (BBCode writer #11242, reptee). Several variants of BBCode are also supported: bbcode_fluxbb (FluxBB), bbcode_phpbb (phpBB), bbcode_steam (Hubzilla), bbcode_hubzilla (Hubzilla), and bbcode_xenforo (xenForo).

• New exported module Text.Pandoc.Readers.AsciiDoc, exporting readAsciiDoc [API change].

• New module Text.Pandoc.Readers.Pptx, exporting readPptx (Anton Antich) [API change].

• New module Text.Pandoc.Readers.Xlsx, exporting readXlsx (Anton Antich) [API change].

• LaTeX reader:

  • Revert \linebreak as LineBreak (LaTeX \linebreak new behavior #11272). \linebreak is more of a hint, it shouldn’t produce a hard break.
  • Better handling of \makeatletter in parsing raw LaTeX (Citeproc prevents building beamer slides containing @ in header-includes #11270).
  • Fix spurious paragraph breaks in math environments (LaTeX reader: fix spurious paragraph breaks in math environments #11265, Emmanuel Ferdman). Previously, a math environment with extra space before the \end would get rendered with a blank line, which LaTeX treats as a paragraph break.
  • Change type on rawLaTeXParser in Text.Pandoc.LaTeX.Parsing. The preparser doesn’t need to return a value.
  • Fix rawTeXParser (etoolbox ifstrequal repeated output #11253). Make macro expansion in raw LaTeX depend on the setting of the latex_macros extension. Previously macros were always expanded, even in raw TeX in markdown. In addition, there was previously a bug that caused content to be garbled in certain cases.
  • Handle ifstrequal at a lower level, like the other if commands (etoolbox ifstrequal repeated output #11253).
  • Move ifstrequal, iftoggle, etc., which were misplaced in environments, to blockCommands, so these commands work properly.

• Docx reader:

  • Handle REF link instruction (Docx reader: Handle REF link instruction #11296, Ezwal).
  • Check recursively for caption styles (Albert Krewinkel). The docx reader uses caption styles to identify figures and captioned tables. It now checks for known caption styles in the full styles hierarchy of a paragraph instead of just checking the style directly. This allows to recognize caption styles that are built on top of the basic caption style, as is sometimes the case in sophisticated styles.

• Markdown reader:

  • Fix performance issue in links with ' (Performance issue when combining a link with apostrophe and multiple apostrophes in text #10880).

• Typst reader:

  • Handle document metadata and #title (typst #title() not allowed in input typst-hs#80). Note that previously, the typst reader never returned document metadata. Now it does, even if the typst document does not contain a #title function that would result in actually printing the title block.

• Djot reader:

  • Add Space elements (Issues when converting from djot to jira #11250). Previously we just got big Str elements with spaces included. But many pandoc writers assume that breakable spaces will be Space elements, and this is also required for automatic wrapping.

• RST reader:

  • Correctly handle intraword emphasis (rST in word emphasis parsed incorrectly #11309).

• Text.Pandoc.Readers:

  • Export readAsciiDoc, readXlsx, readPptx [API change].

• New module Text.Pandoc.Writers.BBCode, exporting writeBBCode, writeBBCodeSteam, writeBBCodeFluxBB, writeBBCodePhpBB, writeBBCodeHubzilla, writeBBCodeXenforo [API change].

• LaTeX writer:

  • Make level 1-3 headings work inside blockquotes (H1-H3 Headers Inside Blockquotes Generate Invalid LaTeX (Incomplete Fix from 2014) #11281, James Barlow).
  • Remove split from list of math environments (Math env error from markdown to latex #11274).
  • Improve handling of math environments in tex math (Latex: math environments not handled properly #11266).

• HTML writer:

  • Add reveal.js scroll and scrollSnap options to writer and template (Add scroll: view option to revealjs template #10052, Asliddinbek Azizovich).
  • Use ‘defer’ when including mathjax script, as recommended in MathJax docs (A small issue with Pandoc passing MathJax entries. #11292).

• ANSI writer:

  • Apply row spans in tables (ANSI writer ignores RowSpan in table cells #10149, Tuong Nguyen Manh). The ANSI writer is now able to keep track of row spans and apply them in rows.

• Pptx writer:

  • Handle reference doc without slides (pptx: Reference doc with no slides causes no slides in output #7536, Tuong Nguyen Manh).

• AsciiDoc writer:

  • Add more table features (asciidoc writer: Add more table features #11267, Tuong Nguyen Manh): Row span and column span, footer row, individual horizontal cell alignment.

• Typst template:

  • Fix font for compatibility with typst 0.14, which doesn’t permit an empty array for font ("error: font fallback list must not be empty" with Typst 0.14 #11238).
  • Re-add columns to typst template (columns dropped out of typst template (regression) #11259), fixing a pandoc 3.8 regression.
  • Fix syntax for bibliography inclusion (fix(templates/default.typst): wrong syntax for bibliography inclusion #11233, Mickaël Canouil). Previously the syntax was wrong when multiple bibliography files were specified. Typst expects an array.

• Text.Pandoc.Writers:

  • Export writeBBCode, writeBBCodeSteam, writeBBCodeFluxBB, writeBBCodePhpBB, writeBBCodeHubzilla, writeBBCodeXenforo [API change].

• Text.Pandoc.Writers.Shared:

  • Add functions insertCurrentSpansAtColumn, takePreviousSpansAtColumn and decrementTrailingRowSpans for applying and keeping track of RowSpans over multiple rows (ANSI writer ignores RowSpan in table cells #10149, Tuong Nguyen Manh). [API change]

• Text.Pandoc.Logging:

  • Change message for missing HTML title warning (Title setting advice also sets <h1>! #11307). Suggest setting the pagetitle variable instead of setting title in metadata.

• Lua subsystem:

  • Preserve common state of custom Lua readers (Albert Krewinkel). The common state is transferred to Lua when calling a custom Lua reader, and is now also transferred back after the reader has finished. This ensures that info messages, warnings, and mediabag entries are available to the main program and all subsequent processing steps.

• Text.Pandoc.PDF:

  • Avoid converting SVG to PDF when non-TeX PDF engine is used (SVG broken when converting Markdown to PDF with WeasyPrint #11275). This fixes a 3.8 regression, which caused documents with SVGs to raise an error when converted to PDF using WeasyPrint.
  • Fix a 3.8 regression with typst and smart quotes (smart quotes do not honor the 'lang' specifcation for pdf via typst after starting with pandoc 3.8 #11256). Before 3.8, the default behavior when producing a PDF -t typst was to produce smart quotes according to typst’s defaults. (This could be defeated by specifying -t typst-smart.) This behavior broke in 3.8 because of a change to Text.Pandoc.PDF. This change caused smart to be disabled for all formats when producing PDFs, when before it was only disable for TeX-based formats (to avoid bad ligatures). This commit restores the old behavior. Possibly the regression also other affects other non-TeX formats, e.g. HTML.

• Text.Pandoc.Shared:

  • Add functions allRowsEmpty and tableBodiesToRows from the RST writer for reuse in other writers. (Tuong Nguyen Manh) [API change].

• Text.Pandoc.Citeproc:

  • Allow formatting in locator to be transmitted to citeproc. We do this indirectly, by rendering the formatting using the HTML tags that citeproc recognizes. Fixes Allow inline formatting in locators? citeproc#68 and Formatting disappears from an enclosed locator citeproc#163. Note that formatting is only possible for locators given in the explicit form, surrounded by curly braces. It won’t work for implicit locators, since these expect number-like expressions.

• New non-exported module Text.Pandoc.Readers.OOXML.Shared containing functions factored out from Text.Pandoc.Readers.Docx.Util (Anton Antich).

• Tests: The common file nativeDiff has been extracted from the Docx and Pptx text files and put in Tests.Helpers.

• Use asciidoc 0.1, djot 0.1.2.4, texmath 0.13.0.2, typst 0.8.1, citeproc 0.12.

• MANUAL.txt:

  • Improve implicit_figure documentation (Explain how to set descriptive alt text as well as caption #11082).
  • Give both forms of options when referring to them (Update output option description for pandoc usage #11306).

• Update INSTALL.md (Installing from source points to outdated Haskell Platform #11271).

---

This discussion was created from the release 3.8.3.

[benz0li]

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