使用Jekyll在Github建立个人博客

03 February 2015

之前用花生壳+ADSL+上网本的网站由于联通封了80端口，而被迫改用443的https，再之后https证书也到期了，并且申请证书又非常麻烦（跟老外交涉有时候特别崩溃，非说我用的不是真名），网站彻底就荒废掉了，本来已经准备放弃这个域名了，而后来同事说可以用github.io建站，试了一下居然成功了，这里作为网站复活的首篇文章记录下来。

1. 注册Github的账号

首先需要在Github上注册一个自己的账号，这个过程很简单，登录Github，点击Sign up for Github并填写相关信息完成注册即可。

2. 添加一个username.github.io的代码库

新增加一个代码库，代码库的名字格式需要是username.github.io，其中username是Github账号的用户名。

3. 下载建好的代码库

使用以下命令下载建立的空代码库

git clone https://github.com/username/username.github.io.git
cd username.github.io

再增加一个gitignore文件，内容如下，避免将Jekyll生成的网站文件提交到代码库中。

_site/*

4. 安装Jekyll

其实提交后的代码到Github后，会自动进行模版的编译，但如果需要在本地环境进行测试则需要安装一个Jekyll环境。其中Jekyll需要有Ruby的支持，需要安装Ruby并同时安装几个Gem包。

#修改一下Gem源
gem sources -r https://rubygems.org
gem sources -a https://ruby.taobao.org
gem install bundler

在代码库中增加一个名为Gemfile的文件，内容如下

source 'https://rubygems.org'
gem 'github-pages'

并在代码库目录中执行

bundle install

完成后还需要安装一个JS引擎，这里使用nodejs，完成后启动Jekyll

pacman -S nodejs
#在代码库的根目录下运行
jekyll server

5. 初始化目录结构

安装Jekyll完成后就需要初始化一下Jekyll的目录结构了，其主要目录结构如下

/--
  |--  _config.yml
  |--　_layouts
  |--　_posts
  |--　index.html

其中_config.yml保存相关配置，_layouts目录中存放页面的模版，_posts目录中存放博客文章，index.html是首页的页面。

6. 绑定自己的域名

首先需要购买一个自己的域名，并将域名的解析作为别名指向自己对应的Github域名上，即增加类似如下的cname解析

www.longlong.asia cname longlong2010.github.io

完成后在代码库中增加一个名为CNAME的文件，内容为访问时使用的域名，例如我这里就是

www.longlong.asia

完成后就可以使用自己的域名访问到自己的博客站了。