urls.Ref

urls.Ref PAGE PATH

urls.Ref PAGE 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）页面的路径，相对于 content 目录。必填。

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"
}