When grouping by last modification date, the value is determined by your [site configuration], defaulting to the lastmod
field in front matter.
The layout string
has the same format as the layout string for the time.Format
function. The resulting group key is localized
for language and region.
#configure-dates
To group content by year and month:
{{ range .Pages.GroupByLastmod "January 2006" }}
<p>{{ .Key }}</p>
<ul>
{{ range .Pages }}
<li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
{{ end }}
</ul>
{{ end }}
To sort the groups in ascending order:
{{ range .Pages.GroupByLastmod "January 2006" "asc" }}
<p>{{ .Key }}</p>
<ul>
{{ range .Pages }}
<li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
{{ end }}
</ul>
{{ end }}
The pages within each group will also be sorted by last modification date, either ascending or descending depending on your grouping option. To sort the pages within each group, use one of the sorting methods. For example, to sort the pages within each group by title:
{{ range .Pages.GroupByLastmod "January 2006" }}
<p>{{ .Key }}</p>
<ul>
{{ range .Pages.ByTitle }}
<li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
{{ end }}
</ul>
{{ end }}