Tenho usado o tema ananke desde o início deste blog. Mas recentemente comecei a ter todo tipo de problemas devido à minha falta de compreensão de como a pasta contents está ligada à pasta layouts e à pasta themes/ananke.
/contents
Então, no tema ananke, você tem a opção de ter mais de um idioma para o seu site. No meu caso, só preciso usar a pasta em inglês, que está na pasta contents/en/. Dentro da pasta contents, cada seção precisa ter um arquivo _index.md indicando que é a página principal. Cada seção pode ser representada por uma pasta com conteúdo dentro e um arquivo _index.md como cabeçalho da seção. No meu caso, meus posts estão em contents/en/posts/. Assim, contents/en/ tem uma pasta _index.md, assim como a pasta contents/en/posts/.
Isso é importante porque, juntamente com o _index.md, você pode ter outras páginas, que serão exibidas de forma diferente de acordo com o local em que estão na pasta contents. Assim, um content/en/page.md está no mesmo nível que content/en/posts/_index.md. No tema ananke, isso pode ser visto visualmente pelas páginas do cabeçalho.
/themes/ananke/layouts
Os layouts html que são usados são armazenados na pasta ananke/layouts. Quando o hugo constrói o site, ele usa os layouts presentes lá por padrão.
/layouts
Esta pasta é usada caso o usuário queira fazer alterações nos arquivos html. Quando a alteração é feita nesta pasta, o hugo usará o layout alterado presente nesta pasta, em vez do que está na pasta /themes/ananke/layouts.
Cada seção e página tem um arquivo de layout html padrão que é usado quando o hugo está construindo o site.
Os arquivos de layout html
Os padrões são armazenados na pasta layouts/_defaults.
baseof.html: é a base HTML do site. Contém todos os módulos que estão ligados a outras partes da página, como cabeçalho e rodapé.list.html: é um tipo de página que lista vários arquivos diferentes no mesmo diretório. Um exemplo seria a páginacontents/en/posts/_index.md.single.html: é o layout para páginas únicas, incluindo a pasta de postscontents/en/posts/.summary-with-image.html: para o temaananke, representa as mini-páginas de resumo que são exibidas na lista de artigos.summary.html: o mesmo que o anterior, mas para artigos que não possuem pré-visualização de imagem.index.html: no caso doananke, este arquivo mostra uma lista dos arquivos recentes de uma determinada seção. Mais comumente, mostra os posts recentes.
Em conclusão, entender a relação entre os layouts e o conteúdo do site é fundamental para compreender onde você precisa alterar as coisas para obter o que deseja.
Referência
Minhas referências para isso estão por toda parte, mas aqui estão elas:
Leia também:
- Guia Completo: Como Integrar o Beehiiv ao Hugo via Cloudflare Workers
- Oracle Cloud Free Tier 2026: Ainda Vale a Pena? Guia Completo + Alternativas
- Introdução ao meu novo espaço na internet
Você pode entrar em contato comigo sobre este e outros tópicos no meu e-mail [email protected] ou preenchendo o formulário abaixo.