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