產品說明

Hugo 是一款以 Go 語言 (Golang) 撰寫的開源靜態網站產生器 (Static Site Generator, SSG)。它的最大賣點在於「速度」—— 能夠在幾毫秒內生成一個頁面，即使是擁有數千頁面的大型網站，也能在幾秒鐘內完成建置。這解決了傳統動態 CMS (如 WordPress) 效能低落與安全性維護不易的問題，同時也比其他腳本語言開發的 SSG (如 Jekyll、Hexo) 快上數十倍。

Hugo 採用單一執行檔 (Single Binary) 發布，這意味著使用者無需安裝複雜的相依套件 (如 Ruby Gems 或 npm modules) 即可開始使用，大幅降低了環境配置的門檻。它原生支援 Markdown 語法，並提供強大的樣板引擎 (Templating) 與短代碼 (Shortcodes) 功能，非常適合用於建立個人部落格、技術文件、公司形象網站或作品集。

核心特色：

極致效能：基於 Go 語言的高並發特性，擁有目前市面上最快的建置速度與即時預覽 (LiveReload) 反應。
單一執行檔：下載即用，跨平台支援度極佳 (Windows/macOS/Linux)，無需煩惱環境相依性地獄。
靈活強大：內建豐富的函式庫，支援多語系 (i18n)、圖片自動處理 (裁切、縮放)、Sass/SCSS 編譯等功能。
內容管理：強大的分類法 (Taxonomies) 與內容類型 (Content Types) 支援，能輕鬆組織複雜的網站結構。
豐富生態：擁有龐大的社群與數百種現成的主題 (Themes)，可快速套用並客製化。

常用指令與操作

Hugo 的操作主要透過命令列介面 (CLI) 進行。其指令設計簡潔明瞭，符合開發者的直覺。

基礎操作

建立新站點：在當前目錄下建立一個完整的 Hugo 專案結構。
```
hugo new site my-website
```
新增內容：使用模板快速建立新的 Markdown 文章。
```
hugo new content posts/my-first-post.md
```
啟動開發伺服器：在本地端啟動 Web Server，支援即時重整 (LiveReload)。加上 -D 參數可預覽草稿 (Draft) 內容。
```
hugo server -D
```
建置網站：將 Markdown 內容轉換為靜態 HTML 檔案，預設輸出至 public/ 資料夾，即可上傳至 GitHub Pages 或 Netlify。
```
hugo
```

常用參數 (Flags)

雖然 Hugo 不是互動式 TUI 軟體，但熟悉以下 CLI 參數能讓你更精準地控制建置行為：

參數	功能說明	適用情境
-D, –buildDrafts	包含草稿 (Include Drafts)	開發預覽時查看尚未發布的文章
-F, –buildFuture	包含未來內容 (Include Future)	預覽設定在未來時間發布的文章
–minify	最小化輸出 (Minify Output)	正式建置時壓縮 HTML/CSS/JS 以提升載入速度
–gc	垃圾回收 (Garbage Collection)	建置後清除未使用的快取資源
-t, –theme	指定主題 (Force Theme)	暫時切換或測試不同主題時使用
–cleanDestinationDir	清理目標目錄	建置前清空 `public/` 資料夾，避免舊檔殘留

進階技巧

短代碼 (Shortcodes)：不想在 Markdown 中寫複雜的 HTML？利用 Hugo 的 Shortcodes 功能，例如 {{< youtube id >}} 即可快速嵌入影片，或自訂 Twitter 推文、Gist 程式碼區塊。
圖片處理管道：在模板中直接呼叫 Hugo 的圖片處理 API，例如 {{ $image.Resize "600x" }}，Hugo 會在建置時自動產生縮圖，無需手動裁切圖片。
設定檔模組化：對於大型專案，可以將 hugo.toml (或 config.yaml) 拆分為多個檔案並放入 config/ 目錄中，依照環境 (development/production) 載入不同的設定。

Hugo

產品說明

常用指令與操作

基礎操作

常用參數 (Flags)

進階技巧

操作介面