Temario

Características

Formato YAML sencillo

Define portada, objetivos, secciones y slides en texto plano. Sin PowerPoint, sin arrastrar cajas.

Plantillas ODP personalizables

Usa tu propia plantilla LibreOffice Impress. Temario detecta los estilos automáticamente.

CLI y GUI

Genera presentaciones con ./temario build o desde la interfaz gráfica de escritorio.

Auto-split inteligente

Código largo o listas extensas se dividen automáticamente en múltiples slides con [N/M].

PDF automático

Exporta a PDF vía LibreOffice headless en el mismo paso de build.

Watch reactivo

Regenera al guardar cambios gracias a inotify (Linux) o FSEvents (macOS).

Inicio rápido

# 1. Dependencias de sistema (Ubuntu/Debian)
sudo apt-get install -y git curl libreoffice poppler-utils

# 2. Instalar uv (gestor de entornos Python)
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.local/bin/env   # o abrir nuevo terminal

# 3. Clonar e instalar
git clone https://gitlab.com/pepesan/escriba && cd escriba
uv sync

# 4. Generar el curso de ejemplo
./temario build courses/ejemplo

# 5. Ver el resultado
ls courses/ejemplo/output/

Ejemplo de YAML

meta:
  portada: "Introducción a Java"
  unidad:  "Unidad 01"
  output:  "01_intro"

objetivos:
  - "Entender la JVM y el compilador javac"
  - "Escribir y ejecutar el primer programa Java"

secciones:
  - titulo: "Hola, mundo"
    slides:
      - tipo: java
        texto: |
          public class Hola {
              public static void main(String[] args) {
                  System.out.println("Hola, mundo!");
              }
          }

conclusion:
  - "Java compila a bytecode portable"
  - "La JVM ejecuta el bytecode en cualquier plataforma"

referencias:
  - ["Documentación oficial Java", "https://docs.oracle.com/javase/"]