latexdiffr (version 0.2.0)

latexdiff: Produce a diff of two files using latexdiff

Description

latexdiff() uses the external utility latexdiff to create a PDF file showing differences between two Rmd, qmd, Rnw or TeX files.

Usage

latexdiff(
  path1,
  path2,
  output = "diff",
  compile = TRUE,
  open = interactive(),
  clean = TRUE,
  quiet = TRUE,
  output_format = NULL,
  ld_opts = "--replace-context2cmd=\"none\""
)

Value

Invisible NULL.

Arguments

path1

Path to the first file.

path2

Path to the second file.

output

File name of the output, without the .tex extension.

compile

Logical. Compile the diff from tex to pdf?

open

Logical. Automatically open the resulting pdf?

clean

Logical. Clean up intermediate TeX files?

quiet

Logical. Suppress printing? Passed to render and knit, and hides standard error of latexdiff itself.

output_format

An rmarkdown output format for Rmd files, probably rmarkdown::latex_document(). The default uses the options defined in the Rmd files. YAML front matter.

ld_opts

Character vector of options to pass to latexdiff. The default avoids some problems with Rmd files.

Details

You will need the latexdiff utility installed on your system:

# on MacOS:
brew install latexdiff
# on Linux:
sudo apt install latexdiff

File types are determined by extension,which should be one of .tex, .Rmd, .qmd or .rnw. Rmd files are processed by rmarkdown::render(). Rnw files are processed by knitr::knit(). qmd files are processed by quarto::quarto_render().

latexdiff is not perfect. Some changes will confuse it. In particular:

• If input and output files are in different directories, the "diff.tex" file may have incorrect paths for e.g. included figures. latexdiff will add the --flatten option in this case, but things still are not guaranteed to work.

• Sometimes the "diff.tex" file fails to compile to pdf. If so, set compile = FALSE and try editing the tex file manually.

Examples

if (FALSE) {
latexdiff("file1.Rmd", "file2.Rmd")
}