USCOTS 2023 Workshop

Reproducible documents, presentations, and websites with Quarto

by: Hunter Glanz, Emily Robinson & Allison Theobold

Welcome!

Welcome to the USCOTS workshop on Quarto! The goal for the workshop is to introduce statistics educators to Quarto. We will highlight how Quarto can be used educationally, both for students and instructors.

Workshop Description

Quarto is the next generation of R Markdown for publishing, including dynamic and static documents and multi-lingual programming language support. With Quarto, you can create documents, books, presentations, websites, or other online resources. The workshop is comprised of three modules. Module 1 will introduce you to Quarto documents, for both student and instructor use. We will demonstrate how we use Quarto documents and RStudio’s Visual Editor to introduce students to reproducible workflows. We will also demonstrate how Quarto documents can be used to create and distribute teaching resources. Modules 2 and 3 will extend the use of Quarto to create teaching resources, outlining how Quarto can be used to create course slides and course websites. We will conclude with tips on how to make your materials publicly available to share with students and other educators.

Learning Objectives for Workshop

At the end of the tutorial, participants will be able to:

  • create Quarto documents
    • add embellishments to Quarto documents
  • create Quarto presentations
    • add stylistic embellishments to Quarto documents

Intended Audience and Level

This workshop is intended for individuals familiar with RMarkdown and RStudio who are interested in learning more about Quarto! No knowledge of Quarto is required.

While we will not be coding in R during the workshop, it could be useful for individuals to have some familiarity with programming in R.

Schedule

Time Topic Presenter
8:30 - 8:45 Introductions, workshop outline, distribute materials Everyone
8:45 - 9:00 A brief refresher of RStudio Hunter
9:00 - 9:30 Introduction to Quarto documents Allison
9:30 - 10:00 Activity: Exploring YAML options You!
10:00 - 10:30 Snack break!
10:30 - 10:45 Share what you discovered! You!
10:45 - 11:30 Styling Quarto documents Emily
11:30 - 12:00 Activity: Making your course syllabus! You!
12:00 - 1:00 Lunch break!
1:00 - 1:30 Quarto presentations Hunter
1:30 - 1:45 Activity: Make a simple presentation You!
1:45 - 2:00 Styling Quarto presentations Emily & Allison
2:00 - 2:30 Activity: Style your Day 1 slides! You!
2:30 - 3:00 Snack break!
3:00 - 4:00 A brief introduction to version control Hunter
4:00 - 4:30 Making your materials public Emily & Allison

In preparation for the workshop

Participants are required to follow the next steps before the day of the workshop:

  1. Install or Update RStudio to the most current version – 2023.03.0+386 “Cherry Blossom”

  2. Install the most current version of Quarto – Quarto CLI 1.3.340

  3. Install or Update R to the most current version: 4.3.0 (2023-04-21) – Already Tomorrow

Workshop Materials

Workshop materials can be found in the github repository quarto-workshop!

After the Workshop

Feel free to parooze the list of Quarto docs and presentations we have used in our statisics courses. Many of these documents are from the first week of classes, so they could give you an idea of how you might want to introduce your students to Quarto!

This work is licensed under a Creative Commons Attribution 4.0 International License.