作業系統: 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教學,有空會再補充一些細節~