Designing R package vignettes

Developing R Packages

Jasmin Ludolf

Content Developer

Create vignette skeleton

library(usethis)

use_vignette(name = "func_conversion", title = "Function Conversion Examples")

name:

  • File name to use for new vignette
  • Should consist only of numbers, letters, underscores? and dashes
  • Lower case is recommended

 

title: Will be fed into the vignette itself

Developing R Packages

Output of use_vignette()

use_vignette() output

Developing R Packages

Output of use_vignette()

use_vignette() output

Developing R Packages

Output of use_vignette()

use_vignette() output

Developing R Packages

Output of use_vignette()

use_vignette() output

Developing R Packages

Output of use_vignette()

use_vignette() output

Developing R Packages

Output of use_vignette()

use_vignette() output

Developing R Packages

Vignette skeleton in func_conversion.Rmd file

Vignette skeleton

Developing R Packages

Vignette skeleton in func_conversion.Rmd file

Vignette skeleton

Developing R Packages

Vignette skeleton in func_conversion.Rmd file

Vignette skeleton

Developing R Packages

Vignette skeleton in func_conversion.Rmd file

Vignette skeleton

Developing R Packages

Recall vignette best practices

  • Clear and focused content
  • Well-organized structure
  • Engaging examples and use cases
Developing R Packages

Update vignette following best practices

Update vignette

Developing R Packages

Update vignette following best practices

Update vignette

Developing R Packages

Update vignette following best practices

Update vignette

Developing R Packages

Update vignette following best practices

Update vignette

Developing R Packages

Update vignette following best practices

Update vignette

Developing R Packages

Two ways to build vignettes

  • rmarkdown::render()

    • Useful for testing syntax and examples during development
    • Done using the Knit HTML button on DataCamp
  • devtools::build_vignettes()

    • More formal addition (of all vignettes) to the package
    • Also creates a .R file with all R code in the vignette
    • Places resulting HTML, .R, and .Rmd files in doc directory
Developing R Packages

Let's practice!

Developing R Packages

Preparing Video For Download...