相关页面
Syntax
PAGES.Related PAGE
PAGES.Related OPTIONS
Returns
page.Pages
基于前置 matter，Hugo 使用多个因素来识别与给定页面相关的內容。使用默认的 相关内容配置 ，或调整结果以匹配所需的索引和参数。参见 详情 。
传递给 Related 方法的参数可以是 Page 或选项映射。例如，传递当前页面：
layouts/_default/single.html
{{ with .Site.RegularPages.Related . | first 5 }}
<p>相关页面：</p>
<ul>
{{ range . }}
<li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
{{ end }}
</ul>
{{ end }}传递选项映射：
layouts/_default/single.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")
}}