2  Installation

In this section, the aim is to have everyone setup with R, RStudio, and Quarto

2.1 Overview

  • Duration 15 minutes

2.2 Questions

  • How do I install R?
  • How do I install Quarto?
  • How do I install LaTeX in a sane way?

2.3 Software Setup

2.3.1 R

2.3.1.1 Windows

https://cloud.r-project.org/bin/windows/

2.3.1.2 MacOS

https://cloud.r-project.org/bin/macosx/

2.3.1.3 Linux

https://cloud.r-project.org/bin/linux/

2.3.2 RStudio

https://posit.co/download/rstudio-desktop/#download

2.4 Quarto

To ensure you are up to date, run the following script to install the packages.

install.packages("quarto")
install.packages("knitr")
install.packages("here")
install.packages("tidyverse")
install.packages("broom")
install.packages("fs")
install.packages("usethis")

2.5 A note on PDF

Quarto documents can be compiled to PDF, which is a great feature. In order to convert the documents to PDF, they use a software called LaTeX (pronounced la-tek or lay-tek).

Installing LaTeX is thankfully handled when you install Quarto, as Quarto includes a built-in Latexmk engine.

2.5.1 PDF / LaTeX Pain

Installing LaTeX can be a pain, but thankfully Yihui Xie has put a lot of time and energy into making an easier way to install it - tinytex. tinytex is an R package that installs a sane, lightweight (<200Mb) version of LaTeX.

If you are running into issues rendering a PDF, you can try the following:

tinytex::install_tinytex()

If you get the following error, this is good! As it means that TeX has already been installed:

Error: Detected an existing tlmgr at /usr/local/bin/tlmgr. It seems TeX Live has been installed (check tinytex::tinytex_root()). You have to uninstall it, or use install_tinytex(force = TRUE) if you are sure TinyTeX can override it (e.g., you are a PATH expert or installed TinyTeX previously).

Alternatively, you can run the following from the terminal

quarto install tinytex
# follow the prompts from here

2.5.2 Problem solving with LaTeX

If you have any problems with installing tinytex, I recommend you check out the tinytex FAQ page.

2.6 Test Script

You should be able to run the following code on your machine

library(quarto)
library(knitr)
library(here)
library(tidyverse)
library(broom)
library(fs)
library(usethis)