在Windows系统配置Jekyll

Jekyll 是一个简单的网站静态页面生成工具。因为是用Ruby语音编写的，因此在Windows系统上配置起来仍是稍微有点繁琐的。具体过程以下：

1. 安装Ruby：在Windows系统上固然使用rubyinstaller了， 猛击我下载 （笔者使用的版本是：Ruby 1.9.3-p545）
2. 安装Ruby DevKit： 猛击我下载
3. 安装Jekyll
4. 安装Python： 猛击我下载
5. 安装Pygments

如下是详细步骤：

1.从rubyinstaller下载安装包并安装到某个磁盘中，好比：E:\Ruby192，在安装界面把全部的选项都勾选上；

2.把下载的DevKit解压到某个目录，好比 E:\devkit , 在该目录中运行以下命令：

> ruby dk.rb init

来生成一个config.xml配置文件，该配置文件中包含了前面的Ruby安装目录 （E:\Ruby192） 而后运行以下命令

> ruby dk.rb install

3.而后运行以下命令安装Jekyll：

> gem install jekyll

如今能够开始使用jekyll了。若是您还须要使用代码高亮工具，则须要继续安装Pygments ，过程以下：

4.安装下载的Portable Python（笔者使用的是PortablePython_3.2.1.1.exe），安装目录为E:\Portable_Python_3.2.1.1

而后把E:\Portable_Python_3.2.1.1\App\Scripts和E:\Portable_Python_3.2.1.1\App目录分别添加到系统Path环境变量中

5.把下载的distribute-0.6.49.tar.gz解压的某个目录(好比：E:\distribute-0.6.28), 猛击我下载

在该目录中运行以下命令：

> python distribute_setup.py

6.而后经过以下命令来安装pygments：

> easy_install Pygments

最后须要修改2处Bug：

1. Pygmentize中的Bug：修改以下文件 E:\Ruby192\lib\ruby\gems\1.9.1\gems\albino-1.3.3\lib\albino.rb 修改的内容参考 这里

2. 因为中文XP系统使用的GBK编码，GBK编码致使jekyll处理的bug，修改E:\Ruby192\lib\ruby\gems\1.9.1\gems\jekyll-0.11.2\lib\jekyll\convertible.rb这个文件，修改方式 参考这里

而后就可使用Jekyll了，在生成静态页面的时候 可能还会出现 GBK字符不能编码的问题，可是不影响生成网页了。

更新

笔者最近安装了最新版的jekyll，已经不存在须要修复两处bug的问题了，安装到第六步就ok了，上面提到的gbk编码问题，可用以下方法解决，在cmd窗口输入以下命令，临时改变编码。

> chcp 65001

参考资料

• Running Jekyll on Windows
• Jekyll 本地调试之若干问题
• 搭建一个免费的，无限流量的Blog
• Markdown 语法说明 (简体中文版)
• jekyll中文站
• markdown在线编辑器
• markdownpad 2