Hexo , 一个简单地、轻量地、基于 Node 的一个静态博客框架。下面介绍下如何使用 hexo 和 github pages 搭建个人博客。

准备工作

注意：本文针对Windows平台和Hexo 3.2.2

1
2
3
4
5
6
$ hexo -v
hexo: 3.2.2
hexo-cli: 1.0.2
os: Windows_NT 10.0.14393 win32 x64
http_parser: 2.7.0
node: 6.10.1

安装 Github For Windows

主要使用 git bash，如果对 git 命令不熟悉的也可以使用 git 客户端进行某些操作
Github For Windows

安装 node.js

因为要使用 npm，比较简单的方法就是安装 node.js

安装完成后添加 Path 环境变量，使 npm 命令生效
;C:\Program Files\nodejs\node_modules\npm

创建 Github Pages

没有Github 账号的话，需要注册一个，然后创建一个仓库，名字是
[yourGithubAccount].github.io

配置 ssh key

使用 git bash 生成 public ssh key, 以下是最简单的方法

1
$ ssh-keygen -t rsa

然后在 C:\Users\[用户名]\.ssh 目录下会生成 id_rsa.pub ，将内容完全复制到 Github Account Setting 里的 ssh key 粘贴即可。

测试

1
2
3
$ ssh -T git@github.com
Hi [yourGithubAccount]! You've successfully authenticated,
but GitHub does not provide shell access.

设置用户信息

1
2
$ git config --global user.name "[yourName]"//用户名
$ git config --global user.email  "[yourEmail]"//填写自己的邮箱

经过以上步骤，本机已成功连接到 github，为部署打下基础。

配置 Hexo

本地 clone

创建本地目录，然后使用 git bash 或者客户端 clone 之前创建的仓库
[yourGithubAccount].github.io

安装、配置 Hexo

进入仓库目录，使用 npm 安装配置 hexo

1
2
3
$ npm install -g hexo-cli
$ npm install hexo --save
$ hexo init

安装 Hexo 插件

1
2
3
4
5
6
7
8
9
10
11
12
13
npm install hexo-generator-index --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-tag --save
npm install hexo-server --save
npm install hexo-deployer-git --save
npm install hexo-deployer-heroku --save
npm install hexo-deployer-rsync --save
npm install hexo-deployer-openshift --save
npm install hexo-renderer-marked@0.2 --save
npm install hexo-renderer-stylus@0.2 --save
npm install hexo-generator-feed@1 --save
npm install hexo-generator-sitemap@1 --save

安装 ejs， 否则无法解析模板

1
$ npm install ejs

安装 hexo 所需的依赖模块

1
npm install

然后运行下面的命令生成 public 文件夹

1
2
$ hexo g
$ hexo s

在浏览器输入 localhost:4000 本地查看效果

主题

hexo 有很多主题可选，我选了 indigo，Material Design 风格的Hexo主题，基于 Hexo 3.0+ 制作。支持多说评论、网站统计、分享等功能，只要稍微配置即可使用。可以根据自己需求进行选择。

使用 hexo

部署

配置 _config.yml

1
2
3
4
deploy:
  type: git
  repository: git@github.com:[yourGithubAccount]/[yourGithubAccount].github.io.git
  branch: master
1
$ hexo d

即可将 hexo 部署到 github 上

提示找不到 git 时

需执行（虽然之前已经执行过）

1
npm install hexo-deployer-git --save

然后

1
$ hexo d

即可访问：

1
http://[yourGithubAccount].github.io/

发表新文章

1
$ hexo new "title"

然后在 source/_post 下会生成该.md文件，即可使用编辑器编写了编写过程中，可以在本地实时查看效果，很是方便。支持 markdown，不了解的自行 百度 。

编写完成后，部署还是一样的

1
$ hexo d -g

如果部署过程中报错，可执行以下命令重新部署

1
2
3
$ hexo clean
$ hexo generate
$ hexo deploy

添加自定义页面

1
$ hexo new page "about"

该命令会生成 source/about/index.md，编辑即可

插件的升级与卸载

1
2
$ npm update
$ npm uninstall <plugin-name>

更新 hexo

1
npm update -g hexo

绑定自定义域名

在 /source/ 目录下新建内容为自定义域名的 CNAME 文件，部署即可（域名设置略）

备注：Hexo简写命令

1
2
3
4
hexo n #new
hexo g #generate
hexo s #server
hexo d #deploy