inara icon indicating copy to clipboard operation
inara copied to clipboard

Update pandoc docker image from 3.2 to 3.6.3

Open cthoyt opened this issue 8 months ago • 2 comments

This PR does the following:

  • [x] Updates the dockerfile from 3.2 (2024-05-11) to 3.6.3 (2025-02-10)
  • [x] Updates the LaTeX outputs with minor changes due to pandoc version bump, see explanation below
  • [ ] Debug issues in the example paper build workflow
  • [ ]

The new version of pandoc causes the following minor changes in latex output:

  1. Tables - tables are now sized with \linewidth instead of \columnwidth. This affects the tables captioned Basic inline markup and examples and Comparison of programming languages used in the publishing tool

  2. Inline Images - the width of the nyan-cat image and sylt images are now determined by the \linewidth instead of \textwidth. Inline images now get the keepaspectratio flag

  3. Free-standing Images - the mandrill image is now wrapped with\pandocbounded{}. Free-standing images now get the keepaspectratio flag.

    This command was introduced in Pandoc in https://github.com/jgm/pandoc/commit/26b25a4428815b04c255e33e95ee86ca7b6ee30e and lives in https://github.com/jgm/pandoc/blob/786356ace43d622866041f021b09452441ced009/data/templates/common.latex#L99-L108 in Pandoc 3.6.3. This requires adding the corresponding command to Inara's latex template

Blockers

It appears that two pre-existing issues that were suppressed by pandoc 3.2 are now causing failures for pandoc 3.6 (or at least, obscuring other errors that are happening with 3.6), so it would be nice to address these first in isolation:

  • #104
  • #102 / #103

cthoyt avatar Feb 10 '25 10:02 cthoyt