Vignetten voor R-pakketten ontwerpen

R-pakketten ontwikkelen

Jasmin Ludolf

Content Developer

Vignet-skelet maken

library(usethis)

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

name:

  • Bestandsnaam voor nieuwe vignette
  • Alleen cijfers, letters, underscores en koppeltekens
  • Kleine letters aanbevolen

 

title: Wordt in de vignette zelf gebruikt

R-pakketten ontwikkelen

Uitvoer van use_vignette()

uitvoer van use_vignette()

R-pakketten ontwikkelen

Uitvoer van use_vignette()

uitvoer van use_vignette()

R-pakketten ontwikkelen

Uitvoer van use_vignette()

uitvoer van use_vignette()

R-pakketten ontwikkelen

Uitvoer van use_vignette()

uitvoer van use_vignette()

R-pakketten ontwikkelen

Uitvoer van use_vignette()

uitvoer van use_vignette()

R-pakketten ontwikkelen

Uitvoer van use_vignette()

uitvoer van use_vignette()

R-pakketten ontwikkelen

Vignet-skelet in bestand func_conversion.Rmd

Vignet-skelet

R-pakketten ontwikkelen

Vignet-skelet in bestand func_conversion.Rmd

Vignet-skelet

R-pakketten ontwikkelen

Vignet-skelet in bestand func_conversion.Rmd

Vignet-skelet

R-pakketten ontwikkelen

Vignet-skelet in bestand func_conversion.Rmd

Vignet-skelet

R-pakketten ontwikkelen

Beste practices voor vignetten: herhaling

  • Duidelijke, gerichte inhoud
  • Goede structuur
  • Pakkende voorbeelden en use-cases
R-pakketten ontwikkelen

Vignette bijwerken volgens best practices

Vignette bijwerken

R-pakketten ontwikkelen

Vignette bijwerken volgens best practices

Vignette bijwerken

R-pakketten ontwikkelen

Vignette bijwerken volgens best practices

Vignette bijwerken

R-pakketten ontwikkelen

Vignette bijwerken volgens best practices

Vignette bijwerken

R-pakketten ontwikkelen

Vignette bijwerken volgens best practices

Vignette bijwerken

R-pakketten ontwikkelen

Twee manieren om vignetten te bouwen

  • rmarkdown::render()

    • Handig om syntaxis en voorbeelden te testen tijdens ontwikkeling
    • Via de knop Knit HTML op DataCamp
  • devtools::build_vignettes()

    • Formele toevoeging (van alle vignetten) aan het pakket
    • Maakt ook een .R-bestand met alle R-code in de vignette
    • Plaatst HTML-, .R- en .Rmd-bestanden in de map doc
R-pakketten ontwikkelen

Laten we oefenen!

R-pakketten ontwikkelen

Preparing Video For Download...