Language
返回給定站點的語言對象。
Syntax
SITE.Language
Returns
langs.Language
Page 對象上的 Language 方法返回給定頁面的語言對象。語言對象派生自站點配置中的語言定義。
您也可以在 Page 對象上使用 Language 方法。請參閱 詳情。
方法
以下示例假設站點配置中有以下內容:
languages:
de:
languageCode: de-DE
languageDirection: ltr
languageName: Deutsch
weight: 1
[languages]
[languages.de]
languageCode = 'de-DE'
languageDirection = 'ltr'
languageName = 'Deutsch'
weight = 1
{
"languages": {
"de": {
"languageCode": "de-DE",
"languageDirection": "ltr",
"languageName": "Deutsch",
"weight": 1
}
}
}
IsDefault
New in v0.153.0(bool) 報告這是否是默認語言對象,由站點配置中的 defaultContentLanguage 設置定義。
{{ .Site.Language.IsDefault }} → trueLang
(string) 由 RFC 5646 定義的語言標簽。這是站點配置中小寫的鍵。
{{ .Site.Language.Lang }} → deLanguageCode
(string) 來自站點配置的語言代碼。如果未定義則回退到 Lang。
{{ .Site.Language.LanguageCode }} → de-DELanguageDirection
(string) 來自站點配置的語言方向,ltr 或 rtl。
{{ .Site.Language.LanguageDirection }} → ltrLanguageName
(string) 來自站點配置的語言名稱。
{{ .Site.Language.LanguageName }} → DeutschName
(string) 由 RFC 5646 定義的語言標簽。這是站點配置中小寫的鍵。這是 Lang 的別名。
{{ .Site.Language.Name }} → deWeight
(int) 來自站點配置的語言權重,決定其在 Site 對象上的 Languages 方法返回的語言切片中的順序。
{{ .Site.Language.Weight }} → 1示例
上述一些方法通常用作基模板中 html 元素的屬性。
<html
lang="{{ .Site.Language.LanguageCode }}"
dir="{{ or .Site.Language.LanguageDirection `ltr` }}"
>