🤖 Agent Instructions

Jekyll website for DotNetDevs.at (Minimal Mistakes theme), hosted on GitHub Pages.

Quick Start

bundle install
npm install
npm run serve

Local URL: http://127.0.0.1:4000

Core Commands

bundle exec jekyll build
bundle exec jekyll serve --incremental
npm test
npm run test:update-snapshots
npm run test:ci

Content Rules

• Events live in _events/<slug>/index.md where <slug> is YYYY-MM-DD (or YYYY-MM-DD-talkN).
• Speakers live in _speakers/ using firstname-lastname.md.
• Sponsors live in _sponsors/.
• Event files must include date, title, speakers, and public: true to be listed.
• Event files should include permalink: /events/<slug>/ to keep stable URLs.
• Event-related archival files (details, images, slides) are stored in the same event folder and are not exposed as download links on pages.
• Speaker names in speakers: must exactly match each speaker file name.
• Use ISO date format (YYYY-MM-DD) in filenames and front matter.

Event Template Fields

Recommended event front matter:

---
date: 2026-01-20
permalink: /events/2026-01-20/
title: "Talk Title"
speakers:
  - Speaker Name
InPersonLink: https://meetup.com/...
RemoteLink: https://meetup.com/...
RecordingLink: ""
Registrations: 0
Participants: 0
Viewers: 0
public: true
abstract: |
  Talk description...
---

Testing & CI

• Always run npm test before committing.
• Update snapshots only for intentional visual changes.
• CI workflow is .github/workflows/jekyll.yml (build → test → deploy).

Useful Scripts

npm run generate:onsite _events/2026-01-20/index.md
npm run generate:remote _events/2026-01-20/index.md
ruby scripts/generate_meetup_image.rb
npm run generate:recording-title -- _events/2026-01-20/index.md

Recording title image notes:

• The generator reads title, date, and speakers from event front matter.
• It writes _events/<slug>/Title for Recording.png, _events/<slug>/Start Streaming.png, and _events/<slug>/Stop Streaming.png and overwrites existing outputs.
• Background templates are templates/Title for Recording.png, templates/Start Streaming.png, and templates/Stop Streaming.png.
• Text rendering uses Consolas.
• Title for Recording.png renders .NET Meetup <Month Year>, then title, then by <speaker(s)>.
• Start Streaming.png and Stop Streaming.png render title and by <speaker(s)>.
• Validate correctness by comparing generated outputs for _events/2026-01-20/Title for Recording.png and _events/2025-12-16/Title for Recording.png with their existing examples; only minor anti-aliasing/font-rendering differences are acceptable.