Build Websites With Hugo

Hugo é o gerador de sites estáticos usado para gerar esse site. Depois de alguma pesquisa, me pareceu a melhor ferramenta do tipo disponível.

Adotá-lo não foi um processo rápido para mim. Sempre que eu parava para estudá-lo por tutoriais no YouTube ou pela documentação oficial, acabava um pouco frustrado por não estar entendendo 100% do que estava acontecendo. Aí deixava ele de lado por um tempo.

O Hugo não é uma ferramenta difícil de usar, longe disso. O problema é que com frequência eu esbarrava em termos específicos dele nos tutoriais. Nunca existia muita preocupação em explicar o que eles significavam. Parecia que os autores sempre assumiam algum conhecimento prévio da ferramenta e eu não tinha conhecimento algum.

Front matter, archetypes, page bundles, shortcodes, taxonomies… Um ou mais termos desses eventualmente apareciam “jogados” no meio da explicação e isso me fazia adiar o consumo daquela documentação para depois que eu tivesse dominado esses conceitos.

A documentação oficial é boa, mas mais como guia de referência do que para aprender do zero.

O livro Build Websites With Hugo foi o livro que me fez sair desse zero para decidir manter esse site com o Hugo. É um livro 100% orientado pela prática. A proposta dele é fazer um site de portfólio pessoal que sai do mais simples possível e vai ficando mais sofisticado a cada capítulo.

Eu fui lendo, tomando notas e fazendo o site proposto pelo livro. Mantive a evolução do site em um repositório git e tentei fazer mensagens de commit informativas para eu poder rever algum conceito depois caso fosse necessário.

2 coisas “clarearam” bastante o Hugo para mim:

1. ler esse livro, fazendo o site proposto e
2. fazer esse site que você está lendo com ele.

Escolhi um tema minimalista e fiz umas poucas adaptações. Além da minha preferência por sites em que o foco é o conteúdo, ser um tema simples tornou mais fácil fazer pequenas alterações.

Além de interessante, foi bem divertido. Esse livro é o manual que falta para o Hugo.