rmarkdown 2.8
-
Fix a issue with Pandoc 2.5 and
latex-div.lua
- documents can now be rendered as expected without error (thanks, @DAVIDWALES, #2121). -
Fix an issue with styling and code folding button behavior when default is
code-folding: show
. The Button can now be correctly style according to state asaria-expanded
attributes is correctly updated. Also, new classes has been added on the button to allow styling during transition:btn-collapsing
andbtn-expanding
are respectively applied during transition Show to Hide and Hide to Show. (This follow Bootstrap behavior for the collapsible block) (thanks, @steveharoz, #2085). -
Fix an issue with
citation_package
having no effect when using.md
file as input torender()
with latex and PDF output formats (thanks, @andrewheiss, #2113). -
A new internal option
rmarkdown.knit.ext
has been added to control the extension of the intermediary knit output during a rendering. It defaults tomd
to produce*.knit.md
. Only useful for very advanced usage (#2098). -
render()
won't produce any*.utf8.md
intermediary file anymore. This was a leftover from previous versions of rmarkdown. Since knitr 1.24 and rmarkdown 2.0, only UTF-8 input files are allowed. (#2098). -
Fix an
Invalid cross-device link
error whentempdir()
is used forintermediates_dir
inrender()
(thanks, @gorgitko, #2096). -
Fix a regression in HTML default template with floating toc incorrectly placed on small size window (thanks, @grimbough, #2071)
-
Provided a
runtime: shiny
fix for output formats that pass a modifiedbslib::bs_theme()
object tohtml_document_base()
'stheme
(thanks, @cpsievert, #2049). -
Rendering using
runtime: shiny_prerendered
orruntime: shinyrmd
will now produce valid HTML by not inserting anymore the full document as body in the resulting shiny apps (thanks, @dakep, #1912). Header content usually containing html dependencies will be inserted in the HTML document at the end of the head before</head>
, unless the rendered HTML contains<!-- HEAD_CONTENT -->
special comment (seehtmltools::renderDocument()
). A new Pandoc variable is set in for shiny prerendered document to allow conditional insertion of such content in the the HTML template using$if(shiny-prerendered)$
. This has been done in all HTML template in this package. Users of custom template should make this change to provide support for this runtime. See rmarkdown default template (default.html
) for an example (#2064). -
Added
tectonic
as a supported LaTeX engine for generating PDF output (thanks, @dpryan79, #2078). You can specify to use this by addingengine: "tectonic"
to your output format in YAML, such aspdf_document
. -
When no
output_format
is provided in any way but anoutput_file
is provided inrender()
, the default format will be determined based on the extension:"pdf_document"
for.pdf
, or"word_document"
for.docx
. Otherwise, it will be"html_document"
as previous version (thanks, @pearsonca, #1569). -
Added a new global option
rmarkdown.render.message
. When setFALSE
,render()
will not output the message starting byOutput created:
allowing RStudio IDE to open a preview of the document. This is useful for package developers that would need to emit there own output message for there custom format. See?render_site
for more info on this special message (#2092). -
Internal changes regarding Lua filters. They have now an explicit Pandoc version minimal requirement: A filter will be skipped with a warning printed by the Lua filter if this requirement is not met. For now, all filters work for Pandoc 2.1 and above (thanks, @atusy, #2088). There is also now a new mechanism to have a share Lua filter script loadable by other Lua files:
render()
will set theRMARKDOWN_LUA_SHARED
env var to the path of Lua filtershared.lua
so that other filters can access functions defined in it usingdofile(os.getenv 'RMARKDOWN_LUA_SHARED')
. This is for internal usage only to avoid duplication (thanks, @tarleb, #2103). -
html_document_base
gains acss
argument, to whichhtml_document
'scss
argument is now passed. This also fix an issue when.sass
or.scss
files are used with thiscss
argument whenself_contained: FALSE
. Moreover, sass caching mechanism can now be used when passing.sass
or.scss
files to thecss
argument (thanks, @cpsievert, #2095). -
The
fig_crop
option of PDF document formats (such aspdf_document
andbeamer_presentation
) supports the value"auto"
now, which meansfig_crop = TRUE
when figure cropping toolspdfcrop
andghostscript
are available. -
The default value of the
fig_crop
option of PDF output formats has been changed fromTRUE
to"auto"
(#2077). -
rmarkdown::tufte_handout
has been deprecated and will be removed in the future from this package. It has been moved to the tufte package since rmarkdown 0.9.5 (released on 2016-02-22). Please usetufte::tufte_handout
instead.