A fast and flexible static site generator built with love bybep,spf13,andfriendsinGo.

---

Website|Installation|Documentation|Support|Contributing|Mastodon

Overview

Hugo is astatic site generatorwritten inGo,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:

• CSS bundling – transpilation (Sass), tree shaking, minification, source maps, SRI hashing, and PostCSS integration
• JavaScript bundling – transpilation (TypeScript, JSX), tree shaking, minification, source maps, and SRI hashing
• Image processing – convert, resize, crop, rotate, adjust colors, apply filters, overlay text and images, and extract EXIF data

And withHugo Modules,you can share content, assets, data, translations, themes, templates, and configuration with other projects via public or private Git repositories.

Sponsors

Installation

Install Hugo from aprebuilt binary,package manager, or package repository. Please see the installation instructions for your operating system:

• macOS
• Linux
• Windows
• DragonFly BSD, FreeBSD, NetBSD, and OpenBSD

Build from source

Hugo is available in two editions: standard and extended. With the extended edition you can:

• Encode to the WebP format when processing images. You can decode WebP images with either edition.
• Transpile Sass to CSS using the embedded LibSass transpiler. The extended edition is not required to use the Dart Sass transpiler.

Prerequisites to build Hugo from source:

• Standard edition: Go 1.19 or later
• Extended edition: Go 1.19 or later, and GCC

Build the standard edition:

go install github /gohugoio/hugo@latest

Build the extended edition:

CGO_ENABLED=1 go install -tags extended github /gohugoio/hugo@latest

Documentation

Hugo'sdocumentationincludes installation instructions, a quick start guide, conceptual explanations, reference information, and examples.

Please submit documentation issues and pull requests to thedocumentation repository.

Support

Pleasedo not use the issue queuefor questions or troubleshooting. Unless you are certain that your issue is a software defect, use theforum.

Hugo’sforumis 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 aboutrequesting helpbefore asking your first question.

Contributing

You can contribute to the Hugo project by:

• Answering questions on theforum
• Improving thedocumentation
• Monitoring theissue queue
• Creating or improvingthemes
• Squashingbugs

Please submit documentation issues and pull requests to thedocumentation repository.

If you have an idea for an enhancement or new feature, create a new topic on theforumin 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 theContribution Guide.

Dependencies

Hugo stands on the shoulders of great open source libraries. Runhugo env --logLevel infoto display a list of dependencies.

See current dependencies

cloud.google /go/compute/metadata= "v0.2.3"
cloud.google /go/iam= "v1.1.0"
cloud.google /go/storage= "v1.30.1"
cloud.google /go= "v0.110.2"
github /Azure/azure-sdk-for-go/sdk/azcore= "v1.6.1"
github /Azure/azure-sdk-for-go/sdk/azidentity= "v1.3.0"
github /Azure/azure-sdk-for-go/sdk/internal= "v1.3.0"
github /Azure/azure-sdk-for-go/sdk/storage/azblob= "v1.0.0"
github /Azure/go-autorest/autorest/to= "v0.4.0"
github /AzureAD/microsoft-authentication-library-for-go= "v1.0.0"
github /BurntSushi/locker= "v0.0.0-20171006230638-a6e239ea1c69"
github /PuerkitoBio/purell= "v1.1.1"
github /PuerkitoBio/urlesc= "v0.0.0-20170810143723-de5bf2ad4578"
github /alecthomas/chroma/v2= "v2.7.0"
github /armon/go-radix= "v1.0.0"
github /aws/aws-sdk-go-v2/aws/protocol/eventstream= "v1.4.10"
github /aws/aws-sdk-go-v2/config= "v1.18.27"
github /aws/aws-sdk-go-v2/credentials= "v1.13.26"
github /aws/aws-sdk-go-v2/feature/ec2/imds= "v1.13.4"
github /aws/aws-sdk-go-v2/feature/s3/manager= "v1.11.70"
github /aws/aws-sdk-go-v2/internal/configsources= "v1.1.34"
github /aws/aws-sdk-go-v2/internal/endpoints/v2= "v2.4.28"
github /aws/aws-sdk-go-v2/internal/ini= "v1.3.35"
github /aws/aws-sdk-go-v2/internal/v4a= "v1.0.26"
github /aws/aws-sdk-go-v2/service/internal/accept-encoding= "v1.9.11"
github /aws/aws-sdk-go-v2/service/internal/checksum= "v1.1.29"
github /aws/aws-sdk-go-v2/service/internal/presigned-url= "v1.9.28"
github /aws/aws-sdk-go-v2/service/internal/s3shared= "v1.14.3"
github /aws/aws-sdk-go-v2/service/s3= "v1.35.0"
github /aws/aws-sdk-go-v2/service/sso= "v1.12.12"
github /aws/aws-sdk-go-v2/service/ssooidc= "v1.14.12"
github /aws/aws-sdk-go-v2/service/sts= "v1.19.2"
github /aws/aws-sdk-go-v2= "v1.18.1"
github /aws/aws-sdk-go= "v1.44.284"
github /aws/smithy-go= "v1.13.5"
github /bep/clocks= "v0.5.0"
github /bep/debounce= "v1.2.0"
github /bep/gitmap= "v1.1.2"
github /bep/goat= "v0.5.0"
github /bep/godartsass/v2= "v2.0.0"
github /bep/godartsass= "v1.2.0"
github /bep/golibsass= "v1.1.1"
github /bep/gowebp= "v0.2.0"
github /bep/lazycache= "v0.2.0"
github /bep/logg= "v0.2.0"
github /bep/mclib= "v1.20400.20402"
github /bep/overlayfs= "v0.6.0"
github /bep/simplecobra= "v0.3.2"
github /bep/tmc= "v0.5.1"
github /clbanning/mxj/v2= "v2.5.7"
github /cli/safeexec= "v1.0.1"
github /cpuguy83/go-md2man/v2= "v2.0.2"
github /disintegration/gift= "v1.2.1"
github /dlclark/regexp2= "v1.10.0"
github /dustin/go-humanize= "v1.0.1"
github /evanw/esbuild= "v0.18.5"
github /fatih/color= "v1.15.0"
github /frankban/quicktest= "v1.14.5"
github /fsnotify/fsnotify= "v1.6.0"
github /getkin/kin-openapi= "v0.118.0"
github /ghodss/yaml= "v1.0.0"
github /go-openapi/jsonpointer= "v0.19.6"
github /go-openapi/swag= "v0.22.3"
github /gobuffalo/flect= "v1.0.2"
github /gobwas/glob= "v0.2.3"
github /gohugoio/go-i18n/v2= "v2.1.3-0.20210430103248-4c28c89f8013"
github /gohugoio/locales= "v0.14.0"
github /gohugoio/localescompressed= "v1.0.1"
github /golang-jwt/jwt/v4= "v4.5.0"
github /golang/groupcache= "v0.0.0-20210331224755-41bb18bfe9da"
github /golang/protobuf= "v1.5.3"
github /google/go-cmp= "v0.5.9"
github /google/s2a-go= "v0.1.4"
github /google/uuid= "v1.3.0"
github /google/wire= "v0.5.0"
github /googleapis/enterprise-certificate-proxy= "v0.2.5"
github /googleapis/gax-go/v2= "v2.11.0"
github /gorilla/websocket= "v1.5.0"
github /hairyhenderson/go-codeowners= "v0.3.0"
github /hashicorp/golang-lru/v2= "v2.0.1"
github /invopop/yaml= "v0.1.0"
github /jdkato/prose= "v1.2.1"
github /jmespath/go-jmespath= "v0.4.0"
github /josharian/intern= "v1.0.0"
github /kr/pretty= "v0.3.1"
github /kr/text= "v0.2.0"
github /kylelemons/godebug= "v1.1.0"
github /kyokomi/emoji/v2= "v2.2.12"
github /mailru/easyjson= "v0.7.7"
github /marekm4/color-extractor= "v1.2.0"
github /mattn/go-colorable= "v0.1.13"
github /mattn/go-isatty= "v0.0.19"
github /mattn/go-runewidth= "v0.0.9"
github /mitchellh/hashstructure= "v1.1.0"
github /mitchellh/mapstructure= "v1.5.0"
github /mohae/deepcopy= "v0.0.0-20170929034955-c48cc78d4826"
github /muesli/smartcrop= "v0.3.0"
github /niklasfasching/go-org= "v1.7.0"
github /olekukonko/tablewriter= "v0.0.5"
github /pelletier/go-toml/v2= "v2.0.8"
github /perimeterx/marshmallow= "v1.1.4"
github /pkg/browser= "v0.0.0-20210911075715-681adbf594b8"
github /pkg/errors= "v0.9.1"
github /rogpeppe/go-internal= "v1.10.1-0.20230508101108-a4f6fabd84c5"
github /russross/blackfriday/v2= "v2.1.0"
github /rwcarlsen/goexif= "v0.0.0-20190401172101-9e8deecbddbd"
github /sanity-io/litter= "v1.5.5"
github /sass/dart-sass/compiler= "1.63.6"
github /sass/dart-sass/implementation= "1.63.6"
github /sass/dart-sass/protocol= "2.1.0"
github /sass/libsass= "3.6.5"
github /spf13/afero= "v1.9.5"
github /spf13/cast= "v1.5.1"
github /spf13/cobra= "v1.7.0"
github /spf13/fsync= "v0.9.0"
github /spf13/pflag= "v1.0.5"
github /tdewolff/minify/v2= "v2.12.7"
github /tdewolff/parse/v2= "v2.6.6"
github /webmproject/libwebp= "v1.2.4"
github /yuin/goldmark= "v1.5.4"
go.opencensus.io= "v0.24.0"
go.uber.org/atomic= "v1.11.0"
go.uber.org/automaxprocs= "v1.5.2"
gocloud.dev= "v0.30.0"
golang.org/x/crypto= "v0.10.0"
golang.org/x/exp= "v0.0.0-20230321023759-10a507213a29"
golang.org/x/image= "v0.8.0"
golang.org/x/mod= "v0.10.0"
golang.org/x/net= "v0.11.0"
golang.org/x/oauth2= "v0.9.0"
golang.org/x/sync= "v0.3.0"
golang.org/x/sys= "v0.9.0"
golang.org/x/text= "v0.10.0"
golang.org/x/tools= "v0.9.3"
golang.org/x/xerrors= "v0.0.0-20220907171357-04be3eba64a2"
google.golang.org/api= "v0.128.0"
google.golang.org/appengine= "v1.6.7"
google.golang.org/genproto/googleapis/api= "v0.0.0-20230530153820-e85fd2cbaebc"
google.golang.org/genproto/googleapis/rpc= "v0.0.0-20230530153820-e85fd2cbaebc"
google.golang.org/genproto= "v0.0.0-20230530153820-e85fd2cbaebc"
google.golang.org/grpc= "v1.56.0"
google.golang.org/protobuf= "v1.30.0"
gopkg.in/yaml.v2= "v2.4.0"
gopkg.in/yaml.v3= "v3.0.1"
software.sslmate /src/go-pkcs12= "v0.2.0"