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