diff options
author | Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com> | 2018-09-24 10:07:50 +0200 |
---|---|---|
committer | Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com> | 2018-09-24 10:07:50 +0200 |
commit | 8388cd90e89358f73ddcb7f496a1a8dc5c30c36c (patch) | |
tree | eefe28014c1cd08d6f3e05a1b3ef872d87751a01 /docs/content/en | |
parent | bc57f5c36e8d93efd741541daa518581f77aa3d9 (diff) |
docs: Document group
Fixes https://github.com/gohugoio/hugoDocs/issues/597
Diffstat (limited to 'docs/content/en')
-rw-r--r-- | docs/content/en/functions/group.md | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/content/en/functions/group.md b/docs/content/en/functions/group.md new file mode 100644 index 000000000..e1a22ef5d --- /dev/null +++ b/docs/content/en/functions/group.md @@ -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). + + + + |