inara
inara copied to clipboard
Update pandoc docker image from 3.2 to 3.6.3
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:
-
Tables - tables are now sized with
\linewidthinstead of\columnwidth. This affects the tables captionedBasic inline markup and examplesandComparison of programming languages used in the publishing tool -
Inline Images - the width of the nyan-cat image and sylt images are now determined by the
\linewidthinstead of\textwidth. Inline images now get thekeepaspectratioflag -
Free-standing Images - the mandrill image is now wrapped with
\pandocbounded{}. Free-standing images now get thekeepaspectratioflag.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