Designing R package vignettes

R-Pakete entwickeln

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

R-Pakete entwickeln

Output of use_vignette()

use_vignette() output

R-Pakete entwickeln

Output of use_vignette()

use_vignette() output

R-Pakete entwickeln

Output of use_vignette()

use_vignette() output

R-Pakete entwickeln

Output of use_vignette()

use_vignette() output

R-Pakete entwickeln

Output of use_vignette()

use_vignette() output

R-Pakete entwickeln

Output of use_vignette()

use_vignette() output

R-Pakete entwickeln

Vignette skeleton in func_conversion.Rmd file

Vignette skeleton

R-Pakete entwickeln

Vignette skeleton in func_conversion.Rmd file

Vignette skeleton

R-Pakete entwickeln

Vignette skeleton in func_conversion.Rmd file

Vignette skeleton

R-Pakete entwickeln

Vignette skeleton in func_conversion.Rmd file

Vignette skeleton

R-Pakete entwickeln

Recall vignette best practices

  • Clear and focused content
  • Well-organized structure
  • Engaging examples and use cases
R-Pakete entwickeln

Update vignette following best practices

Update vignette

R-Pakete entwickeln

Update vignette following best practices

Update vignette

R-Pakete entwickeln

Update vignette following best practices

Update vignette

R-Pakete entwickeln

Update vignette following best practices

Update vignette

R-Pakete entwickeln

Update vignette following best practices

Update vignette

R-Pakete entwickeln

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
R-Pakete entwickeln

Let's practice!

R-Pakete entwickeln

Preparing Video For Download...