Hugo is an [[Apache v2]] licensed static site generator written in [[Go]]. - [Website](https://gohugo.io/) - [Source](https://github.com/gohugoio/hugo) - [Documentation](https://gohugo.io/documentation/) > Hugo is a static site generator written in Go, optimized for speed and designed for flexibility. With its advanced templating system and fast asset pipelines, Hugo renders a complete site in seconds, often less. # Notability # Philosophy # Platform Support # Features # Tips ## Terrible Documentation The documentation was updated in early 2024 which made it terrible to search and reference. The search function is broken due to some (probably paid) integration with a third party search system. For example, search for "date" and you will only get results for "data". Archived versions and third party documentation are a requirement for usage. An old version from 2017 partially in Chinese is literally easier to navigate than the official docs. Embarrassing. - https://bwaycer.github.io/hugo_tutorial.hugo/overview/introduction/ - https://www.jakewiesler.com/blog/hugo-taxonomies > We are making an effort to unify our terminology, and to use these terms consistently throughout the documentation. > > Historically, we have inconsistently referred to the items on this page as functions, parameters, variables, or methods. They are not functions, parameters, or variables; they are methods. > > This page will remain in place as readers become familiar with the unified terminology. See the methods section for a list of methods by object, or the methods quick reference guide. \- early 2023 version of the documentation ## Accessing Config Values in Templates Short answer, you can't because Hugo developers specifically decided that you can't. Long answer is that you can explicitly load the file and unmarshall it like any other data file. - https://discourse.gohugo.io/t/access-config-toml-values-in-themes-partial/35999 ## Custom Config Values ```toml [Params] custom_variable = "my value" ``` ```php {{ .Site.Param "custom_variable" }} ``` ## Search - [[Pagefind]] - https://gist.github.com/eddiewebb/735feb48f50f0ddd65ae5606a1cb41ae ## Behind a Reverse Proxy - https://discourse.gohugo.io/t/hugo-behind-proxy-how-to-start/34713 See also: [[Caddy]] # Resources ## Themes - https://jamstackthemes.dev/ssg/hugo/ - https://github.com/colinwilson/lotusdocs - https://github.com/panr/hugo-theme-terminal/network # References ## Theming - https://draft.dev/learn/creating-hugo-themes -