如何使用 Hexo 部署 GitHub 博客

什么是 Hexo？

Hexo 是一个快速、简洁且高效的静态博客框架，使用 Markdown 格式撰写文章，适合技术人员和喜欢简洁风格的人。通过 Hexo，用户可以方便地搭建自己的博客，并将其部署到 GitHub 上。本文将详细介绍如何使用 Hexo 部署 GitHub 博客。

部署 GitHub 博客的准备工作

在开始之前，我们需要进行一些准备工作：

• Git: 确保你的系统中已安装 Git，可以通过在终端输入 git --version 来检查。
• Node.js: Hexo 依赖 Node.js，安装 Node.js 时请确保选择 LTS 版本，可以在 Node.js 官网 下载。
• GitHub 账号: 确保你已经注册并拥有一个 GitHub 账号。

安装 Hexo

1. 打开终端: 在你的计算机上打开命令行终端。

2. 安装 Hexo: 使用 npm（Node.js 包管理器）安装 Hexo，可以输入以下命令：
   bash
   npm install -g hexo-cli

   该命令会全局安装 Hexo CLI 工具。

3. 创建 Hexo 博客: 选择一个合适的目录来创建博客文件夹，使用以下命令：
   bash
   hexo init myblog
   cd myblog
   npm install

   这将创建一个名为 myblog 的新文件夹，并安装所需的依赖。

配置 Hexo 博客

在创建完成后，我们需要对 Hexo 进行一些基本配置：

• 修改 _config.yml: 在 myblog 文件夹内找到 _config.yml 文件，进行必要的配置。
  • 修改 title 和 description。
  • 设置 url 为你的 GitHub Pages 地址，例如 https://username.github.io/myblog。
• 主题选择: Hexo 支持多种主题，你可以选择自己喜欢的主题并进行配置，推荐使用 Hexo 主题库 进行选择。

发布博客到 GitHub

接下来是将博客部署到 GitHub 的步骤：

1. 创建 GitHub 仓库: 在 GitHub 上创建一个新的仓库，名称通常为 username.github.io，确保勾选 Initialize this repository with a README。

2. 配置 Hexo 部署插件: 在项目根目录下，安装 Hexo 部署插件，输入以下命令：
   bash
   npm install hexo-deployer-git –save

   然后在 _config.yml 文件中添加以下配置：
   yaml
   deploy:
   type: git
   repo: https://github.com/username/username.github.io.git
   branch: main

3. 生成静态文件: 在终端中输入以下命令以生成静态文件：
   bash
   hexo generate

4. 部署到 GitHub: 使用以下命令将生成的文件推送到 GitHub：
   bash
   hexo deploy

   输入你的 GitHub 用户名和密码以完成操作。

查看博客

在完成部署后，打开你的浏览器，访问 https://username.github.io，即可看到你搭建的 Hexo 博客。

FAQ

如何更新我的 Hexo 博客？

在编辑或添加新文章后，只需再次运行以下命令：

1. hexo generate 生成静态文件。
2. hexo deploy 部署更新。

Hexo 的主题如何更换？

可以通过以下步骤更换主题：

• 访问 Hexo 主题库 选择新主题。
• 下载主题并将其放入 themes 文件夹中。
• 修改 _config.yml 中的 theme 字段为新主题名。

如何添加插件？

你可以在 Hexo 插件市场中找到需要的插件，使用 npm 安装，例如：
bash
npm install hexo-plugin-name –save

然后在 _config.yml 中配置相关选项。

Hexo 支持哪些格式的文章？

Hexo 默认支持 Markdown 格式的文章，其他格式如 HTML 也可以，但需要额外配置。建议使用 Markdown 来编写文章。

结语

通过本文的详细介绍，相信你已经能够成功使用 Hexo 在 GitHub 上部署自己的博客。无论是技术分享还是个人记录，Hexo 都是一个不错的选择。