Como organizar um site estático que consegue crescer

Começar com um único index.html é perfeitamente válido. O problema aparece quando cada página nova copia estilos, caminhos e componentes sem uma convenção. Pequenas diferenças acumulam-se até qualquer alteração exigir procurar em muitos ficheiros.

Uma pasta por URL

Uma estrutura baseada em diretórios permite URLs legíveis: /sobre/, /artigos/ e /artigos/nome-do-artigo/. Cada diretório contém um index.html. Esta forma funciona em muitos servidores sem regras especiais.

Os nomes devem usar minúsculas, hífenes e palavras que continuem claras fora do menu. Alterar URLs depois da indexação exige redirecionamentos permanentes.

Recursos partilhados

CSS, JavaScript, ícones e imagens comuns devem viver num local previsível. Um único CSS não é obrigatório, mas reduz repetição em projetos pequenos. Dividir ficheiros faz sentido quando existe uma fronteira real, não apenas para parecer organizado.

O JavaScript deve ser progressivo: conteúdo e ligações continuam disponíveis se o script falhar. No Besttein, o menu móvel e a preparação do email usam JavaScript, mas os endereços e páginas permanecem acessíveis.

Consistência de cabeçalho e rodapé

Sem sistema de componentes, estes blocos são repetidos. É necessário um processo de revisão para garantir que novas páginas entram no menu adequado e que links legais aparecem onde são necessários.

Quando a repetição se torna difícil, pode ser introduzido um gerador estático. O navegador continua a receber HTML pronto, mas os ficheiros são produzidos a partir de modelos. Esta mudança resolve manutenção sem obrigar a criar uma aplicação dinâmica.

Conteúdo como parte da arquitetura

Artigos precisam de metadados coerentes: título, resumo, data, autor, categoria e URL. Mesmo que sejam escritos em HTML, essas decisões devem seguir um formato comum. A listagem de artigos deve ser atualizada juntamente com o sitemap.

Uma página editorial não deve ficar isolada. Deve existir ligação a partir da listagem e, quando relevante, de outros artigos e páginas de projetos.

Separar subdomínios

Um subdomínio como build.besttein.pt pode ter identidade e ficheiros próprios. Isso facilita publicação independente, mas exige atenção aos caminhos absolutos. Dentro da pasta local do Build, /style.css refere-se à raiz do subdomínio depois de publicado, não à raiz do site principal.

Cada subdomínio deve ter políticas e sitemap adequados ao que realmente faz. Também deve ligar de volta ao projeto principal para que a relação seja compreensível.

Automatizar verificações pequenas

Não é necessário um sistema complexo para ganhar confiança. Um script pode percorrer páginas, confirmar idioma, contar H1, verificar canónicas, analisar JSON-LD e testar ligações locais. O navegador automatizado pode procurar erros de consola e deslocamento horizontal.

Estas verificações não substituem leitura e inspeção visual. Encontram classes diferentes de problemas.

Quando deixar de ser estático

Um backend torna-se necessário quando existem contas, dados privados, pesquisa avançada, pagamentos, edição por pessoas não técnicas ou formulários que precisam de processamento próprio. Adicionar servidor apenas para reutilizar um cabeçalho costuma ser uma troca desfavorável.

Estrutura de referência

/
  index.html
  style.css
  script.js
  sobre/index.html
  artigos/index.html
  artigos/meu-artigo/index.html
  privacidade/index.html
  404.html
  robots.txt
  sitemap.xml