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