备选输出格式
Syntax
PAGE.AlternativeOutputFormats
Returns
page.OutputFormats
Hugo 在构建站点时，每个页面会生成一个或多个文件。例如，在渲染主页、 章节 、 分类 和 术语 页面时，Hugo 会生成一个 HTML 文件和一个 RSS 文件。HTML 和 RSS 都是内置的 输出格式 。您可以创建多个输出格式，并根据 页面类型 控制生成，或者为一个或多个页面启用一个或多个输出格式。详情请参见 此处 。
Page 对象上的 AlternativeOutputFormats 方法返回一个 OutputFormat 对象的切片，不包括当前输出格式，每个对象都代表为给定页面启用的输出格式之一。参见 详情 。
方法
- 获取标识符
- (
any) 返回具有给定标识符的OutputFormat对象。 - 媒体类型
- (
media.Type) 返回输出格式的媒体类型。 - MediaType.MainType
- (
string) 返回输出格式媒体类型的主类型。 - MediaType.SubType
- (
string) 返回当前格式媒体类型的子类型。 - 名称
- (
string) 返回输出格式的输出标识符。 - 永久链接
- (
string) 返回当前输出格式生成的页面的永久链接。 - Rel
- (
string) 返回输出格式的rel值，即默认值或站点配置中定义的值。 - RelPermalink
- (
string) 返回当前输出格式生成的页面的相对永久链接。
示例
为每个备选输出格式在每个页面的 <head> 中生成一个 link 元素：
<head>
...
{{ $title := printf "%s | %s" .Title site.Title }}
{{ if .IsHome }}
{{ $title = site.Title }}
{{ end }}
{{ range .AlternativeOutputFormats -}}
{{ printf `<link rel=%q type=%q href=%q title=%q>` .Rel .MediaType.Type .Permalink $title | safeHTML }}
{{ end }}
...
</head>
在网站的首页上，Hugo 会将其渲染为：
<link rel="alternate" type="application/rss+xml" href="https://example.org/index.xml" title="ABC Widgets, Inc.">