Zola · Cloudflare Pages docs

Zola ↗ 是单二进制文件中的快速静态站点生成器，内置所有功能。在本指南中，你将创建新的 Zola 应用并使用 Cloudflare Pages 部署。你将使用 zola CLI 创建新的 Zola 站点。

安装 Zola

首先，按照下方针对操作系统的具体说明安装 ↗ zola CLI：

macOS (Homebrew)

若使用包管理器 Homebrew ↗，在终端运行 brew install 命令安装 Zola：

brew install zola

Windows (Chocolatey)

若使用包管理器 Chocolatey ↗，在终端运行 choco install 命令安装 Zola：

choco install zola

Windows (Scoop)

若使用包管理器 Scoop ↗，在终端运行 scoop install 命令安装 Zola：

scoop install zola

Linux (pkg)

Linux 发行版的包管理器可能包含 Zola。若是，可直接使用发行版包管理器安装——例如使用 pkg，在终端运行以下命令：

pkg install zola

若包管理器不包含 Zola，或你想直接下载发行版，请参阅下方的手动安装部分。

手动安装

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

有关安装这些发行版的更多说明，请参阅 Zola 安装指南 ↗。

创建新项目

安装 Zola 后，在终端使用默认模板运行 zola init 命令创建新项目：

zola init my-zola-project

运行 zola init 时，将提示三个问题：

What is the URL of your site?（你的站点 URL 是什么？）(https://example.com ↗)：现在可以留空。
Do you want to enable Sass compilation?（是否启用 Sass 编译？）[Y/n]: Y
Do you want to enable syntax highlighting?（是否启用语法高亮？）[y/N]: y
Do you want to build a search index of the content?（是否为内容构建搜索索引？）[y/N]: y

继续之前

所有框架指南都假定你已具备 Git ↗ 的基础知识。如果你是 Git 新手，请参阅这份精简 Git 手册 ↗，了解如何在本地设置 Git。

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

更多信息请参阅 GitHub 文档 ↗和 Git 文档 ↗。

创建 GitHub 仓库

访问 repo.new ↗ 创建新的 GitHub 仓库。创建新仓库后，进入新创建的项目目录，在终端中运行以下命令，准备并将本地应用推送到 GitHub：

git remote add origin https://github.com/<your-gh-username>/<repository-name>
git branch -M main
git push -u origin main

使用 Cloudflare Pages 部署

Configuration option	Value
Production branch	`main`
Build command	`zola build`
Build directory	`public`

Zola 已预装在 Cloudflare Pages 构建环境中，无需额外配置。可选：在 Environment Variables (advanced)（环境变量（高级）） 下设置 ZOLA_VERSION 环境变量以固定特定版本。

例如，ZOLA_VERSION：0.19.2。

配置站点后，即可开始首次部署。你将看到 Cloudflare Pages 使用 Zola 构建站点，然后完成部署。

部署站点后，你将在 *.pages.dev 上获得项目的唯一子域名。

现在可以将该子域名添加为 config.toml 文件中的 base_url。

例如：

# The URL the site will be built for
base_url = "https://my-zola-project.pages.dev"

每次向 Zola 提交新代码时，Cloudflare Pages 都会自动重新构建并部署项目。你还可以在新 pull request 上获得预览部署，在部署到 production 环境之前预览更改效果。

处理预览部署

使用 Cloudflare Pages 时，你可能使用预览部署在合并到 main 分支之前测试更改。但是，这些预览部署使用不同的 URL（如 https://your-branch-name.my-zola-project.pages.dev），若 base_url 硬编码可能导致资源加载问题。

要解决此问题，在 Cloudflare Pages 配置中修改构建命令，根据环境动态设置 base URL：

if [ "$CF_PAGES_BRANCH" = "main" ]; then zola build; else zola build --base-url $CF_PAGES_URL; fi

此命令使用：

从 main 分支构建时使用 config.toml 中设置的 base_url
对于所有其他分支，使用预览部署 URL（Cloudflare Pages 自动提供为 $CF_PAGES_URL）

了解更多

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