Skip to content

Commit fd41ddf

Browse files
committed
feat(agenda): add agenda page (#5)
1 parent 0ee67ae commit fd41ddf

2 files changed

Lines changed: 48 additions & 0 deletions

File tree

pages/agenda/index.qmd

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
title: Workshop agenda
3+
---
4+
5+
This is the companion website for the workshop. You will use it during the exercises, and you can refer back to it afterwards. It contains written instructions that match what we cover in the session, plus some extra material.
6+
7+
To open this site go to:
8+
9+
<https://tinyurl.com/quarto2026>
10+
11+
![](quarto2026-qr.png){fig-alt="QR code"}
12+
13+
## Session plan
14+
15+
1. **Introduction:**
16+
Short talk and demo showing how Quarto can be used in research.
17+
18+
2. **Practical set-up and first commit:**
19+
- Create or log in to a GitHub account
20+
- Open the Quarto template in GitHub Codespaces
21+
- Render the site, make a small change, and commit it to Git
22+
23+
3. **Break**
24+
25+
4. **Guided exercises:**
26+
Work through a series of short exercises to practice:
27+
- Markdown basics
28+
- Media (images, videos, documents)
29+
- Customising the appearance of your site
30+
- And a few other core features
31+
32+
33+
5. **Hosting:**
34+
Finally, we will explain how to host your site online via GitHub Pages.
35+
36+
## What to expect
37+
38+
We have a varied cohort: some of you may already have seen GitHub, Markdown, or Quarto, and for others this will all be completely new. The workshop is designed to be accessible if you are new to these tools, so please do not worry if the terminology is unfamiliar at first.
39+
40+
If you find you move quickly through the core exercises, there are extra pages later in this site where you can explore some more advanced concepts including:
41+
42+
- **Task listings** (e.g. blog‑style or gallery‑style listings)
43+
- **Sass and CSS**
44+
- Running and embedding **code** in Quarto.
45+
46+
These are optional and aimed at those who already feel confident with the basics.
47+
48+
You can also browse the **Examples** page, which shows a range of real Quarto sites. Each example has a link to the live site and, via the GitHub icon in the top right, a link to the source code so you can see how it was built.

pages/agenda/quarto2026-qr.png

12.4 KB
Loading

0 commit comments

Comments
 (0)