mirror of https://github.com/gohugoio/hugo
37 lines
771 B
Markdown
37 lines
771 B
Markdown
---
|
|
title: GroupBy
|
|
description: Returns the given page collection grouped by the given field in ascending order.
|
|
categories: []
|
|
keywords: []
|
|
action:
|
|
related: []
|
|
returnType: page.PagesGroup
|
|
signatures: ['PAGES.GroupBy FIELD [SORT]']
|
|
---
|
|
|
|
{{% include "methods/pages/_common/group-sort-order.md" %}}
|
|
|
|
```go-html-template
|
|
{{ range .Pages.GroupBy "Section" }}
|
|
<p>{{ .Key }}</p>
|
|
<ul>
|
|
{{ range .Pages }}
|
|
<li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
|
|
{{ end }}
|
|
</ul>
|
|
{{ end }}
|
|
```
|
|
|
|
To sort the groups in descending order:
|
|
|
|
```go-html-template
|
|
{{ range .Pages.GroupBy "Section" "desc" }}
|
|
<p>{{ .Key }}</p>
|
|
<ul>
|
|
{{ range .Pages }}
|
|
<li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
|
|
{{ end }}
|
|
</ul>
|
|
{{ end }}
|
|
```
|