|
| 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 | +{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. |
0 commit comments