rmarkdown (version 1.0)

html_vignette: Convert to an HTML vignette.

Description

A HTML vignette is a lightweight alternative to html_document suitable for inclusion in packages to be released to CRAN. It reduces the size of a basic vignette from 100k to around 10k.

Usage

html_vignette(fig_width = 3, fig_height = 3, dev = "png", css = NULL, keep_md = FALSE, readme = FALSE, ...)

Arguments

fig_width
Default width (in inches) for figures
fig_height
Default width (in inches) for figures
dev
Graphics device to use for figure output (defaults to png)
css
One or more css files to include
keep_md
Keep the markdown file generated by knitting.
readme
Use this vignette as the package README.md file (i.e. render it as README.md to the package root). Note that if there are image files within your vignette you should be sure to add README_files to .Rbuildignore
...
Additional arguments passed to html_document

Value

R Markdown output format to pass to render

Details

Compared to html_document, it:

  • never uses retina figures
  • has a smaller default figure size
  • uses a custom css stylesheet

See the online documentation for additional details on using the html_vignette format.