hugo

一个快速灵活的静态网站生成器，由bep、spf13和friends用Go语言充满热情地构建。

[网站] | [安装] | [文档] | [支持] | [贡献] | <a rel="me" href="https://fosstodon.org/@gohugoio">Mastodon</a> | <a rel="me" href="https://x.com/gohugoiov2">X</a>

概述

Hugo是一个用Go语言编写的[静态网站生成器]，优化了速度并设计得灵活多变。凭借其先进的模板系统和快速的资源处理管道，Hugo能在几秒钟内渲染完整的网站，通常更快。

由于其灵活的框架、多语言支持和强大的分类系统，Hugo被广泛用于创建：

企业、政府、非营利组织、教育、新闻、活动和项目网站
文档网站
图片作品集
落地页
商业、专业和个人博客
简历和个人履历

在开发过程中使用Hugo的内置Web服务器，可以立即看到内容、结构、行为和展示的变化。然后将网站部署到您的主机，或将更改推送到您的Git提供商以进行自动构建和部署。

Hugo的快速资源处理管道包括：

图像处理 - 转换、调整大小、裁剪、旋转、调整颜色、应用滤镜、叠加文字和图像，以及提取EXIF数据
JavaScript打包 - 将TypeScript和JSX转译为JavaScript，打包、树摇、压缩、创建源映射，并执行SRI哈希
Sass处理 - 将Sass转译为CSS，打包、树摇、压缩、创建源映射，执行SRI哈希，并与PostCSS集成
Tailwind CSS处理 - 将Tailwind CSS实用类编译为标准CSS，打包、树摇、优化、压缩，执行SRI哈希，并与PostCSS集成

通过Hugo Modules，您可以通过公共或私有Git仓库与其他项目共享内容、资源、数据、翻译、主题、模板和配置。

请查看文档的[特性]部分，了解Hugo功能的全面摘要。

赞助商

安装

从[预编译二进制文件]、包管理器或包存储库安装Hugo。请查看您操作系统的安装说明：

macOS
Linux
Windows
[DragonFly BSD, FreeBSD, NetBSD, 和 OpenBSD]

从源代码构建

Hugo有两个版本：标准版和扩展版。使用扩展版，您可以：

在处理图像时编码为WebP格式。两个版本都可以解码WebP图像。
使用内嵌的LibSass转译器将Sass转译为CSS。使用Dart Sass转译器不需要扩展版。

从源代码构建Hugo的先决条件：

标准版：Go 1.20或更高版本
扩展版：Go 1.20或更高版本，以及GCC

构建标准版：

go install github.com/gohugoio/hugo@latest

构建扩展版：

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

星标历史

文档

Hugo的[文档]包括安装说明、快速入门指南、概念解释、参考信息和示例。

请将文档问题和拉取请求提交到[文档仓库]。

支持

请不要使用问题队列来提问或解决故障。除非您确定您的问题是软件缺陷，否则请使用[论坛]。

Hugo的[论坛]是一个活跃的用户和开发者社区，他们回答问题、分享知识并提供示例。快速搜索超过20,000个主题通常能回答您的问题。在提出第一个问题之前，请务必阅读有关[请求帮助]的内容。

贡献

您可以通过以下方式为Hugo项目做出贡献：

在[论坛]上回答问题
改进[文档]
监控[问题队列]
创建或改进[主题]
修复[错误]

请将文档问题和拉取请求提交到[文档仓库]。

如果您有增强功能或新特性的想法，请在[论坛]的"Feature"类别中创建一个新主题。这将帮助您：

确定该功能是否已存在
衡量兴趣度
完善概念

如果有足够的兴趣，[创建一个提案]。在项目负责人接受提案之前，请勿提交拉取请求。

有关为Hugo贡献的完整指南，请参阅贡献指南。

依赖项

Hugo 建立在伟大的开源库之上。运行hugo env --logLevel info以显示依赖项列表。

<details> <summary>查看当前依赖项</summary> ```text cloud.google.com/go/compute/metadata="v0.2.3" cloud.google.com/go/iam="v1.1.5" cloud.google.com/go/storage="v1.35.1" cloud.google.com/go="v0.110.10" github.com/Azure/azure-sdk-for-go/sdk/azcore="v1.9.0" github.com/Azure/azure-sdk-for-go/sdk/azidentity="v1.4.0" github.com/Azure/azure-sdk-for-go/sdk/internal="v1.5.0" github.com/Azure/azure-sdk-for-go/sdk/storage/azblob="v1.2.0" github.com/Azure/go-autorest/autorest/to="v0.4.0" github.com/AzureAD/microsoft-authentication-library-for-go="v1.2.0" github.com/BurntSushi/locker="v0.0.0-20171006230638-a6e239ea1c69" github.com/alecthomas/chroma/v2="v2.14.0" github.com/armon/go-radix="v1.0.1-0.20221118154546-54df44f2176c" github.com/aws/aws-sdk-go-v2/aws/protocol/eventstream="v1.5.4" github.com/aws/aws-sdk-go-v2/config="v1.26.1" github.com/aws/aws-sdk-go-v2/credentials="v1.16.12" github.com/aws/aws-sdk-go-v2/feature/ec2/imds="v1.14.10" github.com/aws/aws-sdk-go-v2/feature/s3/manager="v1.15.7" github.com/aws/aws-sdk-go-v2/internal/configsources="v1.3.5" github.com/aws/aws-sdk-go-v2/internal/endpoints/v2="v2.6.5" github.com/aws/aws-sdk-go-v2/internal/ini="v1.7.2" github.com/aws/aws-sdk-go-v2/internal/v4a="v1.2.9" github.com/aws/aws-sdk-go-v2/service/cloudfront="v1.35.4" github.com/aws/aws-sdk-go-v2/service/internal/accept-encoding="v1.10.4" github.com/aws/aws-sdk-go-v2/service/internal/checksum="v1.2.9" github.com/aws/aws-sdk-go-v2/service/internal/presigned-url="v1.10.9" github.com/aws/aws-sdk-go-v2/service/internal/s3shared="v1.16.9" github.com/aws/aws-sdk-go-v2/service/s3="v1.47.5" github.com/aws/aws-sdk-go-v2/service/sso="v1.18.5" github.com/aws/aws-sdk-go-v2/service/ssooidc="v1.21.5" github.com/aws/aws-sdk-go-v2/service/sts="v1.26.5" github.com/aws/aws-sdk-go-v2="v1.26.1" github.com/aws/aws-sdk-go="v1.50.7" github.com/aws/smithy-go="v1.20.2" github.com/bep/clocks="v0.5.0" github.com/bep/debounce="v1.2.0" github.com/bep/gitmap="v1.1.2" github.com/bep/goat="v0.5.0" github.com/bep/godartsass/v2="v2.0.0" github.com/bep/godartsass="v1.2.0" github.com/bep/golibsass="v1.1.1" github.com/bep/gowebp="v0.3.0" github.com/bep/lazycache="v0.4.0" github.com/bep/logg="v0.4.0" github.com/bep/mclib="v1.20400.20402" github.com/bep/overlayfs="v0.9.2" github.com/bep/simplecobra="v0.4.0" github.com/bep/tmc="v0.5.1" github.com/clbanning/mxj/v2="v2.7.0" github.com/cli/safeexec="v1.0.1" github.com/cpuguy83/go-md2man/v2="v2.0.3" github.com/disintegration/gift="v1.2.1" github.com/dlclark/regexp2="v1.11.0" github.com/dustin/go-humanize="v1.0.1" github.com/evanw/esbuild="v0.21.4" github.com/fatih/color="v1.16.0" github.com/frankban/quicktest="v1.14.6" github.com/fsnotify/fsnotify="v1.7.0" github.com/getkin/kin-openapi="v0.123.0" github.com/ghodss/yaml="v1.0.0" github.com/go-openapi/jsonpointer="v0.20.2" github.com/go-openapi/swag="v0.22.8" github.com/gobuffalo/flect="v1.0.2" github.com/gobwas/glob="v0.2.3" github.com/gohugoio/go-i18n/v2="v2.1.3-0.20230805085216-e63c13218d0e" github.com/gohugoio/httpcache="v0.7.0" github.com/gohugoio/hugo-goldmark-extensions/extras="v0.2.0" github.com/gohugoio/hugo-goldmark-extensions/passthrough="v0.2.0" github.com/gohugoio/locales="v0.14.0" github.com/gohugoio/localescompressed="v1.0.1" github.com/golang-jwt/jwt/v5="v5.1.0" github.com/golang/groupcache="v0.0.0-20210331224755-41bb18bfe9da" github.com/golang/protobuf="v1.5.3" github.com/google/go-cmp="v0.6.0" github.com/google/s2a-go="v0.1.7" github.com/google/uuid="v1.4.0" github.com/google/wire="v0.5.0" github.com/googleapis/enterprise-certificate-proxy="v0.3.2" github.com/googleapis/gax-go/v2="v2.12.0" github.com/gorilla/websocket="v1.5.1" github.com/hairyhenderson/go-codeowners="v0.4.0" github.com/hashicorp/golang-lru/v2="v2.0.7" github.com/invopop/yaml="v0.2.0" github.com/jdkato/prose="v1.2.1" ``` github.com/jmespath/go-jmespath="v0.4.0" github.com/josharian/intern="v1.0.0" github.com/kr/pretty="v0.3.1" github.com/kr/text="v0.2.0" github.com/kylelemons/godebug="v1.1.0" github.com/kyokomi/emoji/v2="v2.2.12" github.com/mailru/easyjson="v0.7.7" github.com/makeworld-the-better-one/dither/v2="v2.4.0" github.com/marekm4/color-extractor="v1.2.1" github.com/mattn/go-colorable="v0.1.13" github.com/mattn/go-isatty="v0.0.20" github.com/mattn/go-runewidth="v0.0.9" github.com/mitchellh/hashstructure="v1.1.0" github.com/mitchellh/mapstructure="v1.5.1-0.20231216201459-8508981c8b6c" github.com/mohae/deepcopy="v0.0.0-20170929034955-c48cc78d4826" github.com/muesli/smartcrop="v0.3.0" github.com/niklasfasching/go-org="v1.7.0" github.com/olekukonko/tablewriter="v0.0.5" github.com/pbnjay/memory="v0.0.0-20210728143218-7b4eea64cf58" github.com/pelletier/go-toml/v2="v2.2.2" github.com/perimeterx/marshmallow="v1.1.5" github.com/pkg/browser="v0.0.0-20210911075715-681adbf594b8" github.com/pkg/errors="v0.9.1" github.com/rogpeppe/go-internal="v1.12.0" github.com/russross/blackfriday/v2="v2.1.0" github.com/rwcarlsen/goexif="v0.0.0-20190401172101-9e8deecbddbd" github.com/sass/dart-sass/compiler="1.77.5" github.com/sass/dart-sass/implementation="1.77.5" github.com/sass/dart-sass/protocol="2.7.1" github.com/sass/libsass="3.6.5" github.com/spf13/afero="v1.11.0" github.com/spf13/cast="v1.6.0" github.com/spf13/cobra="v1.8.0" github.com/spf13/fsync="v0.10.1" github.com/spf13/pflag="v1.0.5" github.com/tdewolff/minify/v2="v2.20.20" github.com/tdewolff/parse/v2="v2.7.13" github.com/webmproject/libwebp="v1.3.2" github.com/yuin/goldmark-emoji="v1.0.3" github.com/yuin/goldmark="v1.7.4" go.opencensus.io="v0.24.0" go.uber.org/automaxprocs="v1.5.3" gocloud.dev="v0.36.0" golang.org/x/crypto="v0.23.0" golang.org/x/exp="v0.0.0-20221031165847-c99f073a8326" golang.org/x/image="v0.16.0" golang.org/x/mod="v0.17.0" golang.org/x/net="v0.25.0" golang.org/x/oauth2="v0.15.0" golang.org/x/sync="v0.7.0" golang.org/x/sys="v0.20.0" golang.org/x/text="v0.15.0" golang.org/x/time="v0.5.0" golang.org/x/tools="v0.20.0" golang.org/x/xerrors="v0.0.0-20231012003039-104605ab7028" google.golang.org/api="v0.152.0" google.golang.org/genproto/googleapis/api="v0.0.0-20231120223509-83a465c0220f" google.golang.org/genproto/googleapis/rpc="v0.0.0-20231120223509-83a465c0220f" google.golang.org/genproto="v0.0.0-20231120223509-83a465c0220f" google.golang.org/grpc="v1.59.0" google.golang.org/protobuf="v1.33.0" gopkg.in/yaml.v2="v2.4.0" gopkg.in/yaml.v3="v3.0.1" software.sslmate.com/src/go-pkcs12="v0.2.0"