Hexo quick setup

什麼是 Hexo？

---

以下引自官網 : Hexo 是一個快速、簡單且強大的網誌框架。Hexo 使用 Markdown（或其他渲染引擎）解析您的文章，並在幾秒鐘內，透過漂亮的主題產生靜態檔案。

雖然過程真的很簡明，但年紀大了記不住事，步驟加減記錄

安裝

---

在有已安裝好 Node 及 git 的情況下， Hexo 的安裝及設定是很簡單的，若本機上尚未安裝 Node / git ，請參考官網的設定

$ npm install hexo-cli -g
$ mkdir ~/Documents/blog
$ hexo init ~/Documents/blog
$ cd ~/Documents/blog
$ npm install

打完，收工。

它內建簡單的 web server，具 auto reload 的功能，作為預覽文件還不錯用，開啟方式如下

$ hexo server

若啟動過程沒有錯誤，透過瀏覽器開啟 http://localhost:4000 就可以看到基本樣貌了

設定

---

設定檔的詳細說明請參考 https://hexo.io/zh-tw/docs/configuration.html

以下是簡單的範例 (未列出的部份是不想管的)

# 基本設定 title: The Moment subtitle: 阿宅的筆記 description: 溢出的腦漿暫存區 author: Yu-Wen Huang language: zh-tw timezone: Asia/Taipei

# 未來網頁放置於 github.io 上 url: http://napmas.github.io

# 中英文間自動加入空白 auto_spacing: true

# Theme theme: bootstrap-blog

# 佈置設定 deploy: type: git repo: git@github.com:napmas/napmas.github.io.git branch: master

改完設定檔記得重啟 server 才會生效。

網站樣式/主題

---

都要當阿宅了，就不打算下來改 CSS 了， 在 https://hexo.io/themes/ 挑一個喜歡的， git clone 到 ~/Documents/blog/themes 下，依網址上的指示安裝必要的檔案，然後將 _config.yml 的 theme 參數指定為你要的theme的目錄名稱即可

p.s 預設為 landscape p.s 多數的 theme 的 github 頁面有含安裝的詳細說明

佈署

---

由於這個網站主要想放技術類的筆記，放到 github 似乎是一個好選擇。

預先準備

1. 先建立repository，如果帳號名稱叫 abc ，那 repository 名稱就叫abc.github.io
2. 修改 ~/Documents/blog/_config.yml 裡的 deploy 參數 (參考上面設定)
3. 到 github 個人設定的 Setting 中設定 SSH KEY 好一鍵佈署不用再跟你問密碼
4. 在 ~/Document/blog 下執行 npm install hexo-deployer-git --save

發佈

1. 執行hexo g，把 markdown 文件轉成你要發佈的靜態文件並放到 public 目錄下
2. 執行 hexo d 把 public 目錄 push 到 github 上

其他

---

想幹掉舊文章 (eg. 預設的 hellow-world.md)，只要把 source 下對應的文章砍掉即可

花在學 markdown 的時間還比安裝的時間多五、六倍 orz XD XD