Allow override of date format (#291)

Previously the default date format (`January 2, 2006` ) was used for
blog and single page date visualizations.

The new parameter `date_format` can be used to override this format.
This allows the visualization of localized dates or a changed precision
(down to the minute or up to the month or year of publication).

Co-authored-by: Regis Philibert <login@regisphilibert.com>
This commit is contained in:
Lars Kruse 2021-10-01 19:45:22 +02:00 committed by GitHub
parent 775277039e
commit b0bf3ccca1
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
3 changed files with 14 additions and 2 deletions

View file

@ -192,6 +192,18 @@ You can replace the title of your site in the top left corner of each page with
``` ```
### Localize date format
Dates of blog posts and single pages are rendered with the default date format commonly used in the USA and Canada. It is possible to specify a different format.
```
[params]
date_format = "2. January 2006"
```
See hugo's documentation of the [`dateFormat` function](https://gohugo.io/functions/dateformat/) for more details.
### Nearly finished ### Nearly finished
In order to see your site in action, run Hugo's built-in local server. In order to see your site in action, run Hugo's built-in local server.

View file

@ -32,7 +32,7 @@
{{/* Hugo uses Go's date formatting is set by example. Here are two formats */}} {{/* Hugo uses Go's date formatting is set by example. Here are two formats */}}
{{ if not .Date.IsZero }} {{ if not .Date.IsZero }}
<time class="f6 mv4 dib tracked" {{ printf `datetime="%s"` (.Date.Format "2006-01-02T15:04:05Z07:00") | safeHTMLAttr }}> <time class="f6 mv4 dib tracked" {{ printf `datetime="%s"` (.Date.Format "2006-01-02T15:04:05Z07:00") | safeHTMLAttr }}>
{{- .Date.Format "January 2, 2006" -}} {{- .Date.Format (default "January 2, 2006" .Site.Params.date_format) -}}
</time> </time>
{{end}} {{end}}

View file

@ -1,7 +1,7 @@
<div class="mb3 pa4 mid-gray overflow-hidden"> <div class="mb3 pa4 mid-gray overflow-hidden">
{{ if .Date }} {{ if .Date }}
<div class="f6"> <div class="f6">
{{ .Date.Format "January 2, 2006" }} {{ .Date.Format (default "January 2, 2006" .Site.Params.date_format) }}
</div> </div>
{{ end }} {{ end }}
<h1 class="f3 near-black"> <h1 class="f3 near-black">