Windows平台安装Jekyll

一、安装Ruby

这里在Windows下安装Ruby,对应自己电脑的操作系统位数，如我的是Windows 8.1 64位，对应下载Ruby 2.0.0-p451(x64)这个版本的Ruby。然后安装过程就很简单了。

注意：Ruby的完整安装路径中一定不要有空格。

命令行下输入ruby -v 检测是否安装成功：

C:\Users\shallot>ruby -v
ruby 2.0.0p451 (2014-02-24) [x64-mingw32]

出现版本号就说明安装成功了，接下来就要安装DevKit.

二、安装DevKit

在Ruby的下载页面下载安装DevKit，这里DevKit的版本一定要和之前下载的Ruby配套。

将DevKit的文件拷贝到一个永久目录中，这个目录的完整文件路径不能有空格存在。在命令提示符(管理员)中，进入DevKit目录。

执行"ruby dk.rb init"，生成config.yml配置文件。

最后"ruby dk.rb install"，安装DevKit到你Ruby中。

对于64位操作系统来说，可能会报错："Invalid configuration. Please fix 'config.yml' and rerun 'ruby dk.rb install'"。

解决方案是将Ruby目录的绝对路径写在config.yml中，如下：

# This configuration file contains the absolute path locations of all
# installed Rubies to be enhanced to work with the DevKit. This config
# file is generated by the 'ruby dk.rb init' step and may be modified
# before running the 'ruby dk.rb install' step. To include any installed
# Rubies that were not automagically discovered, simply add a line below
# the triple hyphens with the absolute path to the Ruby root directory.
#
# Example:
#
# ---
# - C:/ruby19trunk
# - C:/ruby192dev
#

注意规则：按照Example的格式进行书写。前面不要加上井号。

然后再试"ruby dk.rb install"。如下提示：

$ ruby dk.rb install
[INFO] Updating convenience notice gem override for 'C:/Ruby200-x64'
[INFO] Installing 'C:/Ruby200-x64/lib/ruby/site_ruby/devkit.rb'

那么就说明安装成功了，然后就安装Jekyll吧。

三、安装jekykll

在命令提示符(管理员)下安装，执行如下命令：

$ gem install jekyll

检测是否安装成功：

$ jekyll -v
jekyll 1.4.3

提示OK了！

四、Jekyll应用

下面举一个"用Jekyll构建基于bootstrap模板"的例子。

首先从github下载模板：

$ git clone https://github.com/plusjade/jekyll-bootstrap.git

然后进入项目目录，启动Jekyll服务：

$ cd jekyll-bootstrap
$ jekyll serve

如果在启动时出现：以下错误：

$ jekyll serve
Configuration file: e:/jek_demo/jekyll-bootstrap/_config.yml
Source: e:/jek_demo/jekyll-bootstrap
Destination: e:/jek_demo/jekyll-bootstrap/_site
Generating... error: Invalid argument - e:/jek_demo/jekyll-bootstrap/_site/e:. Use --trace to view backtrace

就说明你下载的Jekyll是最新版1.4.3，与你的Ruby版本的问题，这里卸载最新版，安装1.4.2的版本的就行了。

卸载原先安装的最新版1.4.3的Jekyll：

$ gem uninstall jekyll
Remove executables:
jekyll

in addition to the gem? [Yn]  y
Removing jekyll
Successfully uninstalled jekyll-1.4.3

安装1.4.2版本的Jekyll：

$ gem install jekyll --version "=1.4.2"
Fetching: jekyll-1.4.2.gem (100%)
Successfully installed jekyll-1.4.2
Parsing documentation for jekyll-1.4.2
Installing ri documentation for jekyll-1.4.2
1 gem installed

$ jekyll -v
jekyll 1.4.2

然后再启动服务，OK啦：

$ jekyll serve
Configuration file: e:/jek_demo/jekyll-bootstrap/_config.yml
Source: e:/jek_demo/jekyll-bootstrap
Destination: e:/jek_demo/jekyll-bootstrap/_site
Generating... done.
Server address: http://0.0.0.0:4000
Server running... press ctrl-c to stop.

在浏览器中访问http://localhost:4000/就出现网站的页面了。