在Windows系統配置Jekyll

標籤：style   blog   http   color   io   ar   使用   sp   檔案   

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

在Windows系統配置Jekyll