mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-18 18:06:46 -05:00
67 lines
1.3 KiB
Markdown
67 lines
1.3 KiB
Markdown
|
---
|
||
|
title: Sites
|
||
|
description: Returns a collection of all Site objects, one for each language, ordered by language weight.
|
||
|
categories: []
|
||
|
keywords: []
|
||
|
action:
|
||
|
related: []
|
||
|
returnType: page.Sites
|
||
|
signatures: [SITE.Sites]
|
||
|
---
|
||
|
|
||
|
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.Sites }}
|
||
|
<li><a href="{{ .Home.Permalink }}">{{ .Title }}</a></li>
|
||
|
{{ end }}
|
||
|
</ul>
|
||
|
```
|
||
|
|
||
|
Produces a list of links to each home page:
|
||
|
|
||
|
```html
|
||
|
<ul>
|
||
|
<li><a href="https://example.org/de/">Projekt Dokumentation</a></li>
|
||
|
<li><a href="https://example.org/en/">Project Documentation</a></li>
|
||
|
</ul>
|
||
|
```
|
||
|
|
||
|
To render a link to home page of the primary (first) language:
|
||
|
|
||
|
```go-html-template
|
||
|
{{ with .Site.Sites.First }}
|
||
|
<a href="{{ .Home.Permalink }}">{{ .Title }}</a>
|
||
|
{{ end }}
|
||
|
```
|
||
|
|
||
|
This is equivalent to:
|
||
|
|
||
|
```go-html-template
|
||
|
{{ with index .Site.Sites 0 }}
|
||
|
<a href="{{ .Home.Permalink }}">{{ .Title }}</a>
|
||
|
{{ end }}
|
||
|
```
|