搭建ruby + jekyll + github pages

       端午節，花了2天時間學習了下ruby + jekyll + github pages，踩過不少坑，記錄下學習筆記。

       ruby建議是在linux環境下安裝的，但是工作電腦是windows比較常見，下面記錄下在windows 7 64bit版本下安裝ruby + jekyll + ruby devkit的經歷，進過坑，不過都爬出來了，把爬坑經歷記錄下方便後來者。

       搭建環境：  windows 7 64bit電腦舉例

       步驟一：下載ruby x64、ruby devkit x64、python 2.7 x64，ruby建議用2.3.3，親測2.4.1有插件不支持，2.4.1纔出不久，插件未經考驗，python不強求2.7版本，只是個人習慣用這個版本了，ruby devkit可以用最新版本，下載地址：https://rubyinstaller.org/downloads/

       

         步驟二：下載python2.7，下載地址：https://www.python.org/downloads/release/python-2713/

步驟三：下載ruby SSL證書文件，下載地址：http://curl.haxx.se/ca/cacert.pem，該證書文件待用。

         步驟四：下載Git x64安裝包，下載地址：https://git-scm.com/download/win，下載windows setup即可。

       

下載完成後，開始安裝並配置環境變量，雖然安裝選項中會有是否配置環境變量提示，但是仍然是習慣自己配置環境變量。

         1、安裝python，D:\新建PYTHON_HOME，把python27安裝到D:\PYTHON_HOME\Python27下，具體過程不一一詳細講解，需要excuteInstall功能

         2、安裝ruby dev kit，D:\新建RubyDevKit，把DevKit解壓到D:\RubyDevKit\下，具體操作不一一詳細講解，因windows環境沒有linux命令，所以需要這個工具包增加操作命令。

         3、安裝ruby，在上一環節的D:\RubyDevKit\新建Ruby目錄，把ruby安裝到這個目錄下。

         安裝完ruby dev  kit和ruby後，需要執行如下安裝操作：

         cd D:\RubyDevKit

         創建config.yml配置文件，初始化init，編輯config.yml添加上ruby的安裝目錄，然後review添加結果，最後執行install，沒報錯表示配置成功。

         

        

        4、放置ruby SSL證書文件到D:\RubyDevKit\Ruby\ Ruby23-x64\bin目錄下，最後開始設置環境變量

          

          5、安裝Git，直接保持默認值，一路安裝完成，注意設置環境變量時要勾選設置Path。

        

        安裝完成後，開始下一步配置環境變量：

        系統 - 高級系統設置 - 環境變量，新增RUBY_HOME，值爲D:\RubyDevKit\Ruby\Ruby23-x64，繼續新增PYTHON_HOME，值爲：D:\PYTHON_HOME\Python27，繼續新增SSL_CERT_FILE，值爲D:\RubyDevKit\Ruby\ Ruby23-x64\bin\cacert.pem。

        

          

開始校驗下安裝和環境變量配置是否正確：

校驗無誤後，開始進行jekyll安裝，

執行命令：

安裝bundler

>gem install bundler

安裝jekyll

>gem install jekyll

安裝完成後，可以創建自己的blog目錄 -這裏以test名稱舉例截圖

>jekyll new myBlog

>cd myBlog

>jekyll s

看到如下信息表示一個初步的靜態blog系統搭建好

中途可能會碰到4000端口被佔用情況，可以cmd進去後執行netstat -ano找到佔用4000端口的pid，然後進系統進程找到對應的pid，看是哪個服務進程，可以關閉，

比如我的電腦因爲安裝了Foxit pdf，佔用了4000，可以關閉這個無用的Foxit service。

如果沒碰到4000端口占用問題，可以不理會上面的端口衝突關閉其他4000佔用進程步驟，開始進一步的完善jekyll，先查看啓動的服務界面。在瀏覽器輸入

http://127.0.0.1:4000，可以看到如下界面，表示jekyll服務初步成功

這個只是demo，jekyll如果只是這麼點功能，那就不推薦了，jekyll的好處就是模板多，我們可以去github上找更多精美的模板，進行二次開發。模板

地址：http://jekyllthemes.org/，如下圖，有很多精美模板可供參考：

還可以下載我的個人https://github.com/anTtutu/anTtutu.github.io，我的這個也是在別人的基礎上修改而來，所以下載模板進行二次開發最便捷的手段，省去美化的時間。

那麼，使用他人的模板，插件庫可能不一致，導致的問題有很多

首先，使用git命令下載模板庫後，進入對方的模板庫目錄

>git clone https://github.com/anTtutu/anTtutu.github.io -- 截圖以anttu工程名爲例

>cd anTtutu.github.io

安裝模板依賴的插件

>bundle install

 

更新模板依賴的插件

>bundle update

      

       下載好模板和插件後，可以切換到模板目錄再次jekyll s啓動模板的工程。

       >cd F:\testWorksapce\anttu   

       >jekyll s   

       檢查如同demo  myBlog那個啓動成功沒錯誤提示表示OK了。可以愉快的去修改、試用模板了。

       模板的語法是用ruby + markdown寫的，這點對於有開發基礎的人來說不是問題。

      Tips：

      中間會碰到問題gem安裝或者bundle install提示如下信息：

C:\Users\test>gem install watir
ERROR:  Error installing watir:
        The 'ffi' native gem requires installed build tools.

Please update your PATH to include build tools or download the DevKit
from 'http://rubyinstaller.org/downloads' and follow the instructions

      解決步驟和命令如下：修復RubyDevKit的dk.rb初始化和安裝

D:\RubyDevKit>ruby dk.rb init
[INFO] found RubyInstaller v1.9.3 at C:/Ruby193

Initialization complete! Please review and modify the auto-ge
'config.yml' file to ensure it contains the root directories
of the installed Rubies you want enhanced by the DevKit.

 

D:\RubyDevKit>ruby dk.rb install
[INFO] Updating convenience notice gem override for 'C:/Ruby1
[INFO] Installing 'C:/Ruby193/lib/ruby/site_ruby/devkit.rb'

 

D:\RubyDevKit>gem install rdiscount --platform=ruby
Fetching: rdiscount-1.6.8.gem (100%)
Temporarily enhancing PATH to include DevKit...
Building native extensions.  This could take a while...
Successfully installed rdiscount-1.6.8
1 gem installed
Installing ri documentation for rdiscount-1.6.8...
Installing RDoc documentation for rdiscount-1.6.8...

at 'http://github.com/oneclick/rubyinstaller/wiki/Development-Kit'