mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-18 17:36:52 -05:00
5fd1e74903
``` git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash ``` Closes #11925
31 lines
937 B
Markdown
31 lines
937 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](/templates/lists#group-content) in Hugo. The above example can be [paginated](/templates/pagination/#list-paginator-pages).
|