RinDig/lecture-deck

Lecture Deck (Vortragsfolien)

Ein Anspruch pro Bildschirm, ein Bild, das den Mechanismus zeigt, ein Bildtitel, und alles andere in den Notizen. Das Deck wird aus Python-Bildschirmmodulen gegen ein Theme erstellt, zur Überprüfung als PNG gerendert und vor dem Verlassen auf Register geprüft.

Wenn Sie eine Anfrage erhalten

1. Fragen Sie nach oder leiten Sie den Raum ab: wer, wie viele, wo, wie lange, was sie bereits wissen, wer spricht und wer den Raum leitet. Wenn ein Ablaufplan (Timings eines Gastgebers) existiert, nehmen Sie ihn als gegeben hin.
2. Schreiben Sie zuerst storyboard.md unter Verwendung von reference/storyboard-template.md. Ziel, Argument als nummerierte Behauptungen, Ablaufplan mit Modi, dann ein Eintrag pro Bildschirm mit seinem Bild und seiner Überleitung. Lesen Sie die Überschriften allein als Argument; dann die Überleitungen allein. Korrigieren Sie hier die Reihenfolge.
3. Bei mehr als zehn Bildschirmen kritisieren Sie das Storyboard vor dem Bauen (Ablauf, Niveau des Publikums, ob jedes Bild seine Behauptung erklärt, Abdeckung des Briefings). Integrieren Sie die Änderungen.
4. Gerüst und Bau der Bildschirme (reference/workflow.md, reference/kit-api.md). Teilen Sie bei einem langen Deck die Bildschirme in Module auf und bauen Sie sie parallel.
5. Rendern Sie jeden Bildschirm und betrachten Sie jedes Kontaktblatt. Beheben Sie Überläufe, Abschneidungen, unleserlichen Text, Bilder, die verzieren statt erklären.
6. Führen Sie die Registerprüfung mit --dump durch und lesen Sie den Text flach. Beheben Sie Fehler, rendern Sie geänderte Bildschirme neu, wiederholen Sie, bis alles sauber ist.
7. Liefern Sie das HTML, benennen Sie, was Platzhalter ist (Daten, Namen, eine Plattform, die möglicherweise nicht bereit ist), und sagen Sie, wie es präsentiert wird (Pfeile, N, O, B, F, Drucken).

Die Regeln, die es gut machen

• Die Belastungsregel. Die Kopfzeile ist die Behauptung. Ein Bild. Höchstens ein Bildtitel. Fußnoten nur für verifizierte Zitate. Hinweise nur auf Übungs- und Logistikbildschirmen. Tiefe geht in SAGEN und WENN DER RAUM VORAUS IST, Wort für Wort.
• Bilder zeigen Mechanismen. Ein Bild, das unter jeder Kopfzeile stehen könnte, ist Dekoration. Zeichnen Sie die tatsächliche Sache: den Chat, die Datei, den Ordner, die sich bückende Person, die sich füllenden Behälter. Bauen Sie es in der Reihenfolge auf, in der der Sprecher spricht, mit anim, draw, grow, rise, slide_in, drop. Komplex ist in Ordnung, wenn es erklärt.
• Eine Besetzung. Verwenden Sie figure, machine, rigid für jede Person, jedes System und jede starre Box, damit das Publikum im gesamten Deck dieselben Zeichnungen sieht.
• Rollen, nicht Farben. HIGHLIGHT ist das Subjekt und jetzt; COOL das System; WARM was geschrieben steht; SOFT die andere Partei; NEUTRAL Lücken; LIVE nur der Modus-Punkt. Dann funktioniert jedes Theme.
• Der Modusstreifen. Jeder Bildschirm beginnt mit mode(kind, label, who): Folien, Teilen, Auszeit, Solo, Übergabe, Pause. Das Publikum weiß immer, wer den Bildschirm hat; der Sprecher weiß immer, wann er Apps wechseln oder übergeben muss. Die Ablaufleiste verwendet dieselben Farben.
• Register. Öffnen Sie mit der Behauptung, vollständige Sätze, erklären statt vorführen. Keine Enthüllungszeilen, kein "nicht X, sondern Y" über mehr als eines pro Deck, keine Fragmente, die einen Punkt landen, keine erzwungenen Dreiergruppen, keine Bindestriche, keine Standard-KI-Wörter, keine Methodenvokabeln auf Publikumsbildschirmen. Nur verifizierte Zitate. Beispiele eins pro Publikumssegment, immer dieselbe Reihenfolge. Details in reference/writing.md.
• Notizen sind der Vortrag. SAGEN in der Stimme des Sprechers, JETZT MACHEN mit Zeiten für den Gastgeber, SUCHEN NACH, WENN FESTSTECKT, WENN DER RAUM VORAUS IST, und eine ÜBERLEITUNG, die zur nächsten Kopfzeile führt.
• In Originalgröße prüfen. Der statische Modus des Renderers zeigt jedes animierte Element in seinem endgültigen Zustand. Fehler, die in einem Browserfenster unsichtbar sind, werden bei 1280×720 sichtbar.

Befehle

python scripts/new_deck.py path/to/deck --title "Session one" --theme eduba --left "PROGRAMM" --right "SESSION 1"
python scripts/build_deck.py path/to/deck            # schreibt deck/out/<name>.html
python scripts/build_deck.py path/to/deck --theme slate   # eine zweite Datei in einem anderen Theme
python scripts/render.py path/to/deck/out/<name>.html     # PNG pro Bildschirm + Kontaktblätter, statischer Modus
python scripts/check_text.py path/to/deck/out/<name>.html --dump

Anforderungen: Python 3.9+, ein Chromium zum Rendern (Playwright's, Chrome oder Edge; oder setzen Sie DECK_CHROME), Pillow für Kontaktblätter. Schriftarten werden beim Öffnen von Google Fonts geladen; das Theme trägt einen Fallback-Stack.

Dateien

• scripts/deckkit/kit.py die Helfer, Konstanten, Besetzung, gemeinsame Bilder. scripts/deckkit/shell.py die Seitenhülle. scripts/deckkit/themes/*.json die Themes.
• reference/workflow.md die Schleife · reference/writing.md das Register · reference/kit-api.md jeder Helfer · reference/themes.md Rollen und wie man ein Theme erstellt · reference/storyboard-template.md.
• examples/demo/ ein Neun-Bildschirm-Deck, das die meisten Funktionen des Kits nutzt; bauen Sie es in jedem Theme, um die Bandbreite zu sehen.