Windows下Jekyll配置過程詳解
Jekyll 是一個簡單的網站靜態頁面生成工具。由于是用Ruby語音編寫的,所以在Windows系統上配置起來還是稍微有點繁瑣的。具體過程如下:
- 安裝Ruby:在Windows系統上當然使用rubyinstaller了, 猛擊我下載 (筆者使用的版本是:Ruby 1.9.3-p545)
- 安裝Ruby DevKit: 猛擊我下載
- 安裝Jekyll
- 安裝Python: 猛擊我下載
- 安裝Pygments </ol>
- Pygmentize中的Bug:修改如下文件 E:\Ruby192\lib\ruby\gems\1.9.1\gems\albino-1.3.3\lib\albino.rb 修改的內容參考 這里
- 由于中文XP系統使用的GBK編碼,GBK編碼導致jekyll處理的bug,修改E:\Ruby192\lib\ruby\gems\1.9.1\gems\jekyll-0.11.2\lib\jekyll\convertible.rb這個文件,修改方式 參考這里 </ol>
以下是詳細步驟:
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:
然后就可以使用Jekyll了,在生成靜態頁面的時候 可能還會出現 GBK字符不能編碼的問題,但是不影響生成網頁了。
更新
筆者最近安裝了最新版的jekyll,已經不存在需要修復兩處bug的問題了,安裝到第六步就ok了,上面提到的gbk編碼問題,可用如下方法解決,在cmd窗口輸入如下命令,臨時改變編碼。
> chcp 65001