Allow override of date format (#291)

Lars Kruse

01.45.2021 b0bf3ccca1a431feb7b788b2ec1210aa903bed97

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>

 README.md

@@ -192,6 +192,18 @@
```


### 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

In order to see your site in action, run Hugo's built-in local server.

 layouts/_default/single.html

@@ -32,7 +32,7 @@
      {{/* Hugo uses Go's date formatting is set by example. Here are two formats */}}
      {{ if not .Date.IsZero }}
      <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>
      {{end}}


 layouts/post/summary.html

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