Setup

To use quarto I would suggest using VScode.

To install Quarto see The Quarto Get Started page.

VScode QoL

Go to File > Preferences > Settings

  • Search for “Disable AI Features” and toggle it on
  • Search for “Accept suggestion on Enter” set it to “off”
    • Getting widgets/code auto completed from a word like “table” when you press enter is very annoying
    • Tab works for accepting the suggestion

Extensions

For this site you will also want to follow the below install instruction.

R

R in Visual Studio Code

Spell checker

Code Spell Checker: Useful for spell checking normal words

When using this click on a misspelt word (signified by squiggly underlining) and press “ctrl+.” to get a dropdown of suggestions

To change to GB spelling:

  1. Go to “Extension” on VScode (On far left, icon is three squares and a diamond)
  2. Click on the gear icon for Code Spell Checker
  3. Click on “Settings”
  4. Change “C Spell: Language” to “en-GB”

Create Quarto website project

You can create a quarto project in 2 different way, a quarto command or copying a template.

Quarto command

In the command palette in VScode (the text bar at the top middle) type in the following:

>Quarto: Create Project

Further instructions are here: Quarto Website Quick Start

Copying a template

Optionally, you can copy a template or other project from github and edit it.

If you already have the files you can then copy and paste to a new directory (ensure you don’t copy over any git files/directories if you do this).

To download all the files of a gihub repo:

  1. Navigate to the page via a browser (e.g. https://github.com/m-gemmell/Quarto_guide)
  2. Click on the green <> Code button
  3. Select “Download ZIP”

R package installs

Their are various R packages that are shown for various functions in quarto. Below are the install instructions for them all.

#Webexercises
install.packages("webexercises")
#Tippy tooltips
install.packages("tippy")
#Reticulate to allow use of python in knitr
install.packages("reticulate")
#Icons, below code also included in that section in this guide
install.packages("remotes")
remotes::install_github("mitchelloharawild/icons")
#Download icon sets
icons::download_fontawesome()
icons::download_ionicons()
icons::download_bioicons()