Transform your plain text into static websites and blogs.
Jekyll 是一個(gè)簡(jiǎn)單的免費(fèi)的 Blog 生成工具，類似 WordPress诫睬。但是和 WordPress 又有很大的不同急鳄，原因是 Jekyll 只是一個(gè)生成靜態(tài)網(wǎng)頁(yè)的工具聪轿，不需要數(shù)據(jù)庫(kù)支持壹粟。Jekyll 可以免費(fèi)部署在 Github 上热押，而且可以綁定自己的域名斗这。
Jekyll 可以使用 .html碌补、.md虏束、.sass 文件進(jìn)行維護(hù)，和其他類似的應(yīng)用一樣厦章，它也需要運(yùn)行在一個(gè)環(huán)境下镇匀，其訪問(wèn)地址如：http://127.0.0.1:4000。
官方文檔提供了安裝教程袜啃，簡(jiǎn)單的不能再簡(jiǎn)單汗侵，每一行都會(huì)有幾個(gè)坑，筆者最近配置的時(shí)候遇到了這些問(wèn)題群发，所以撰寫(xiě)本文做個(gè)記錄晰韵。
先看官方的安裝教程：
- Install a full Ruby development environment
- Install Jekyll and bundler gems
gem install jekyll bundler
- Create a new Jekyll site at
./myblogjekyll new myblog
- Change into your new directory
cd myblog
- Build the site and make it available on a local server
bundle exec jekyll serve
- Now browse to http://localhost:4000
教程說(shuō)的清楚，安裝 Jekyll 需要 Ruby 環(huán)境支持熟妓，Mac 系統(tǒng)是自帶了 Ruby 環(huán)境的雪猪。目前的 Jekyll 需要 Ruby 2.2.5+，終端中使用 ruby -v 可以查看當(dāng)前 Ruby 版本起愈。
除了 Ruby浪蹂，還需要 RubyGems，RubyGems（簡(jiǎn)稱 gems）是一個(gè)用于對(duì) Ruby 組件進(jìn)行打包的 Ruby 打包模塊告材。 它提供一個(gè)分發(fā) Ruby 程序和庫(kù)的標(biāo)準(zhǔn)格式，還提供一個(gè)管理程序包安裝的工具古劲。如果已安裝該模塊斥赋，終端中輸入 gem -v 可以查看其版本。
另外产艾，還需要 GCC 和 Make 支持疤剑，這一般是系統(tǒng)自帶的，可通過(guò) gcc -v闷堡、g++ -v 和 make -v 查看其版本隘膘。
最后，還需要安裝 command-line tools（命令行工具）才能編譯擴(kuò)展（native extensions）,執(zhí)行 xcode-select --install 可開(kāi)始安裝（還需要安裝 XCode 哦~）杠览，這里的 command-line tools 單個(gè)大概有 700Mb+弯菊。
確認(rèn)上述的環(huán)境都配置正確后，就可以開(kāi)始使用 gem 安裝 Jekyll 了踱阿，終端中執(zhí)行 gem install jekyll bundler 開(kāi)始安裝管钳。安裝完成后可輸入 bundler -v 和 jekyll -v 查看其版本钦铁。
但需要注意，bundler 可能比較順利就安裝完成了才漆，Jekyll 則可能出現(xiàn)無(wú)法安裝的問(wèn)題牛曹，這其中有分為大致兩種情況：
一是提示 /usr/bin 無(wú)權(quán)限，或者 /Library/Ruby/Gems/2.3.0/ 無(wú)權(quán)限醇滥，這個(gè)需要用到 rootless 機(jī)制（默認(rèn)開(kāi)啟）去解鎖黎比，單純使用 sudo 是無(wú)法解決問(wèn)題的。
Rootless 關(guān)閉與開(kāi)啟
同時(shí)按住
Command + R重啟電腦鸳玩，直到看到進(jìn)度條松開(kāi)鍵盤阅虫，即可進(jìn)入恢復(fù)分區(qū)（類似安裝界面）。然后在 【實(shí)用工具】找到 【終端】啟動(dòng)運(yùn)行怀喉，可輸入csrutil status查看其狀態(tài)书妻，輸入csrutil disable; reboot可禁用 Rootless 并重啟電腦，輸入csrutil enable; reboot啟用 Rootless 并重啟電腦躬拢。蘋果從 OS X El Capitan 10.11 系統(tǒng)開(kāi)始使用了 Rootless 機(jī)制躲履，可以將該機(jī)制理解為一個(gè)更高等級(jí)的系統(tǒng)的內(nèi)核保護(hù)措施，系統(tǒng)默認(rèn)將會(huì)鎖定
/system聊闯、/sbin工猜、/usr這三個(gè)目錄，通常建議啟用 Rootless菱蔬。
操作的時(shí)候要小心篷帅，禁用 Rootless 后，登錄的用戶就擁有了比較高級(jí)的操作權(quán)限拴泌，在操作終端時(shí)可能會(huì)出現(xiàn)錯(cuò)誤魏身，例如，打開(kāi)終端顯示【進(jìn)程已完成】蚪腐，終端無(wú)法操作（修正 Shell 打開(kāi)方式箭昵、檢測(cè)磁盤權(quán)限、重啟電腦等均無(wú)效回季，"知乎"上提到的更新系統(tǒng)不必嘗試的）家制，筆者的操作系統(tǒng)是 macOS High Sierra 10.13.6，出現(xiàn)上述問(wèn)題后泡一，經(jīng)網(wǎng)友提示和仔細(xì)排查颤殴，發(fā)現(xiàn)在 /usr/bin 下面多了一個(gè) login 腳本（網(wǎng)上說(shuō)有個(gè) login 的目錄，亦或是網(wǎng)友打錯(cuò)了鼻忠，命令 = 目錄 = ml）涵但，重命名或刪除之，重新開(kāi)啟終端問(wèn)題解決。
另一個(gè)問(wèn)題是贤笆，可能會(huì)提示 Failed to build gem native extension.蝇棉，這個(gè)可通過(guò)安裝上面提到的 command-line tools 解決。
安裝完成后芥永，可參考官方教材 和 Jetyll 命令篡殷，創(chuàng)建項(xiàng)目。
# 創(chuàng)建項(xiàng)目埋涧，請(qǐng)這樣創(chuàng)建板辽，否則會(huì)缺少很多問(wèn)題，如 Gemfile
$ jekyll new myblog
# 進(jìn)入項(xiàng)目
$ cd myblog
# 運(yùn)行項(xiàng)目
$ bundle exec jekyll serve
參考資料
- Jekyll 官網(wǎng)
- Jekyll 主題模板
- 怎么用jekyll + GitPage 搭建自己的Blog 作者：貓那個(gè)咪個(gè)喵 來(lái)源：簡(jiǎn)書(shū)
