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 頁面 閱讀。
-
前往 http://rubyinstaller.org/downloads/
-
下載與 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.exe2.0 and 2.1 (32bits version only):
DevKit-mingw64-32-4.7.2-20130224-1151-sfx.exe2.0 and 2.1 (x64 - 64bits only)
DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe -
執行檔案選擇解壓目錄,如“D:\ToolKits\Ruby\DevKit”
-
解壓完成後,通過初始化來建立 config.yml 檔案。在命令列視窗內,輸入下列命令:
cd "D:\ToolKits\Ruby\DevKit" ruby dk.rb init notepad config.yml
-
此時已經使用記事本開啟所建立的”config.yml”檔案,於末尾新增新的一行: “- D:/ToolKits/Ruby/Ruby21-x64“,這裡的目錄為你的Ruby的安裝目錄,儲存檔案並退出。
-
回到命令列視窗內進行安裝。
ruby dk.rb install
安裝 Jekyll
-
首先確保 gem 已經正確安裝
//命令輸入 gem -v //輸出 2.2.2
-
安裝 Jekyll
//命令列執行 gem install jekyll
-
錯誤
在這裡或許你將遇到一定的問題,比如:
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。
安裝步驟演示