infra: route description to title slide; add .takeaways primitive#38
Merged
Conversation
…tive Override Quarto's default reveal.js title-slide partial so the sub-line reads $description$ instead of $subtitle$. Wired in decks/_metadata.yml so every deck inherits it; authors write the hook once, and it serves both the title slide and the OG card. Add .takeaways/.takeaway/.takeaway-label to both vigil-reveal themes: an auto-fit grid of bordered cards for 2-4 categorical claims / rules / caveats — replaces the inline-styled <div style="grid…"> pattern. Pre-commit now permits underscore-prefixed support dirs under decks/ (e.g. decks/_partials/) as an exception to the escape-hatch HTML rule, matching Quarto's "don't render" convention for _-prefixed paths.
… to .takeaways Front matter: single `description:` now feeds both the title-slide sub-line (via decks/_partials/title-slide.html) and the OG card — the two hooks that previously duplicated across `subtitle:` + `description:` collapse into one. Slide 8: replace the inline `<div style="display: grid; …">` with `.takeaways` fenced-div markup — same four cards, same content, styling moves to the vigil-reveal theme.
lopes
force-pushed
the
infra/deck-description-takeaways
branch
from
July 7, 2026 20:46
75fb18d to
e9aa5d3
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
description:to the title-slide sub-line. Overrides Quarto's default reveal.js title-slide partial viadecks/_partials/title-slide.html, wired for every deck indecks/_metadata.yml. Authors write the one-line hook once; it now feeds both the title slide and the OG card.subtitle:is dropped from deck front matter everywhere..takeaways/.takeaway/.takeaway-labelcomposition primitive to both vigil-reveal themes — auto-fit grid of bordered cards for 2–4 parallel takeaways / caveats / rules / steps. Replaces the inline<div style="display: grid; …">pattern deck authors were reaching for. Documented in the scaffold-deck skill (SKILL.md + reveal-conventions.md), and indecks/README.md.decks/lantana-little-help-claude/) to the new pattern — description becomes the single hook, slide 8's inline-styled grid becomes::: {.takeaways}markup._-prefixed support dirs underdecks/(likedecks/_partials/) as an exception to the escape-hatch-HTML-under-assets/rule. Gitignore has a matching un-ignore fordecks/_partials/*.htmlso the partial is tracked despite the global*.htmlexclusion.The scaffold-deck skill files under
~/.config/claude/skills/(in dotfiles) got parallel updates — SKILL.md and references/reveal-conventions.md now dropsubtitle:from templates, add.takeawaysto the design vocabulary, and update the shape decision table. Those aren't in this PR (different repo).Test plan
quarto render decks/lantana-little-help-claude/index.qmd --to revealjssucceeds locally<p class="subtitle">contains thedescription:value (was previously thesubtitle:value)<div class="takeaways"><div class="takeaway">…</div></div>— no inlinestyle=attributes./scripts/pre-commit.shpasses on the modified pilotintegration.yml) reruns pre-commit +quarto render— confirm greenquarto preview: title slide sub-line reads well; takeaways cards lay out at 2 wide (or 2×2) at projection resolution.takeawaysare additive, so this is theoretical for now