Guides & How-to

Adding and editing pages

How to add a new page to this wiki, and what every frontmatter field does.

To add a page: copy an existing .md file into src/content/subjects/ or src/content/guides/, rename it, and change the title at the top. The navigation and the front page update themselves — there is no menu to edit.

The filename becomes the URL, so exam-technique.md in guides/ is served at /guides/exam-technique/. Use lowercase words separated by hyphens, and no spaces.

The bit at the top

Every page starts with a block fenced by three dashes. This is frontmatter — settings rather than content:

---
title: Exam technique
summary: How we teach timing and question triage.
order: 2
---

Only title is required. The full list:

Field Required What it does
title Yes Page heading, nav label, browser tab
summary No One line under the title and on the front-page card
order No Lower numbers sort first in the nav; unset sorts by title
videos No List of video links to embed (see below)
files No List of links out to files (see below)
draft No true hides it from nav and front page while you write

Adding a video

Paste the URL straight from the address bar — YouTube or Vimeo, including unlisted links:

videos:
  - url: https://www.youtube.com/watch?v=abc123
    title: Marking a Q3 response
  - url: https://vimeo.com/123456789
    title: Setting up the whiteboard

Videos appear in their own block below the written content. YouTube embeds use the no-cookie domain, so loading a page doesn’t set tracking cookies on tutors.

If you want a video in the middle of a page rather than at the bottom, paste the embed code from YouTube’s Share → Embed button directly into the body — raw HTML works inside Markdown.

Linking to files

Nothing is stored on this site. files is a list of links out — to Cloudflare R2, Google Drive, or anywhere else:

files:
  - url: https://files.example.com/paper-1.pdf
    title: Paper 1 practice set
    note: Updated September 2026

note is optional and shows as a grey second line.

Keep student-linked files out of here. Anything with a student’s name attached belongs in Drive, shared per tutor — not in the shared library.

Seeing your changes

Run npm run dev in the resources-wiki folder and open the address it prints. Edits to a .md file show up in the browser as soon as you save.

Adding a whole new section

Sections (Subjects, Guides) are deliberately not automatic — a new one is a structural decision, not a page. Adding one means editing three small files: src/content.config.ts, src/lib/nav.ts, and a new route folder under src/pages/. Copy how guides is done in each.