HuGo

一个快速灵活的静态站点生成器，由bep、spf13和朋友用Go构建。

概述

Hugo 是一个用 Go 编写的静态 HTML 和 CSS 网站生成器。 它针对速度、易用性和可配置性进行了优化。 Hugo 获取一个包含内容和模板的目录，并将它们呈现为一个完整的 HTML 网站。

Hugo 依赖于 Markdown 文件和元数据的前端，你可以从任何目录运行 Hugo。 这适用于您没有特权帐户的共享主机和其他系统。

Hugo 在几分之一秒内渲染了一个中等大小的典型网站。 一个好的经验法则是，每条内容的呈现时间约为 1 毫秒。

Hugo 旨在适用于任何类型的网站，包括博客、翻滚和文档。

支持的架构

目前，我们为 x64 的 Windows、Linux、FreeBSD、NetBSD、DragonFly BSD、OpenBSD、macOS (Darwin) 和 Android 提供预构建的 Hugo 二进制文件， i386 和 ARM 架构。

Hugo 也可以在 Go 编译器工具链可以运行的任何地方从源代码编译，例如用于其他操作系统，包括 Plan 9 和 Solaris。

完整的文档可在 Hugo 文档 获得。

选择安装方式

如果您想使用 Hugo 作为您的站点生成器，只需安装 Hugo 二进制文件。

要为 Hugo 源代码或文档做出贡献，您应该 fork Hugo GitHub 项目 并将其克隆到本地计算机。

最后，您可以使用 go 安装 Hugo 源代码，自己构建二进制文件，然后以这种方式运行 Hugo。 对于有经验的 go getter 来说，构建二进制文件是一件容易的事。

安装 Hugo 作为您的站点生成器（二进制安装）

使用 Hugo 文档中的安装说明。

从源代码构建和安装二进制文件（高级安装）

先决条件工具

• Git
• [Go（我们使用最后 2 个主要版本对其进行测试；但请注意，Hugo 0.95.0 仅使用 >= Go 1.18 构建。）]（https://golang.org/dl/）

从 GitHub 获取

从 GitHub 获取和构建源代码：

mkdir $HOME/src
cd $HOME/src
git clone https://github.com/gohugoio/hugo.git
cd hugo
go install

如果您是 Windows 用户，请将上面的 $HOME 环境变量替换为 %USERPROFILE%。

如果您想使用 Sass/SCSS 支持进行编译，请使用 --tags extended 并确保在您的 go 环境中设置了 CGO_ENABLED=1。如果不想启用 CGO，可以使用以下命令临时启用 CGO，仅用于 hugo 编译：

git clone git@github.com:gohugoio/hugo.git

雨果文档

Hugo 文档现在位于其自己的存储库中，请参阅 https://github.com/gohugoio/hugoDocs。但我们确实将该文档的一个版本作为“git subtree”保存在这个存储库中。要将子文件夹 /docs 构建为 Hugo 站点，您需要克隆此 repo：

git clone git@github.com:gohugoio/hugo.git

为 Hugo 贡献代码

注意 2022 年 3 月 16 日： 我们目前在进行代码审查方面的人力资源非常有限，因此我们目前要求任何新的拉取请求仅限于解决现有问题的错误修复。此外，我们已更新到 Go 1.18，但我们目前不接受任何通用重写、“interface{} to any”替换和类似内容。

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

我们欢迎任何形式的对 Hugo 的贡献，包括文档、主题、 组织、教程、博客文章、错误报告、问题、功能请求、 功能实现、拉取请求、在论坛上回答问题、 帮助管理问题等。

Hugo 社区和维护者非常活跃 并且乐于助人，该项目从这项活动中受益匪浅。

提出支持问题

我们有一个活跃的 讨论论坛，用户和开发者可以在这里提问。 请不要使用 GitHub 问题跟踪器来提问。

报告问题

如果您认为在 Hugo 或其文档中发现了缺陷，请使用 GitHub 问题跟踪器向 Hugo 维护者报告问题。 如果您不确定这是否是错误，请先在 讨论论坛 中提问。 报告问题时，请提供正在使用的 Hugo 版本（hugo version）。