使用 Hexo+Github 搭建博客

reference:
GitHub Pages
Hexo guide 2015-03-20

1.创建 git repository

参考GitHub Pages

2.安装

安装 Node.js

安装 nvm:

1
$ curl https://raw.github.com/creationix/nvm/master/install.sh | sh

重启 Terminal 运行 nvm 安装 nodejs:

1
2
3
$ nvm install 0.12
######################################################################## 100.0%
Now using node v0.12.0

安装 Hexo

运行 npm 安装 Hexo:

1
$ npm install -g hexo-cli

3.配置

初始化资源:

1
2
3
4
5
$ cd {username}.github.io
$ hexo init
INFO  Copying data to {WORKSPACE}/{username}.github.io
INFO  You are almost done! Don't forget to run 'npm install' before you start blogging with Hexo!
$ npm install

修改 _config.yml

参考 Hexo Configuration

其中 Deployment 部分可参考 Deployment Doc 配置:

1
2
3
4
deploy:
  type: git
  repo: git@github.com:{username}/{username}.github.io.git
  branch: master

域名绑定

  1. 在 DNSPod 添加自己的域名

  2. 在 Godaddy 将 Nameserver 指定为 a.dnspod.com, b.dnspod.com

  3. 添加 CNAME 记录指向github page域名

  4. 在 source 目录下创建 CNAME 并填写绑定的域名

添加 Google Analytics

将ID复制到主题的配置文件 _config.yml 下:

1
google_analytics: UA-********-*

4.使用

新建文章:

1
2
$ hexo n post "How to build blog by Hexo"
INFO  Created: {WORKSPACE}/{username}.github.io/source/_posts/How-to-build-blog-by-Hexo.md

More: Writing

生成 html 等文件:

1
$ hexo g

More: Generating

本地服务器测试:

1
$ hexo s

More: Server

发布:

发布前需要安装 hexo-deployer-git

1
$ npm install hexo-deployer-git --save

运行 Deploy 命令发布

1
$ hexo d

More: Deployment

5.注意

5.1 注意文章中冒号后面需要空格，否则会遇到如下错误:

1
2
ERROR Process failed: _posts/How-to-build-blog-by-Hexo.md
JS-YAML: can not read a block mapping entry; a multiline key may not be an implicit key

5.2 多tags分割，参考 YAML 语法

每個清單成員以單行表示，並用短槓+空白（-）起始。或使用方括號（[ ]），並用逗號+空白（,）分開成員:

1
tags: [Hexo,GitHub,Node.js]

或

1
2
3
4
tags: 
-Hexo
-GitHub
-Node.js