mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-01 14:19:14 -05:00
56 lines
1.4 KiB
Markdown
56 lines
1.4 KiB
Markdown
|
---
|
||
|
title: MainSections
|
||
|
description: Returns a slice of the main section names as defined in the site configuration, falling back to the top level section with the most pages.
|
||
|
categories: []
|
||
|
keywords: []
|
||
|
action:
|
||
|
related: []
|
||
|
returnType: '[]string'
|
||
|
signatures: [SITE.MainSections]
|
||
|
---
|
||
|
|
||
|
Site configuration:
|
||
|
|
||
|
{{< code-toggle file=hugo >}}
|
||
|
[params]
|
||
|
mainSections = ['books','films']
|
||
|
{{< /code-toggle >}}
|
||
|
|
||
|
Template:
|
||
|
|
||
|
```go-html-template
|
||
|
{{ .Site.MainSections }} → [books films]
|
||
|
```
|
||
|
|
||
|
If `params.mainSections` is not defined in the site configuration, this method returns a slice with one element---the top level section with the most pages.
|
||
|
|
||
|
With this content structure, the "films" section has the most pages:
|
||
|
|
||
|
```text
|
||
|
content/
|
||
|
├── books/
|
||
|
│ ├── book-1.md
|
||
|
│ └── book-2.md
|
||
|
├── films/
|
||
|
│ ├── film-1.md
|
||
|
│ ├── film-2.md
|
||
|
│ └── film-3.md
|
||
|
└── _index.md
|
||
|
```
|
||
|
|
||
|
Template:
|
||
|
|
||
|
```go-html-template
|
||
|
{{ .Site.MainSections }} → [films]
|
||
|
```
|
||
|
|
||
|
When creating a theme, instead of hardcoding section names when listing the most relevant pages on the front page, instruct site authors to set `params.mainSections` in their site configuration.
|
||
|
|
||
|
Then your home page template can do something like this:
|
||
|
|
||
|
```go-html-template
|
||
|
{{ range where .Site.RegularPages "Section" "in" .Site.MainSections }}
|
||
|
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
|
||
|
{{ end }}
|
||
|
```
|