Cloudflare 中文文档
Pages
编辑这个页面
跳转官方原文档
Set theme to dark (⇧+D)

Hugo

Hugo是一款用 Go 语言编写的静态网站生成工具。它的运行速度快得令人难以置信,而且拥有强大、灵活的高级原语,可使用不同的 内容格式管理内容。

在本指南中,你将创建一个新的 Hugo 应用程序,并使用 Cloudflare Pages 进行部署。你将使用 hugo CLI 创建一个新的 Hugo 站点。

​​ 在你继续之前

所有框架指南都假定你已经对 Git 有了基本了解。如果你是 Git 的新手,请参考这本 Git 手册摘要,了解如何在本地机器上设置 Git。

如果使用 SSH 克隆,则必须在每台用于从 GitHub 推送或拉取的计算机上 生成 SSH 密钥

更多信息请参阅 GitHub 文档 Git 文档

如果你已经有一个托管在 Git 提供商的 Hugo 网站,请转到 使用 Cloudflare 页面部署

​​ Hugo安装

使用操作系统的具体说明安装 Hugo CLI。

如果使用软件包管理器 Homebrew,请在终端运行 brew install 命令安装 Hugo:

如果使用软件包管理器 Chocolatey,请在终端运行 choco install 命令安装Hugo:

如果使用软件包管理器 Scoop,请在终端运行 scoop install 命令安装 Hugo:

你的 Linux 发行版的软件包管理器可能包含 Hugo。如果是这种情况,请使用发行版的软件包管理器直接安装 Hugo,例如,在 Ubuntu 中,运行以下命令:

如果你的软件包管理器不包含 Hugo,或者你想直接下载发行版,请参阅 手册部分。

​​ 手动安装

Hugo GitHub 仓库包含适用于各种操作系统的 Hugo 命令行工具预构建版本,可在 Releases 页面 上找到。

有关安装这些版本的更多说明,请参阅 Hugo 文档

​​ 创建一个新项目

安装 Hugo 后,请参阅 Hugo 快速入门 创建项目,或在终端运行 hugo new 命令创建新项目:

Hugo网站使用主题来定制静态构建的 HTML 网站的外观和感觉。 theme.gohugo.io提供了许多主题,目前请在终端运行以下命令,使用 Ananake 主题

​​ 创建帖子

创建一篇新文章,为Hugo网站添加一些初始内容。在终端运行 “hugo new “命令,生成新帖子:

hello-world.md 中添加一些初始内容以创建帖子。准备发布文章时,移除文章 frontmatter 中的 draft 行。任何设置了 draft: true 的文章都会被Hugo的构建过程跳过。

​​ 创建 GitHub 仓库

访问 repo.new,创建一个新的 GitHub 仓库。创建新仓库后,进入新创建的项目目录,准备并在终端运行以下命令将本地应用程序推送到 GitHub:

​​ 使用 Cloudflare 页面部署

将网站部署到页面:

  1. 登录 Cloudflare 仪表板 并选择你的账户。
  2. 在账户主页,选择 Workers & Pages > 创建应用程序 > 页面 > 连接到 Git
  3. 选择创建的新 GitHub 仓库,并在 设置构建和部署部分提供以下信息:
Configuration option Value
Production branch main
Build command hugo
Build directory public

完成部署配置后,选择保存并部署。在部署之前,你应该会看到 Cloudflare 页面正在安装 hugo 和你的项目依赖项,并正在构建你的网站。

部署网站后,你将在 *.pages.dev 上收到一个唯一的项目子域。 每次你向 Hugo 网站提交新代码时,Cloudflare Pages 都会自动重建你的项目并进行部署。你还可以在新的拉取请求中访问 预览部署,这样你就可以在将更改部署到生产环境之前预览网站的外观。

​​ 使用特定或更新的Hugo版本

要使用 特定或更新版本的 Hugo,请在 Pages 项目 > 设置 > 环境变量中创建HUGO_VERSION环境变量。将值设为你要指定的 Hugo 版本(建议使用 v0.112.0 或更高版本)。

例如,HUGO_VERSION: 0.115.4

​​ 了解更多

完成本指南后,你已成功将 Hugo 网站部署到 Cloudflare Pages。要开始使用其他框架,请参阅框架指南列表