次世代 Hugo

無駄を削ぎ、本質を研ぐ

Hugo 常用的 NPM Script

Sam Xiao's Avatar 2025-08-19

Hugo 有一些參數特別適合 開發編譯 時使用,可將最 常用 參數直接寫在 NPM Script。

Version

Hugo 0.148.2

NPM Script

{
  "name": "hugo-theme",
  "version": "1.0.0",
  "license": "MIT",
  "scripts": {
    "dev": "hugo server --disableFastRender --renderToMemory",
    "build": "hugo --cleanDestinationDir --minify",
    "serve": "npx serve public"
  }
}

Line 6

"dev": "hugo server --disableFastRender --renderToMemory",

開發用 script:

  • disableFastRender:在 開發 時,修改 Partial、Layout、Front Matter 都會重新 render
  • renderToMemory:在 開發 時,HTML/CSS/JavaScript 將渲染到 記憶體,而非 public 目錄下加速

Line 7

"build": "hugo --cleanDestinationDir --minify"

編譯用 script:

  • cleanDestinationDir:在 編譯 前先刪除 public 目錄
  • minify:在 編譯 時將 HTML/CSS/JavaScript 加以壓縮

Line 8

"serve": "npx serve public"

顯示編譯過的網站:

  • npx:類似 npx 一次性執行 serve,不必手動安裝到 global
  • serve public:使用 serve web server 執行 public 目錄下的 HTML/CSS/JavaScript

Conclusion

  • NPM Script 適合參數不多,若參數過多就必須使用 Bash Script
  • 雖然本文僅列少數參數,但基本上 開發編譯 也都夠用