Hexo Note 01:常用 Hexo 指令

單純記錄我真的有用到的 Hexo 指令,並無其他延伸用法,真要查指令 官方文件 永遠是最好的選擇,不過還是整理了些使用上遇到的問題。

初始化 blog 專案

command line tool
1
2
3
$ hexo init <folder>
$ cd <folder>
$ npm install
  1. hexo 建立專案 (一個新的網站)。

  2. 進入專案資料夾。

  3. npm 安裝必要的依賴檔案 (從 git clone 時也要記得這步)。

建立新文章

command line tool
1
$ hexo new [layout] <title>

本地預覽

command line tool
1
$ hexo clean && hexo server
  • clean:清除快取檔案 (db.json) 和已產生的靜態檔案 (public)。

  • server:啟動伺服器展示 Blog 渲染結果,預設網址http://localhost:4000/

  • 啟動伺服器後 command line 會提示需要按 Ctrl + C 結束伺服器才能繼續使用 command line:

    command line tool
    1
    2
    INFO  Start processing
    INFO Hexo is running at http://localhost:4000/ . Press Ctrl+C to stop.
  • 啟動伺服器後,有更改任何 config 時都要結束伺服器重新 clean 後再開啟不然設定不會更新;若只有更改 Markdown 檔案則不用,檔案存檔後會自動更新畫面。

註:我在 Windows 11 使用 Windows PowerShell 無法使用 && 指令,所以兩個指令需要分開下。

註:我在 Windows 11 使用 Git Bash 無法用 Ctrl + C 來結束 Server,都要用工作管理員把 Node.js JavaScript Runtime 強制結束工作。

快速部署

command line tool
1
$ hexo clean && hexo deploy

clean:清除快取檔案 (db.json) 和已產生的靜態檔案 (public),建議部屬前都清理一次。

deploy:部署 Blog 網站。

註:我在 Windows 11 使用 Windows PowerShell 無法使用 && 指令,所以兩個指令需要分開下。

結語

幾乎只會用到這四種功能的最基礎指令 XD,甚至初始化專案指令也只用了最開始的那一次。

障礙最多的反而是在 Windows 11 的 command line tool 設定,目前我還沒去研究,就是小小不方便而已,倒是使用 Mac 的 Terminal 都沒遇到問題 (真的不是要臭,純粹描述遇到的狀況)。