rstudio / rticles

LaTeX Journal Article Templates for R Markdown
https://pkgs.rstudio.com/rticles/
1.46k stars 516 forks source link

Update LaTeX templates #410

Closed cderv closed 1 year ago

cderv commented 3 years ago

Pandoc 2.14 has updated its tex template. https://pandoc.org/releases.html

We should have a look to see what may need to be modified in our templates

mfhepp commented 2 years ago

Three ideas:

  1. Check if the diff of a new Pandoc releases is relevant semi-automatically for all templates.
  2. Add test cases, i.e. check if existing templates yield the same, expected output with a new Pandoc release (this would spot changes in variables passed from Pandoc to the template etc.).
  3. Modularize, like Quarto is doing. Basically, they seem to break down each new Pandoc LaTeX template into what they call partials (sub-templates) and compile the entire template by importing those.

See also the GitHub repository and instructions for new formats.

This allows replacing just e.g. the TeX code for tables. The basic mechanism is that Quarto uses the default "partial" to assemble the complete template, unless a format includes a modified partial.

The advantage of this is that the individual adjustments become much more independent from the evolution of the Pandoc template as a whole.

The downside is that you may need to tweak RStudio to implement the mechanism (but that sounds not too difficult).

mfhepp commented 2 years ago

Addendum: The history of the template.latex file of Pandoc is here

cderv commented 1 year ago

Some updates has been done. Ideas for improvement has been moved to new issue to track

github-actions[bot] commented 8 months ago

This old thread has been automatically locked. If you think you have found something related to this, please open a new issue by following the issue guide (https://yihui.org/issue/), and link to this old issue if necessary.