跳转到内容
搜索文档

Eleventy

最后更新 查看 MarkdownAgent 设置

Eleventy ↗ 是一个简单的静态网站生成器。在本指南中,你将创建新的 Eleventy 站点并使用 Cloudflare Pages 部署。您将使用 eleventy CLI 创建一个新的 Eleventy 网站。

安装 Eleventy

在终端运行以下命令安装 eleventy CLI:

npm install -g @11ty/eleventy

创建新项目

Eleventy 网站上提供了很多 入门项目 (starter projects) ↗。作为一个示例,通过在终端中运行以下命令来使用 eleventy-base-blog 项目:

git clone https://github.com/11ty/eleventy-base-blog.git my-blog-name
cd my-blog-name
npm install

继续之前

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

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

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

创建 GitHub 仓库

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

git remote set-url origin https://github.com/yourgithubusername/githubrepo
git branch -M main
git push -u origin main

使用 Cloudflare Pages 部署

要将站点部署到 Pages:

  1. 在 Cloudflare 仪表板中,前往 Workers & Pages 页面。

    Go to Workers & Pages ↗
  2. 选择 Create application(创建应用程序)。

  3. 选择 Pages 选项卡。

  4. 选择 Import an existing Git repository(导入现有 Git 仓库)。

  5. 选择你创建的新 GitHub 仓库,然后选择 Begin setup(开始设置)。

  6. 在 Build settings(构建设置) 部分,选择 Eleventy 作为 Framework preset(框架预设)。你的选择将提供以下信息:

Configuration optionValue
Production branchmain
Build commandnpx @11ty/eleventy
Build directory_site

部署站点后,你将在 *.pages.dev 上获得项目的唯一子域名。 每次向 Eleventy 提交新代码时,Cloudflare Pages 都会自动重新构建并部署项目。你还可以在新 pull request 上获得预览部署,在部署到生产环境之前预览更改效果。

了解更多

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

这篇文档对您有帮助吗?