1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
|
---
title: ByParam
description: Returns the given page collection sorted by the given parameter in ascending order.
categories: []
keywords: []
action:
related:
- methods/pages/ByTitle
- methods/pages/ByLinkTitle
returnType: page.Pages
signatures: [PAGES.ByParam PARAM]
---
If the given parameter is not present in front matter, Hugo will use the matching parameter in your site configuration if present.
```go-html-template
{{ range .Pages.ByParam "author" }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}
```
To sort in descending order:
```go-html-template
{{ range (.Pages.ByParam "author").Reverse }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}
```
If the targeted parameter is nested, access the field using dot notation:
```go-html-template
{{ range .Pages.ByParam "author.last_name" }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}
```
|
