進階設定

資料夾結構

Hugo 網站有 4 個主要資料夾：

• content/ 用於你的 Markdown 格式內容文件（首頁等）
  • _index.md 首頁（Hugo 要求首頁和存檔頁面必須有下劃線前綴）
• assets/
  • media/ 用於你的媒體文件（圖片、視頻）
    • icons/custom/ 上傳任何你想要使用的自訂 SVG 圖示
• config/_default/ 用於你的網站設定文件
  • hugo.yaml 配置 Hugo（網站標題、URL、Hugo 選項、設置每個資料夾頁面功能）
  • module.yaml 安裝或卸載 Hugo 主題和插件
  • params.yaml 配置 Hugo Blox 選項（SEO、分析、網站功能）
  • menus.yaml 配置你的選單連結（如果選單在 params.yaml 中啟用）
  • languages.yaml 配置你的網站語言或設置多語言網站的語言特定選項
• static/uploads/ 用於任何你想要讓訪客下載的文件，例如 PDF
• go.mod 設置 Hugo 主題/插件的版本

Hugo 文件命名慣例

Hugo 給了我們兩種命名標準頁面文件的方式：TITLE/index.md 或 TITLE.md，其中 TITLE 是你的頁面名稱。

頁面名稱應該是小寫，並使用連字符 (-) 而不是空格。

兩種方法的結果相同，所以你可以選擇你喜歡的方式來命名和組織文件。使用資料夾方法的優點是，所有頁面的文件（例如圖片）都包含在頁面的資料夾中，所以如果你想要分享原始的 Markdown 頁面，它會更便於攜帶。

首頁是一個特殊情況，Hugo 要求首頁和列表頁面必須命名為 _index.md。

文件導航

文件導航是根據 docs/ 資料夾中的內容自動生成的，並按字母順序排序。

頁面的順序可以通過在 Markdown 文件的前言中添加 weight 參數來更改。

以下範例中，example.md 頁面會在 test.md 頁面之前出現，因為它有較低的 weight：

example.md 頁面：

---
title: My Example
weight: 1
---

test.md 頁面：

---
title: My Test
weight: 2
---