Hexo + GitHub 搭建个人博客

Hexo 简介

来自官方的描述：

A fast, simple & powerful blog framework, powered by Node.js.

简单清晰：由 Node.js 驱动，快速、简单、强大的博客框架

---

安装 Hexo 框架

来自官方安装教程：

1. 前提条件
2. 安装 Hexo 框架
3. 初始化博客目录

1.前提条件：

请确保以下软件已被安装：
Node.js 、Git

2. 安装 Hexo

npm i hexo-cli -g

3. 初始化博客目录

hexo init blog

目录说明

这里 Hexo 博客框架就安装完了，不过还是对博客主目录进行一些简短的说明：

├── _config.yml # 站点配置文件
├── package.json # webpack 配置文件
├── scaffolds # 模版文件夹
├── source # 资源文件夹
|   ├── _drafts # 文章草稿文件夹
|   └── _posts # 文章发布文件夹
├── public # 文章部署文件夹
└── themes # 主题文件夹

这里只提一点：
在发布部署过程中，source 目录下的文件会被解析或拷贝至 public 目录。

• source/_posts 中所有的 Markdown 和 HTML 文件会被解析并放到 public 目录
• source 中的其余目录会完整拷贝至 public 目录

---

发布到 Github

想使用 Github 发布 Hexo 的博客，主要有以下两个步骤：

1. 在 Github 创建相关仓库
2. 配置 hexo-deployer-git 插件

1. 在 Github 创建相关仓库

创建和 Github 账号同名的仓库，规则如下：
例如：GitHub 账号为 iDukelu，则仓库名应创建为 iDukeLu.github.io

2. 配置 hexo-deployer-git 插件

• 安装 hexo-deployer-git 插件

npm i hexo-deployer-git -s

注：Hexo 3.0 以后，使用 Git 进行提交需先安装hexo-deployer-git 插件，否则，直接使用 Git 提交会报错：ERROR Deployer not found: github

• 修改站点配置文件 _config.yml 如下：

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: https://github.com/iDukeLu/iDukeLu.github.io.git
  # repo: [email protected]:iDukeLu/iDukeLu.github.io.git 配置了 ssh 后的地址
  branch: master

简单说明下着几个参数：

• type：部署方式
• repo：部署的 gi t 仓库地址（可用使用 https 或 ssh）
• branch：git 仓库分支

至此，原生的 Hexo 博客框架就已经部署到了 Github 上了，可以通过 https:iDukeLu.github.io，进行访问查看博客站点的内容了

---

参考：
https://github.com/hexojs/hexo
https://hexo.io/zh-cn/docs/