Jekyll本地环境搭建

本文记录下自己笔记本搭建本地jekyll环境的步骤，方便日后查阅、部署。

一.ruby环境

由于jekyll是用ruby语言写的一个静态网页生成工具，所以要搭建jekyll本地环境就需要先配置好ruby环境。

1. 去官网下载ruby：http://rubyinstaller.org/downloads/，我选择的是Ruby 2.0.0-p598 (x64)

2. 下载后一路next，安装好后会自动添加环境变量，此时打开cmd，输入ruby -v会有版本号显示，表示安装成功。

3. 下载DevKit，选择和上面安装ruby版本相对应的进行下载，我下载的是DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe64位版本，之后解压到了D:\devkit下，打开cmd，切换到D:\devkit下，分步执行如下命令：

ruby dk.rb init

ruby dk.rb install

这一步会提示这个错误：Invalid configuration or no Rubies listed. Please fix ‘config.yml’ and rerun ‘ruby dk.rb install’

解决办法：编辑devkit目录下面的config.yml，最下面增加一行ruby安装路径。

# 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
#
---
 - C:/Ruby200-x64

如果执行ruby dk.rb install出现如下结果：

D:\Ruby187\DevKit>ruby dk.rb install
[INFO] Skipping existing gem override for 'D:/Ruby187'
[WARN] Skipping existing DevKit helper library for 'D:/Ruby187'

那么需要到ruby目录下的\lib\ruby\site_ruby目录，如（D:\Ruby187\lib\ruby\site_ruby）将devkit.rb文件及其备份都删除，然后重新执行ruby dk.rb install命令。

二.ruby环境（需联网安装）

1. 因为墙的原因，所以需要将ruby软件源设到国内，修改gem命令代码源为ruby.taobao.org，具体设置见：http://ruby.taobao.org/

2. 打开cmd，执行gem install jekyll命令

3. 安装结束后，运行jekyll -v显示版本信息即可表示安装成功。

三.安装rdiscount

_config.yml中一旦配置了markdown:rdiscount，则需要安装rdiscount，否则在jekyll build时候显示如下图错误

安装命令：

gem install rdiscount

四.安装 Python

1. 前往 http://www.python.org/download/
2. 下载合适的 Python windows 安装包，如 Python 2.7.6 Windows Installer。 请注意，Python 2 可能会更合适，因为暂时 Python 3 可能不会正常工作。
3. 安装
4. 添加安装路径 (如： C:\Python27) 至 PATH。

5. 检验 Python 安装是否成功

   python –version

   输出示例：

   Python 2.7.6

五.安装 ‘Easy Install’

1. 浏览 https://pypi.python.org/pypi/setuptools#installation-instructions 来查看详细的安装指南。

2. 对于 Windows 7 的机器，下载 ez_setup.py 并保存，例如，至C:\。
   然后从命令行使用 Python 运行此文件：

   python “C:\ez_setup.py”

3. 添加 ‘Python Scripts’ 路径 (如： C:\Python27\Scripts) 至 PATH

六.安装 Pygments

1. 确保 easy_install 已经正确安装

   easy_install –version

   输出示例：

   setuptools 3.1

2. 使用 “easy_install” 来安装 Pygments

   easy_install Pygments

七.启动 Jekyll

按照官方的 Jekyll 快速开始手册
的步骤， 一个新的 Jekyll 博客可以被建立并在 localhost:4000浏览。

jekyll new myblog

cd myblog

jekyll build

jekyll serve

至此，本地环境搭建完毕，就不必每次push到github上再看结果了！

参考文献

• http://www.cnblogs.com/yevon/p/3308158.html
• http://cn.yizeng.me/2013/05/10/setup-jekyll-on-windows/