在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