Gridsome ↗ 是一个由 Vue.js 驱动的 Jamstack 框架,用于构建默认快速的静态生成网站和应用。在本指南中,你将创建新的 Gridsome 项目并使用 Cloudflare Pages 部署。你将使用 @gridsome/cli ↗,这是用于创建新 Gridsome 项目的命令行工具。
在终端运行以下命令安装 @gridsome/cli:
npm install --global @gridsome/cli安装 Gridsome 后,运行 gridsome create 设置新项目。create 命令接受一个用于定义所创建项目目录的名称,以及一个可选的入门套件名称。你可以在 Gridsome 入门项目部分 ↗ 中查看更多入门项目。
npx gridsome create my-gridsome-website所有框架指南都假定你已具备 Git ↗ 的基础知识。如果你是 Git 新手,请参阅这份精简 Git 手册 ↗,了解如何在本地设置 Git。
如果你使用 SSH 克隆,则必须在每台用于向 GitHub 推送或拉取的计算机上生成 SSH 密钥 ↗。
更多信息请参阅 GitHub 文档 ↗和 Git 文档 ↗。
访问 repo.new ↗ 创建新的 GitHub 仓库。创建新仓库后,进入新创建的项目目录,在终端中运行以下命令,准备并将本地应用推送到 GitHub:
git init
git remote add origin https://github.com/<your-gh-username>/<repository-name>
git add .
git commit -m "Initial commit"
git branch -M main
git push -u origin main要将站点部署到 Pages:
要将站点部署到 Pages:
-
在 Cloudflare 仪表板中,前往 Workers & Pages 页面。
Go to Workers & Pages ↗ -
选择 Create application(创建应用程序)。
-
选择 Pages 选项卡。
-
选择 Import an existing Git repository(导入现有 Git 仓库)。
-
选择你创建的新 GitHub 仓库,然后选择 Begin setup(开始设置)。
在 Build settings(构建设置) 部分,选择 Gridsome 作为 Framework preset(框架预设)。你的选择将提供以下信息:
| Configuration option | Value |
|---|---|
| Production branch | main |
| Build command | npx gridsome build |
| Build directory | dist |
配置站点后,即可开始首次部署。你将看到 Cloudflare Pages 安装 vuepress、项目依赖并构建站点,然后完成部署。
部署站点后,你将在 *.pages.dev 上获得项目的唯一子域名。每次向 Gridsome 项目提交新代码时,Cloudflare Pages 都会自动重新构建并部署您的项目。您还可以在新 pull request 上获得预览部署,以便在将更改部署到生产环境之前预览网站的显示效果。
完成本指南后,你已成功将 Gridsome 站点部署到 Cloudflare Pages。要开始使用其他框架,请参阅框架指南列表。