Merge pull request #7 from pythonhealthdatascience/dev

Dev

Author: amyheather

_quarto.yml

@@ -21,6 +21,7 @@ website:
     contents:
       - text: Welcome
         href: index.qmd
+      - pages/agenda/index.qmd
       - text: "Slides: Why make a website for your research?"
         href: pages/why/index.qmd
       - section: "Tutorial"
@@ -33,6 +34,7 @@ website:
           - pages/media/index.qmd
           - pages/inline_html/index.qmd
           - pages/customising/index.qmd
+          - pages/hosting/index.qmd
       - pages/task/index.qmd
       - section: "Optional extras"
         contents:

pages/agenda/index.qmd

@@ -0,0 +1,48 @@
+---
+title: Workshop agenda
+---
+
+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.
+
+To open this site go to:
+
+<https://tinyurl.com/quarto2026>
+
+![](quarto2026-qr.png){fig-alt="QR code"}
+
+## Session plan
+
+1. **Introduction:**
+    Short talk and demo showing how Quarto can be used in research.
+
+2. **Practical set-up and first commit:**
+   - Create or log in to a GitHub account  
+   - Open the Quarto template in GitHub Codespaces  
+   - Render the site, make a small change, and commit it to Git
+
+3. **Break**
+
+4. **Guided exercises:**
+    Work through a series of short exercises to practice:
+   - Markdown basics  
+   - Media (images, videos, documents)  
+   - Customising the appearance of your site  
+   - And a few other core features
+
+
+5. **Hosting:**
+    Finally, we will explain how to host your site online via GitHub Pages.
+
+## What to expect
+
+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.
+
+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:
+
+- **Task listings** (e.g. blog‑style or gallery‑style listings)  
+- **Sass and CSS**
+- Running and embedding **code** in Quarto.
+
+These are optional and aimed at those who already feel confident with the basics.
+
+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

@@ -80,7 +80,7 @@ book:
   chapters:
     - text: Overview
       href: index.qmd
-    - pages/TODO.qmd
+    - pages/pagename.qmd
   navbar:
     right:
       - icon: github
@@ -98,11 +98,19 @@ A `.qmd` file is a **Quarto Markdown** document. It mixes metadata at the top, t
 
 > If you're familiar with R Markdown (`.Rmd`), these are similar, but `.qmd` is more flexible.
 
-Each `.qmd` file begins with **YAML front matter**, enclosed by three dashes (`---`). This defines metadata such as the page title. Below that is the page. Here we just have one sentence: `This is my homepage.`.
+Each `.qmd` file begins with **YAML front matter**, enclosed by three dashes (`---`). This defines metadata such as the page title, author information and date. Below that is the main content of the page. Here we just have one sentence: `This is my homepage.`.
 
-```{.r}
+```{.yaml}
 ---
 title: My homepage
+author:
+  - name: Amy Heather
+    orcid: 0000-0002-6596-3479
+    affiliations: University of Exeter
+  - name: Thomas Monks
+    orcid: 0000-0003-2631-4481
+    affiliations: University of Exeter
+date: 06-01-2026
 ---
 
 

pages/basic_structure/index.qmd

@@ -0,0 +1,7 @@
+---
+title: Example 1
+---
+
+This page has a picture of a butterfly.
+
+![Butterfly](butterfly.jpg)

pages/blog/examples/example1/butterfly.jpg

@@ -0,0 +1,7 @@
+---
+title: Example 2
+---
+
+This page has a picture of a squirrel.
+
+![Squirrel](squirrel.jpg)

pages/blog/examples/example1/index.qmd

@@ -0,0 +1,7 @@
+---
+title: Example 3
+---
+
+This page has a picture of a cat.
+
+![Cat](cat.jpg)