最近開始使用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

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

參考資料

?

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

?

?

轉載于:https://www.cnblogs.com/kaiye/archive/2013/04/24/3039345.html

總結

以上是生活随笔為你收集整理的Mac下搭建jekyll环境的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。