Formato YAML

Estructura general

meta:
  portada: "Título visible en la portada"
  unidad:  "Unidad 00"
  output:  "00_nombre-fichero"   # prefijo del fichero de salida

objetivos:
  - "Objetivo didáctico 1"
  - "Objetivo didáctico 2"

indice:
  - "Primera sección"
  - "Segunda sección"

secciones:
  - indice: 1          # referencia 1-based a la lista indice:
    slides:
      - tipo: texto
        texto: "Contenido introductorio."

conclusion:
  - "Punto de conclusión 1"
  - "Punto de conclusión 2"

referencias:
  - ["Nombre del recurso", "https://url.ejemplo.com"]

Tipos de slide

Contenido básico

- tipo: texto
  texto: "Texto libre de la diapositiva."

- tipo: bullets
  items:
    - "Punto uno"
    - "Punto dos"

- tipo: aviso
  nivel: warning    # info | warning | error
  texto: "Mensaje importante."

- tipo: cita
  cita: "La simplicidad es la máxima sofisticación."
  autor: "Leonardo da Vinci"

Código fuente

- tipo: java
  fichero: "src/main/java/Hola.java"   # opcional
  texto: |
    public class Hola {
        public static void main(String[] args) {
            System.out.println("Hola!");
        }
    }

- tipo: python
  texto: |
    def saludar(nombre: str) -> str:
        return f"Hola, {nombre}!"

Misma estructura que java o python, cambiando tipo: por: javascript, html, xml, css, json, yaml, jsp

Terminal y salida

terminal
salida

- tipo: terminal
  items:
    - {cmt: "Compilar el proyecto"}
    - "mvn clean package"
    - {cmt: "Ejecutar"}
    - "java -jar target/app.jar"

- tipo: salida
  items:
    - "BUILD SUCCESS"
    - {ok: "Tests: 42 passed"}
    - {err: "ERROR: conexión rechazada"}

Layouts especiales

- tipo: dos_columnas
  izquierda:
    - "Punto izquierda 1"
    - "Punto izquierda 2"
  derecha:
    - "Punto derecha 1"
    - "Punto derecha 2"

- tipo: comparar          # comparar_python | comparar_java | comparar_xml ...
  izquierda:
    - "antes"
  derecha:
    - "después"

- tipo: tabla
  cabeceras: ["Columna A", "Columna B"]
  filas:
    - ["valor 1", "valor 2"]
    - ["valor 3", "valor 4"]

- tipo: imagen
  ruta: "assets/diagrama.png"

Reglas importantes

Código > 20 líneas → se divide en slides [N/M]
Listas > 14 ítems → se divide en slides [N/M]

Configurable en ~/.config/temario/temario.yaml:

generation:
  code_split_lines: 20
  list_split_items: 14