hugo/docs/content/en/methods/site/Languages.md

60 lines
1.2 KiB
Markdown
Raw Normal View History

---
title: Languages
description: Returns a collection of language objects for all sites, ordered by language weight.
categories: []
keywords: []
action:
related:
- methods/site/Language
returnType: langs.Languages
signatures: [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 view the data structure:
```go-html-template
<pre>{{ jsonify (dict "indent" " ") .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:
```go-html-template
<ul>
{{ range .Site.Languages }}
<li>{{ .Title }} ({{ .LanguageName }})</li>
{{ end }}
</ul>
```
Is rendered to:
```html
<ul>
<li>Projekt Dokumentation (Deutsch)</li>
<li>Project Documentation (English)</li>
</ul>
```