Gestão do catálogo de ferramentas
Decisão
- Gerenciar a lista de
/toolscom uma Content Collection usando YAML. - Cada entrada YAML representa metadados de uma ferramenta.
- Armazenar
title/descriptionlocalizados dentro da própria entrada YAML. - Não gerar automaticamente páginas
/tools/<slug>a partir do catálogo; páginas de ferramenta devem ser implementadas. - Tratar
urliniciando com/como link interno; caso contrário, como externo. - Manter categorias flexíveis (sem enum fixo).
Contexto
Páginas de ferramenta exigem implementação (ex.: gerador de UUID), então geração baseada em Markdown não é adequada. Ao mesmo tempo, a lista /tools precisa de tags/categorias para filtros e deve ser fácil de atualizar.
Alternativas
- Markdown: conteúdo de corpo desnecessário.
- TS/JSON: seguro por tipo, mas mais orientado a código para atualização.
- CMS externo: pesado demais para um site pessoal.
Consequências
- A lista é atualizada por alterações em YAML.
- As páginas de ferramenta permanecem livres para implementação.
categoryetagspodem ser usados para busca e filtragem.
hsb.horse