hugo_start() starts a hugo server that will automatically re-generate the site whenever the input changes. You only need to execute this once per session; it continues to run in the background as you work on the site. For large sites the hugo server can be slow to start; if it takes longer than 30 seconds hugo_start() throws an error.

hugo_stop() kills the server. This happens automatically when you exit R so you shouldn't normally need to run this.

hugo_browse() opens the site in the RStudio viewer or your web browser.

  site = ".",
  auto_navigate = TRUE,
  browse = TRUE,
  render_to_disk = FALSE,
  port = 1313





Path to hugo site.


Automatically navigate to the most recently changed page?


Automatically preview the site after the server starts?


Render site to disk? The default is to serve the site from memory, but rendering to disk can be helpful for debugging.


Port to run server on. For advanced use only.

Hugo version

hugodown will attempt to automatically use the correct version of hugo for your site (prompting you to call hugo_install() if needed). It looks in two places:

  • If _hugodown.yaml is present, it looks for the hugo_version key.

  • If netlify.toml is present, it looks in context$production$environment$HUGO_VERSION

This means if you already use netlify, hugodown will automatically match the version of hugo that you're using for deployment.