Docusaurus
Docusaurus是一款静态网站生成器。它利用 React 的全部功能来创建具有快速客户端导航功能的单页应用程序,从而使网站具有交互性。它提供了开箱即用的文档功能,但也可用于创建任何类型的网站,如个人网站、产品网站、博客或营销登陆页面。
建立一个新项目
使用
create-cloudflare
CLI (C3) 设置项目。C3 将创建一个新的项目目录,启动 Docusaurus 的官方设置工具,并提供即时部署选项。
要使用 create-cloudflare
创建新的 Docusaurus 项目,请运行以下命令:
create-cloudflare
将安装其他依赖项,包括Wrangler CLI 和任何必要的适配器,并向你提出设置问题。
在你继续之前
所有框架指南都假定你已经对 Git 有了基本了解。如果你是 Git 的新手,请参考这本 Git 手册摘要,了解如何在本地机器上设置 Git。
如果使用 SSH 克隆,则必须在每台用于从 GitHub 推送或拉取的计算机上 生成 SSH 密钥。
创建 GitHub 仓库
访问 repo.new,创建一个新的 GitHub 仓库。创建新仓库后,进入新创建的项目目录,准备并在终端运行以下命令将本地应用程序推送到 GitHub:
使用 Cloudflare 页面部署
通过 create-cloudflare
CLI (C3) 进行部署
如果使用
create-cloudflare
(C3)创建新的 Docusaurus 项目,C3 将安装项目所需的所有依赖项,并提示你通过 CLI 部署项目。如果你进行了部署,你的网站就会上线,并向你提供一个部署 URL。
通过 Cloudflare 控制面板部署
- 登录 Cloudflare 仪表板 并选择你的账户。
- 在账户主页,选择 工作者和页面> 创建应用程序> 页面> 连接到 Git。
- 选择你创建的新 GitHub 仓库,并在设置构建和部署部分,选择 Docusaurus 作为你的框架预设。你的选择将提供以下信息。
Configuration option | Value |
---|---|
Production branch | main |
Build command | npm run build |
Build directory | build |
部署网站后,你将在 *.pages.dev
上为你的项目收到一个唯一的子域。
每次你向 Docusaurus 网站提交新代码并将这些更改推送到 GitHub 时,Cloudflare Pages 都会自动重建你的项目并进行部署。你还可以访问新拉取请求上的 预览部署,并在将更改部署到生产之前预览网站的外观。
有关将你的第一个网站部署到 Cloudflare Pages 的完整指南,请参阅 入门指南。
了解更多
完成本指南后,你已成功将 Docusaurus 网站部署到 Cloudflare Pages。要开始使用其他框架,请参阅框架指南列表