hexo/Jekyll + github搭建自己的博客

首先，必须有一个GitHub账号，相信大家都有，没有的话自己去创建吧。

一、GitHub Pages的使用

1. 创建一个分支，使用你的GitHub name

Head over to GitHub and create a new repository named username.github.io, where username is your username (or organization name) on GitHub.

我的GitHub name是 SkylerHu，以我的名字为例。

2. 初始化项目

若是借助Jekyll和hexo的话，只需clone下来即可。

已下步骤是基于terminal的git命令，若是使用界面工具，自己去GitHub Pages看

~$ git clone https://github.com/SkylerHu/SkylerHu.github.io
~$ cd SkylerHu.github.io
~$ echo "Hello World" > index.html
~$ git add --all
~$ git commit -m "Initial commit"
~$ git push -u origin master

也可以在index.html中添加HTML内容，然后在push

一切OK之后，可以访问 http://SkylerHu.github.io. 可以查看index.html的内容。这个网址就是你的博客网址。

二、使用Jekyll

上面新建的项目中，Settings中可以看到GitHubPages相关配置，官方推荐使用Jekyll
GitHub Pages Settings

1. 初始化

安装需要Ruby环境，没有的话自行安装。

1 2	~$ gem install jekyll ~$ jekyll new my-awesome-site

把项目生成的所有文件，全部copy到SkylerHu.github.io目录下.

2. 目录结构

3. 本地启动预览

1 2	~$ cd SkylerHu.github.io ~/SkylerHu.github.io$ jekyll serve

直接访问http://localhost:4000/ 就可以看到你的网站了。

4. 写文章

在目录/SkylerHu.github.io/_posts/下新建xxxx.md；
格式需要按照模板提供的去写；

5. 部署

1 2	~/SkylerHu.github.io$ git add --all ~/SkylerHu.github.io$ git push

6. 使用自己的域名

1) 添加CNAME文件push到GitHub

1	~/SkylerHu.github.io$ echo "pages.skylerhu.com" > CNAME

2) 域名解析

使pages.skylerhu.com解析到 SkylerHu.github.io
注意选择解析类型是CNAME

7. 主题

推荐网站：

可以根据自己的喜好去选择主题，都大同小异。

三、使用hexo

之所有使用hexo,因为好多网友都说这个比较好，所有研究了一下使用方法。

需要安装Node.js

1. 安装

1	~$ sudo npm install -g hexo

2. 初始化

~$ cd blog
# 初始化
~/blog$ hexo init
# 生成静态页面，把markdown转化成html，hexo g 也行
~/blog$ hexo generate
# 启动本地服务，hexo s 也行
~/blog$ hexo server

其他hexo命令

若是之后nodejs升级了，需要执行一下 npm --registry=https://registry.npm.taobao.org install
或者直接执行 npm install, 有参数的意思是使用淘宝源

3. 配置GitHub

编辑blog目录下_config.yml文件，详见hexo配置

1	~/blog$ vim _config.yml

找到deploy配置如下：

deploy:
     type: git
     repo:https://github.com/SkylerHu/SkylerHu.github.io.git
     branch:master
     message: commit的message，默认 Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}

保存后执行命令安装插件hexo-deployer-git

1	~/blog$ npm install hexo-deployer-git --save

4. 配置RSS

编辑_config.yml配置feed

feed:
  type: atom
  path: atom.xml
  limit: 20
  hub:

安装插件hexo-generator-feed

1	~/blog$ npm install hexo-generator-feed --save

5. 部署GitHub Pages

部署之前可以修改_confi.yml中deploy.message作为git commit的message

# 每次修改之后都需要clean和generate
~/blog$ hexo clean
~/blog$ hexo generate
# hexo d 也可以
~/blog$ hexo deploy

会生成一个.deploy_git 文件夹同步到GitHub项目中。

5. 主题

推荐网站https://hexo.io/themes/
我自己使用的是 hexo-theme-yilia

1	~$ git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

修改hexo根目录下的 _config.yml ： theme: yilia

6. 使用自己的域名

同Jekyll一样，也需要修改域名解析，同样也要在GitHub项目下添加CNAME文件。

注意：

不能直接在deploy_git目录下直接添加CNAME文件，每次generate之后会删除

需要添加到source文件夹下echo "pages.skylerhu.com" > source/CNAME

7. 其他配置

可以在blog/_config.yml配置语言和时区

1 2	language: zh-Hans timezone: Asia/Shanghai

我的网站还添加了多说评论和百度统计，具体使用详见推荐网站。

四、比较

	Jekyll	hexo
语言	Ruby	node.js
效率	So fast	稍慢
部署	需要多个命令	直接使用git命令

两个之间都可以互相迁移，看个人操作习惯和爱好吧。

遇到的问题

升级了Node.js后，发现在项目目录中执行hexo相关命令会报出错误

1
2
3

[Error: Module version mismatch. Expected 47, got 46.]
{ [Error: Cannot find module './build/default/DTraceProviderBindings'] code: 'MODULE_NOT_FOUND' }
{ [Error: Cannot find module './build/Debug/DTraceProviderBindings'] code: 'MODULE_NOT_FOUND' }

解决方案如下：

执行npm uninstall hexo卸载hexo；
重新安装hexo，npm install -g hexo；
到博客目录执行npm install，hexo clean，hexo generate

2016-06-27