跳转到内容
搜索文档

Hexo

最后更新 查看 MarkdownAgent 设置

Hexo 是一个由 Node.js 驱动的静态网站生成工具。Hexo 的优势包括速度快、简单且灵活,可通过 Node.js 将 Markdown 文件渲染为静态网页。

在本指南中,你将创建新的 Hexo 应用并使用 Cloudflare Pages 部署。你将使用 hexo CLI 创建新的 Hexo 站点。

安装 Hexo

首先,在终端运行以下任一命令,使用 npmyarn 安装 Hexo CLI:

npm install hexo-cli -g
# or
yarn global add hexo-cli

在 macOS 和 Linux 上,可以使用 brew 安装:

brew install hexo

继续之前

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

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

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

创建新项目

安装 Hexo CLI 后,在终端运行 hexo init 命令创建新项目:

hexo init my-hexo-site
cd my-hexo-site

Hexo 站点使用主题自定义静态构建 HTML 站点的外观。Hexo 有自动安装的默认主题,可在 Hexo 主题页面 找到。

创建文章

创建新文章为 Hexo 站点添加初始内容。在终端运行 hexo new 命令生成新文章:

hexo new "hello hexo"

hello-hexo.md 中,使用 Markdown 编写文章内容。你可以自定义文章中的 tags、categories 或其他变量。更多信息请参阅 Hexo 文档Front Matter 部分

创建 GitHub 仓库

访问 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

使用 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. Set up builds and deployments(设置构建和部署) 部分,提供以下信息:

配置选项
Production branch(生产分支) main
Build command(构建命令) npm run build
Build directory(构建目录) public

完成配置后,点击 **Save and Deploy(保存并部署)**按钮。你将看到 Cloudflare Pages 安装 hexo 和项目依赖,构建站点,然后部署。

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

使用特定 Node.js 版本

某些 Hexo 主题或插件对不同 Node.js 版本有额外要求。要为 Hexo 使用特定 Node.js 版本:

  1. 前往你的 Pages 项目。
  2. 前往 Settings(设置)> Environment variables(环境变量)
  3. 设置环境变量 NODE_VERSION,值为你所需的 Node.js 版本(例如 14.3)。
按照上述说明在 Pages 仪表板中设置环境变量

了解更多

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

这篇文档对您有帮助吗?