urls.Ref

urls.Ref PAGE PATH/OPTIONS

string

ref

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

第二个参数是一个页面路径，可以带有文件扩展名，也可以带有锚点。如果路径没有以/开头，则首先将其相对于给定的上下文解析，然后再相对于整个站点进行解析。或者，您可以提供一个选项映射，而不是直接给出路径。

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

选项

您也可以提供一个选项映射来替代指定路径：

path

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

lang

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

outputFormat

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

要返回另一语言版本页面的绝对永久链接：

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

要返回页面的另一输出格式的绝对永久链接：

{{ ref . (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"
}