hugo/docs/content/en/methods/site/Languages.md
2024-06-21 09:41:24 +02:00

1.2 KiB

title description categories keywords action
Languages Returns a collection of language objects for all sites, ordered by language weight.
related returnType signatures
methods/site/Language
langs.Languages
SITE.Languages

The Languages method on a Site object returns a collection of language objects for all sites, ordered by language weight. Each language object points to its language definition in the site configuration.

To inspect the data structure:

<pre>{{ debug.Dump .Site.Languages }}</pre>

With this site configuration:

{{< code-toggle file=hugo >}} defaultContentLanguage = 'de' defaultContentLanguageInSubdir = false

[languages.de] languageCode = 'de-DE' languageDirection = 'ltr' languageName = 'Deutsch' title = 'Projekt Dokumentation' weight = 1

[languages.en] languageCode = 'en-US' languageDirection = 'ltr' languageName = 'English' title = 'Project Documentation' weight = 2 {{< /code-toggle >}}

This template:

<ul>
  {{ range .Site.Languages }}
    <li>{{ .Title }} ({{ .LanguageName }})</li>
  {{ end }}
</ul>

Is rendered to:

<ul>
  <li>Projekt Dokumentation (Deutsch)</li>
  <li>Project Documentation (English)</li>
</ul>