Windows 上安裝 Jekyll

標籤：技術分享   ogr   www   creating   one   pos   png   man   not   

 

 

 

 

 

 

目錄(?)[+]

1. 安裝 Ruby
2. 安裝 DevKit
3. 安裝 Jekyll
4. 安裝 Pygments
   1. 安裝 Python
   2. 安裝 Easy Install
   3. 安裝 Pygments
5. 啟動 Jekyll
6. 故障診斷

轉載：http://blog.csdn.net/rainloving/article/details/45745491  

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

原文連結： http://blog.csdn.net/kong5090041/article/details/38408211

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

 

共分為以下幾個重要步驟

• 安裝 Ruby
• 安裝 DevKit
• 安裝 Jekyll
• 安裝 Pygments
  • 安裝 Python
  • 安裝 ‘Easy Install’
  • 安裝 Pygments
• 啟動 Jekyll
• 故障診斷

 

安裝 Ruby

1. 前往 http://rubyinstaller.org/downloads/

2. 在 “RubyInstallers” 部分，選擇某個版本點擊下載。
   例如， Ruby 2.0.0-p451 (x64) 是適於64位 Windows 機器上的 Ruby 2.0.0 x64 安裝包。

3. 通過安裝包安裝

   • 最好保持預設的路徑 C:\Ruby200-x64， 因為安裝包明確提出 “請不要使用帶有空格的檔案夾 (如： Program Files)”。
   • 勾選 “Add Ruby executables to your PATH”，這樣執行程式會被自動添加至 PATH 而避免不必要的頭疼。

4. 開啟一個命令提示行並輸入以下命令來檢測 Ruby 是否成功安裝。

   ruby -v

   輸出樣本：

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

安裝 DevKit

DevKit 是一個在 Windows 上協助簡化安裝及使用 Ruby C/C++ 擴充如 RDiscount 和 RedCloth 的工具箱。 詳細的安裝指南可以在程式的wiki 頁面 閱讀。

1. 再次前往 http://rubyinstaller.org/downloads/

2. 下載同系統及 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

3. 運行安裝包並解壓縮至某檔案夾，如 C:\DevKit

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

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

5. 在開啟的記事本視窗中，於末尾添加新的一行 - C:\Ruby200-x64，儲存檔案並退出。

6. 回到命令列視窗內，審查（非必須）並安裝。

   ruby dk.rb review
   ruby dk.rb install

安裝 Jekyll

1. 確保 gem 已經正確安裝

   gem -v

   輸出樣本：

   2.0.14

2. 安裝 Jekyll gem

   gem install jekyll

安裝 Pygments

Jekyll 裡預設的文法高亮外掛程式是 Pygments。 它需要安裝 Python 並在網站的設定檔_config.yml 裡將 highlighter 的值設定為pygments。

不久之前，Jekyll 還添加另一個高亮引擎名為 Rouge， 儘管暫時不如 Pygments 支援那麼多的語言，但它是原生 Ruby 程式，而不需要使用 python。 更多資訊請點此關注。

安裝 Python

1. 前往 http://www.python.org/download/
2. 下載合適的 Python windows 安裝包，如 Python 2.7.6 Windows Installer。 請注意，Python 2 可能會更合適，因為暫時 Python 3 可能不會正常工作。
3. 安裝
4. 添加安裝路徑 (如： C:\Python27) 至 PATH。(如何操作? 請參見 故障診斷 #1)

5. 檢驗 Python 安裝是否成功

   python –V

   輸出樣本：

   Python 2.7.6

安裝 ‘Easy Install’

1. 瀏覽 https://pypi.python.org/pypi/setuptools#installation-instructions 來查看詳細的安裝指南。

2. 對於 Windows 7 的機器，下載 ez_setup.py 並儲存，例如，至C:\。 然後從命令列使用 Python 運行此檔案：

   python “C:\ez_setup.py”

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

安裝 Pygments

1. 確保 easy_install 已經正確安裝

   easy_install --version

   輸出樣本：

   setuptools 3.1

2. 使用 “easy_install” 來安裝 Pygments

   easy_install Pygments

啟動 Jekyll

按照官方的 Jekyll 快速開始手冊 的步驟， 一個新的 Jekyll 部落格可以被建立並在localhost:4000瀏覽。

jekyll new myblog
cd myblog
jekyll serve

故障診斷

1. 錯誤資訊：

   “python” is not recognized as an internal or external command, operable program or batch file.

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

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

   嘗試解法： 確保程式已被正確安裝。然後手動將其添加至 PATH，請參考如下步驟[1]。

   1. 按住 Win 鍵再按下 Pause
   2. 點擊 Advanced System Settings
   3. 點擊 Environment Variables
   4. 將 ;C:\python27 添加至 Path 變數的末尾
   5. 重啟命令列

2. 錯誤資訊：

   ERROR:  Error installing jekyll:ERROR: Failed to build gem native extension."C:/Program Files/Ruby/Ruby200-x64/bin/ruby.exe" extconf.rbcreating Makefilemake generating stemmer-x64-mingw32.defcompiling porter.c...make install/usr/bin/install -c -m 0755 stemmer.so C:/Program Files/Ruby/Ruby200-x64/lib/ruby/gems/2.0.0/gems/fast-stemmer-1.0.2/li/usr/bin/install: target `Files/Ruby/Ruby200-x64/lib/ruby/gems/2.0.0/gems/fast-stemmer-1.0.2/lib‘ is not a directorymake: *** [install-so] Error 1

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

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

3. 錯誤資訊：

   Generating... Liquid Exception: No such file or directory - python c:/Ruby200-x64/lib/ruby/gems/2.0.0/gems/pygments.rb-0.4.2/lib/pygments/mentos.py in 2013-04-22-yizeng-hello-world.md

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

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

4. 錯誤資訊：

   Generating... Liquid Exception: No such file or directory - /bin/sh in _posts/2013-04-22-yizeng-hello-world.md

   可能原因： 與 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

5. 錯誤資訊：

   c:/Ruby200-x64/lib/ruby/2.0.0/rubygems/dependency.rb:296:in `to_specs‘: Could not find ‘pygments.rb‘ (~> 0.4.2) - did find: [pygments.rb-0.5.0] (Gem::LoadError)from c:/Ruby200-x64/lib/ruby/2.0.0/rubygems/specification.rb:1196:in `block in activate_dependencies‘from c:/Ruby200-x64/lib/ruby/2.0.0/rubygems/specification.rb:1185:in `each‘from c:/Ruby200-x64/lib/ruby/2.0.0/rubygems/specification.rb:1185:in `activate_dependencies‘from c:/Ruby200-x64/lib/ruby/2.0.0/rubygems/specification.rb:1167:in `activate‘from c:/Ruby200-x64/lib/ruby/2.0.0/rubygems/core_ext/kernel_gem.rb:48:in`gem‘from c:/Ruby200-x64/bin/jekyll:22:in `<main>‘`

   可能原因：如錯誤資訊所述，找不到 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”

6. 錯誤資訊：

   Generating... You are missing a library required for Markdown. Please run:$ [sudo] gem install rdiscountConversion error: There was an error converting ‘_posts/2013-04-22-yizeng-hello-world.md/#excerpt‘.ERROR: YOUR SITE COULD NOT BE BUILT:   ------------------------------------   Missing dependency: rdiscount

   可能原因： 依賴包 rdiscount 未找到。 此問題最有可能的原因是，網站使用的是 rdiscount 作為 Markdown 引擎，而不是 Jekyll 預設的引擎，故需要手動自行安裝。

   嘗試解法：

   gem install rdiscount

7. 錯誤資訊：

   c:/Ruby200-x64/lib/ruby/site_ruby/2.0.0/rubygems/core_ext/kernel_require.rb:55:in `require‘: cannot load such file -- wdm (LoadError)from c:/Ruby200-x64/lib/ruby/site_ruby/2.0.0/rubygems/core_ext/kernel_require.rb:55:in `require‘from c:/Ruby200-x64/lib/ruby/gems/2.0.0/gems/listen-1.3.1/lib/listen/adapter.rb:207:in `load_dependent_adapter‘from c:/Ruby200-x64/lib/ruby/gems/2.0.0/gems/listen-1.3.1/lib/listen/adapters/windows.rb:33:in `load_dependent_adapter‘...

   可能原因： wdm gem 未被安裝。因為 Jekyll 只官方地支援 *nix 系統，所以 Windows Directory Monitor 並沒有作為依賴包而被自動安裝。

   嘗試解法：

   gem install wdm

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

Windows 上安裝 Jekyll