Serve package vignettes under the ‘vignettes/’ directory. Because the HTML output files should not be included in the source package, this function renders R Markdown/HTML vignettes, displays them in the web browser, and deletes the HTML output files. You will see the HTML output when you click the links on the ‘.Rmd’ or ‘.Rhtml’ files (unlike the static HTTP server, the compiled output instead of the source document is displayed).
The root directory to serve.
server configurations passed to
When developing R packages, you may want to preview your vignettes once in a
while. You can certainly click the button in RStudio to do it, but that
requires you to install the package and rebuild the vignettes. With this
function, your vignette will be rebuilt automatically when you update the
source document. Moreover, because the compilation takes place in the current
R session, you can take advantage of
devtools::load_all() (which has a
keyboard shortcut in the RStudio IDE) to reload your package and see the
updated vignette in the web browser.
You are supposed to call this function from the root directory of your
package. If that is not the case, you should provide the correct path to
the ‘vignettes/’ directory of your package to the
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.