HUGO
Menu
GitHub 87548 stars Mastodon

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 }} → true

Lang

(string) 由 RFC 5646 定义的语言标签。这是站点配置中小写的键。

{{ .Site.Language.Lang }} → de

LanguageCode

(string) 来自站点配置的语言代码。如果未定义则回退到 Lang

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

LanguageDirection

(string) 来自站点配置的语言方向,ltrrtl

{{ .Site.Language.LanguageDirection }} → ltr

LanguageName

(string) 来自站点配置的语言名称。

{{ .Site.Language.LanguageName }} → Deutsch

Name

(string) 由 RFC 5646 定义的语言标签。这是站点配置中小写的键。这是 Lang 的别名。

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

Weight

(int) 来自站点配置的语言权重,决定其在 Site 对象上的 Languages 方法返回的语言切片中的顺序。

{{ .Site.Language.Weight }} → 1

示例

上述一些方法通常用作基模板中 html 元素的属性。

<html
  lang="{{ .Site.Language.LanguageCode }}" 
  dir="{{ or .Site.Language.LanguageDirection `ltr` }}"
>

Last updated: January 1, 0001
Improve this page