README.md - hugo - [fork] hugo port for 9front
HTML git clone https://git.drkhsh.at/hugo.git
DIR Log
DIR Files
DIR Refs
DIR Submodules
DIR README
DIR LICENSE
---
README.md (12705B)
---
1 [bep]: https://github.com/bep
2 [bugs]: https://github.com/gohugoio/hugo/issues?q=is%3Aopen+is%3Aissue+label%3ABug
3 [contributing]: CONTRIBUTING.md
4 [create a proposal]: https://github.com/gohugoio/hugo/issues/new?labels=Proposal%2C+NeedsTriage&template=feature_request.md
5 [documentation repository]: https://github.com/gohugoio/hugoDocs
6 [documentation]: https://gohugo.io/documentation
7 [dragonfly bsd, freebsd, netbsd, and openbsd]: https://gohugo.io/installation/bsd
8 [features]: https://gohugo.io/about/features/
9 [forum]: https://discourse.gohugo.io
10 [friends]: https://github.com/gohugoio/hugo/graphs/contributors
11 [go]: https://go.dev/
12 [hugo modules]: https://gohugo.io/hugo-modules/
13 [installation]: https://gohugo.io/installation
14 [issue queue]: https://github.com/gohugoio/hugo/issues
15 [linux]: https://gohugo.io/installation/linux
16 [macos]: https://gohugo.io/installation/macos
17 [prebuilt binary]: https://github.com/gohugoio/hugo/releases/latest
18 [requesting help]: https://discourse.gohugo.io/t/requesting-help/9132
19 [spf13]: https://github.com/spf13
20 [static site generator]: https://en.wikipedia.org/wiki/Static_site_generator
21 [support]: https://discourse.gohugo.io
22 [themes]: https://themes.gohugo.io/
23 [website]: https://gohugo.io
24 [windows]: https://gohugo.io/installation/windows
25
26 <a href="https://gohugo.io/"><img src="https://raw.githubusercontent.com/gohugoio/gohugoioTheme/master/static/images/hugo-logo-wide.svg?sanitize=true" alt="Hugo" width="565"></a>
27
28 A fast and flexible static site generator built with love by [bep], [spf13], and [friends] in [Go].
29
30 ---
31
32 [](https://godoc.org/github.com/gohugoio/hugo)
33 [](https://github.com/gohugoio/hugo/actions?query=workflow%3ATest)
34 [](https://goreportcard.com/report/github.com/gohugoio/hugo)
35
36 [Website] | [Installation] | [Documentation] | [Support] | [Contributing] | <a rel="me" href="https://fosstodon.org/@gohugoio">Mastodon</a>
37
38 ## Overview
39
40 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.
41
42 Due to its flexible framework, multilingual support, and powerful taxonomy system, Hugo is widely used to create:
43
44 - Corporate, government, nonprofit, education, news, event, and project sites
45 - Documentation sites
46 - Image portfolios
47 - Landing pages
48 - Business, professional, and personal blogs
49 - Resumes and CVs
50
51 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.
52
53 Hugo's fast asset pipelines include:
54
55 - Image processing – Convert, resize, crop, rotate, adjust colors, apply filters, overlay text and images, and extract EXIF data
56 - JavaScript bundling – Transpile TypeScript and JSX to JavaScript, bundle, tree shake, minify, create source maps, and perform SRI hashing.
57 - Sass processing – Transpile Sass to CSS, bundle, tree shake, minify, create source maps, perform SRI hashing, and integrate with PostCSS
58 - Tailwind CSS processing – Compile Tailwind CSS utility classes into standard CSS, bundle, tree shake, optimize, minify, perform SRI hashing, and integrate with PostCSS
59
60 And with [Hugo Modules], you can share content, assets, data, translations, themes, templates, and configuration with other projects via public or private Git repositories.
61
62 See the [features] section of the documentation for a comprehensive summary of Hugo's capabilities.
63
64 ## Sponsors
65
66 <p> </p>
67 <p float="left">
68 <a href="https://www.linode.com/?utm_campaign=hugosponsor&utm_medium=banner&utm_source=hugogithub" target="_blank"><img src="https://raw.githubusercontent.com/gohugoio/hugoDocs/master/assets/images/sponsors/linode-logo_standard_light_medium.png" width="200" alt="Linode"></a>
69
70 <a href="https://www.jetbrains.com/go/?utm_source=OSS&utm_medium=referral&utm_campaign=hugo" target="_blank"><img src="https://raw.githubusercontent.com/gohugoio/hugoDocs/master/assets/images/sponsors/goland.svg" width="200" alt="The complete IDE crafted for professional Go developers."></a>
71
72 <a href="https://pinme.eth.limo/?s=hugo" target="_blank"><img src="https://raw.githubusercontent.com/gohugoio/hugoDocs/master/assets/images/sponsors/logo-pinme.svg" width="200" alt="PinMe."></a>
73 </p>
74
75 ## Editions
76
77 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.
78
79 Feature|extended edition|extended/deploy edition
80 :--|:-:|:-:
81 Encode to the WebP format when [processing images]. You can decode WebP images with any edition.|:heavy_check_mark:|:heavy_check_mark:
82 [Transpile Sass to CSS] using the embedded LibSass transpiler. You can use the [Dart Sass] transpiler with any edition.|:heavy_check_mark:|:heavy_check_mark:
83 Deploy your site directly to a Google Cloud Storage bucket, an AWS S3 bucket, or an Azure Storage container. See [details].|:x:|:heavy_check_mark:
84
85 [dart sass]: https://gohugo.io/functions/css/sass/#dart-sass
86 [processing images]: https://gohugo.io/content-management/image-processing/
87 [transpile sass to css]: https://gohugo.io/functions/css/sass/
88 [details]: https://gohugo.io/hosting-and-deployment/hugo-deploy/
89
90 Unless your specific deployment needs require the extended/deploy edition, we recommend the extended edition.
91
92 ## Installation
93
94 Install Hugo from a [prebuilt binary], package manager, or package repository. Please see the installation instructions for your operating system:
95
96 - [macOS]
97 - [Linux]
98 - [Windows]
99 - [DragonFly BSD, FreeBSD, NetBSD, and OpenBSD]
100
101 ## Build from source
102
103 Prerequisites to build Hugo from source:
104
105 - Standard edition: Go 1.23.0 or later
106 - Extended edition: Go 1.23.0 or later, and GCC
107 - Extended/deploy edition: Go 1.23.0 or later, and GCC
108
109 Build the standard edition:
110
111 ```text
112 go install github.com/gohugoio/hugo@latest
113 ```
114
115 Build the extended edition:
116
117 ```text
118 CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest
119 ```
120
121 Build the extended/deploy edition:
122
123 ```text
124 CGO_ENABLED=1 go install -tags extended,withdeploy github.com/gohugoio/hugo@latest
125 ```
126
127 ## Star History
128
129 [](https://star-history.com/#gohugoio/hugo&Timeline)
130
131 ## Documentation
132
133 Hugo's [documentation] includes installation instructions, a quick start guide, conceptual explanations, reference information, and examples.
134
135 Please submit documentation issues and pull requests to the [documentation repository].
136
137 ## Support
138
139 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].
140
141 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.
142
143 ## Contributing
144
145 You can contribute to the Hugo project by:
146
147 - Answering questions on the [forum]
148 - Improving the [documentation]
149 - Monitoring the [issue queue]
150 - Creating or improving [themes]
151 - Squashing [bugs]
152
153 Please submit documentation issues and pull requests to the [documentation repository].
154
155 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:
156
157 - Determine if the capability already exists
158 - Measure interest
159 - Refine the concept
160
161 If there is sufficient interest, [create a proposal]. Do not submit a pull request until the project lead accepts the proposal.
162
163 For a complete guide to contributing to Hugo, see the [Contribution Guide](CONTRIBUTING.md).
164
165 ## Dependencies
166
167 Hugo stands on the shoulders of great open source libraries. Run `hugo env --logLevel info` to display a list of dependencies.
168
169 <details>
170 <summary>See current dependencies</summary>
171
172 ```text
173 github.com/BurntSushi/locker="v0.0.0-20171006230638-a6e239ea1c69"
174 github.com/PuerkitoBio/goquery="v1.10.1"
175 github.com/alecthomas/chroma/v2="v2.15.0"
176 github.com/andybalholm/cascadia="v1.3.3"
177 github.com/armon/go-radix="v1.0.1-0.20221118154546-54df44f2176c"
178 github.com/bep/clocks="v0.5.0"
179 github.com/bep/debounce="v1.2.0"
180 github.com/bep/gitmap="v1.6.0"
181 github.com/bep/goat="v0.5.0"
182 github.com/bep/godartsass/v2="v2.3.2"
183 github.com/bep/golibsass="v1.2.0"
184 github.com/bep/gowebp="v0.3.0"
185 github.com/bep/imagemeta="v0.8.4"
186 github.com/bep/lazycache="v0.7.0"
187 github.com/bep/logg="v0.4.0"
188 github.com/bep/overlayfs="v0.9.2"
189 github.com/bep/simplecobra="v0.5.0"
190 github.com/bep/tmc="v0.5.1"
191 github.com/cespare/xxhash/v2="v2.3.0"
192 github.com/clbanning/mxj/v2="v2.7.0"
193 github.com/cpuguy83/go-md2man/v2="v2.0.4"
194 github.com/disintegration/gift="v1.2.1"
195 github.com/dlclark/regexp2="v1.11.5"
196 github.com/dop251/goja="v0.0.0-20250125213203-5ef83b82af17"
197 github.com/evanw/esbuild="v0.24.2"
198 github.com/fatih/color="v1.18.0"
199 github.com/frankban/quicktest="v1.14.6"
200 github.com/fsnotify/fsnotify="v1.8.0"
201 github.com/getkin/kin-openapi="v0.129.0"
202 github.com/ghodss/yaml="v1.0.0"
203 github.com/go-openapi/jsonpointer="v0.21.0"
204 github.com/go-openapi/swag="v0.23.0"
205 github.com/go-sourcemap/sourcemap="v2.1.4+incompatible"
206 github.com/gobuffalo/flect="v1.0.3"
207 github.com/gobwas/glob="v0.2.3"
208 github.com/gohugoio/go-i18n/v2="v2.1.3-0.20230805085216-e63c13218d0e"
209 github.com/gohugoio/hashstructure="v0.5.0"
210 github.com/gohugoio/httpcache="v0.7.0"
211 github.com/gohugoio/hugo-goldmark-extensions/extras="v0.2.0"
212 github.com/gohugoio/hugo-goldmark-extensions/passthrough="v0.3.0"
213 github.com/gohugoio/locales="v0.14.0"
214 github.com/gohugoio/localescompressed="v1.0.1"
215 github.com/golang/freetype="v0.0.0-20170609003504-e2365dfdc4a0"
216 github.com/google/go-cmp="v0.6.0"
217 github.com/google/pprof="v0.0.0-20250208200701-d0013a598941"
218 github.com/gorilla/websocket="v1.5.3"
219 github.com/hairyhenderson/go-codeowners="v0.7.0"
220 github.com/hashicorp/golang-lru/v2="v2.0.7"
221 github.com/jdkato/prose="v1.2.1"
222 github.com/josharian/intern="v1.0.0"
223 github.com/kr/pretty="v0.3.1"
224 github.com/kr/text="v0.2.0"
225 github.com/kyokomi/emoji/v2="v2.2.13"
226 github.com/lucasb-eyer/go-colorful="v1.2.0"
227 github.com/mailru/easyjson="v0.7.7"
228 github.com/makeworld-the-better-one/dither/v2="v2.4.0"
229 github.com/marekm4/color-extractor="v1.2.1"
230 github.com/mattn/go-colorable="v0.1.13"
231 github.com/mattn/go-isatty="v0.0.20"
232 github.com/mattn/go-runewidth="v0.0.9"
233 github.com/mazznoer/csscolorparser="v0.1.5"
234 github.com/mitchellh/mapstructure="v1.5.1-0.20231216201459-8508981c8b6c"
235 github.com/mohae/deepcopy="v0.0.0-20170929034955-c48cc78d4826"
236 github.com/muesli/smartcrop="v0.3.0"
237 github.com/niklasfasching/go-org="v1.7.0"
238 github.com/oasdiff/yaml3="v0.0.0-20241210130736-a94c01f36349"
239 github.com/oasdiff/yaml="v0.0.0-20241210131133-6b86fb107d80"
240 github.com/olekukonko/tablewriter="v0.0.5"
241 github.com/pbnjay/memory="v0.0.0-20210728143218-7b4eea64cf58"
242 github.com/pelletier/go-toml/v2="v2.2.3"
243 github.com/perimeterx/marshmallow="v1.1.5"
244 github.com/pkg/browser="v0.0.0-20240102092130-5ac0b6a4141c"
245 github.com/pkg/errors="v0.9.1"
246 github.com/rivo/uniseg="v0.4.7"
247 github.com/rogpeppe/go-internal="v1.13.1"
248 github.com/russross/blackfriday/v2="v2.1.0"
249 github.com/sass/libsass="3.6.6"
250 github.com/spf13/afero="v1.11.0"
251 github.com/spf13/cast="v1.7.1"
252 github.com/spf13/cobra="v1.8.1"
253 github.com/spf13/fsync="v0.10.1"
254 github.com/spf13/pflag="v1.0.6"
255 github.com/tdewolff/minify/v2="v2.20.37"
256 github.com/tdewolff/parse/v2="v2.7.15"
257 github.com/tetratelabs/wazero="v1.8.2"
258 github.com/webmproject/libwebp="v1.3.2"
259 github.com/yuin/goldmark-emoji="v1.0.4"
260 github.com/yuin/goldmark="v1.7.8"
261 go.uber.org/automaxprocs="v1.5.3"
262 golang.org/x/crypto="v0.33.0"
263 golang.org/x/exp="v0.0.0-20250210185358-939b2ce775ac"
264 golang.org/x/image="v0.24.0"
265 golang.org/x/mod="v0.23.0"
266 golang.org/x/net="v0.35.0"
267 golang.org/x/sync="v0.11.0"
268 golang.org/x/sys="v0.30.0"
269 golang.org/x/text="v0.22.0"
270 golang.org/x/tools="v0.30.0"
271 golang.org/x/xerrors="v0.0.0-20240903120638-7835f813f4da"
272 gonum.org/v1/plot="v0.15.0"
273 google.golang.org/protobuf="v1.36.5"
274 gopkg.in/yaml.v2="v2.4.0"
275 gopkg.in/yaml.v3="v3.0.1"
276 oss.terrastruct.com/d2="v0.6.9"
277 oss.terrastruct.com/util-go="v0.0.0-20241005222610-44c011a04896"
278 rsc.io/qr="v0.2.0"
279 software.sslmate.com/src/go-pkcs12="v0.2.0"
280 ```
281 </details>