How mjeya3/2026-09-24-bath works
This repository is a Jekyll template for building Carpentries workshop websites. The main workflow is to customize workshop metadata and site settings, select curriculum content and schedules, then render and publish the site through GitHub Pages. It also provides participant setup guidance and a workshop-metadata checker. The README documents additional template capabilities; connections involving unsampled templates are limited to documented Jekyll rendering behavior.
Main entry points: _includes Shared includes · workshop_check.py Metadata checker · index.md Workshop metadata · _config.yml Site configuration
Components 16
Workshop authoring
- Workshop metadata
index.md - Site configuration
_config.yml
Site rendering
- Page layouts
_layouts - Shared includes
_includes - Site assets
assets - Jekyll renderer
Workshop content
- Curriculum content
_includes - Workshop schedules
_includes - Setup instructions
_includes/install_instructions - Customization guidance
_extras
Workshop checks
- Metadata checker
bin/workshop_check.py - Parsing utilities
bin/util.py - Validation reporter
bin/reporter.py
Other components
- Workshop organizer
- GitHub Pages
- Workshop website
Connections 17
- Workshop organizer → Workshop metadata: edits metadata
- Workshop organizer → Site configuration: customizes settings
- Workshop organizer → Workshop schedules: edits schedule
- Workshop organizer → Customization guidance: consults guidance
- Workshop metadata → Jekyll renderer: provides page data
- Site configuration → Jekyll renderer: configures render
- Jekyll renderer → Page layouts: renders pages
- Page layouts → Shared includes: uses includes
- Shared includes → Curriculum content: includes curriculum
- Shared includes → Workshop schedules: includes schedules
- Shared includes → Setup instructions: includes instructions
- Jekyll renderer → Site assets: uses assets
- Jekyll renderer → Workshop website: generates site
- GitHub Pages → Workshop website: publishes site
- Workshop organizer → Metadata checker: runs checks
- Metadata checker → Parsing utilities: loads metadata
- Metadata checker → Validation reporter: records results