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