Estrutura de pastas
Este texto foi traduzido automaticamente com IA a partir do original em English. Pode ter erros.
Ver o original (English)Como pastas e notas se tornam as páginas do site.
O mapa
Site/ a pasta com as notas do site
├── _index.md página inicial e configurações do site
├── Docs/ seção de documentação (blup: docs)
│ ├── _index.md página de abertura da documentação
│ └── Getting started/ um grupo no menu lateral
├── Roadmap/ quadro do roadmap (blup: roadmap)
├── Changelog/ lista de versões (blup: changelog)
├── Help/ central de ajuda (blup: help)
├── Blog/ blog (blup: blog)
├── Feedback/ quadro de solicitações (blup: feedback)
├── Writers/ perfis de autores (blup: authors)
└── Attachments/ imagens, áudios e outros arquivos
As regras
- Cada nota vira uma página.
- Cada pasta vira um grupo ou uma seção.
- A nota _index de uma pasta dá a ela um título, uma descrição e um texto de abertura.
- No Bento, a propriedade blup no _index de uma pasta de nível superior define que tipo de seção ela é:
docs,roadmap,changelog,help,blog,feedbackouauthors. Você pode dar à pasta o nome que quiser. - Uma pasta chamada
en,esouptao lado de uma nota guarda a tradução dela. Veja Sites multilíngues.
O que fica fora do site
- Notas com
draft: true(elas aparecem só na prévia). - Pastas que começam com ponto, como
.blup. - A pasta de modelos (Templates).
- A pasta de autores: ela só vira os dados do perfil.
- Os guias para agentes de IA (
AGENTS.md,CLAUDE.mdeGEMINI.md), que o Studio cria quando você abre o terminal. - Anexos que nenhuma nota usa.
Pastas que o Blup usa por trás dos panos
- .blup, dentro da pasta de notas: guarda o arquivo
site.toml, a parte das configurações que acompanha a sincronização. - A pasta do site (fora das suas notas):
blup.toml, os arquivos do gerador, a Lixeira do Studio e o estado da sincronização. Você nunca precisa abri-la.
Endereços das páginas
O endereço vem dos nomes da pasta e da nota, sem acentos e com hífens: a nota “Folder structure” dentro de “Getting started” vira /docs/getting-started/folder-structure/.