方法 网站方法

语言

Syntax

SITE.Language

Returns

langs.Language

Language方法在Site对象上返回给定站点的语言对象。语言对象指向站点配置中的语言定义。

您还可以在Page对象上使用Language方法。参见详情。

方法

以下示例假设您的站点配置具有以下内容：

hugo.
      
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
      }
   }
}

Lang ：（字符串）语言标签，根据RFC 5646定义。

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

LanguageCode ：（字符串）来自站点配置的语言代码。

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

LanguageDirection ：（字符串）来自站点配置的语言方向，可以是ltr或rtl。

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

LanguageName ：（字符串）来自站点配置的语言名称。

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

Weight ：（整数）来自站点配置的语言权重，用于确定返回的Site对象上的语言切片的顺序。

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

示例

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

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

上面的示例使用全局site函数，而不是通过.Site符号访问Site对象。

还要注意，每个属性都通过or运算符分配了一个回退值。

See also

Last updated: November 23, 2023: first release (332dc4cd7)
Improve this page