mirror of https://github.com/gohugoio/hugo
32 lines
926 B
Markdown
32 lines
926 B
Markdown
---
|
|
title: collections.Group
|
|
description: Groups the given page collection by the given key.
|
|
categories: []
|
|
keywords: []
|
|
action:
|
|
aliases: [group]
|
|
related: []
|
|
returnType: any
|
|
signatures: [collections.Group KEY PAGES]
|
|
aliases: [/functions/group]
|
|
---
|
|
|
|
```go-html-template
|
|
{{ $new := .Site.RegularPages | first 10 | group "New" }}
|
|
{{ $old := .Site.RegularPages | last 10 | group "Old" }}
|
|
{{ $groups := slice $new $old }}
|
|
{{ range $groups }}
|
|
<h3>{{ .Key }}{{/* Prints "New", "Old" */}}</h3>
|
|
<ul>
|
|
{{ range .Pages }}
|
|
<li>
|
|
<a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
|
|
<div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
|
|
</li>
|
|
{{ end }}
|
|
</ul>
|
|
{{ end }}
|
|
```
|
|
|
|
The page group you get from `group` is of the same type you get from the built-in [group methods](/quick-reference/page-collections/#group) in Hugo. The example above can be [paginated](/templates/pagination/).
|