Hexo+Github个人博客搭建教程

keRee 最后编辑于

系统配置

1、 安装node.js （已安装的请进行下一步）

node.js官网：https://nodejs.org/zh-cn/
首次的安装的可以参考这篇博客：Nodejs、NPM安装

这篇博客讲的比较详细，对于首次的安装Node.js的我再啰嗦下:
确保版本提示ok

1
2
node -v    //v4.4.4
npm -v     //3.10.5

最好要配置好npm的全局模块的存放路径

1
2
npm config set prefix "C:\Program Files\nodejs\node_global"
npm config set cache "C:\Program Files\nodejs\node_cache"

后面的文件路径可以自定义，存放在你的node文档中比较好，以后全局安装的模块都可以在这里找到

注意全局变量的设置

2、安装Git （已安装的请进行下一步）

Git官网： https://www.git-scm.com/
或者看廖雪峰的官网-安装Git

3、安装Hexo

Hexo官网中文文档：https://hexo.io/zh-cn/docs/index.html

当然既然node已经安装好了，我们可以自定义安装：

1
npm install -g hexo

OK，安装完成之后，可以 hexo -v 即可以看到自己相关的系统配置
贴下我自己的系统环境：

1
2
3
4
5
6
7
8
9
10
11
12
hexo: 3.2.2
hexo-cli: 1.0.2
os: Windows_NT 6.1.7601 win32 x64
http_parser: 2.5.2
node: 4.4.4
v8: 4.5.103.35
uv: 1.8.0
zlib: 1.2.8
ares: 1.10.1-DEV
icu: 56.1
modules: 46
openssl: 1.0.2h

Hexo初试

1、 初始化 新建一个自己的项目目录，如myBlog，然后在cmd中cd到项目目录，执行命令：

1
hexo init

提示： INFO Start blogging with Hexo! 则说明成功了。

此时我们可以看到myBlog目录结构：

1
2
3
4
5
6
7
8
--myBlog
|--+ node_modules
|--+ scaffolds
|--+ source
|--+ themes
|--- .gitignore
|--- _config.yml
|--- package.json

2、 生产静态页面 在cmd项目目录，执行命令：

1
hexo g           //或者 hexo generate  也可以

提示： INFO 28 files generated in 3.24s 类似的就OK啦！

3、 启动本地服务 在cmd项目目录，执行命令：

1
hexo s           //或者 hexo server  也可以

提示： INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

此时，我们可以在浏览器输入http://localhost:4000/
可以看的到系统提供的 Hexo Hello world!页面。
如有问题可以查下看看4000端口是否被占用

好了，到这里其实我们就可以开始配置Github了。

Github配置

到了这里我们需要关联Hexo和Github中的项目仓库。
1、建立项目仓库Respository

我们需要建立与自己用户名相对应的项目仓库，比如我的用户名是aduoo,那么我新建的仓库名为：aduoo.github.io

2、配置Git SSH Key> 可以参考这篇博客

这个目的是为了Hexo后面免密部署项目

3、修改Hexo配置，正式关联Hexo和Github

（1）、打开我们项目目录myBlog里的_config.yml文件（用编辑器哈）
（2）、翻到最后，修改如下（用户名处改成自己的哈）

1
2
3
4
deploy:
  type: git
  repository: ssh://git@github.com/aduoo/aduoo.github.io.git
  branch: master

那么接下来，我们可以部署自己的项目了。

Hexo部署项目

在cmd项目目录，输入命令hexo d，最后提示INFO Deploy done: git，则说明项目成功部署到Github.

恭喜，你可以在浏览器输入https://aduoo.github.io访问自己的blog了，可以看到会与在本地看到的一样。