Setup

To follow along with the workshop exercises, you’ll need Quarto version 1.8+ and access to a code editor that supports R or Python.

While Quarto itself doesn’t require a programming language, the exercises will include code chunks in R or Python. If you don’t already have R or Python set up locally, we recommend using a cloud-based option like Posit Cloud (for R) or GitHub Codespaces (for Python).

Recommended Setup Options

Option 1: Posit Cloud (RStudio in the cloud)

• Create a free account at https://posit.cloud/
• Open the Posit Cloud project link: Posit Cloud link: https://posit.cloud/spaces/679626/join?access_code=VwU0N2fEy5wwQ8qHayo8TrTZRKcT6sndAF13AHlx
• Click “Yes” to join the space.
• Click Content and select quarto-brand-exercises or go to https://posit.cloud/spaces/679626/content/10865885/
• To save a copy of the project to your workspace, click “Save a permanent copy”.

Option 2: GitHub Codespaces (VS Code in the browser)

• Create a free account at https://github.com/
• Go to the GitHub repo: https://github.com/posit-dev/quarto-brand-codespaces/
• Click “Use this template” then “Open in a codespace”.
  • Please note that loading the codespace will take several minutes.
  • If you are asked to install an extension called markdownlit, say “yes” and trust the publisher.
• You will need to following the “Install the Necessary Packages” instructions below.
  • Create your virtual environment by selecting Python: Create Environment in the Command Palette.
  • Select your environment type (recommend Venv).
  • Choose an interpreter path.
  • Select requirements.txt check box to install dependencies.

Option 3: Local Installation

Choose one editor and follow the steps:

Positron

• Download and install Positron: https://positron.posit.co/download.html/
• Quarto comes pre-installed.
  • Make sure Quarto is version 1.8+.

RStudio

• Download and install RStudio: https://posit.co/downloads/
  • Make sure RStudio is version 2022.07+.
• Quarto comes pre-installed.
  • Make sure Quarto is version 1.8+.

VS Code

• Download and install VS Code: https://code.visualstudio.com/download/
• Download and install Quarto: https://quarto.org/docs/get-started/
• Install the following extensions:
  • Quarto Extension: https://marketplace.visualstudio.com/items?itemName=quarto.quarto/
  • Jupyter Extension: https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter/

Accessing the Workshop Materials

If you are using a cloud-based option, the files will be included in the project folder.

If you are not using a cloud-based option:

If you use Git/GitHub:

• Exercises are available at: https://github.com/posit-dev/quarto-brand-exercises/
• Clone the repository with Git:

git clone https://github.com/posit-dev/quarto-brand-exercises.git

If you don’t use Git/GitHub:

• Go to the GitHub repo: https://github.com/posit-dev/quarto-brand-exercises/
• Click the green “Code” button → “Download ZIP”.
• Unzip the folder and open it in your chosen editor.

Install the Necessary Packages

R

If you are using Posit Cloud, the packages will be pre-installed. If you are using RStudio or Positron locally, install the packages on a Mac by running:

if (!require("pak")) install.packages("pak")
pak::pak(c("tidyverse", "quarto", "patchwork", "posit-dev/brand-yml/pkg-r"))

If you are using Windows, please run the below for the brand.yml package:

install.packages('brand.yml', repos = c('https://posit-dev.r-universe.dev', 'https://cloud.r-project.org'))

Python

• Create your virtual environment by selecting Python: Create Environment in the Command Palette.
• Select your environment type (recommend Venv).
• Choose an interpreter path.
• Select requirements.txt check box to install dependencies.