Skip to content

infra: add decks feature for reveal.js slides#36

Merged
lopes merged 10 commits into
mainfrom
infra/slides-feature
Jul 7, 2026
Merged

infra: add decks feature for reveal.js slides#36
lopes merged 10 commits into
mainfrom
infra/slides-feature

Conversation

@lopes

@lopes lopes commented Jul 6, 2026

Copy link
Copy Markdown
Owner

Summary

Type

  • New post (post/)
  • Revision (revise/)
  • Design / theme
  • Infrastructure / CI
  • Docs / typo

Checklist

  • Pre-commit hook passed locally
  • Images are WebP and under 300 KB
  • OG image exists (new posts only)
  • Frontmatter complete — title ≤60 chars, description ≤160 chars, image set
  • No placeholder links (url-here, link_here) remaining
  • Post date is correct
  • Branch name follows <namespace>/<short-description> convention

lopes and others added 10 commits July 6, 2026 17:38
Scaffolds a decks/ content type alongside log/: vigil-reveal theme
(dark/light SCSS), per-deck metadata defaults, authoring guide, and
pre-commit gates for deck slug/title/description length, required tlp
field with publishable-only whitelist (clear|white|green), theme
reference, escape-hatch HTML layout, and no-leak rule for arbitrary
Markdown inside decks/<slug>/. First deck under
decks/lantana-little-help-claude/ included.
- Convert lantana deck assets (jpeg/png → webp), update _brief.md refs.
- README: cut stale _test-site step and redundant sections, replace
  brief-header explanation with a concrete example, tighten pitfalls.
- CLAUDE.md: fix _metadata.yml description (freeze: auto, not "no
  freeze") and note webp as the image authoring convention.
Cherny (Building Claude Code) and Yegge (From IDEs to AI Agents)
promoted to their own references bullet with direct links to the
newsletter transcripts.
… deck

Extend vigil-reveal-{dark,light}.scss with expressive primitives so decks
can compose beyond bullet lists and screenshots: .big-number, .pull-quote
(attributed), .stat-grid, .metric-delta, .chat-snippet, .aside-box,
.timeline, .section-divider, .contact-row. All WIRED-compliant (square
corners, hairline borders, single accent, no shadows).

.contact-row auto-anchors to the bottom of its slide via a scoped
`section:has(> .contact-row)` selector — no per-deck wrapper needed.

Refresh the lantana deck as the proof-of-concept: text-carrying
screenshots (chat/terminal/stats) are extracted into .chat-snippet /
.metric-delta / .stat-grid, references stay bulleted (nonincremental),
contact handles moved to a .contact-row of icon+label chips. Thank you
sits penultimate; Q&A closes the deck.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…es/)

One bucket per deck instead of splitting by type. All non-.qmd deck
content — slide images, iframe escape-hatch HTML, {python} data files —
lives at decks/<slug>/assets/. The OG image stays at deck root (metadata,
not slide content; consistent with log/).

- pre-commit: iframe HTML must live at decks/<slug>/assets/<name>.html
  (was apps/).
- decks/README.md + CLAUDE.md: doctrine updated to the single-folder
  layout, including resources: - assets/ front matter for iframe decks.
- No file moves needed — the only existing deck (lantana) already uses
  assets/ for its screenshots.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1200x630 webp, 60 KB. Fills the image: field in the front matter and
unlocks OG cards on social shares.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The hook already checked the image: field is present and ends .webp,
but never verified the referenced file actually exists — so a post or
deck could ship with a dangling reference. Adds an -f test resolving
the image path relative to the .qmd's directory (posts and decks).

Would have caught the missing og-lantana-little-help-claude.webp on
the current branch before it merged.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- Subtitle: "From beta to v1 in 2 months (review)"
- Description: "How Claude Code accelerated Lantana v1"
- References: dropped the placeholder-heavy tone and added the two
  external sources cited in the AI Literacy notes that back the
  takeaways slide (Chase-H-AI's 6 Levels; Miessler's PAIMM).
  Consolidated the Lantana repo + both posts onto one bullet to
  make room without exceeding the ~5-item cap.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Decks are now a first-class content type. `deck/<slug>` is a valid
branch shape alongside `post/<slug>` for deck-focused work.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@lopes
lopes merged commit 5b2c9ad into main Jul 7, 2026
1 check passed
@lopes
lopes deleted the infra/slides-feature branch July 7, 2026 16:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant