Ref
返回具有给定路径、语言和输出格式的页面的绝对 URL。
Syntax
PAGE.Ref OPTIONS
Returns
string
用法
Ref 方法接受单个参数：选项映射。
选项
- path
- (
string) 目标页面的路径。没有前导斜杠 (/) 的路径首先相对于当前页面解析，然后相对于站点其余部分解析。 - lang
- (
string) 目标页面的语言。默认为当前语言。可选。 - outputFormat
- (
string) 目标页面的输出格式。默认为当前输出格式。可选。
示例
以下示例显示站点英文版本页面上渲染的输出：
{{ $opts := dict "path" "/books/book-1" }}
{{ .Ref $opts }} → https://example.org/en/books/book-1/
{{ $opts := dict "path" "/books/book-1" "lang" "de" }}
{{ .Ref $opts }} → https://example.org/de/books/book-1/
{{ $opts := dict "path" "/books/book-1" "lang" "de" "outputFormat" "json" }}
{{ .Ref $opts }} → https://example.org/de/books/book-1/index.json错误处理
默认情况下，如果 Hugo 无法解析路径，它将抛出错误并使构建失败。您可以在站点配置中将其更改为警告，并指定在无法解析路径时返回的 URL。
refLinksErrorLevel: warning
refLinksNotFoundURL: /some/other/url
refLinksErrorLevel = 'warning'
refLinksNotFoundURL = '/some/other/url'
{
"refLinksErrorLevel": "warning",
"refLinksNotFoundURL": "/some/other/url"
}