knitr 1.27
NEW FEATURES
- The chunk option
message = FALSE
can now be used to suppress the message "running: command ..." when the language engine is a command such asbash
,awk
,perl
,ruby
,sas
,sed
, andstata
, etc. (thanks, @splaisan, #1782).
BUG FIXES
-
The figure caption was placed incorrectly when there are multiple
include_graphics()
in a code chunk (thanks, @hadley #1771, @cderv #1776). -
The chunk option
fig.keep
was buggy when taking a numeric vector. The bug was originally introduced in #1265 and discovered in the SO post https://stackoverflow.com/q/59180351/559676. -
When the chunk option
dev = 'tikz'
and a plot in the code chunk is generated by ggplot2 with a legend on a continuous scale, tikzDevice will create a raster image for the legend. Now the path to the raster image in the.tex
file is tweaked to include the dir name of the.tex
file, so that the.tex
file can be correctly compiled to PDF via LaTeX (thanks to @rstub for the debugging at https://stackoverflow.com/a/58410965/559676). -
hook_pdfcrop()
does not crop all plots when multiple graphical devices are used in a code chunk (i.e., the chunk optiondev
takes a vector of devices) due to a bug in the internal functionall_figs()
identified by @bastistician in #1766, who also proposed a fix.
MAJOR CHANGES
options('width')
no longer affects caching. With this change, your previous cache will be invalidated if you update knitr from 1.26 to 1.27. If you prefer that changes in the R global optionwidth
invalidate cache (as in previous versions of knitr), you may associate it with a chunk option, e.g.,cache.extra = getOption('width')
. The reason for this change is that it is too costly to invalidate the cache when thewidth
option changes---the effect of this option is only cosmetic and the code chunk output may not really rely on this option (thanks, @jaburgoyne, #1781).
MINOR CHANGES
-
is_html_output()
returnsTRUE
for the Pandoc output formatgfm
now (thanks, @ttimbers @cderv, rstudio/rmarkdown#1756). -
plot_crop()
no longer calls theconvert
command in ImageMagick to trim non-PDF plots. Instead, the functionmagick::image_trim()
is called. This means you no longer need to install ImageMagick, but should install the R package magick (thanks, @hpages, #1785). -
When the chunk option
fig.scap
is used in R Markdown and the output format is LaTeX/PDF, the plot hookknitr::hook_plot_tex()
will be used to create the appropriate figure environment. In previous versions,fig.scap
is silently ignored (thanks, @billdenney, #1793).