Add configurable timestamping for posts

COMMUNITY-FEATURES.md

@@ -27,3 +27,8 @@ eg:
 - **Support for beautiful *KaTeX* formulae** ([amtoine/hugo-theme-terminal-katex](https://github.com/amtoine/hugo-theme-terminal-katex))
   - SHORT DESCRIPTION
   - Antoine Stevan ([@amtoine](https://github.com/amtoine)), software engineer into open source
+
+- **Configurable timestamping for posts** ([KatieTheDev/hugo-theme-terminal](https://github.com/KatieTheDev/hugo-theme-terminal))
+  - Allows for configuring timestamping, not just datestamping
+  - Works with last modification dates as well
+  - KatieTheDev ([@KatieTheDev](https://github.com/KatieTheDev))

README.md

@@ -203,6 +203,20 @@ paginate = 5
   # can be overridden in a page's front-matter
   # TocTitle = "Table of Contents" # default
 
+  # Set date/time format for posts
+  # This will impact the date/time displayed on
+  # index.html, the posts list page, and on posts themselves
+  # This value can also be configured per-post on front matter
+  # If you have any issues with the timezone rendering differently
+  # than you expected, please ensure your timezone is correctly set
+  # on your server.
+  # This value can be customized according to Hugo documentation:
+  # https://gohugo.io/functions/time/format/
+  # Default value (no changes needed):
+  # dateFormat = "2006-01-02"
+  # Example format, with date, time, and timezone abbreviation:
+  # dateFormat = "2006-01-02 3:04:06 PM MST"
+
 
 [params.twitter]
   # set Twitter handles for Twitter cards

archetypes/posts.md

@@ -1,6 +1,7 @@
 +++
 title = "{{ replace .TranslationBaseName "-" " " | title }}"
 date = "{{ .Date }}"
+#dateFormat = "2006-01-02" # This value can be configured for per-post date formatting
 author = ""
 authorTwitter = "" #do not include @
 cover = ""

layouts/_default/index.html

@@ -23,7 +23,16 @@ <h2 class="post-title">
         <div class="post-meta">
           {{- if .Date -}}
             <time class="post-date">
-              {{- .Date.Format "2006-01-02" -}}
+              {{- $date := .Date | time -}}
+              {{- with .Params.dateFormat -}}
+                {{- $date.Format . -}}
+              {{- else -}}
+                {{- with .Site.Params.dateFormat -}}
+                  {{- $date.Format . -}}
+                {{- else -}}
+                  {{- $date.Format "2006-01-02" -}}
+                {{- end -}}
+              {{- end -}}
             </time>
           {{- end -}}
           {{- with .Params.Author -}}

layouts/_default/list.html

@@ -13,7 +13,16 @@ <h2 class="post-title">
         <div class="post-meta">
           {{- if .Date -}}
             <time class="post-date">
-              {{- .Date.Format "2006-01-02" -}}
+              {{- $date := .Date | time -}}
+              {{- with .Params.dateFormat -}}
+                {{- $date.Format . -}}
+              {{- else -}}
+                {{- with .Site.Params.dateFormat -}}
+                  {{- $date.Format . -}}
+                {{- else -}}
+                  {{- $date.Format "2006-01-02" -}}
+                {{- end -}}
+              {{- end -}}
             </time>
           {{- end -}}
           {{- with .Params.Author -}}

layouts/_default/single.html

@@ -6,9 +6,27 @@ <h1 class="post-title">
   <div class="post-meta">
     {{- if .Date -}}
       <time class="post-date">
-        {{- .Date.Format "2006-01-02" -}}
+        {{- $date := .Date | time -}}
+        {{- with .Params.dateFormat -}}
+          {{- $date.Format . -}}
+        {{- else -}}
+          {{- with .Site.Params.dateFormat -}}
+            {{- $date.Format . -}}
+          {{- else -}}
+            {{- $date.Format "2006-01-02" -}}
+          {{- end -}}
+        {{- end -}}
         {{- if $.Site.Params.showLastUpdated -}}
-          [{{- or $.Site.Params.updatedDatePrefix "Updated" -}} :: {{- .Lastmod.Format "2006-01-02" -}}]
+          {{- $lastmod := .Lastmod | time -}}
+          {{- with .Params.dateFormat -}}
+            &nbsp;[{{- $lastmod.Format . -}}]
+          {{- else -}}
+            {{- with .Site.Params.dateFormat -}}
+              &nbsp;[{{- $lastmod.Format . -}}]
+            {{- else -}}
+              &nbsp;[{{- $lastmod.Format "2006-01-02" -}}]
+            {{- end -}}
+          {{- end -}}
         {{- end -}}
       </time>
     {{- end -}}