Use Hugo and Blowfish to build web sites.
We’re using Hugo with the Book and Blowfish themes to build websites.
Pros#
- Hugo is powerful, widely-used, and has many themes.
- The Book theme supports clean documentation for the Service Infrastructure Book.
- The Blowfish theme supports attractive styling and solid structure for agent.io.
Cons#
- Hugo is complex! Customization has been painful.
- Hugo is intended for static sites. I’ve wanted to do server-side rendering for a few things, and this has been difficult but doable. For the main site, I modified a few pages to generate Go templates and use a Go server to intercept requests for these pages and do the template evaluation. It works but feels awkward… it might be better to generate these pages without Hugo, but that would lose the customization of Hugo templates.