之前興起想要紀錄自己工作的筆記，陸陸續續找了一些技術 blog 平台，ex Blogger、 Logdown…，發現像 Blogger 並不能使用現在很潮的的 Markdown， Logdown 要 custom domain 需要付費，但覺得自己並不是很高文字量產出的作者，少少文章要用到付費功能，似乎也不太划算。後來考慮自己架，發現租vps費用也不便宜，還要還要自己負責一些主機的設定，不是很好的方案

最後決定用 GitHub Pages 的功能，原因有幾種，使用 Github 感覺很潮，身為一個工程師用個 Github 寫 blog 也是理所當然，有搜尋到幾個常見的套件，第一個就是 GitHub 官網推薦的 jeklly 以及 Octopress & Hexo 前兩是試用 Ruby 完成的套件，最後一個是 Javascript 實現的，不過最初我一直卡在 rvm 的環境一直踩雷，後來改成用 npm 非常的好使用，就決定使用 Hexo。

基本上推薦幾個必備套件:

  • hexo-deployer-git (部屬github必備)
  • hexo-generator-sitemap (產生sitemap.xml)
  • hexo-generator-feed (產生rss atom.xml)
  • hexo-generator-tag (依文章內容產生tag)
  • hexo-generator-category (依文章內容產生 category)

更多套件以及安裝使用方法都在 Hexo Plugin 請自行參閱。

大致上 Hexo 官網有非常詳盡的安裝說明，只要 npm 安裝完後就可以開始按表操課了。

在 GitHub 如果你要創建個人頁面請先建立一個一個專案名稱為 username.github.io，然後在 hexo 專案裡的 _config.yml 設定如下：

deploy:
  type: git
  repo: [email protected]:username/username.github.io.git
  branch: master
  message:

接著只要再下

hexo generate -d //產生完立即部屬

然後直接訪問 {username}.github.io 即可。

如果是要做專案頁面，設定方式稍有不同，要在專案分支(branch)，另開一個叫做 gh-pages 的分支，hexo 設定如下：

deploy:
  type: git
  repo: [email protected]:{username}/project.git
  branch: gh-pages
  message:

部屬完，訪問 {username}.github.io/project 這樣就完成了。 如果有需要 custom domain 請參閱我的令一篇文章。