slidev:handout

Handout Generation

Create comprehensive LaTeX handout combining slides, presenter notes, and supplementary research.

Note: Handouts should include detailed explanations that don't appear on slides (MIT CommLab principle: slides are minimal, handouts are comprehensive).

Execution

1. Check Prerequisites

Required:

• slides.md must exist
• Slides must be exportable (Slidev working)

Optional but helpful:

• brainstorm.md (for additional context)
• Presenter notes in slides (for note sections)

Check all handout dependencies:

${CLAUDE_PLUGIN_ROOT}/scripts/check-handout-deps.sh

Handle exit codes:

• 0: All dependencies available → Proceed with full handout (PNG slides, rich formatting)
• 1: pdflatex missing → EXIT with error, provide installation instructions
• 2: LaTeX packages missing → Proceed with basic handout (standard LaTeX formatting)
• 3: Playwright missing → Proceed with text-only handout (no slide images)

Graceful degradation strategies:

If LaTeX packages (tcolorbox, enumitem) missing:

• Skip \usepackage{tcolorbox} and \usepackage{enumitem}
• Use standard LaTeX boxes instead of colored tcolorbox
• Use standard enumerate/itemize instead of enumitem features
• Handout quality: Basic but functional

If Playwright missing:

• Skip slide PNG export step entirely
• Generate handout with prose only (no slide images)
• Still include all Further Reading links and content
• Handout quality: Text-only reference document

If pdflatex missing:

• Cannot generate handout at all
• Inform user LaTeX is required
• Provide installation instructions
• Offer to create .tex file anyway (user can compile later)

2. Export Slides to Individual PNGs (If Playwright Available)

Only if dependency check returned 0 or 2 (Playwright available):

Export each slide as a separate PNG image:

cd [presentation-dir]
slidev export slides.md --output exports/slides --format png --per-slide

This creates exports/slide-1.png, exports/slide-2.png, etc.