Skip to content

Adding Events

Jump to bottom
Alexander Refsum Jensenius edited this page Jun 21, 2026 · 3 revisions

Events are stored as Markdown files in site/_events/. Each file becomes a page at /events/{slug}/.

File naming

site/_events/YYYY-MM-DD-short-slug.md

The date in the filename controls sorting. The slug becomes part of the URL unless overridden in frontmatter.

Example: site/_events/2026-03-12-meshup07.md → /events/2026-03-12-meshup07/

Frontmatter fields

---
title: "MeshUp #7 – Sports Media and AI"
date: 2026-03-12 14:00:00 +01:00      # Required — event start (datetime + timezone)
end_date: 2026-03-12 16:00:00 +01:00  # Optional — event end time
location: "Zoom / University of Oslo"  # Optional — venue
layout: event
categories: [MeshUp, WP7]             # Used for filtering; include the relevant WP here
description: "Short summary shown in listings and meta tags."
tags: [Sports Media, AI Production]   # Topic keywords (do NOT repeat WP tags here)
image: "https://example.com/image.jpg" # Optional — thumbnail shown in listings
slug: meshup07                         # Optional — overrides URL slug
redirect_from:                         # Optional — old URLs that should redirect here
  - /events/old-slug/
---

Key rules:

  • date must include time and timezone offset (+01:00 for Oslo)
  • categories should include the WP (e.g. WP7) — this is the only place WPs belong
  • tags are topic keywords only; do not duplicate WP tags in tags
  • layout: event is required for proper rendering and iCalendar generation

Body content

Write the event description in Markdown below the frontmatter ---. Images, links, speaker bios, and programme details all go here.

Checking whether events appear

Events with future dates are published because future: true is set in _config.yml. They will appear in the events listing and calendar automatically once the site is rebuilt.

Calendar integration

The event layout automatically:

  • Adds a Google Calendar link on the event page
  • Includes the event in the ICS calendar feed at /events/calendar.ics

WP-specific event listings

Each WP page can show its own filtered event list using the events_wp_pages.html include. The WP must be listed in the event's categories for it to appear there.

Clone this wiki locally