OS X 下使用 Jekyll 和 Coding Pages 搭建靜態博客

Jekyll 是一個免費的簡單靜態網頁生成工具，能夠配合第三方服務例如 Disqus 實現一些擴展功能，不須要數據庫支持。而且 Jekyll 能夠部署在Github 或 Coding 上，能夠綁定本身的域名，並且目前這是徹底免費的。

---

1，Git 安裝

搭建博客須要用到 git，git --version 命令可查看本機是否已安裝 git，若未安裝可參考這篇博文進行安裝。

2，安裝 Homebrew

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
複製代碼

3，Ruby 安裝/升級

brew install ruby
複製代碼

4，Gem 安裝/設置

安裝 Jekyll 須要用到包管理器 gem，gem -v 命令可查看本機是否已安裝 gem，若未安裝請自行安裝。

因爲衆所周知的緣由，國內訪問官方默認 gem sources 源速度不是十分理想，因此建議切換成國內的，利用 gem sources -l 命令可查看當前 gem sources 源：

gem sources --remove http://rubygems.org/
複製代碼

而後利用如下命令將其替換爲淘寶的（注意：這裏的 http://rubygems.org/ 替換成當前 gem sources 源地址）：

gem sources -a https://ruby.taobao.org/
複製代碼

5，安裝 Jekyll 到本地

由於打算在 Coding Pages 上搭建，根據 Coding 幫助文檔，Coding Pages 目前支持 jekyll 3.0，因此咱們須要指定版本安裝 Jekyll，終端執行如下命令：

sudo gem install jekyll -v '3.0'
複製代碼

輸入密碼後等待安裝完成，執行如下命令嘗試查看 Jekyll 版本號：

jekyll -v
複製代碼

若能正確顯示版本號 jekyll 3.0 表示安裝成功。

6，本地創建博客

從零開始手動編寫的話能夠參考：這篇博文，同時網上有大量開發者們分享的模板可供選擇使用：

Jekyll Themes

Github Jekyll Sites

本博客的搭建我選擇了在該模板的基礎上進行修改，在這裏對原做者表示感謝，🙏

在終端中切換到合適的目錄下執行如下命令：

git clone https://github.com/sl4m/skim.cc.git
複製代碼

將模板 git 倉庫下載到本地。

7，本地效果預覽

終端中用 cd 命令切換到本地博客所在目錄，即 skim.cc 目錄下，執行 jekyll server 命令啓動本地服務器，若啓動成功可在瀏覽器中訪問 http://0.0.0.0:4000/ 進行預覽。

8，上傳到 Coding Pages

在 Coding 新建一個項目，將博客所在項目 push 到新建的項目中，推薦的作法是建立一個新的 coding-pages 分支來做爲啓動 Coding Pages 之用（其餘分支名也能夠），而後切換到 Pages 標籤，開啓 pages 服務，分支名填寫爲咱們須要的分支，這裏是 coding-pages。

9，服務器效果預覽

這時 Coding 會提供一個相似 {user_name}.coding.me/{project_name} 的連接用於訪問，例如項目名爲 blog.eyrefree，則對應的訪問地址是：

eyrefree.coding.me/blog.eyrefr…

10，綁定域名

默認提供的連接可能過長或者不便於平常使用，咱們也能夠綁定本身的域名。

首先，須要提早準備一個域名，而後打開本身的域名控制面板，新建一個 CNAME 解析到 {user_name}.coding.me，例如個人是將 blog.eyrefree.org 解析到 eyrefree.coding.me；

而後，打開 Coding 項目頁面切換到 pages 項，填入剛纔的設置解析的域名 blog.eyrefree.org，點擊「添加域名綁定」按鈕便可，在瀏覽器中直接訪問 blog.eyrefree.org 就能成功打開。

有時可能因爲緩存或者解析時間的問題，稍等片刻便可。

11，編寫博文

接下來就是平常的博文編寫啦，這裏是使用 markdown 格式的，編寫完成後添加到 _posts 目錄下 push 到 Coding 服務器便可，具體可參考這篇博文。

12，備註

嘛，大概就是這些內容了，有遺漏的話後期會繼續補充，😝，個人博客在原模版基礎上將 Google 統計，Disqus 評論，feedburner 等替換爲了本身的，其餘的一些修改詳情參見個人 GitHub 倉庫的 Jekyll 分支：

github.com/EyreFree/ey…

---

若有任何知識產權、版權問題或理論錯誤，還請指正。 https://juejin.im/post/5a320fb651882534af25f83a 轉載請註明原做者及以上信息。