This project provides a comprehensive template for creating interactive slide decks using Slidev, specifically designed for WebTigerPython presentations. The template integrates WebTigerPython as an embedded iframe, allowing for dynamic and engaging educational content.
- Slidev Integration: Leverage the power of Slidev for modern, markdown-based presentations
- WebTigerPython Embedding: Seamlessly include interactive Python programming environments
- Easy Deployment: One-click GitHub Pages deployment
- Responsive Design: Slides look great on any device
- Node.js (v14+ recommended)
- npm
# Clone the repository
git clone https://github.com/tiger-jython/wtp-slides-template.git
# Navigate to project directory
cd wtp-slides-template
# Install dependencies
npm install# Start development server
npm run dev
# Open in browser
# Visit http://localhost:3030- Edit
slides.mdto modify slide content - Use markdown and Slidev-specific syntax for rich presentations
- Embed WebTigerPython directly in slides
Every push to main or a feature/** branch is automatically built and published to GitHub Pages by .github/workflows/deploy.yml:
maindeploys to the site root: 👉 https://tiger-jython.github.io/wtp-slides-template/- Any
feature/<name>branch deploys to its own subpath:https://tiger-jython.github.io/wtp-slides-template/feature/<name>/
This lets multiple decks (conference talks, courses, etc.) live as separate branches in one repo, each with its own persistent URL, instead of needing a separate repo per deck. See dev-clemons/wtp-slides-template for an example with several decks deployed this way.
- Create a branch named
feature/<your-deck-name> - Push it — the Action builds and publishes it automatically
- It goes live at
.../feature/<your-deck-name>/
- GitHub Pages source must be set to "Deploy from a branch" →
gh-pages→/ (root)under Settings → Pages. The default "GitHub Actions" source only supports one live deployment at a time and won't work with this per-branch setup. - The workflow uses a per-branch
concurrency.group(pages-${{ github.ref_name }}) so multiple branches can deploy in parallel without cancelling each other. - The
maindeploy usesclean-excludeto protect other branches'feature/subfolders ongh-pagesfrom being wiped out when the root gets rebuilt.
Happy Presenting! 🎉👩💻👨💻