Just dumping some thoughts out for now
Will add more to this once I’ve had time to sit down and think about this first post.
Raw code file from GitHub
1// Copyright 2024 The Hugo Authors. All rights reserved.
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6// http://www.apache.org/licenses/LICENSE-2.0
7//
8// Unless required by applicable law or agreed to in writing, software
9// distributed under the License is distributed on an "AS IS" BASIS,
10// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
11// See the License for the specific language governing permissions and
12// limitations under the License.
13
14package commands
15
16import (
17 "context"
18 "runtime"
19
20 "github.com/bep/simplecobra"
21 "github.com/gohugoio/hugo/common/hugo"
22 "github.com/spf13/cobra"
23)
24
25func newEnvCommand() simplecobra.Commander {
26 return &simpleCommand{
27 name: "env",
28 short: "Display version and environment info",
29 long: "Display version and environment info. This is useful in Hugo bug reports",
30 run: func(ctx context.Context, cd *simplecobra.Commandeer, r *rootCommand, args []string) error {
31 r.Printf("%s\n", hugo.BuildVersionString())
32 r.Printf("GOOS=%q\n", runtime.GOOS)
33 r.Printf("GOARCH=%q\n", runtime.GOARCH)
34 r.Printf("GOVERSION=%q\n", runtime.Version())
35
36 if r.isVerbose() {
37 deps := hugo.GetDependencyList()
38 for _, dep := range deps {
39 r.Printf("%s\n", dep)
40 }
41 } else {
42 // These are also included in the GetDependencyList above;
43 // always print these as these are most likely the most useful to know about.
44 deps := hugo.GetDependencyListNonGo()
45 for _, dep := range deps {
46 r.Printf("%s\n", dep)
47 }
48 }
49 return nil
50 },
51 withc: func(cmd *cobra.Command, r *rootCommand) {
52 cmd.ValidArgsFunction = cobra.NoFileCompletions
53 },
54 }
55}
56
57func newVersionCmd() simplecobra.Commander {
58 return &simpleCommand{
59 name: "version",
60 run: func(ctx context.Context, cd *simplecobra.Commandeer, r *rootCommand, args []string) error {
61 r.Println(hugo.BuildVersionString())
62 return nil
63 },
64 short: "Display version",
65 long: "Display version and environment info. This is useful in Hugo bug reports.",
66 withc: func(cmd *cobra.Command, r *rootCommand) {
67 cmd.ValidArgsFunction = cobra.NoFileCompletions
68 },
69 }
70}
Markdown from GitHub
A fast and flexible static site generator built with love by bep, spf13, and friends in Go.
Website | Installation | Documentation | Support | Contributing | Mastodon
Overview
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.
Due to its flexible framework, multilingual support, and powerful taxonomy system, Hugo is widely used to create:
- Corporate, government, nonprofit, education, news, event, and project sites
- Documentation sites
- Image portfolios
- Landing pages
- Business, professional, and personal blogs
- Resumes and CVs
Use Hugo’s embedded web server during development to instantly see changes to content, structure, behavior, and presentation. Then deploy the site to your host, or push changes to your Git provider for automated builds and deployment.
Hugo’s fast asset pipelines include:
- Image processing – Convert, resize, crop, rotate, adjust colors, apply filters, overlay text and images, and extract EXIF data
- JavaScript bundling – Transpile TypeScript and JSX to JavaScript, bundle, tree shake, minify, create source maps, and perform SRI hashing.
- Sass processing – Transpile Sass to CSS, bundle, tree shake, minify, create source maps, perform SRI hashing, and integrate with PostCSS
- Tailwind CSS processing – Compile Tailwind CSS utility classes into standard CSS, bundle, tree shake, optimize, minify, perform SRI hashing, and integrate with PostCSS
And with Hugo Modules, you can share content, assets, data, translations, themes, templates, and configuration with other projects via public or private Git repositories.
See the features section of the documentation for a comprehensive summary of Hugo’s capabilities.
Sponsors
Editions
Hugo is available in three editions: standard, extended, and extended/deploy. While the standard edition provides core functionality, the extended and extended/deploy editions offer advanced features.
| Feature | extended edition | extended/deploy edition |
|---|---|---|
| Encode to the WebP format when processing images. You can decode WebP images with any edition. | ✔️ | ✔️ |
| Transpile Sass to CSS using the embedded LibSass transpiler. You can use the Dart Sass transpiler with any edition. | ✔️ | ✔️ |
| Deploy your site directly to a Google Cloud Storage bucket, an AWS S3 bucket, or an Azure Storage container. See details. | ❌ | ✔️ |
Unless your specific deployment needs require the extended/deploy edition, we recommend the extended edition.
Installation
Install Hugo from a prebuilt binary, package manager, or package repository. Please see the installation instructions for your operating system:
Build from source
Prerequisites to build Hugo from source:
- Standard edition: Go 1.24.0 or later
- Extended edition: Go 1.24.0 or later, and GCC
- Extended/deploy edition: Go 1.24.0 or later, and GCC
Build the standard edition:
1go install github.com/gohugoio/hugo@latest
Build the extended edition:
1CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest
Build the extended/deploy edition:
1CGO_ENABLED=1 go install -tags extended,withdeploy github.com/gohugoio/hugo@latest
Star History
Documentation
Hugo’s documentation includes installation instructions, a quick start guide, conceptual explanations, reference information, and examples.
Please submit documentation issues and pull requests to the documentation repository.
Support
Please do not use the issue queue for questions or troubleshooting. Unless you are certain that your issue is a software defect, use the forum.
Hugo’s forum is an active community of users and developers who answer questions, share knowledge, and provide examples. A quick search of over 20,000 topics will often answer your question. Please be sure to read about requesting help before asking your first question.
Contributing
You can contribute to the Hugo project by:
- Answering questions on the forum
- Improving the documentation
- Monitoring the issue queue
- Creating or improving themes
- Squashing bugs
Please submit documentation issues and pull requests to the documentation repository.
If you have an idea for an enhancement or new feature, create a new topic on the forum in the “Feature” category. This will help you to:
- Determine if the capability already exists
- Measure interest
- Refine the concept
If there is sufficient interest, create a proposal. Do not submit a pull request until the project lead accepts the proposal.
For a complete guide to contributing to Hugo, see the Contribution Guide.
Dependencies
Hugo stands on the shoulders of great open source libraries. Run hugo env --logLevel info to display a list of dependencies.
See current dependencies
1github.com/BurntSushi/locker="v0.0.0-20171006230638-a6e239ea1c69"
2github.com/PuerkitoBio/goquery="v1.10.1"
3github.com/alecthomas/chroma/v2="v2.15.0"
4github.com/andybalholm/cascadia="v1.3.3"
5github.com/armon/go-radix="v1.0.1-0.20221118154546-54df44f2176c"
6github.com/bep/clocks="v0.5.0"
7github.com/bep/debounce="v1.2.0"
8github.com/bep/gitmap="v1.6.0"
9github.com/bep/goat="v0.5.0"
10github.com/bep/godartsass/v2="v2.3.2"
11github.com/bep/golibsass="v1.2.0"
12github.com/bep/gowebp="v0.3.0"
13github.com/bep/imagemeta="v0.8.4"
14github.com/bep/lazycache="v0.7.0"
15github.com/bep/logg="v0.4.0"
16github.com/bep/mclib="v1.20400.20402"
17github.com/bep/overlayfs="v0.9.2"
18github.com/bep/simplecobra="v0.5.0"
19github.com/bep/tmc="v0.5.1"
20github.com/cespare/xxhash/v2="v2.3.0"
21github.com/clbanning/mxj/v2="v2.7.0"
22github.com/cpuguy83/go-md2man/v2="v2.0.4"
23github.com/disintegration/gift="v1.2.1"
24github.com/dlclark/regexp2="v1.11.5"
25github.com/dop251/goja="v0.0.0-20250125213203-5ef83b82af17"
26github.com/evanw/esbuild="v0.24.2"
27github.com/fatih/color="v1.18.0"
28github.com/frankban/quicktest="v1.14.6"
29github.com/fsnotify/fsnotify="v1.8.0"
30github.com/getkin/kin-openapi="v0.129.0"
31github.com/ghodss/yaml="v1.0.0"
32github.com/go-openapi/jsonpointer="v0.21.0"
33github.com/go-openapi/swag="v0.23.0"
34github.com/go-sourcemap/sourcemap="v2.1.4+incompatible"
35github.com/gobuffalo/flect="v1.0.3"
36github.com/gobwas/glob="v0.2.3"
37github.com/gohugoio/go-i18n/v2="v2.1.3-0.20230805085216-e63c13218d0e"
38github.com/gohugoio/hashstructure="v0.5.0"
39github.com/gohugoio/httpcache="v0.7.0"
40github.com/gohugoio/hugo-goldmark-extensions/extras="v0.2.0"
41github.com/gohugoio/hugo-goldmark-extensions/passthrough="v0.3.0"
42github.com/gohugoio/locales="v0.14.0"
43github.com/gohugoio/localescompressed="v1.0.1"
44github.com/golang/freetype="v0.0.0-20170609003504-e2365dfdc4a0"
45github.com/google/go-cmp="v0.6.0"
46github.com/google/pprof="v0.0.0-20250208200701-d0013a598941"
47github.com/gorilla/websocket="v1.5.3"
48github.com/hairyhenderson/go-codeowners="v0.7.0"
49github.com/hashicorp/golang-lru/v2="v2.0.7"
50github.com/jdkato/prose="v1.2.1"
51github.com/josharian/intern="v1.0.0"
52github.com/kr/pretty="v0.3.1"
53github.com/kr/text="v0.2.0"
54github.com/kyokomi/emoji/v2="v2.2.13"
55github.com/lucasb-eyer/go-colorful="v1.2.0"
56github.com/mailru/easyjson="v0.7.7"
57github.com/makeworld-the-better-one/dither/v2="v2.4.0"
58github.com/marekm4/color-extractor="v1.2.1"
59github.com/mattn/go-colorable="v0.1.13"
60github.com/mattn/go-isatty="v0.0.20"
61github.com/mattn/go-runewidth="v0.0.9"
62github.com/mazznoer/csscolorparser="v0.1.5"
63github.com/mitchellh/mapstructure="v1.5.1-0.20231216201459-8508981c8b6c"
64github.com/mohae/deepcopy="v0.0.0-20170929034955-c48cc78d4826"
65github.com/muesli/smartcrop="v0.3.0"
66github.com/niklasfasching/go-org="v1.7.0"
67github.com/oasdiff/yaml3="v0.0.0-20241210130736-a94c01f36349"
68github.com/oasdiff/yaml="v0.0.0-20241210131133-6b86fb107d80"
69github.com/olekukonko/tablewriter="v0.0.5"
70github.com/pbnjay/memory="v0.0.0-20210728143218-7b4eea64cf58"
71github.com/pelletier/go-toml/v2="v2.2.3"
72github.com/perimeterx/marshmallow="v1.1.5"
73github.com/pkg/browser="v0.0.0-20240102092130-5ac0b6a4141c"
74github.com/pkg/errors="v0.9.1"
75github.com/rivo/uniseg="v0.4.7"
76github.com/rogpeppe/go-internal="v1.13.1"
77github.com/russross/blackfriday/v2="v2.1.0"
78github.com/sass/libsass="3.6.6"
79github.com/spf13/afero="v1.11.0"
80github.com/spf13/cast="v1.7.1"
81github.com/spf13/cobra="v1.8.1"
82github.com/spf13/fsync="v0.10.1"
83github.com/spf13/pflag="v1.0.6"
84github.com/tdewolff/minify/v2="v2.20.37"
85github.com/tdewolff/parse/v2="v2.7.15"
86github.com/tetratelabs/wazero="v1.8.2"
87github.com/webmproject/libwebp="v1.3.2"
88github.com/yuin/goldmark-emoji="v1.0.4"
89github.com/yuin/goldmark="v1.7.8"
90go.uber.org/automaxprocs="v1.5.3"
91golang.org/x/crypto="v0.33.0"
92golang.org/x/exp="v0.0.0-20250210185358-939b2ce775ac"
93golang.org/x/image="v0.24.0"
94golang.org/x/mod="v0.23.0"
95golang.org/x/net="v0.35.0"
96golang.org/x/sync="v0.11.0"
97golang.org/x/sys="v0.30.0"
98golang.org/x/text="v0.22.0"
99golang.org/x/tools="v0.30.0"
100golang.org/x/xerrors="v0.0.0-20240903120638-7835f813f4da"
101gonum.org/v1/plot="v0.15.0"
102google.golang.org/protobuf="v1.36.5"
103gopkg.in/yaml.v2="v2.4.0"
104gopkg.in/yaml.v3="v3.0.1"
105oss.terrastruct.com/d2="v0.6.9"
106oss.terrastruct.com/util-go="v0.0.0-20241005222610-44c011a04896"
107rsc.io/qr="v0.2.0"
108software.sslmate.com/src/go-pkcs12="v0.2.0"
