Windows 下 jekyll 环境搭建

虽然网上教程不少，但照着做也折腾了我一个下午，可见还是有问题的。

现在以 Windows 8.1 x64 为例，把流程记录一下：

1. 安装 ruby，假设安装目录是 C:\ruby

   google 搜索 rubyinstaller

   x64 安装包，安装程序可以自动添加 ruby 目录进 PATH

   x64 7z压缩包，需要手动添加 ruby 目录进 PATH，或者写个 run.bat 保存到 ruby 目录：

   1	@set path=%~dp0;%path% & @cmd /k

2. 更新 RubyGems 到最新版

   cmd 下执行

   1	gem update --system

3. 下载 DevKit

   http://rubyinstaller.org/downloads/

   DevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe

   解压到

   1	C:\ruby\devkit

4. 安装 DevKit

   1. 切换到 devkit 目录

      1	cd/d C:\ruby\devkit

   2. 1	ruby dk.rb init

      此时会生成一个

      1	C:\ruby\devkit\config.yml

      。

      打开它，把最后一行的

      1

      ---

      改成

      1

      - C:/ruby

   3. 1	ruby dk.rb install

5. 切换到淘宝的 RubyGems 镜像

   http://ruby.taobao.org/

6. 安装 jekyll、wdm、kramdown

   1. 1	gem install jekyll --version=1.4.2

      当前最新版本是

      1

      1.4.3

      ，据说跟 Windows 相性不好

   2. 1	gem install wdm

      当前最新版是

      1

      0.1.0

   3. 1	gem install kramdown

      当前最新版是

      1

      1.3.2

另外还有些小问题：

• 使用绿色版的 python 2.x

# C:\ruby\lib\ruby\gems\2.0.0\gems\pygments.rb-0.5.4\lib\pygments\popen.rb:47

def python_binary
  @python_binary ||= begin
    'D:/Dev/Python27/python.exe'
    #`which python2`
    #$?.success? ? "python2" : "python"
  end
end

• ruby 自带的 httpserver 不支持带中文的 path

# C:\ruby\lib\ruby\2.0.0\webrick\httprequest.rb:217

#@path = HTTPUtils::unescape(@request_uri.path)
@path = HTTPUtils::unescape(@request_uri.path).force_encoding('UTF-8')

• jekyll 不支持中文，只需要在

  1	_config.yml

  里加上一行

  1	encoding: "utf-8"

最后可以写个批处理启动 jekyll