urls.RelRef

urls.RelRef PAGE PATH/OPTIONS

string

relref

第一个参数是用于解析相对路径的页面上下文，通常是当前页面。

第二个参数是页面的路径，可以带有文件扩展名，也可以带有锚点。如果路径没有前导斜杠 /，则首先相对于给定的上下文解析，然后相对于网站的剩余部分继续解析。 或者，可以提供一个选项映射而不是路径。

{{ relref . "about" }}
{{ relref . "about#anchor" }}
{{ relref . "about.md" }}
{{ relref . "about.md#anchor" }}
{{ relref . "#anchor" }}
{{ relref . "/blog/my-post" }}
{{ relref . "/blog/my-post.md" }}

返回的永久链接相对于站点配置中指定的 baseURL 的协议+主机部分。例如：

选项

除了指定路径外，还可以提供选项映射：

path

(string) 页面的路径，相对于内容目录。必填。

lang

(string) 要搜索页面的语言（站点）。默认为当前语言。可选。

outputFormat

(string) 要搜索页面的输出格式。默认为当前输出格式。可选。

返回其他语言版本页面的相对永久链接：

{{ relref . (dict "path" "about.md" "lang" "fr") }}

返回页面的其他输出格式的相对永久链接：

{{ relref . (dict "path" "about.md" "outputFormat" "rss") }}

默认情况下，如果 Hugo 无法解析路径，则会引发错误并中断构建。您可以在站点配置中将其更改为警告，并指定在无法解析路径时要返回的 URL。

refLinksErrorLevel: warning
refLinksNotFoundURL: /some/other/url

refLinksErrorLevel = 'warning'
refLinksNotFoundURL = '/some/other/url'

{
   "refLinksErrorLevel": "warning",
   "refLinksNotFoundURL": "/some/other/url"
}