urls.RelRef
返回具有给定路径、语言与输出格式的页面的相对 URL。
用法
relref 函数接受两个参数：
- 用于解析相对路径的上下文（通常是当前页面）。
- 目标页面的路径，或一个选项映射（见下文）。
选项
path- （
string）目标页面的路径。不以斜杠（/）开头的路径会先相对于当前页面解析，再相对于站点其余部分解析。 lang- （
string）目标页面的语言。默认为当前语言。可选项。 outputFormat- （
string）目标页面的输出格式。默认为当前输出格式。可选项。
示例
下面的示例展示英语版站点上某个页面的渲染输出：
{{ relref . "/books/book-1" }} → /en/books/book-1/
{{ $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。
refLinksErrorLevel = 'warning'
refLinksNotFoundURL = '/some/other/url'