use_vignette: Create a vignette or article

In usethis: Automate Package and Project Setup

Create a vignette or article

Description

Creates a new vignette or article in ⁠vignettes/⁠. Articles are a special type of vignette that appear on pkgdown websites, but are not included in the package itself (because they are added to .Rbuildignore automatically).

Usage

use_vignette(name, title = name)

use_article(name, title = name)

Arguments

name	Base for file name to use for new vignette. Should consist only of numbers, letters, ⁠_⁠ and -. Lower case is recommended.
title	The title of the vignette.

General setup

• Adds needed packages to DESCRIPTION.

• Adds inst/doc to .gitignore so built vignettes aren't tracked.

• Adds ⁠vignettes/*.html⁠ and ⁠vignettes/*.R⁠ to .gitignore so you never accidentally track rendered vignettes.

See Also

The vignettes chapter of R Packages.

Examples

## Not run: 
use_vignette("how-to-do-stuff", "How to do stuff")

## End(Not run)

usethis documentation built on July 9, 2023, 7:23 p.m.