pandoc 3.11

[jgm]

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

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

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

Some changes of note:

- A new `--math-method` option, which replaces the (now deprecated but
  still functional) options `--mathml`, `--mathjax`, `--gladtex`,
  `--katex`, `--webtex`. The `plain` style can now be specified
  explicitly. In defaults files, `html-math-method` is now
  `math-method` (though `html-math-method` will still work).

- `mathml` is now the default math-method.

- A new option `--completion={bash,zsh,fish}` generates completion
  scripts for all three shells (see the manual for instructions on
  how to use them). `--bash-completion` continues ot work, an alias of
  `--completion=bash`.

- It is now possible to reset a Markdown example list counter (e.g.,
  at the beginning of a chapter), using the syntax `(1@)` or
  `(1@label)`.

- Enhanced support for RTL languages: RTL text direction now
  works in ODT. In addition, setting `lang` at the document level
  is now sufficient in Docx to make documents RTL.

- Fixed pandoc 3.8 regressions in syntax highlighting.

- Fixed a security-related bug in template fetching which
  could result in a local file being fetched instead of a
  remote one.

API changes:

- Text.Pandoc.Options: Rename HTMLMathMethod type to MathMethod.
  Rename `writerHTMLMathMethod` field of WriterOptions to
  `writerMathMethod`.

- Text.Pandoc.App: the `optHTMLMathMethod` constructor for OPt
  is renamed to optMathMethod.

Thanks to all who contributed, especially new contributors Wrong-Code
and wzy.

Click to expand changelog

• Add --math-method option. This replaces (now deprecated but still functional) options --mathml, --mathjax, --gladtex, --katex, --webtex. The plain style can now be specified explicitly. In defaults files, html-math-method is now math-method (though html-math-method will still work).

• Make mathml the default math-method (Set MathML as the default writerHTMLMathMethod #11751).

• Add --completion={bash,zsh,fish} ([feature] more shell completions #8542, wzy). Make --bash-completion an alias of --completion=bash. See the manual for instructions on how to use these completions.

• Text.Pandoc.Options [API change]:

  • Rename HTMLMathMethod type to MathMethod.
  • Rename writerHTMLMathMethod field of WriterOptions to writerMathMethod.

• Markdown reader:

  • Add a syntax (1@label) for resetting example list counter (Add option to reset numbered example list start value every chapter for PDF output #10940). This is needed often at the beginning of a chapter.

• MediaWiki writer:

  • Put <nowiki> around possible URLs (Mediawiki writer generates incorrect output for URLs #11834). Otherwise they get linkified automatically.

• Docx reader:

  • Handle case where non-header rows come before header rows (DOCX reader looses table columns (regression) #11833).
  • Improve handling of tables with uneven rows (DOCX reader looses table columns (regression) #11833).

• RTF Reader:

  • Add support for nested tables (Complex RTF table fails to parse properly. #11218, Alex).

• Typst reader:

  • Remove handling of ‘block’ as an inline-level element (typst blocks do not render in separate paragraphs when converting to docx #11814).

• HTML reader:

  • Handle pre without code (HTML reader discards whitespace in a <pre> element that has no inner <code> #11810). Preserve whitespace as nonbreaking spaces.

• ODT/OpenDocument writers:

  • Support RTL text direction (ODT output RTL doesn't work #11301). RTL is now properly handled in these cases: dir: rtl (or ltr) in document metadata; an RTL lang in metadata (e.g. he, ar), unless overridden by dir; a dir attribute on a Div. Code blocks remain ltr regardless.
  • Use style:language-complex rather than fo:language for RTL languages (ODT output RTL doesn't work #11301).
  • Fix treatment of DefaultHighlighting (Highlighting regression from 3.8 remains in context, typst, opendocument and ms writers (cf. #11156) #11829).

• Docx writer:

  • Initialize envLang from lang metadata (ODT output RTL doesn't work #11301). This ensures that setting lang will affect the whole document. Previously, setting lang to he was not sufficient to make the document RTL.

• JATS writer:

  • Fix illegal use of p element inside p (pandoc 3.10.2 defects in jats, docx #11809).

• Ms writer:

  • Fix treatment of DefaultHighlighting (Highlighting regression from 3.8 remains in context, typst, opendocument and ms writers (cf. #11156) #11829). (Regression from 3.8.)

• ConTeXt writer:

  • Fix bug in syntax highlighting (Highlighting regression from 3.8 remains in context, typst, opendocument and ms writers (cf. #11156) #11829). (Regression from 3.8.)

• Text.Pandoc.App.Opt:

  • In Opt, change optHTMLMathMethod to optMathMethod. [API change]

• MSI installer: Fix upgrade detection for per-machine installations (Fix upgrade detection for per-machine installations #11827, Wrong-Code). Previously, registry records of previous versions were not being removed.

• Text.Pandoc.Templates:

  • Fix bug in getTemplate. When calling fetchItem in getTemplate, we temporarily reset the stSourceURL in CommonState so that the template is sought locally. Previously, an exception in fetchItem would prevent stSourceURL from being set back to its original value. This could result in a local file being fetched instead of a remote one. Note that an exception is triggered when one uses e.g. --template default.html5; in that case getTemplate handles the exception by looking for the file in the user data directory. This patch fixes the bug so that the stSourceURL is reset regardless of whether fetchItem raises an exception. Thanks to Yingjie Su for identifying the problem.

• beamer template: remove spurious extra tableofcontents (beamer template duplicates "\tableofcontents" #11819).

• Text.Pandoc.App.CommandLineOptions:

  • Export OptionSpec, which can encode the type of completion needed by each option (wzy).

• Add new unexported module Text.Pandoc.Completion (wzy).

• Replace a use of nub with nubOrd.

• Use latest releases of djot, asciidoc, typst, texmath.

• MANUAL.txt:

  • Add a note that thanks in typst doesn’t currently work (thanks footnote content missing in default Typst template output #11807).
  • Note that sourcepos extension works for djot too.

---

This discussion was created from the release pandoc 3.11.

[benz0li]

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