RelRef

選項映射包含：

  • 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"
}
RelRef RelPermalink