Tu primer curso

Esta guía te lleva desde cero hasta tener un ODP y un PDF generados en menos de diez minutos.

Antes de empezar

Asegúrate de tener Temario instalado y configurado. Si aún no lo has hecho, consulta la guía de instalación.

1. Crear la estructura del curso

./temario new mi-primer-curso

Esto crea el directorio courses/mi-primer-curso/ con todo lo necesario:

courses/mi-primer-curso/
├── content/
│   └── mi-primer-curso_00.yaml   ← aquí escribes el contenido
├── template/
│   └── plantilla.odp             ← plantilla visual (copia del ejemplo)
├── output/
│   ├── odp/
│   └── pdf/
└── version.txt

2. Editar el contenido

Abre courses/mi-primer-curso/content/mi-primer-curso_00.yaml en tu editor favorito o en la GUI (./temario-grafico) y reemplaza el contenido inicial:

meta:
  portada: "Introducción a Docker"
  unidad:  "Unidad 01"
  output:  "01_introduccion"

objetivos:
  - "Entender qué es un contenedor"
  - "Instalar Docker en Ubuntu"
  - "Ejecutar tu primer contenedor"

indice:
  - "¿Qué es Docker?"
  - "Instalación"
  - "Primeros pasos"

secciones:
  - indice: 1
    slides:
      - tipo: texto
        texto: "Docker es una plataforma de contenedores que permite empaquetar
                aplicaciones con todas sus dependencias."
      - tipo: bullets
        items:
          - "Contenedor ≠ máquina virtual"
          - "Ligero y portable"
          - "Mismo comportamiento en dev y producción"

  - indice: 2
    slides:
      - tipo: terminal
        items:
          - {cmt: "Instalar Docker en Ubuntu"}
          - "sudo apt-get install -y docker.io"
          - {cmt: "Verificar instalación"}
          - "docker --version"

  - indice: 3
    slides:
      - tipo: terminal
        items:
          - {cmt: "Ejecutar el contenedor de prueba"}
          - "docker run hello-world"
      - tipo: salida
        items:
          - {ok: "Hello from Docker!"}
          - "This message shows that your installation appears to be working."

conclusion:
  - "Docker simplifica el despliegue de aplicaciones"
  - "Los contenedores son reproducibles y portables"

referencias:
  - ["Documentación oficial Docker", "https://docs.docker.com"]

3. Generar la presentación

./temario build courses/mi-primer-curso

Verás algo como:

[mi-primer-curso] versión → v1
Generado courses/mi-primer-curso/output/odp/mi-primer-curso_01_introduccion_v1.odp
Generado courses/mi-primer-curso/output/pdf/mi-primer-curso_01_introduccion_v1.pdf

4. Abrir el resultado

# Abrir el ODP en LibreOffice Impress
libreoffice --impress courses/mi-primer-curso/output/odp/mi-primer-curso_01_introduccion_v1.odp

O abre directamente el PDF con tu visor habitual.

5. Modificar y regenerar

Edita el YAML, guarda y vuelve a ejecutar ./temario build. La versión solo sube a v2 si ya existe el v1 en output/odp/, así que puedes regenerar libremente durante el desarrollo.

Para regenerar automáticamente al guardar:

./temario build --watch courses/mi-primer-curso

Usa la GUI

./temario-grafico hace todo esto con interfaz visual: árbol de secciones, snippets de código por tipo de slide y log de build en tiempo real.

Siguientes pasos

• Consulta el Formato YAML para ver todos los tipos de slide disponibles
• Aprende a usar plantillas personalizadas para darle tu propio diseño
• Revisa la referencia del CLI para todos los subcomandos disponibles