Studio UMZU workshop slides

Markdown slide decks for Studio UMZU workshops, built with MkSlides and Reveal.js.

Requirements

• Python 3.10 or newer
• pip

Setup

python -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

Build

Build all Markdown decks from slides/ into site/:

mkslides build

For a strict build, which fails on unresolved relative links:

mkslides build --strict

The generated site is ignored by Git. Open site/index.html in a browser to choose a deck, or open a deck directly, for example site/roboter-funk/index.html.

To preview while editing:

mkslides serve

Run mkslides serve --help for the available server options.

Project layout

mkslides.yml          MkSlides and Reveal.js configuration
slides/               Markdown source and shared theme
  */index.md          Slide decks
  theme.css           Shared Reveal.js theme
  images/             Deck-specific images
favicon/              Browser icon and web manifest
site/                 Generated HTML and bundled assets (ignored)
requirements.txt      Python dependencies

Authoring slides

Each deck is a Markdown file named index.md. Separate horizontal slides with:

---

Use <!-- vertical --> for vertical slides and Notes: for speaker notes. Relative images and links are resolved from the Markdown file's directory.

The shared theme adds the Studio UMZU logo and signature line to regular slides. Add the title-slide class to a title section when those decorations should be hidden, or no-logo when only the logo should be hidden.

Generated output

site/ is rebuilt from scratch by MkSlides. Do not edit generated HTML or copied assets there; change the Markdown, mkslides.yml, or slides/theme.css and rebuild instead.