Postado em 15.01.2023 00:00
Autor(es): Brian P. Hogan
Editora: The Pragmatic Bookshelf
Páginas: 147
Idioma: inglês
ISBN-13: 9781680507263
ISBN-10: ?
[Hugo](https://gohugo.io/) é 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*](https://gohugo.io/content-management/front-matter/), [*archetypes*](https://gohugo.io/content-management/archetypes/), [*page bundles*](https://gohugo.io/content-management/page-bundles/), [*shortcodes*](https://gohugo.io/content-management/shortcodes/), [*taxonomies*](https://gohugo.io/content-management/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](https://github.com/gmgall/hugo-example) 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
1. fazer esse site que você está lendo com ele.
Escolhi [um tema](https://themes.gohugo.io/themes/smol/) [minimalista](https://themes.gohugo.io/tags/minimal/) 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.
