前言：

今天五一假期最後一天，趁著放假，搭建一個個人部落格。之前就聽說了GitHub Pages + Jekyll來搭建，今天想都不想其他的實現方式直接就使用這兩個搭建。

關於這方面的文章很多，網上查一下一大堆，這篇文章就整理一下搭建的步驟和過程，以及遇到的問題。
之前覺得挺簡單的，自己搞了一下，真是各種問題。真的是 紙上得來終覺淺，絕知此事要躬行。

1. 安裝Jekyll環境

1-1 安裝ruby環境

mac下自帶ruby 2.0.0，可用命令列檢視：

  ruby --version

1-2 安裝 bundler

雖然不知道這是個什麼玩意，但是按照官方文件說的來吧。

 gem install bundler

直接這樣在命令列中輸入會出錯，因為牆和許可權問題，解決方法：

1. 使用homebrew再安裝一個ruby。
   因為在Mac OSX下自帶的ruby是系統的，使用映象後 gem intall bundler會發現沒有許可權，使用 sudo 也可以，但是不好，所以重新安裝一個自己的ruby吧。
   更多請參考 Mac OS X 下使用 Ruby Gem 的兩個坑。

2. 使用淘寶映象
   安裝完ruby後發現ruby的version為 2.3.0了。然後再次gem install bundler 時就會有牆的問題。所以按照 淘寶映象 修改mirror，以後使用就方便很多。

1-3 確認是否安裝成功

命令列中輸入：

jekyll -v

檢視是否安裝成功，當前版本為 3.0.5。

2. 建立GitHub倉庫

參考 官方文件 上建立倉庫，注意你的repo的name必須為 yourUsername.github.io

建立完後並克隆到本地，接下來配置主題。

3. 配置主題

1. 第一步：
   在 Jekyll Themes 中選一個自己看好的，下載到本地，將其內所有檔案複製到 repo中(第二步克隆到本地的檔案)。

2. 第二步：
   當前我使用的是 pithy 主題。在選主題時要注意不要太久遠了。之前用了一個13年的，各種版本更新不適配。

3. 第三步：
   放進去後，使用命令列 bundle install

   更新一些檔案

4. 第四步：
   命令列輸入 bundle exec jekyll serve 開啟本地伺服器，在瀏覽器中輸入網址： http://127.0.0.1:4000/ 就可以在本地檢視自己的部落格了。此時可以進行一些配置，比如對 _config.xml 的檔案修改等。

至此，就可以看到剛配置好的部落格在本地顯示的樣子了。接下來就是推送到遠端。

4. 推送到遠端

1. 新增.gitignore 檔案
   預設的Jekyll專案沒有新增.gitignore檔案。必須要手動新增。
   新增一下內容，其中 .DS_Store是Mac OSX的桌面檔案：

   _site/
   .sass-cache/
   .jekyll-metadata
   .DS_Store 
   

2. 使用git操作推送到遠端，即你的github倉庫上。

3. 過幾分鐘左右，在瀏覽器輸入網址 yourUsername.github.io 就可以看到你自己的個人部落格網站啦。在_post 檔案下可以建立 xxx.markdown 檔案進行部落格書寫。

結語：

使用 Jekyll 來對部落格進行操作，剛剛接觸，對該專案、專案結構、檔案組織等都不是很清晰，不是很會使用。目前僅僅搭建了一個能看的網頁而已，還有很多東西要學呀。嘿嘿。

善用工具吧，騷年。去嘗試，去面對，去努力。