RelRef
Syntax
PAGE.RelRef OPTIONS
Returns
string
选项映射包含以下内容：
- path
- (
string) 页面的路径，相对于内容目录。必填。 - lang
- (
string) 搜索页面的语言（站点）。默认为当前语言。可选。 - outputFormat
- (
string) 搜索页面的输出格式。默认为当前输出格式。可选。
以下示例展示了访问站点的英文版本页面时的渲染输出：
{{ $opts := dict "path" "/books/book-1" }}
{{ .RelRef $opts }} → /en/books/book-1/
{{ $opts := dict "path" "/books/book-1" "lang" "de" }}
{{ .RelRef $opts }} → /de/books/book-1/
{{ $opts := dict "path" "/books/book-1" "lang" "de" "outputFormat" "json" }}
{{ .RelRef $opts }} → /de/books/book-1/index.json
默认情况下，如果Hugo无法解析路径，将会抛出错误并停止构建。您可以在站点配置中将其更改为警告，并指定无法解析路径时要返回的URL。
hugo.
refLinksErrorLevel: warning
refLinksNotFoundURL: /some/other/url
refLinksErrorLevel = 'warning'
refLinksNotFoundURL = '/some/other/url'
{
"refLinksErrorLevel": "warning",
"refLinksNotFoundURL": "/some/other/url"
}