mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-18 18:06:46 -05:00
32 lines
826 B
Markdown
32 lines
826 B
Markdown
|
---
|
||
|
|
title: ByPublishDate
|
||
|
|
description: Returns the given page collection sorted by publish date in ascending order.
|
||
|
|
categories: []
|
||
|
|
keywords: []
|
||
|
|
action:
|
||
|
|
related:
|
||
|
|
- methods/pages/ByDate
|
||
|
|
- methods/pages/ByExpiryDate
|
||
|
|
- methods/pages/ByLastMod
|
||
|
|
returnType: page.Pages
|
||
|
|
signatures: [PAGES.ByPublishDate]
|
||
|
|
---
|
||
|
|
|
||
|
|
When sorting by publish date, the value is determined by your [site configuration], defaulting to the `publishDate` field in front matter.
|
||
|
|
|
||
|
|
[site configuration]: /getting-started/configuration/#configure-dates
|
||
|
|
|
||
|
|
```go-html-template
|
||
|
|
{{ range .Pages.ByPublishDate }}
|
||
|
|
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
|
||
|
|
{{ end }}
|
||
|
|
```
|
||
|
|
|
||
|
|
To sort in descending order:
|
||
|
|
|
||
|
|
```go-html-template
|
||
|
|
{{ range .Pages.ByPublishDate.Reverse }}
|
||
|
|
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
|
||
|
|
{{ end }}
|
||
|
|
```
|