1. 程式人生 > >Jekyll在Windows下的安裝(不需要安裝Python)

Jekyll在Windows下的安裝(不需要安裝Python)

======================================================== 
作者:qiujuer 
部落格:blog.csdn.net/qiujuer 
網站:www.qiujuer.net 
開源庫:github.com/qiujuer/Genius-Android 
轉載請註明出處:http://blog.csdn.net/qiujuer/article/details/44620019 
——學之開源,用於開源;初學者的心態,與君共勉!

========================================================

Jekyll是一款靜態網站生成工具,允許使用者使用HTML、Markdown或Textile通過模組的方式建立所需網站,然後通過模板引擎Liquid(Liquid Templating Engine)來執行或者生成對應的靜態網站檔案. 
在GitHub上使用較多,通過GitHub搭建自己的部落格一般來說就是使用Jekyll;因為GitHub的渲染引擎預設為Jekyll。

網上很多類似的安裝教程,但是一般來說都是需要安裝Python,在本篇文章中我們不使用“Pygments”程式碼高亮引擎,所以不需要安裝Python。

安裝 Ruby

Jekyll是一款基於Ruby的外掛,安裝Ruby是必須的. 
1. 下載,傳送陣:http://rubyinstaller.org/downloads/ 
2. 點選版本並下載,這裡我下載的是:“Ruby 2.2.1 (x64)” 
3. 點選進行安裝,此時需要注意兩點: 
*安裝目錄不允許包含空格 
*選中“Add Ruby executables to your PATH”這樣將自動完成環境變數的配置。 
這裡寫圖片描述

4.完成後進入“CMD”輸入“ruby -v

”如顯示版本則代表安裝成功。

安裝 DevKit

DevKit 是一個在 Windows 上幫助簡化安裝及使用 Ruby C/C++ 擴充套件如 RDiscount 和 RedCloth 的工具箱。 
更多詳細的安裝指南請檢視Ruby的 wiki 頁面 閱讀。

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

  2. 下載與 Ruby 版本相對應的 DevKit 安裝包。 例如:“DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe” 
    版本對應關係:

    Ruby 1.8.7 and 1.9.3: 
    DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe

    2.0 and 2.1 (32bits version only): 
    DevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe

    2.0 and 2.1 (x64 - 64bits only) 
    DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe

  3. 執行檔案選擇解壓目錄,如“D:\ToolKits\Ruby\DevKit”

  4. 解壓完成後,通過初始化來建立 config.yml 檔案。在命令列視窗內,輸入下列命令:

    cd "D:\ToolKits\Ruby\DevKit"
    ruby dk.rb init
    notepad config.yml
  5. 此時已經使用記事本開啟所建立的”config.yml”檔案,於末尾新增新的一行: “- D:/ToolKits/Ruby/Ruby21-x64“,這裡的目錄為你的Ruby的安裝目錄,儲存檔案並退出。

  6. 回到命令列視窗內進行安裝。

    ruby dk.rb install

安裝 Jekyll

  1. 首先確保 gem 已經正確安裝

    //命令輸入
    gem -v
    //輸出
    2.2.2
  2. 安裝 Jekyll

    //命令列執行
    gem install jekyll
  3. 錯誤 
    在這裡或許你將遇到一定的問題,比如:

ERROR: Could not find a valid gem ‘jekyll’ (>= 0), here is why: 
Unable to download data from https://rubygems.org/ - SSL_connect returned=1 errno=0 state=SSLv3 read server certificate B: certificate verify failed (https://api.rubygems.org/latest_spece.4.8.gz)

這個錯誤的原因是因為證書問題,簡單的解決辦法為:下載最新的證書,放到指定資料夾,並配置環境變數。

下載:http://curl.haxx.se/ca/cacert.pem 
拷貝到:Ruby安裝目錄下的“bin”資料夾下 
環境變數: 
這裡寫圖片描述

至於其他錯誤,比如443錯誤,這個多訪問幾次,或者掛上VPN進行,多嘗試幾次就OK。

安裝 Rouge

一般來說靜態生成中經常會使用高亮程式碼等功能,而高亮程式碼的生成一般需要外掛幫助完成才行;在常規中一般都是使用:“Pygments”;因為”Pygments“是python下面的外掛,所以需要先安裝Python之後才能安裝該外掛,我嫌麻煩在實際使用中採用的是”Rouge“高亮外掛。 
之所以使用:”Rouge”,是因為在 Jekyll 官網中也曾提到以後將會使用該外掛。 
安裝步驟非常簡單,同樣使用命令列安裝就OK:

//命令列 Gem 安裝
gem install rouge

一般來說有一定可能會遇到伺服器沒有響應或者 443 等錯誤,這些都無需擔心,多嘗試幾次就OK。

安裝步驟演示

這裡寫圖片描述
這裡寫圖片描述
這裡寫圖片描述
這裡寫圖片描述
這裡寫圖片描述
這裡寫圖片描述
這裡寫圖片描述
這裡寫圖片描述