RinDig/lecture-deck

Lecture deck (Deck de conferencia)

Una afirmación por pantalla, una imagen que muestre el mecanismo, un pie de foto, y todo lo demás en las notas. El deck se construye a partir de módulos Python contra un tema, se renderiza a PNG para verificar y se comprueba el registro antes de entregarlo.

Cuando recibes una solicitud

1. Pregunta o deduce la sala: quién, cuántos, dónde, cuánto tiempo, qué saben ya, quién habla y quién gestiona la sala. Si existe un guion de desarrollo (los tiempos del presentador), tómalo como dado.
2. Escribe primero storyboard.md, usando reference/storyboard-template.md. Objetivo, argumento como afirmaciones numeradas, guion de desarrollo con modos, luego una entrada por pantalla con su imagen y su puente. Lee los encabezados solos como argumento; luego los puentes solos. Corrige el orden aquí.
3. Para más de diez pantallas, critica el storyboard antes de construir (flujo, nivel de audiencia, si cada imagen explica su afirmación, cobertura del briefing). Incorpora los cambios.
4. Crea y construye las pantallas (reference/workflow.md, reference/kit-api.md). Para un deck largo, divide las pantallas en módulos y constrúyelos en paralelo.
5. Renderiza cada pantalla y mira cada hoja de contactos. Corrige desbordamientos, recortes, texto ilegible, imágenes que decoran en lugar de explicar.
6. Ejecuta la verificación de registro con --dump y lee el texto plano. Corrige, vuelve a renderizar lo que haya cambiado, repite hasta que esté limpio.
7. Entrega el HTML, nombra lo que es provisional (fechas, nombres, una plataforma que quizá no esté lista) y di cómo presentarlo (flechas, N, O, B, F, Imprimir).

Las reglas que lo hacen bueno

• La regla de la carga. El encabezado es la afirmación. Una imagen. Como máximo un pie de foto. Notas al pie solo para citas verificadas. Indicaciones solo en pantallas de ejercicio y logística. La profundidad va en DI Y SI LA SALA VA ADELANTADA, palabra por palabra.
• Las imágenes muestran mecanismos. Una imagen que pudiera ir debajo de cualquier encabezado es decoración. Dibuja la cosa real: el chat, el archivo, la carpeta, la persona que se agacha, los contenedores que se llenan. Construye en el orden en que hablará el orador, con anim, draw, grow, rise, slide_in, drop. Lo complejo está bien cuando explica.
• Un solo elenco. Usa figure, machine, rigid para cada persona, sistema y caja rígida, para que la audiencia se encuentre con los mismos dibujos en todo el deck.
• Roles, no colores. HIGHLIGHT es el sujeto y el ahora; COOL el sistema; WARM lo escrito; SOFT la otra parte; NEUTRAL espacios; LIVE solo el punto de modo. Entonces funciona cualquier tema.
• La franja de modo. Cada pantalla comienza con mode(tipo, etiqueta, quién): diapositivas, compartir, grupo, individual, traspaso, descanso. La audiencia siempre sabe quién tiene la pantalla; el orador siempre sabe cuándo cambiar de aplicación o ceder el turno. La barra de guion de desarrollo usa los mismos colores.
• Registro. Abre con la afirmación, oraciones completas, explica en lugar de actuar. Sin líneas de revelación, sin "no X sino Y" más de una vez por deck, sin fragmentos que suelten un punto, sin tríadas forzadas, sin guiones, sin palabras típicas de IA, sin vocabulario de método en pantallas de audiencia. Solo citas verificadas. Ejemplos, uno por segmento de audiencia, mismo orden cada vez. Detalles en reference/writing.md.
• Las notas son la conferencia. DI en la voz del orador, HAZ AHORA con tiempos para el presentador, BUSCA, SI ESTÁS ATASCADO, SI LA SALA VA ADELANTADA, y un PUENTE que lleve al siguiente encabezado.
• Verifica a tamaño real. El modo estático del renderizador muestra cada elemento animado en su estado final. Los fallos invisibles en el panel del navegador se ven a 1280×720.

Comandos

python scripts/new_deck.py ruta/al/deck --title "Sesión uno" --theme eduba --left "PROGRAMA" --right "SESIÓN 1"
python scripts/build_deck.py ruta/al/deck            # escribe deck/out/<nombre>.html
python scripts/build_deck.py ruta/al/deck --theme slate   # un segundo archivo en otro tema
python scripts/render.py ruta/al/deck/out/<nombre>.html     # PNG por pantalla + hojas de contactos, modo estático
python scripts/check_text.py ruta/al/deck/out/<nombre>.html --dump

Requisitos: Python 3.9+, un Chromium para renderizar (Playwright, Chrome o Edge; o establece DECK_CHROME), Pillow para las hojas de contactos. Las fuentes se cargan desde Google Fonts al abrir; el tema lleva una pila alternativa.

Archivos

• scripts/deckkit/kit.py los ayudantes, constantes, elenco, imágenes comunes. scripts/deckkit/shell.py el esqueleto de la página. scripts/deckkit/themes/*.json los temas.
• reference/workflow.md el bucle · reference/writing.md el registro · reference/kit-api.md cada ayudante · reference/themes.md roles y cómo hacer un tema · reference/storyboard-template.md.
• examples/demo/ un deck de nueve pantallas que ejercita la mayor parte del kit; constrúyelo en cada tema para ver el rango.