Designing R package vignettes

Desarrollo de paquetes en R

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

Desarrollo de paquetes en R

Output of use_vignette()

use_vignette() output

Desarrollo de paquetes en R

Output of use_vignette()

use_vignette() output

Desarrollo de paquetes en R

Output of use_vignette()

use_vignette() output

Desarrollo de paquetes en R

Output of use_vignette()

use_vignette() output

Desarrollo de paquetes en R

Output of use_vignette()

use_vignette() output

Desarrollo de paquetes en R

Output of use_vignette()

use_vignette() output

Desarrollo de paquetes en R

Vignette skeleton in func_conversion.Rmd file

Vignette skeleton

Desarrollo de paquetes en R

Vignette skeleton in func_conversion.Rmd file

Vignette skeleton

Desarrollo de paquetes en R

Vignette skeleton in func_conversion.Rmd file

Vignette skeleton

Desarrollo de paquetes en R

Vignette skeleton in func_conversion.Rmd file

Vignette skeleton

Desarrollo de paquetes en R

Recall vignette best practices

  • Clear and focused content
  • Well-organized structure
  • Engaging examples and use cases
Desarrollo de paquetes en R

Update vignette following best practices

Update vignette

Desarrollo de paquetes en R

Update vignette following best practices

Update vignette

Desarrollo de paquetes en R

Update vignette following best practices

Update vignette

Desarrollo de paquetes en R

Update vignette following best practices

Update vignette

Desarrollo de paquetes en R

Update vignette following best practices

Update vignette

Desarrollo de paquetes en R

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
Desarrollo de paquetes en R

Let's practice!

Desarrollo de paquetes en R

Preparing Video For Download...