RinDig/lecture-deck

Lecture deck

Une affirmation par écran, une image qui montre le mécanisme, une légende, et tout le reste dans les notes. Le deck est construit à partir de modules Python d'écran contre un thème, rendu en PNG pour vérification, et contrôlé pour le registre avant d'être livré.

Quand vous recevez une demande

1. Demandez ou déduisez le contexte : qui, combien, où, combien de temps, ce qu'ils savent déjà, qui parle et qui gère la salle. S'il existe un déroulé (les minutages d'un animateur), tenez-le pour acquis.
2. Rédigez d'abord storyboard.md en utilisant reference/storyboard-template.md. Objectif, argument sous forme d'affirmations numérotées, déroulé avec modes, puis une entrée par écran avec son image et sa transition. Lisez les en-têtes seuls comme un argument, puis les transitions seules. Corrigez l'ordre ici.
3. Pour tout deck de plus de dix écrans, critiquez le storyboard avant de construire (flux, niveau du public, si chaque image explique son affirmation, couverture du brief). Intégrez les modifications.
4. Échafaudez et construisez les écrans (reference/workflow.md, reference/kit-api.md). Pour un long deck, divisez les écrans en modules et construisez-les en parallèle.
5. Rendez chaque écran et examinez chaque planche-contact. Corrigez les débordements, les coupures, les textes illisibles, les images qui décorent au lieu d'expliquer.
6. Lancez le contrôle de registre avec --dump et lisez le texte à plat. Corrigez, re-rendez ce qui a changé, répétez jusqu'à ce que ce soit propre.
7. Livrez le HTML, nommez ce qui est provisoire (dates, noms, une plateforme qui n'est peut-être pas prête), et expliquez comment le présenter (flèches, N, O, B, F, Imprimer).

Les règles qui le rendent bon

• La règle de charge. L'en-tête est l'affirmation. Une seule image. Au maximum une légende. Les notes de bas de page sont réservées aux citations vérifiées. Les indications ne figurent que sur les écrans d'exercice et de logistique. La profondeur va dans SAY et IF THE ROOM IS AHEAD, mot pour mot.
• Les images montrent les mécanismes. Une image qui pourrait se trouver sous n'importe quel en-tête est une décoration. Dessinez la chose réelle : le chat, le fichier, le dossier, la personne qui se penche, les poubelles qui se remplissent. Construisez-la dans l'ordre dont l'orateur parlera, avec anim, draw, grow, rise, slide_in, drop. Le complexe est bienvenu quand il explique.
• Un seul casting. Utilisez figure, machine, rigid pour chaque personne, système et boîte rigide afin que le public retrouve les mêmes dessins tout au long du deck.
• Des rôles, pas des couleurs. HIGHLIGHT est le sujet et maintenant ; COOL le système ; WARM ce qui est écrit ; SOFT l'autre partie ; NEUTRAL les espaces ; LIVE uniquement le point de mode. N'importe quel thème fonctionne alors.
• La barre de mode. Chaque écran commence par mode(kind, label, who) : slides, share, breakout, solo, handoff, break. Le public sait toujours qui a l'écran ; l'orateur sait toujours quand changer d'application ou passer la main. La barre de déroulé utilise les mêmes couleurs.
• Le registre. Ouverture sur l'affirmation, phrases complètes, expliquez plutôt que de faire un show. Pas de lignes de révélation, pas de "non pas X mais Y" au-delà d'un par deck, pas de fragments qui concluent un point, pas de triades forcées, pas de tirets, pas de mots d'IA génériques, pas de vocabulaire de méthode sur les écrans du public. Citations vérifiées uniquement. Exemples : un par segment de public, dans le même ordre à chaque fois. Détails dans reference/writing.md.
• Les notes sont le cours. SAY dans la voix de l'orateur, DO NOW avec les temps pour l'animateur, LOOK FOR, IF STUCK, IF THE ROOM IS AHEAD, et une BRIDGE qui mène à l'en-tête suivant.
• Vérifiez en taille réelle. Le mode statique du moteur de rendu montre chaque élément animé dans son état final. Les défauts invisibles dans le volet du navigateur apparaissent en 1280×720.

Commandes

python scripts/new_deck.py chemin/vers/deck --title "Session une" --theme eduba --left "PROGRAMME" --right "SESSION 1"
python scripts/build_deck.py chemin/vers/deck            # écrit deck/out/<nom>.html
python scripts/build_deck.py chemin/vers/deck --theme slate   # un second fichier dans un autre thème
python scripts/render.py chemin/vers/deck/out/<nom>.html     # PNG par écran + planches-contact, mode statique
python scripts/check_text.py chemin/vers/deck/out/<nom>.html --dump

Prérequis : Python 3.9+, un Chromium pour le rendu (Playwright, Chrome ou Edge ; ou définissez DECK_CHROME), Pillow pour les planches-contact. Les polices sont chargées depuis Google Fonts à l'ouverture ; le thème comporte une pile de repli.

Fichiers

• scripts/deckkit/kit.py : les helpers, constantes, casting, images communes. scripts/deckkit/shell.py : le squelette de page. scripts/deckkit/themes/*.json : les thèmes.
• reference/workflow.md : la boucle · reference/writing.md : le registre · reference/kit-api.md : tous les helpers · reference/themes.md : les rôles et comment créer un thème · reference/storyboard-template.md.
• examples/demo/ : un deck de neuf écrans qui utilise la plupart de la bibliothèque ; construisez-le dans chaque thème pour voir l'étendue.