Quantilica — Documentação

Portal público da Quantilica (docs.quantilica.com), construído com MkDocs Material.

Desenvolvimento local

uv sync
uv run mkdocs serve

Site disponível em https://docs.quantilica.com/.

Estrutura

docs/
├── docs/ # conteúdo (Markdown)
│ ├── index.md # hero e narrativa de abertura
│ ├── quickstart.md # 5 minutos para o primeiro dado
│ ├── concepts/ # arquitetura, princípios, padrões
│ ├── fundacoes/ # quantilica-core, quantilica-analytics
│ ├── ibge/ tesouro/ ... # domínios e ferramentas
│ └── cookbook/ # receitas multi-fonte
├── overrides/ # extensões do tema Material
│ └── partials/
│ └── extrahead.html # meta tags Open Graph / Twitter
└── mkdocs.yml

Open Graph e cards sociais

A configuração padrão emite tags og:* e twitter:* básicas via overrides/partials/extrahead.html, usando a description do front-matter de cada página e a imagem em docs/assets/og-image.png.

Para gerar cards Open Graph automáticos por página (com título, descrição e logo), ative o plugin social do Material:

uv add "mkdocs-material[imaging]"

Depois descomente o bloco - social: em mkdocs.yml. Esse plugin requer Cairo e Pango no sistema (no Windows, geralmente via MSYS2 ou WSL).

og-image.png

Coloque em docs/assets/og-image.png uma imagem 1200×630 com o logo e a tagline da Quantilica. Esse é o fallback usado quando o plugin social não está ativo.

Padrões editoriais

• Idioma: português brasileiro. Identificadores, flags de CLI e nomes de função permanecem em inglês.
• Sem emoji decorativo em títulos e prosa.
• Toda página nova deve ter front-matter com title e description para SEO e Open Graph.
• Veja Padrões de Escrita para o padrão de READMEs dos repositórios.