mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-28 23:02:05 -05:00
docs: Document group
Fixes https://github.com/gohugoio/hugoDocs/issues/597
This commit is contained in:
parent
bc57f5c36e
commit
8388cd90e8
1 changed files with 37 additions and 0 deletions
37
docs/content/en/functions/group.md
Normal file
37
docs/content/en/functions/group.md
Normal file
|
@ -0,0 +1,37 @@
|
||||||
|
---
|
||||||
|
title: group
|
||||||
|
description: "`group` groups a list of pages."
|
||||||
|
date: 2018-09-14
|
||||||
|
categories: [functions]
|
||||||
|
menu:
|
||||||
|
docs:
|
||||||
|
parent: "functions"
|
||||||
|
keywords: [collections]
|
||||||
|
signature: ["PAGES | group KEY"]
|
||||||
|
hugoversion: "0.49"
|
||||||
|
---
|
||||||
|
|
||||||
|
{{< code file="layouts/partials/groups.html" >}}
|
||||||
|
{{ $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="{{ .Permalink }}">{{ .Title }}</a>
|
||||||
|
<div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
|
||||||
|
</li>
|
||||||
|
{{ end }}
|
||||||
|
</ul>
|
||||||
|
{{ end }}
|
||||||
|
{{< /code >}}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
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 even be [paginated](/templates/pagination/#list-paginator-pages).
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue