Ref

選項映射包含:

path
(string) 頁面相對於內容目錄的路徑。必填。
lang
(string) 搜尋頁面時使用的語言(網站語言)。預設為當前語言。可選。
outputFormat
(string) 搜尋頁面時使用的輸出格式。預設為當前輸出格式。可選。

以下範例顯示了訪問英語語言版本網站頁面時的渲染輸出:

{{ $opts := dict "path" "/books/book-1" }}
{{ .Ref $opts }} → https://example.org/en/books/book-1/

{{ $opts := dict "path" "/books/book-1" "lang" "de" }}
{{ .Ref $opts }} → https://example.org/de/books/book-1/

{{ $opts := dict "path" "/books/book-1" "lang" "de" "outputFormat" "json" }}
{{ .Ref $opts }} → https://example.org/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"
}