Windows 上安裝 Jekyll

Jekyll是一個靜态網站生成工具。它允許使用者使用HTML、Markdown或Textile來建立靜态頁面，然後通過模闆引擎Liquid（Liquid Templating Engine）來運作.

目前，網上有許多Jekyll的安裝方法，大都相似，為了友善更多準備學習Jekyll的人，特翻譯如下：

共分為以下幾個重要步驟

安裝 Ruby

安裝 DevKit

安裝 Jekyll

安裝 Pygments

安裝 Python

安裝 ‘Easy Install’

啟動 Jekyll

故障診斷

在 “RubyInstallers” 部分，選擇某個版本點選下載下傳。

例如， Ruby 2.0.0-p451 (x64) 是适于64位 Windows 機器上的 Ruby 2.0.0 x64 安裝包。

通過安裝包安裝

最好保持預設的路徑 <code>C:\Ruby200-x64</code>， 因為安裝包明确提出 “請不要使用帶有空格的檔案夾 (如： Program Files)”。

勾選 “Add Ruby executables to your PATH”，這樣執行程式會被自動添加至 PATH 而避免不必要的頭疼。

打開一個指令提示行并輸入以下指令來檢測 Ruby 是否成功安裝。

ruby -v

輸出示例：

ruby 2.0.0p451 (2014-02-24) [x64-mingw32]

下載下傳同系統及 Ruby 版本相對應的 DevKit 安裝包。 例如，DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe 适用于64位 Windows 系統上的 Ruby 2.0.0 x64。

下面列出了如何選擇正确的 DevKit 版本：

Ruby 1.8.6 to 1.9.3: DevKit tdm-32-4.5.2 Ruby 2.0.0: DevKit mingw64-32-4.7.2 Ruby 2.0.0 x64: DevKit mingw64-64-4.7.2

運作安裝包并解壓縮至某檔案夾，如 C:\DevKit

通過初始化來建立 config.yml 檔案。在指令行視窗内，輸入下列指令：

cd “C:\DevKit” ruby dk.rb init notepad config.yml

在打開的記事本視窗中，于末尾添加新的一行 <code>- C:\Ruby200-x64</code>，儲存檔案并退出。

回到指令行視窗内，審查（非必須）并安裝。

ruby dk.rb review ruby dk.rb install

確定 gem 已經正确安裝

gem -v

2.0.14

安裝 Jekyll gem

gem install jekyll

下載下傳合适的 Python windows 安裝包，如 Python 2.7.6 Windows Installer。 請注意，Python 2 可能會更合适，因為暫時 Python 3 可能不會正常工作。

安裝

檢驗 Python 安裝是否成功

python –V

Python 2.7.6

python “C:\ez_setup.py”

添加 ‘Python Scripts’ 路徑 (如： C:\Python27\Scripts) 至 PATH

確定 easy_install 已經正确安裝

easy_install --version

setuptools 3.1

使用 “easy_install” 來安裝 Pygments

easy_install Pygments

jekyll new myblog cd myblog jekyll serve

錯誤資訊：

其他情況： 這裡的 “python” 也可能是 “ruby”， “gem” 或是 “easy_install” 等。

可能原因： 該程式可能未被正确地安裝或未在 PATH 裡設定成功。

按住 Win 鍵再按下 Pause 點選 Advanced System Settings 點選 Environment Variables 将 ;C:\python27 添加至 Path 變量的末尾 重新開機指令行

可能原因： Ruby 被安裝在含有空格的路徑裡。

嘗試解法： 重新安裝 Ruby，這次請不要使用帶有空格的路徑，或者請直接選擇使用預設路徑。

可能原因： Pygments 未能被正确安裝或是 PATH 設定尚未生效。

嘗試解法： 首先請確定 Pygments 已成功安裝且 Python 的 PATH 設定正确未包含空格和最後多餘的斜杠。 然後重新開機指令行。如果依舊失敗，請嘗試登出并重新登入 Windows。 甚至使用終極解法，重新開機電腦。

可能原因： 與 pygments.rb 0.5.1/0.5.2 版本的相容性問題。

嘗試解法： 将 pygments.rb gem 的版本從 0.5.1/0.5.2 降至 0.5.0。

gem uninstall pygments.rb –version ‘=0.5.2’ gem install pygments.rb –version 0.5.0

可能原因：如錯誤資訊所述，找不到 pygments.rb 0.4.2，僅找到 pygments.rb 0.5.0。 （此問題出現于此文初稿時的 Jekyll 版本，現版本應已修複）

嘗試解法： 将 pygments.rb gem 的版本降級至 0.4.2

gem uninstall pygments.rb –version “=0.5.0” gem install pygments.rb –version “=0.4.2”

嘗試解法：

gem install rdiscount

gem install wdm

8.為了能夠讓這裡網站正常運作，這裡需要删除_post檔案夾裡的檔案（應該有一個xxxx-xx-xx-welcome-to- jekyll.markdown字樣的檔案），因為這個檔案内部使用了文法高亮插件（另外不删，則可以修改配置檔案禁用該文法高亮插件，即修改根目錄下 _config.yml中的pygments: true為false便可。），這個需要另外安裝，不再本文範圍内，不删會導緻生成的靜态頁面有問題，因時間有限本文暫不提此問題。