使用github与jekyll搭建个人博客（一）

虽然使用博客园还没有多久，但是最近看到一些大神的博客觉得很是炫酷。于是突发奇想，想要搭建自己的博客站点儿。编程菜鸟一枚，还是想要记录下最近的搭建博客经历。

使用github搭建个人博客的方式有很多，百度了很多，最多最好用的还是使用jekyll。

首先第一步，建立github pages站点儿，教程在这里。

第二步便是安装jekyll，其实最近有朋友推荐使用Hexo来搭建，但是由于对node.js的不了解，研究了两天，但是执行到$ npm install -g hexo-cli 这一步时，始终会出现错误，思虑再三，应该是系统或者安装的某个程序的版本问题，导致Hexo无法安装成功。安装Hexo带来的挫败感让我很烦躁，折腾再三最终还是放弃了。于是换用jekyll。在百度上查看再三，只知道jekyll与Hexo相比可能更需要一些其他方面的编程知识，但是，还是要尽力一时。安装jekyll的步骤：

1、jekyll 是一款简单的博客系统，静态网站生成器。她有一个模版目录，存放整个静态网站的模版文件，可以通过Liquid处理模版文件，把使用标记语言Textile或Markdown编写的内容文件，按照模版格式，转换成最终的静态网站页面。大名鼎鼎的GitHub Pages就是通过她实现的。

安装jekyll，首先需要在本机MacBook上安装ruby，本机装有Xcode，其也自动安装了ruby，知识版本较低，以至于此版本无法使用gem安装jekyll。使用gem update --system命令对gem进行升级也无法成功。

所以，需要先安装brew：HomeBrew是新一代Mac OS的套件管理工具，使用其安装套件十分简单，由于mac自带ruby，所以只需要打开终端，用命令行输入

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

便可以自动安装。

2、Homebrew安装完成之后，通过她安装最新版ruby.(通过$ ruby --version  查看后，我当前版本的ruby为

2.0.0p481)命令如下：

brew install ruby

最新版ruby安装完成之后，会提示你最新版本安装在/usr/local/opt/ruby/bin目录下面。原来的旧版仍然在/usr/bin下面.

可以修改环境变量PATH的值，将新版本的路径在查找路径中前置。修改~/.bash_profile文件，如下：

export PATH=/usr/local/opt/ruby/bin:$PATH

修改方式，可以打开终端，在命令行输入echo 'export PATH=/usr/local/opt/ruby/bin:$PATH' >> ~/.bash_profile

打开一个新的Terminal，echo $PATH ,查看新的$PATH内容。

或者显示隐藏文件,直接编辑~/.bash_profile文件。

（关于还原默认$PATH：显示隐藏文件后在Finder中直接删除~/.bash_profile。

或者在终端输入：cd ~/; ls -la; rm -rf .bash_profile; ls -la）

修改后source ~/.bash_profile或者重新打开一个Terminal，新版Ruby就生效了。

可以通过ruby --version查看版本号，我的新版信息如下:

ruby 2.2.1p85 (2015-02-26 revision 49769) [x86_64-darwin14

如果，版本不对，就使用which ruby看看，当前生效的ruby是否在/usr/local/opt/ruby/bin下，不对，就修改环境变量PATH,如上。

如此，安装ruby最新版完成，但是此时执行gem update --system命令，仍然发生了错误，报以下错误：

(Gem::RemoteFetcher::FetchError)

究其原因，可能在于墙的问题，无法成功从ruby处下载数据。由于国内网络原因，导致 rubygems.org 存放在 Amazon S3 上面的资源文件间歇性连接失败。所以你会与遇到 gem install rack 或 bundle install的时候半天没有响应，具体可以用 gem install rails -V 来查看执行过程。

此时我们可以更换淘宝的镜像。这是一个完整 rubygems.org 镜像，你可以用此代替官方版本，同步频率目前为15分钟一次以保证尽量与官方服务同步。

具体执行步骤为：

$ gem sources --remove https://rubygems.org/
$ gem sources -a https://ruby.taobao.org/
$ gem sources -l
*** CURRENT SOURCES ***

https://ruby.taobao.org
# 请确保只有 ruby.taobao.org
$ gem install rails

此方法摘自于：这里

之后再执行

gem update --syste

OK,完美升级。我升级完之后的版本为2.4.6。

3、有了最新版的ruby,安装jekyll就简单了。

gem install jekyll

如果使用的标记语言是Markdown，则需要另外安装

gem install rdiscount

如果使用的标记语言是Textile,则需要另外安装

gem install RedCloth

上面三个可以一次性安装，如下

gem install jekyll rdiscount RedCloth

说明：这里安装的jekyll、rdiscount、redcloth都安装在本机的/usr/local/opt/ruby/bin目录下面。

4、现在测试一下jekyll

cd ~
 mkdir jekyllTest
 cd jekyllTest
 git clone https://github.com/mojombo/tpw.git
 cd tpw
 jekyll server

在浏览器访问localhost:4000，或者终端最后显示的地址，显示博客列表。OK,成功！

注：关于Github+Jekyll的工作机制，可以查看这里。