2.4 KiB
2.4 KiB
title, description, categories, keywords, params
| title | description | categories | keywords | params | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Language | Returns the Language object for the given site. |
|
The Language method on a Site object returns the Language object for the given site, derived from the language definition in your project configuration.
You can also use the Language method on a Page object. See details.
Methods
Use these methods on the Language object.
The examples below assume the following language definition.
{{< code-toggle file=hugo >}} [languages.de] direction = 'ltr' label = 'Deutsch' locale = 'de-DE' weight = 2 {{< /code-toggle >}}
Direction- {{< new-in 0.158.0 />}}
- (
string) Returns thedirectionfrom the language definition.{{ .Site.Language.Direction }} → ltr IsDefault- {{< new-in 0.153.0 />}}
- (
bool) Reports whether this is the default language.{{ .Site.Language.IsDefault }} → true Label- {{< new-in 0.158.0 />}}
- (
string) Returns thelabelfrom the language definition.{{ .Site.Language.Label }} → Deutsch Lang- {{<deprecated-in 0.158.0 />}}
- Use
Nameinstead. LanguageCode- {{<deprecated-in 0.158.0 />}}
- Use
Localeinstead. LanguageDirection- {{<deprecated-in 0.158.0 />}}
- Use
Directioninstead. LanguageName- {{<deprecated-in 0.158.0 />}}
- Use
Labelinstead. Locale- {{< new-in 0.158.0 />}}
- (
string) Returns thelocalefrom the language definition, falling back toName.{{ .Site.Language.Locale }} → de-DE Name- {{< new-in 0.153.0 />}}
- (
string) Returns the language tag as defined by RFC 5646. This is the lowercased key from the language definition.{{ .Site.Language.Name }} → de Weight- {{<deprecated-in 0.158.0 />}}
Example
Some of the methods above are commonly used in a base template as attributes for the html element.
<html
lang="{{ .Site.Language.Locale }}"
dir="{{ or .Site.Language.Direction `ltr` }}"
>