📊 Cap 12: Frontmatter YAML & Metadados

Docs-as-Code • Taxonomias, SEO e Motores de Templates

🗺️ O Acoplamento entre Metadados e Conteúdo

flowchart TD
    subgraph YAML_DATA ["Cabeçalho YAML (Entre '---')"]
        Y1["layout: default\ntitle: 'Meu Guia'\ntags: ['docker', 'ci']\nauthor: 'Engenharia'"]
    end

    subgraph BODY_MD ["Corpo Markdown"]
        B1["# Título\nTexto explicativo, código e diagramas..."]
    end

    YAML_DATA --- BODY_MD

    style YAML_DATA fill:#ede7f6,stroke:#512da8,stroke-width:2px
    style BODY_MD fill:#e8f5e9,stroke:#4caf50,stroke-width:2px

🎯 Slide 1: O Que é o Frontmatter?

• Um bloco de metadados estruturados em formato YAML posicionado obrigatoriamente na primeira linha do arquivo.

• Delimitado por três hífens:

  ---
  layout: default
  title: "Título Oficial da Página"
  ---
  

🎯 Slide 2: Diferença entre Categorias e Tags

• Categories (Categorias):
  • Estruturais, hierárquicas e definem pastas lógicas de navegação.

  • Exemplo: categories: [backend, apis] -> URL /docs/backend/apis/....

• Tags:
  • Etiquetas transversais e não hierárquicas.
  • Exemplo: tags: [performance, caching, redis].

🎯 Slide 3: Variáveis Customizadas de Template

• Você pode inventar qualquer variável no frontmatter!

• Exemplos práticos:
  • sidebar: false (ocultar menu lateral).
  • toc: true (gerar sumário automático no topo).
  • math: true (carregar bibliotecas KaTeX sob demanda).