explorable-beamer

Explorable beamer deck

Build a beamer deck that teaches the way a good explorable does, but inside the frame a talk imposes: linear, timed, driven by a presenter, 160 × 90 mm with no scrolling. The explorable's non-linear tree becomes a spine of counted frames plus an appendix of side rooms. Its playables become stages the presenter steps through while talking. Its "static read must work" becomes: the handout PDF must carry the argument on its own.

The sibling skill explorable-deck builds the same deck in Quarto reveal.js with live, draggable stages; explorable-explanations builds the website version. This one produces a PDF from LaTeX, and it reuses the website's or the Quarto deck's numbers when one already exists for the topic.

What you produce

One folder per deck, built with sh build.sh:

<deck>/
  deck.tex             the deck: one \begin{frame} per idea, a \note on every frame
  theme/explorable.sty tokens, faces, layouts, the stage, stat cards, chart styles
  data/numbers.tex     the single home of every number a chart or a sentence uses
  data/*.csv           series the charts plot, loaded by numbers.tex
  charts/*.tex         the stages: pgfplots/TikZ, one file each, input into a stage
  figs/*.pdf           the source's figures, recoloured by convert_figs.sh; committed with the deck
  figs/convert_figs.sh, figs/restyle_figs.py
  build.sh             deck.pdf, deck-handout.pdf (one page per frame), deck-notes.pdf (pdfpc)
  shoot.py             one PNG per page, the page → frame map, log messages, overflow check
  check_deck.py        lints deck.tex against the craft rules beamer does not enforce
  README.md            how to build, check, present; where the numbers come from
  plan.md              the talk script (see below)

scripts/new_deck.sh <path> copies the template in assets/template/ and the scripts into place. Start every new deck from it: the template already solves the beamer traps listed in the notes reference, and it compiles on any TeX Live (lualatex) with no network and no font install.