We assume
You know R
You know a little bit of Markdown
You want to learn about Quarto, the next-generation of RMarkdown
We’ll teach you
Quarto syntax and formats
More Markdown
Even more R along the way!
Your TAs
Carlos Scheidegger - RStudio + Quarto
Isabel Zimmerman - RStudio + Python/Vetiver
Katie Masiello - RStudio + Solutions Engineering
Tan Ho - ML Engineer at Zelus Analytics
Pouring milk
A straight-forward task - pour the boxed milk into the glass.
Easy to use
Pouring milk
A straight-forward task - pour the boxed milk into the glass.
Easy to use
Understanding the full details
Why Quarto?1
Shakespeare’s Hamlet as a “Quarto”
What about RMarkdown?
Quarto, more than just knitr
We learned from 10 years of literate programming with knitr + rmarkdown
Quarto, more than just knitr
Quarto, more than just knitr
Comfort of your own workspace
So what is Quarto?
A Quarto document i.e. a
.qmdis a plain text file, like a.rmd, that can be rendered to many different formats
Rendering
- Render in RStudio
- System shell via
quarto render
Change your mental model
Source
Output
Change your mental model
---
title: "ggplot2 demo"
author: "Norah Jones"
date: "5/22/2021"
format:
html:
fig-width: 8
fig-height: 4
code-fold: true
---
## Air Quality
@fig-airquality further explores the impact of temperature
on ozone level.
```{r}
#| label: fig-airquality
#| fig-cap: Temperature and ozone level.
#| warning: false
library(ggplot2)
ggplot(airquality, aes(Temp, Ozone)) +
geom_point() +
geom_smooth(method = "loess"
)
```
Code
Code, more than just R
```{python}
#| label: fig-polar
#| fig-cap: "A line plot on a polar axis"
import numpy as np
import matplotlib.pyplot as plt
r = np.arange(0, 2, 0.01)
theta = 2 * np.pi * r
fig, ax = plt.subplots(
subplot_kw = {'projection': 'polar'}
)
ax.plot(theta, r)
ax.set_rticks([0.5, 1, 1.5, 2])
ax.grid(True)
plt.show()
```
What about the CLI?
Quarto is a command line interface (CLI) that renders plain text formats (
.qmd,.rmd,.md) OR mixed formats (.ipynb/Jupyter notebook) into static PDF/Word/HTML reports, books, websites, presentations and more
RStudio Refresher
https://r4ds.had.co.nz/introduction.html#prerequisites
CLI Overview
thomasmock$ quarto --help
Usage: quarto
Version: 1.0.36
Description:
Quarto CLI
Options:
-h, --help - Show this help.
-V, --version - Show the version number for this program.
Commands:
render [input] [args...] - Render input file(s) to various document types.
preview [file] [args...] - Render and preview a document or website project.
serve [input] - Serve a Shiny interactive document.
create-project [dir] - Create a project for rendering multiple documents
convert <input> - Convert documents to alternate representations.
pandoc [args...] - Run the version of Pandoc embedded within Quarto.
run [script] [args...] - Run a TypeScript, R, Python, or Lua script.
install <type> [target] - Installs an extension or global dependency.
publish [provider] [path] - Publish a document or project. Available providers include:
check [target] - Verify correct functioning of Quarto installation.
help [command] - Show this help or the help of a sub-command. 