AlternativeOutputFormats
语法
PAGE.AlternativeOutputFormats
返回值
page.OutputFormats
在构建站点时,Hugo 会为每个页面生成一个或多个文件。例如,在呈现主页、节、分类法 和 术语 页面时,Hugo 会生成一个 HTML 文件和一个 RSS 文件。HTML 和 RSS 都是内置的输出格式。可以创建多种输出格式,并根据 页面类型 控制生成,或者为一个或多个页面启用一种或多种输出格式。请参阅详细信息。
Page
对象上的 AlternativeOutputFormats
方法返回一个 OutputFormat
对象切片,其中不包括当前输出格式,每个对象代表给定页面启用的一种输出格式。请参阅详细信息。
方法
- Get IDENTIFIER
- (
any
) 返回具有给定标识符的OutputFormat
对象。 - MediaType
- (
media.Type
) 返回输出格式的媒体类型。 - MediaType.MainType
- (
string
) 返回输出格式的媒体类型的主类型。 - MediaType.SubType
- (
string
) 返回当前格式的媒体类型的子类型。 - Name
- (
string
) 返回输出格式的输出标识符。 - Permalink
- (
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.">