usethis: use_pkgdown – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

use_pkgdown

Use pkgdown

pkgdown makes it easy to turn your package into a beautiful website. usethis provides two functions help you use pkgdown:

use_pkgdown(): creates a pkgdown config file, adds relevant files or directories to .Rbuildignore and .gitignore, and builds favicons if your package has a logo.
use_pkgdown_github_pages(): implements the GitHub setup needed to automatically publish your pkgdown site to GitHub pages:
- use_github_pages() prepares to publish the pkgdown site from the github-pages branch
- use_github_action("pkgdown") configures a GitHub Action to automatically build the pkgdown site and deploy it via GitHub Pages
- The pkgdown site's URL is added to the pkgdown configuration file, to the URL field of DESCRIPTION, and to the GitHub repo.

use_pkgdown_travis() is deprecated; we no longer recommend that you use Travis-CI.

use_pkgdown(config_file = "_pkgdown.yml", destdir = "docs")

use_pkgdown_github_pages()

use_pkgdown_travis()

`config_file`	Path to the pkgdown yaml config file
`destdir`	Target directory for pkgdown docs