quarto

Code

import pandas as pd
event_data_cached = pd.read_csv("https://docs.google.com/spreadsheets/d/e/2PACX-1vRqatWozaX_-OaBG_9Peoj4RknvI1OMUOpHUbb8TvzzN8aB5VFGLpLTlqrkY9iavuKZPl9eH0I3Aozm/pub?gid=0&single=true&output=csv")
ojs_define(event_data_cached = event_data_cached)

Workshop

Introduction to Quarto

Learn to create reproducible reports that weave together text and code seamlessly.

About the Workshop

This on-line workshop introduces you to Quarto, a scientific and technical publishing system designed to facilitate reproducible working practices by allowing you to integrate code, results, and narrative text in a single document. Quarto supports multiple programming languages, including R, Python, Julia, and Observable JavaScript.

The workshop will be taught using R and RStudio, but the concepts are applicable to other programming languages supported by Quarto. Some familiarity with the layout of RStudio and beginner level knowledge of R is assumed.

By the end of this workshop, participants will be able to transform raw data into a professional, polished report (HTML, Word, or PDF) where the text and analysis remain in sync. We will use the Gapminder data on global development to demonstrate how to produce a reproducible country profile report that analyses the relationship between wealth (GDP per capita) and health (Life Expectancy) over the last 50 years.

Audience

This workshop is intended for researchers and research support staff in academia or industry or others that regularly produce reports with data analysis.

What you will learn

The Workflow: How to set up a Quarto project in RStudio
Formatting: Text styling, headers, and citations
Code Integration: Embedding R code chunks and controlling their output
Dynamic Statistics: Insert dynamic statistics (e.g., means or p-values) directly into sentences, ensuring numbers update automatically
Exporting: Rendering your work to HTML, PDF, and Word formats

Prerequisites

To participate in this course, you will need a computer with internet access.

To follow along with the activities with the instructor, you will need R and RStudio installed on your computer, or access to Posit Cloud, an online platform for R and RStudio.

Detailed Pre-course instructions

Code

html`
<h3>Event Details</h3>

<div class="event-detail-item">
  <div class="event-detail-icon">
    <i class="fa-regular fa-calendar-days"></i>
  </div>
  <div class="event-detail-content">
    <p>Date</p>
    <p>${event.date || 'TBA'}</p>
  </div>
</div>

<div class="event-detail-item">
  <div class="event-detail-icon">
    <i class="fa-regular fa-clock"></i>
  </div>
  <div class="event-detail-content">
    <p>Time</p>
    <p>${event.time || 'TBA'}</p>
  </div>
</div>

<div class="event-detail-item">
  <div class="event-detail-icon">
    <i class="fa-solid fa-location-dot"></i>
  </div>
  <div class="event-detail-content">
    <p>Location</p>
    <p>${event.location || 'Online'}</p>
  </div>
</div>

<div class="event-detail-item">
  <div class="event-detail-icon">
    <i class="fa-solid fa-sterling-sign"></i>
  </div>
  <div class="event-detail-content">
    <p>Fees</p>
    ${(event.fees || '').split('\n').map(line => `<p>${line}</p>`).join('')}
  </div>
</div>

<a href="${event.register_link || '#'}" class="register-button">Register Now</a>

<p class="event-note">Limited to 30 places</p>

<div class="questions-section">
  <p>Questions?</p>
  <a href="mailto:research-digital-skills@york.ac.uk">research-digital-skills@york.ac.uk</a>
</div>
`