index.qmd

---
title: "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](causeweb.org/cause/uscots/uscots23/w04-reproducible-documents-presentations-and-websites-quarto-room-106)! 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](/materials/00-introductions.qmd) |    Everyone     |
|  8:45 - 9:00  |           [A brief refresher of RStudio](/materials/01-rstudio-refresher.qmd)           |     Hunter      |
|  9:00 - 9:30  |            [Introduction to Quarto documents](/materials/02-quarto-docs.qmd)            |     Allison     |
| 9:30 - 10:00  |       [Activity: Exploring YAML options](/materials/02-activity-quarto-yaml.qmd)        |      You!       |
| 10:00 - 10:30 |                                      Snack break!                                       |                 |
| 10:30 - 10:45 |                               Share what you discovered!                                |      You!       |
| 10:45 - 11:30 |         [Styling Quarto documents](/materials/03-styling-quarto-docs.qmd)          |      Emily      |
| 11:30 - 12:00 |         [Activity: Making your course syllabus!](/materials/03-activity-styling-quarto-docs.qmd)         |      You!       |
| 12:00 - 1:00  |                                      Lunch break!                                       |                 |
|  1:00 - 1:30  |             [Quarto presentations](/materials/04-quarto-presentations.qmd)              |     Hunter      |
|  1:30 - 1:45  | [Activity: Make a simple presentation](/materials/04-activity-quarto-presentations.qmd) |      You!       |
|  1:45 - 2:00  |     [Styling Quarto presentations](/materials/05-styling-quarto-presentations.qmd)      | Emily & Allison |
|  2:00 - 2:30  |    [Activity: Style your Day 1 slides!](/materials/05-activity-styling-quarto-presentations.qmd)     |      You!       |
|  2:30 - 3:00  |                                      Snack break!                                       |                 |
|  3:00 - 4:00  |      [A brief introduction to version control](/materials/06-version-control.qmd)       |     Hunter      |
|  4:00 - 4:30  |                     [Making your materials public](/materials/07-publishing.qmd)        |     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"](https://posit.co/download/rstudio-desktop/)

2.  Install the most current version of Quarto -- [Quarto CLI 1.3.340](https://quarto.org/docs/get-started/)

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

-   Windows: <https://cran.rstudio.com/bin/windows/>

-   Mac: <https://cran.rstudio.com/bin/macosx/>

-   Linux: <https://cran.rstudio.com/bin/linux/>

# Workshop Materials

Workshop materials can be found in the github repository [quarto-workshop](https://github.com/atheobold/uscots-quarto)!

# After the Workshop

Feel free to parooze the [list of Quarto docs and presentations](resources/resource-list.qmd) 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! 

------------------------------------------------------------------------

![](https://i.creativecommons.org/l/by/4.0/88x31.png) This work is licensed under a [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).