wflow_build: Build the site
In jdblischak/workflowrBeta: A workflow template for creating a research website

Description Usage Arguments Details Value See Also Examples

wflow_build builds the website from the files in the analysis directory. This is intended to be used when developing your code to preview the changes. When you are ready to commit the files, use wflow_publish.

1
2
3

wflow_build(files = NULL, make = is.null(files), update = FALSE,
  republish = FALSE, view = interactive(), seed = 12345, log_dir = NULL,
  local = FALSE, dry_run = FALSE, project = ".")

`files`	character (default: NULL). Files to build. Only allows files in the analysis directory with the extension Rmd or rmd. If `files` is `NULL`, the default behavior is to build all outdated files (see argument `make` below). Supports file globbing.
`make`	logical (default: `is.null(files)`). When `make = TRUE`, build any files that have been modified more recently than their corresponding HTML files (inspired by GNU Make). This is the default action if no files are specified.
`update`	logical (default: FALSE). Build any files that have been committed more recently than their corresponding HTML files (and do not have any unstaged or staged changes). This ensures that the commit version ID inserted into the HTML corresponds to the exact version of the source file that was used to produce it.
`republish`	logical (default: FALSE). Build all published R Markdown files. Useful for site-wide changes like updating the theme, navigation bar, or any other setting in `_site.yml`.
`view`	logical (default: `interactive`). View the website with `wflow_view` after building files. If only one file is built, it is opened. If more than one file is built, the main index page is opened. Not applicable if no files are built or if `dry_run = TRUE`.
`seed`	numeric (default: 12345). The seed to set before building each file. Passed to `set.seed`.
`log_dir`	character (default: NULL). The directory to save log files from building files. It will be created if necessary and ignored if `local = TRUE`. The default is to use a directory named `workflowr` in `tempdir`.
`local`	logical (default: FALSE). Build files locally in the R console. This should only be used for debugging purposes. The default is to build each file in its own separate fresh R process to ensure each file is reproducible in isolation.
`dry_run`	logical (default: FALSE). List the files to be built, without building them.
`project`	character (default: ".") By default the function assumes the current working directory is within the project. If this is not true, you'll need to provide the path to the project directory.

wflow_build has multiple, non-mutually exclusive options for deciding which files to build. In other words, if multiple options are set to TRUE, the union of all files will be built:

Files specified via the argument files are always built.
If make = TRUE, all files which have been modified more recently than their corresponding HTML files will be built.
If update = TRUE, all files which have been committed more recently than their corresponding HTML files will be built. However, files which currently have staged or unstaged changes will be ignored.
If republish = TRUE, all published files will be rebuilt.

Under the hood, wflow_build is a wrapper for render_site from the package rmarkdown.

An object of class wflow_build, which is a list with the following elements:

files: The input argument files
make: The input argument make
update: The input argument update
republish: The input argument republish
view: The input argument view
seed: The input argument seed
log_dir: The directory where the log files were saved
local: The input argument local
dry_run: The input argument dry_run
built: The relative paths to the built R Markdown files
html: The relative paths to the corresponding HTML files

wflow_publish

## Not run: 

# Build any files which have modified
wflow_build() # equivalent to wflow_build(make = TRUE)
# Build a single file
wflow_build("file.Rmd")
# Build multiple files
wflow_build(c("file1.Rmd", "file2.Rmd"))
# Build multiple files using a file glob
wflow_build("file*.Rmd")
# Build every published file
wflow_build(republish = TRUE)
# Build file.Rmd and any files which have been modified
wflow_build("file.Rmd", make = TRUE)

## End(Not run)