Hugo
Hugo是一款用 Go 语言编写的静态网站生成工具。它的运行速度快得令人难以置信,而且拥有强大、灵活的高级原语,可使用不同的 内容格式管理内容。
在本指南中,你将创建一个新的 Hugo 应用程序,并使用 Cloudflare Pages 进行部署。你将使用 hugo
CLI 创建一个新的 Hugo 站点。
在你继续之前
所有框架指南都假定你已经对 Git 有了基本了解。如果你是 Git 的新手,请参考这本 Git 手册摘要,了解如何在本地机器上设置 Git。
如果使用 SSH 克隆,则必须在每台用于从 GitHub 推送或拉取的计算机上 生成 SSH 密钥。
如果你已经有一个托管在 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 页面部署
将网站部署到页面:
- 登录 Cloudflare 仪表板 并选择你的账户。
- 在账户主页,选择 Workers & Pages > 创建应用程序 > 页面 > 连接到 Git。
- 选择创建的新 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。要开始使用其他框架,请参阅框架指南列表