之前興起想要紀錄自己工作的筆記,陸陸續續找了一些技術 blog 平台,ex BloggerLogdown…,發現像 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 請參閱我的令一篇文章