Compile all Rmd files and build the site through Hugo.
build_site(local = FALSE, method = c("html", "custom"), run_hugo = TRUE)
Whether to build the website locally to be served via
serve_site()
.
Different methods to build a website (each with pros and cons).
See Details. The value of this argument will be obtained from the global
option getOption('blogdown.method')
when it is set.
Whether to run hugo_build()
after R Markdown files are
compiled.
You can use serve_site()
to preview your website locally, and
build_site()
to build the site for publishing.
For the method
argument: method = "html"
means to render all
Rmd files to HTML via rmarkdown::render()
(which
means Markdown is processed through Pandoc), and process the paths of
external dependencies generated from R code chunks, including images and HTML
dependencies.
For all rendering methods, a custom R script R/build.R
will be
executed if you have provided it under the root directory of the website
(e.g. you can compile Rmd to Markdown through
knitr::knit()
and build the side via
hugo_cmd()
). method = "custom"
means it is entirely up
to this R script how a website is rendered. The script is executed via
command line Rscript "R/build.R"
, which means it is executed in a
separate R session. The value of the argument local
is passed to the
command line (you can retrieve the command-line arguments via
commandArgs(TRUE)
).