Jekyll本地环境折腾记

终于下定决心利用GitHub Pages和Jekyll搭建博客，但是搭建Jekyll环境时遇到了不少坑，决定纪录下来。

1、准备工作

本地环境是Mac OS 10.11.1，我已经选好了模版，然后打算安装Jekyll进行本地调试。

2、安装Jekyll

2.1、安装Jekyll的前置环境

安装Jekyll之前，需要先安装：

• Ruby (including development headers, v1.9.3 or above for Jekyll 2 and v2 or above for Jekyll 3)
• RubyGems
• NodeJS
• Python2.7 (for Jekyll 2 and earlier)

Mac OS已经内置Ruby和Python了，所以我们只需要安装RubyGems和NodeJS。

安装RubyGems

1. 下载TGZ格式或者ZIP格式
2. 解压缩然后通过cd进入解压缩目录
3. 通过控制台安装：ruby setup.rb（可能需要root权限：sodu ruby setup.rb）

安装好之后在控制台输入：gem -v能查看RubyGems的版本号。

安装NodeJS

这个没啥可说的，下载来的是.pkg文件。

2.2、安装Jekyll

Jekyll官网告诉我们通过在控制台输入下面的语句安装Jekyll：

$ gem install jekyll

但是，提示没有权限之类的，好吧，试试：

$ sudo gem install jekyll

同样还是报错，Google了一下，需要这样写：

sudo gem install -n /usr/local/bin jekyll

装完之后，需要把/usr/local/bin加到环境变量中，不然Jekyll指令无法执行：

$ export PATH=/usr/local/bin

以上，Jekyll就算安装好了。

3、本地通过Jekyll生成静态网页

通过cd进入项目文件夹（建议在.gitignore里加入_site，Jekyll编译生成的文件全在_site目录下），然后执行：

$ jekyll serve

浏览器打开http://127.0.0.1:4000，就能看到你的网站啦。

扩展阅读

Liquid用法笔记 Bootstrap教程