build_site_github_pages: Build site for GitHub pages

View source: R/build-github.R

build_site_github_pagesR Documentation

Build site for GitHub pages

Description

Designed to be run as part of automated workflows for deploying to GitHub pages. It cleans out the old site, builds the site into dest_dir adds a .nojekyll file to suppress rendering by Jekyll, and adds a CNAME file if needed.

It is designed to be run in CI, so by default it:

  • Clean out the old site.

  • Does not install the package.

  • Runs build_site() in process.

Usage

build_site_github_pages(
  pkg = ".",
  ...,
  dest_dir = "docs",
  clean = TRUE,
  install = FALSE,
  new_process = FALSE
)

Arguments

pkg

Path to package.

...

Additional arguments passed to build_site().

dest_dir

Directory to build site in.

clean

Clean all files from old site.

install

If TRUE, will install the package in a temporary library so it is available for vignettes.

new_process

If TRUE, will run build_site() in a separate process. This enhances reproducibility by ensuring nothing that you have loaded in the current process affects the build process.


pkgdown documentation built on April 24, 2022, 5:05 p.m.