作業系統: Windows10、編輯器: Visual Studio Code
建立環境
1.安裝 Node.js
要安裝Node.js是因為Hexo是基於Node.js開發的
(建議下載LTS版本較為穩定)

2.安裝 Git
後續的自動化部署會用到

3.確認成功安裝
在cmd裡依序輸入以下指令:
1 | node -v |
(ps. 安裝node.js的同時,也會安裝npm)

都能正確顯示版本的話即代表安裝成功~
4.安裝Hexo
1 | npm install -g hexo-cli |

5.確認成功安裝Hexo
1 | hexo -v |

到這邊環境安裝就結束了~
建立 Hexo 專案
在想建立 Hexo專案的路徑下輸入以下指令即可建立Hexo專案
1 | hexo init [資料夾名稱] |


建立文章
所有文章都是以Markdown撰寫~
請在專案路徑下開啟cmd並輸入:
1 | hexo new '文章名稱' |

建立的文章被放在source\_posts資料夾裡面

預設內容如下:

產生靜態檔案
記得切到專案路徑底下再輸入!
1 | hexo generate |

靜態檔案會被放在public資料夾中,放在裡面的東西就是我們實際上的部落格內容


開啟測試伺服器
輸入以下指令可開啟測試伺服器並檢視部落格:
1 | hexo server |


清除暫存檔案
輸入以下指令,可以解決一些奇怪的問題:
1 | hexo clean |
主要是用來清除快取檔案 (db.json) 以及編譯檔案 (public):

部署靜態檔案
輸入以下指令,可以將部落格自動部屬或更新到特定的遠端數據庫:
1 | hexo deploy |
在輸入指令前,要先做一些設定,以部署到github為例:
1.建立數據庫

2.安裝部署套件
輸入以下指令:
1 | npm install --save hexo-deployer-git |

3.修改hexo/_config.yml
把url改成自己建立的git page網址:

deploy區塊修改方式如下:

4.部屬到github
1 | hexo generate |


ps.可能會需要驗證帳號,有多個帳號記得切,參考此篇


重新整理後,可以在數據庫看到部署的東西

5.設定 git page

6.檢視部落格
從git page的網址進入部落格:

更新部落格
要更新部落格的文章可以直接修改對應的.md檔案,或新增新文章後編輯
編輯完後依序輸入以下指令即可:
1 | hexo generate |
以上就是簡明版的Hexo教學,有空會再補充一些細節~