Ref
返回具有給定路徑、語言和輸出格式的頁面的絕對 URL。
Syntax
SHORTCODE.Ref OPTIONS
Returns
string
用法
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。
refLinksErrorLevel: warning
refLinksNotFoundURL: /some/other/url
refLinksErrorLevel = 'warning'
refLinksNotFoundURL = '/some/other/url'
{
"refLinksErrorLevel": "warning",
"refLinksNotFoundURL": "/some/other/url"
}