Your first course

This guide takes you from zero to a generated ODP and PDF in under ten minutes.

Before you start

Make sure Temario is installed and configured. If not, see the installation guide.

1. Create the course structure

./temario new my-first-course

This creates the courses/my-first-course/ directory with everything you need:

courses/my-first-course/
├── content/
│   └── my-first-course_00.yaml   ← write your content here
├── template/
│   └── plantilla.odp             ← visual template (copy from example)
├── output/
│   ├── odp/
│   └── pdf/
└── version.txt

2. Edit the content

Open courses/my-first-course/content/my-first-course_00.yaml in your favourite editor or in the GUI (./temario-grafico) and replace the initial content:

meta:
  portada: "Introduction to Docker"
  unidad:  "Unit 01"
  output:  "01_introduction"

objetivos:
  - "Understand what a container is"
  - "Install Docker on Ubuntu"
  - "Run your first container"

indice:
  - "What is Docker?"
  - "Installation"
  - "First steps"

secciones:
  - indice: 1
    slides:
      - tipo: texto
        texto: "Docker is a container platform that allows packaging applications
                with all their dependencies."
      - tipo: bullets
        items:
          - "Container ≠ virtual machine"
          - "Lightweight and portable"
          - "Same behaviour in dev and production"

  - indice: 2
    slides:
      - tipo: terminal
        items:
          - {cmt: "Install Docker on Ubuntu"}
          - "sudo apt-get install -y docker.io"
          - {cmt: "Verify installation"}
          - "docker --version"

  - indice: 3
    slides:
      - tipo: terminal
        items:
          - {cmt: "Run the test container"}
          - "docker run hello-world"
      - tipo: salida
        items:
          - {ok: "Hello from Docker!"}
          - "This message shows that your installation appears to be working."

conclusion:
  - "Docker simplifies application deployment"
  - "Containers are reproducible and portable"

referencias:
  - ["Official Docker documentation", "https://docs.docker.com"]

3. Build the presentation

./temario build courses/my-first-course

You will see something like:

[my-first-course] version → v1
Generated courses/my-first-course/output/odp/my-first-course_01_introduction_v1.odp
Generated courses/my-first-course/output/pdf/my-first-course_01_introduction_v1.pdf

4. Open the result

# Open the ODP in LibreOffice Impress
libreoffice --impress courses/my-first-course/output/odp/my-first-course_01_introduction_v1.odp

Or open the PDF directly with your usual viewer.

5. Edit and rebuild

Edit the YAML, save and run ./temario build again. The version only increments to v2 if v1 already exists in output/odp/, so you can regenerate freely during development.

To regenerate automatically on save:

./temario build --watch courses/my-first-course

Next steps

Read YAML Format to see all available slide types
Learn to use custom templates to apply your own design
Check the CLI reference for all available subcommands