Related
返回與給定頁面相關的頁面集合。
Syntax
PAGES.Related PAGE
PAGES.Related OPTIONS
Returns
page.Pages
基於 front matter，Hugo 使用多個因素來識別與給定頁面相關的內容。使用默認的 相關內容配置，或調整結果以使用所需的索引和參數。請參閱 詳情。
傳遞給 Related 方法的參數可以是 Page 或選項映射。例如，傳遞當前頁面：
layouts/page.html
{{ with .Site.RegularPages.Related . | first 5 }}
<p>相關頁面：</p>
<ul>
{{ range . }}
<li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
{{ end }}
</ul>
{{ end }}傳遞選項映射：
layouts/page.html
{{ $opts := dict
"document" .
"indices" (slice "tags" "keywords")
}}
{{ with .Site.RegularPages.Related $opts | first 5 }}
<p>相關頁面：</p>
<ul>
{{ range . }}
<li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
{{ end }}
</ul>
{{ end }}選項
- indices
- (
slice) 要在其中搜索的索引。 - document
- (
page) 要查找相關內容的頁面。指定選項映射時必需。 - namedSlices
- (
slice) 要搜索的關鍵字，使用keyVals函數表示為KeyValues的切片。
- fragments
- (
slice) 用於配置為"fragments"類型的索引的特殊關鍵字列表。這將匹配文檔的 片段 標識符。
使用上述所有選項的人為示例：
{{ $page := . }}
{{ $opts := dict
"indices" (slice "tags" "keywords")
"document" $page
"namedSlices" (slice (keyVals "tags" "hugo" "rocks") (keyVals "date" $page.Date))
"fragments" (slice "heading-1" "heading-2")
}}