Topic | Time |
---|---|
Welcome and setup | 11:00 - 11:05 |
What is Quarto? What can it do? | 11:05 - 11:15 |
Creating Quarto reports from .R, .Rmd files | 11:15 - 11:45 |
Ways to share Quarto reports | 11:45 - 11:55 |
BREAK | 11:55 - 12:05 |
Creating a report from your script | 12:05 - 12:35 |
Sharing your report | 12:35 - 12:45 |
Where to get more help | 12:45 - 12:50 |
Reproducibility
Dynamic updating
Easy to share - from coauthors to journals to web audiences
Feature | Quarto | Rmd | Markdown |
---|---|---|---|
Markup syntax (** for emphasis, etc) |
x | x | x |
Render to multiple document types | x | x | x |
Interweave text and code | x | x | x |
Interweave text and executed R code | x | x | |
Execute non-R code | x | ||
Expanded set of document types (dashboards, manuscripts, …) | x |
Let’s start from this R script: https://github.com/cct-datascience/workshop-wednesdays/blob/2023-quarto-reports/202312-quarto-reports/mouse_report.R
Example report document available here: https://github.com/cct-datascience/workshop-wednesdays/blob/2023-quarto-reports/202312-quarto-reports/mouse_report_RMD.Rmd
Most .Rmd documents will render as-is!
Document-level options moved to header
output
changed to format
Chunk-level options moved from ```{r ....}
to #|
within the chunk
knitr::convert_chunk_header(<file_path>)
helps with conversion
knitr::convert_chunk_header
Hosted online with a shareable URL
Static documents to share
Create a free account
Published reports are public
Example: https://cct-datascience.quarto.pub/quarto-workshop-example/
For university research; accounts available for University of Arizona researchers: https://datascience.arizona.edu/analytics-powerhouse/rstudio-connect
Published reports can be public or private
Example: https://viz.datascience.arizona.edu/quarto-workshop-example/
Render using the gfm
output format
Resulting .md files are visible online on GitHub
Published reports may be public or private (depending on repo scopes)
Example: https://github.com/diazrenata/squareone-quarto/blob/main/s3_biomass_as_quarto.md
Render to html
, docx
, or pdf
Resulting documents are portable
Example .pdf: https://github.com/diazrenata/squareone-quarto/blob/main/s3_biomass_as_quarto.pdf
Example .docx (download): https://github.com/diazrenata/squareone-quarto/blob/main/s3_biomass_as_quarto.docx
Share, edit, and re-render a single .qmd
Especially for collaboration on GitHub
Example: https://github.com/diazrenata/squareone-quarto/blob/main/s3_biomass_as_quarto.qmd
Pick one (or more!) of the following options:
Thank you for attending!
For details on drop-in hours, upcoming workshops, and Incubator Program offerings from CCT-Data Science, see our website!