Language

Site 对象上的 Language 方法返回给定站点的 Language 对象，其内容来自项目配置中的语言定义。

你也可以在 Page 对象上使用 Language 方法。详见说明。

方法

在 Language 对象上使用这些方法。

下面的示例都基于如下语言定义。

[languages.de]
direction = 'ltr'
label = 'Deutsch'
locale = 'de-DE'
weight = 2

Direction

（0.158.0 新增）

（string）返回语言定义中的 direction。

{{ .Site.Language.Direction }} → ltr

IsDefault

（0.153.0 新增）

（bool）报告这是否为默认语言。

{{ .Site.Language.IsDefault }} → true

Label

（0.158.0 新增）

（string）返回语言定义中的 label。

{{ .Site.Language.Label }} → Deutsch

Lang

（0.158.0 起弃用）

请改用 Name。

LanguageCode

（0.158.0 起弃用）

请改用 Locale。

LanguageDirection

（0.158.0 起弃用）

请改用 Direction。

LanguageName

（0.158.0 起弃用）

请改用 Label。

Locale

（0.158.0 新增）

（string）返回语言定义中的 locale，找不到时回退到 Name。

{{ .Site.Language.Locale }} → de-DE

Name

（0.153.0 新增）

（string）返回由 RFC 5646 定义的语言标签，即语言定义中转为小写的键名。

{{ .Site.Language.Name }} → de

Weight

（0.158.0 起弃用）

示例

上面的一些方法常用于 base 模板，作为 html 元素的属性。

<html
  lang="{{ .Site.Language.Locale }}"
  dir="{{ or .Site.Language.Direction `ltr` }}"
>