Estrutura de pastas

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, feedback ou authors. Você pode dar à pasta o nome que quiser.
  • Uma pasta chamada en, es ou pt ao 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.md e GEMINI.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/.