Skip to content
This repository has been archived by the owner on Sep 29, 2023. It is now read-only.

WarwickRUG/wrug_website

Repository files navigation

Archived repo

This repository has been superseeded by https://github.com/WarwickRUG/WarwickRUG.github.io Any new development to WRUG's website will take place there, and this one will be archived.

Warwick R User Group Website

All Contributors

Warwick R User Group website, created using Distill.

Some icons obtained from Reshot.

Installation

  1. Clone this repo: git clone git@github.com:WarwickRUG/wrug_website.git
  2. Install renv if not already installed (instructions here).
  3. Run renv::restore() to restore the state of your project from renv.lock.

Updating packages

  1. Install packages as usual.
  2. Run renv::snapshot() to update renv.lock.
  3. Create a commit with renv.lock changes and push it to the repo.

Updating website

Content creation

Add new blog posts

  1. Create a new blog post by running distill::create_post("<date_your title>", draft = TRUE) where <date_your title> will be replaced with an actual date in yyy-mm-dd format and any meaningful title which will be the blog post's url.
  2. Edit content as a regular Rmd file (refer to https://rstudio.github.io/distill/blog.html#creating-a-post for more information)
  3. Once you are happy with the results:
  4. change draft = TRUE to draft = FALSE (or just comment the line) so the post can be displayed.
  5. knit the Rmd file: knitr::knit(<your filename>) or use RStudio's interface.

Edit an existing blog post

  1. Edit the desired post within `_posts``folder
  2. Save changes
  3. Knit the file

Rendering and deploying the website

  1. run rmarkdown::render_site() to render a local copy of the website. (this will only deploy any rendered site)
  2. website deployment will depend on what we decide in this issue

Troubleshooting

Can't install a new package

If facing issues installing packages from Windows, run this command. (more info in renv documentation and in this discussion)

Sys.setenv(RENV_DOWNLOAD_METHOD = "libcurl")

I can't see my updated content

Make sure that you knit your content after editing your .Rmd file, otherwise, it will not show in the new site when rendering and deploying the site. The advantage of this approach is that older blog posts don't break if you update your R packages or dependencies and don't want to update the posts. If you don't fancy re-knitting every time you make a change, then you can write an ordinary markdown post

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Carlos Cámara

💻 📆

Heather Turner

💬

David Selby

💬 🖋

Aditi Shenvi

💻

James Tripp

💻

This project follows the all-contributors specification. Contributions of any kind welcome!