Hexo + GitHub 部署指南

1. 软件支持

2. 安装 Node

打开 Node 官网，下载适合你系统的 Node 安装程序。下载后安装，建议使用默认目录 C:/Program Files/nodejs/。

安装完成后，检查是否安装成功。按下 Win + R 键，输入 CMD，然后回车，打开 CMD 窗口，执行 node -v 命令，看到版本信息则说明安装成功。

修改 npm 源。npm 下载模块默认从国外服务器下载，速度较慢，建议配置成华为云镜像源。打开 CMD 窗口，运行如下命令：

1
npm config set registry https://mirrors.huaweicloud.com/repository/npm/

3. 安装 Git

进入 Git 官网 下载适合你系统的安装程序，下载后傻瓜式安装即可，建议使用默认目录 C:/Program Files/Git。
安装后，你可以在 开始菜单 找到以下工具：
Git CMD：Windows 命令行的指令风格
Git Bash：Linux 系统的指令风格（建议使用）
Git GUI：图形化界面（新手学习不建议使用）

4. 配置 Git 密钥并连接至 GitHub

常用 Git 命令：

查看所有配置：git config -l
查看系统配置：git config --system --list
查看用户（全局）配置：git config --global --list

配置用户名和邮箱：

1
2
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

通过 git config -l 检查是否配置成功。

5. 配置公钥连接 GitHub

生成 SSH 密钥：

1
ssh-keygen -t rsa -C "你的邮箱"
  • 提示 Enter file in which to save the key 时直接回车，新手不推荐设置密钥密码。
  • 打开 C:\Users\Administrator\.ssh 文件夹，会看到以下文件：
    • id_rsa（私钥）
    • id_rsa.pub（公钥）
  • 用记事本打开 id_rsa.pub 文件，复制里面的内容，然后在 GitHub 中配置 SSH 密钥。

测试连接github是否成功，输入以下命令：

1
ssh -T git@github.com

第一次连接会提示 Are you sure you want to continue connecting (yes/no/[fingerprint])?，输入 yes 即可。如果看到连接到账户的信息，说明配置成功。

6. 安装 Hexo

在 Hexo 根目录使用 Git Bash 中输入如下命令安装 Hexo：

1
npm install -g hexo-cli && hexo -v

安装完成后，输入 hexo -v 验证是否安装成功。

7. 初始化 Hexo 项目并安装依赖

初始化 Hexo 项目：

1
2
3
hexo init blog-demo
cd blog-demo
npm i

项目结构说明：

node_modules：依赖包
scaffolds：生成文章的模板
source：存放文章的目录
themes：主题
.npmignore：发布时忽略的文件（可忽略）
_config.landscape.yml：主题配置文件
config.yml：博客配置文件
package.json：项目名称、描述、版本、运行和开发等信息

启动项目：

1
hexo cl && hexo s

打开浏览器，输入地址 http://localhost:4000/，如果看到预期效果，则说明博客已成功构建。

8. 将静态博客挂载到 GitHub Pages

安装 Hexo 部署插件：

1
npm install hexo-deployer-git --save

编辑文章并预览：

1
hexo cl; hexo s

确认无误后使用以下命令，将本地文章推送至GitHub仓库即可：

1
hexo cl; hexo g; hexo d

8. Vscode 终端首次执行报错解决

1
Set-ExecutionPolicy RemoteSigned

请用 管理员模式 打开 Windows PowerShell 输入代码即可，按 Y 回车。

9. 安装butterfly主题

在你的 Hexo 根目录安装

1
git clone -b master https://gitee.com/immyw/hexo-theme-butterfly.git themes/butterfly

应用主题：

  • 修改 Hexo 根目录下的 _config.yml，把主题改为 butterfly
1
theme: butterfly

安装插件：

  • 如果你没有 pug 以及 stylus 的渲染器，请下载安装：
1
npm install hexo-renderer-pug hexo-renderer-stylus --save
  • 在 hexo 的根目录创建一个文件 _config.butterfly.yml，并把 butterfly 主题目录的 _config.yml 内容复制到 _config.butterfly.yml 去。( 注意: 复制的是 butterfly 主题的 _config.yml ，而不是 hexo 的 _config.yml)
  • 注意： 以后只需要在 _config.butterfly.yml 进行配置就行。
  • 如果使用了 _config.butterfly.yml， 配置主题的 _config.yml 将不会有效果。

注意： 不要把 butterfly 主题目录的 _config.yml 删掉。