Windows下安裝Ruby和Jekyll
作者: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 頁面 閱讀。
-
下載與 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錯誤,這個多訪問幾次,或者掛上V*N進行,多嘗試幾次就OK。
安裝 Rouge
一般來說靜態生成中經常會使用高亮代碼等功能,而高亮代碼的生成一般需要插件幫助完成才行;在常規中一般都是使用:“Pygments”;因為”Pygments“是python下面的插件,所以需要先安裝Python之后才能安裝該插件,我嫌麻煩在實際使用中采用的是”Rouge“高亮插件。
之所以使用:”Rouge”,是因為在 Jekyll 官網中也曾提到以后將會使用該插件。
安裝步驟非常簡單,同樣使用命令行安裝就OK:
//命令行 Gem 安裝 gem install rouge
一般來說有一定可能會遇到服務器沒有響應或者 443 等錯誤,這些都無需擔心,多嘗試幾次就OK。
安裝步驟演示