Import RMarkdown

RMarkdown is a popular format with statisticians, often edited within RStudio.

So how can we edit our site with RStudio?

Prerequisites

Follow the guide to setup Wowchemy and Hugo on your computer.

Local development with RStudio

  1. Open RStudio and install Blogdown:

     remotes::install_github('rstudio/blogdown')
    
  2. Open academic.Rproj from your site’s folder, downloading it if necessary

  3. Blogdown will automatically move your site’s config/_default/config.yaml file to the site folder as Blogdown does not fully support Hugo’s config folder

  4. In the RStudio menu bar, choose Addins > Serve Site (clicking this button will call blogdown:::serve_site())

  • Paste the local URL which RStudio provides (e.g. http://127.0.0.1:4321) into your web browser to preview your new site
  • Avoid using the integrated RStudio web browser as it can be outdated and buggy

The community recommend saving R content as Markdown with the .Rmarkdown file extension rather than as HTML with the .Rmd extension.

Why is RMarkdown recommended? Hugo is used to convert Markdown content into an HTML website powered by a Wowchemy template and Wowchemy’s page building components. Hence, by providing Rmd’s HTML rather than processed RMarkdown as the input to Hugo and Wowchemy, you may experience conflicts as the Rmd ecosystem performs similar actions to Hugo yet has little awareness of Hugo and Wowchemy templates.

Next