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 仓库
访问 repo.new,创建一个新的 GitHub 仓库。创建新仓库后,进入新创建的项目目录,准备并在终端运行以下命令将本地应用程序推送到 GitHub:
如果你要将现有的 Jekyll 项目迁移到 Pages,请确认你的 Gemfile
已作为代码库的一部分提交。Pages 会查看你的 Gemfile 并运行 bundle install
为你的项目安装所需的依赖项,包括 jekyll
gem。
使用 Cloudflare 页面部署
将网站部署到页面:
- 登录 Cloudflare 仪表板 并选择你的账户。
- 在账户主页,选择 工作者和页面> 创建应用程序> 页面> 连接到 Git。
- 选择创建的新 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。要开始使用其他框架,请参阅框架指南列表