Mac下搭建jekyll環境

最近開始使用github pages來管理自己Blog的靜態DEMO，發現的確很方便，並且還順帶了DEMO的版本管理。可惜我對jekyll、liquid都不熟，每次都ci到github后再預覽十分不便，遂決定搭建一個本地的jekyll環境，以便調試和學習之用。

1、安裝/升級本地ruby

安裝rvm

可以先 ruby -v 查看下本地ruby版本號，如果是1.9.2以上的直接跳過該步。由於gem安裝jekyll需要ruby 1.9.2以上版本，現在官方推薦的是1.9.3，而mac自帶的ruby為1.8.6，所以需要先升級本地的ruby，否則在安裝的時候會出現類似“instance of Date needs to have method `marshal_load'”的報錯。

網上不少人使用源碼安裝來替換本地ruby，其實用rvm來管理多版本ruby是更安全、方便的方案。rvm的安裝比較簡單：

 

$ curl -L https://get.rvm.io | bash -s stable

 

安裝好rvm后需要按照提示 source ~/.bash_profile 將rvm添加到環境變量中。

卸載macports

在正式安裝ruby前還需要確保你本地沒有安裝macports，由於rvm會通過homebrew來安裝ruby，而homebrew與macports存在兼容性問題，如果不刪除macports會導致安裝失敗。刪除macports有一定風險，請先自行 cd /opt/local 確認軟件均可刪除。

 

$ sudo port -f uninstall installed
$ sudo rm -rf /opt/local ~/.macports

 

安裝ruby

 

接下來可以正式安裝ruby了，這里可以先通過 rvm use 命令來獲取詳細的版本號，安裝過程可參考以下代碼：

 

$ rvm use 1.9.3
ruby-1.9.3-p392 is not installed.
To install do: 'rvm install ruby-1.9.3-p392'
$ rvm install ruby-1.9.3-p392

大概N分鍾之后，ruby 以及 homebrew即可安裝完成，且自動切換到最新版ruby。

 

2、安裝jekyll

更換gem source

據說gem source會被牆，所以在正式安裝jekyll之前可以先換成淘寶的鏡像。

 

$ gem sources -l
$ gem sources --remove https://rubygems.org/
$ gem sources -a http://ruby.taobao.org/

安裝jekyll

$ gem install jekyll

 

安裝完成后，cd到項目根目錄，使用以下命令即可運行jekyll環境，通過 localhost:4000 即可訪問。

$ jekyll --server

接下來就可以開始 github pages之路了～

補充：windows類似以下 GBK報錯解決方案，請參考這里的修改解決： https://github.com/imathis/octopress/issues/232#issuecomment-2480736

Error reading file F:/github.com/kaiye.github.com/index.html: invalid byte sequence in GBK

 Liquid Exception: invalid byte sequence in GBK in alpha-layer.html
error: invalid byte sequence in GBK. Use --trace to view backtrace

參考資料

 

• http://beiyuu.com/github-pages/