💾 Archived View for gemini.ctrl-c.club › ~gmgall › books › build-websites-with-hugo › index.gmi captured on 2024-07-08 at 23:59:23. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

Build Websites With Hugo

Postado em 15.01.2023 00:00

Capa

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.