Language

The Language method on a Page object returns the Language object for the given page, derived from the language definition in your project configuration.

You can also use the Language method on a Site object. See details.

Methods

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 the direction from the language definition.

{{ .Language.Direction }} → ltr

IsDefault

{{< new-in 0.153.0 />}}

(bool) Reports whether this is the default language.

{{ .Language.IsDefault }} → true

Label

{{< new-in 0.158.0 />}}

(string) Returns the label from the language definition.

{{ .Language.Label }} → Deutsch

Lang

{{<deprecated-in 0.158.0 />}}

Use Name instead.

LanguageCode

{{<deprecated-in 0.158.0 />}}

Use Locale instead.

LanguageDirection

{{<deprecated-in 0.158.0 />}}

Use Direction instead.

LanguageName

{{<deprecated-in 0.158.0 />}}

Use Label instead.

Locale

{{< new-in 0.158.0 />}}

(string) Returns the locale from the language definition, falling back to Name.

{{ .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.

{{ .Language.Name }} → de

Weight

{{<deprecated-in 0.158.0 />}}

Example

Use the code below to create a language selector, allowing users to navigate between the different translated versions of the current page.

{{ with .Rotate "language" }}
  <nav class="language-selector">
    <ul>
      {{ range . }}
        {{ if eq .Language $.Language }}
          <li class="active">
            <a aria-current="page" href="{{ .Permalink }}" hreflang="{{ .Language.Locale }}">{{ .Language.Label }}</a>
          </li>
        {{ else }}
          <li>
            <a href="{{ .Permalink }}" hreflang="{{ .Language.Locale }}">{{ .Language.Label }}</a>
          </li>
        {{ end }}
      {{ end }}
    </ul>
  </nav>
{{ end }}