Windows 上安裝 Jekyll

 

 

 

 

 

 

目錄(?)[+]

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.rb
   
   creating Makefile
   make generating stemmer-x64-mingw32.def
   compiling 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 directory
   make: *** [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 rdiscount
   Conversion 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_a
   dapter'
   ...

   可能緣由： wdm gem 未被安裝。由於 Jekyll 只官方地支持 *nix 系統，因此 Windows Directory Monitor 並無做爲依賴包而被自動安裝。

   嘗試解法：

   gem install wdm

8.爲了可以讓這裏網站正常運行，這裏須要刪除_post文件夾裏的文件（應該有一個xxxx-xx-xx-welcome-to- jekyll.markdown字樣的文件），由於這個文件內部使用了語法高亮插件（另外不刪，則能夠修改配置文件禁用該語法高亮插件，即修改根目錄下 _config.yml中的pygments: true爲false即可。），這個須要另外安裝，再也不本文範圍內，不刪會致使生成的靜態頁面有問題，因時間有限本文暫不提此問題。