Template lookup order

查找規則

Hugo 在選擇特定頁面的模板時會考慮以下參數。模板按具體程度排序。這應該是自然的，但請查看下面的表格，了解不同參數變化的具體例子。

類型

頁面的 Kind（首頁是其中之一）。請參閱每種類型的示例表格。這也決定了它是單一頁面（即常規內容頁面，我們會查找 _default/single.html 來渲染 HTML）還是列表頁面（區段列表、首頁、分類列表、分類術語。我們會查找 _default/list.html 來渲染 HTML）。

布局

可以在 Front Matter 中設定。

輸出格式

請參閱自訂輸出格式。輸出格式有一個 name（例如 rss、amp、html）和一個 suffix（例如 xml、html）。我們優先匹配兩者（例如 index.amp.html），但也會尋找較不具體的模板。

注意，如果輸出格式的媒體類型定義了多個後綴，僅會考慮第一個。

語言

我們會考慮模板名稱中的語言標籤。如果網站語言是 fr，那麼 index.fr.amp.html 會優先於 index.amp.html，但 index.amp.html 會在 index.fr.html 之前被選擇。

類型

如果在 Front Matter 中設定了 type，則是其值；否則是根區段的名稱（例如 “blog”）。它總是有一個值，所以如果沒有設定，則默認值為 “page”。

區段

與 section、taxonomy 和 term 類型有關。

針對模板

你無法更改查找順序來針對內容頁面，但可以更改內容頁面來指定目標模板。在 Front Matter 中指定 type、layout 或兩者。

考慮以下的內容結構：

content/
├── about.md
└── contact.md

位於內容目錄根目錄的檔案有一個內容類型，默認為 page。要使用獨特的模板渲染這些頁面，請創建對應的子目錄：

layouts/
└── page/
    └── single.html

但是聯絡頁面可能有表單並需要不同的模板。在 Front Matter 中指定 layout：

layout: contact
title: 聯絡

layout = 'contact'
title = '聯絡'

{
   "layout": "contact",
   "title": "聯絡"
}

然後為聯絡頁面創建模板：

layouts/
└── page/
    └── contact.html  <-- 渲染 contact.md
    └── single.html   <-- 渲染 about.md

作為內容類型，page 這個詞比較模糊。也許 miscellaneous 會更好。將 type 添加到每個頁面的 Front Matter：

title: 關於
type: miscellaneous

title = '關於'
type = 'miscellaneous'

{
   "title": "關於",
   "type": "miscellaneous"
}

layout: contact
title: 聯絡
type: miscellaneous

layout = 'contact'
title = '聯絡'
type = 'miscellaneous'

{
   "layout": "contact",
   "title": "聯絡",
   "type": "miscellaneous"
}

現在將模板放置到對應的目錄中：

layouts/
└── miscellaneous/
    └── contact.html  <-- 渲染 contact.md
    └── single.html   <-- 渲染 about.md

首頁模板

這些模板路徑按具體程度排序，最不具體的路徑位於每個列表的底部。

單一頁面模板

這些模板路徑按具體程度排序，最不具體的路徑位於每個列表的底部。

區段模板

這些模板路徑按具體程度排序，最不具體的路徑位於每個列表的底部。

分類模板

這些模板路徑按具體程度排序，最不具體的路徑位於每個列表的底部。

以下範例假設有以下站點配置：

taxonomies:
  category: categories

[taxonomies]
  category = 'categories'

{
   "taxonomies": {
      "category": "categories"
   }
}

標籤模板

這些模板路徑按具體程度排序，最不具體的路徑位於每個列表的底部。

以下範例假設有以下站點配置：

taxonomies:
  category: categories

[taxonomies]
  category = 'categories'

{
   "taxonomies": {
      "category": "categories"
   }
}

RSS 模板

這些模板路徑按具體程度排序，最不具體的路徑位於每個列表的底部。

以下範例假設有以下站點配置：

taxonomies:
  category: categories

[taxonomies]
  category = 'categories'

{
   "taxonomies": {
      "category": "categories"
   }
}