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

Jekyll

Jekyll是一个用于创建网站的开源框架,以 Markdown 和 Liquid 模板为基础。在本指南中,你将创建一个新的 Jekyll 应用程序,并使用 Cloudflare Pages 进行部署。你将使用 jekyll CLI 创建一个新的 Jekyll 网站。

​​ 安装 Jekyll

Jekyll 是用 Ruby 编写的,这意味着你需要一个正常运行的 Ruby 安装,如 rbenv 来安装 Jekyll。

要在计算机上安装 Ruby,请遵循 rbenv安装说明,并在终端中运行 rbenv 命令来选择 Ruby 的最新版本。你安装的 Ruby 版本也将用于配置应用程序的页面部署。

安装好 Ruby 后,就可以安装 jekyll Ruby gem:

​​ 创建一个新项目

安装好 Jekyll 后,你可以在终端运行 jekyll new 创建一个新项目:

在新创建的文件夹中创建一个基本的 index.html,为网站提供内容:

如果你想在新的 Jekyll 网站开始时就有很好的默认样式,也可以选择使用一个主题。例如, minimal-mistakes 主题有一个 jekyll new 开始 部分,可以帮助你把主题添加到新网站。

​​ 在你继续之前

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

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

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

​​ 创建 GitHub 仓库

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

如果你要将现有的 Jekyll 项目迁移到 Pages,请确认你的 Gemfile 已作为代码库的一部分提交。Pages 会查看你的 Gemfile 并运行 bundle install 为你的项目安装所需的依赖项,包括 jekyll gem。

​​ 使用 Cloudflare 页面部署

将网站部署到页面:

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

添加与本地使用的 Ruby 版本相匹配的 环境变量。在预览版和生产版部署中都将其设置为 RUBY_VERSION。下面以 3.1.3为例:

Environment variable Value
RUBY_VERSION 3.1.3

配置好网站后,你就可以开始第一次部署了。你应该会看到 Cloudflare 页面正在安装 jekyll、项目依赖项,并在部署前构建你的网站。

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

​​ 了解更多

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