Multi-Deck Slide Hosting

This GitHub Pages project hosts multiple reveal-md slide decks under one site. Each deck has its own URL path.

Features

• Multiple slide decks hosted under one site
• Independent URL path for each deck, such as /sys/ or /example/
• Custom landing page listing available decks
• Backup slide index page at /slides.html
• Automatic deployment to GitHub Pages
• reveal-md based slide generation

Usage

Add a New Deck

1. Create a new .md file under src/.
2. The filename becomes the URL path, for example example.md -> /example/.
3. The first heading becomes the deck title in the generated index.
4. If the deck needs assets, add the corresponding copy step in the workflow so the files are included in _site/.

Local Preview

make

Build and Deploy

# Build all decks
make build

# Clean the build directory
make clean

GitHub Actions builds and deploys the site automatically whenever changes are pushed to main.

Project Structure

.
├── .github/workflows/   # GitHub Actions workflow configuration
├── src/                 # Source files
│   ├── index.html       # Custom landing page
│   ├── sys.md           # Computer Systems III deck
│   ├── example.md       # Example deck
│   ├── *.md             # Other slide deck files
│   ├── template.html    # Slide HTML template
│   ├── custom.css       # Custom styles
│   ├── heti_worker.js   # Typography support script
│   └── Makefile         # Build script
└── README.md            # This file

Site Structure

• / - landing page for all slide decks
• /sys/ - Computer Systems III XPart project deck
• /arvr/ - AR/VR seminar project deck

Tech Stack

• reveal-md for generating slides from Markdown
• GitHub Actions for automated builds and deployment
• GitHub Pages for static hosting

License

MIT License