fix showLastUpdate #503

* Add configurable timestamping

* Add attribution for configurable timestamping

* Add new post timestamp options to example hugo.toml

* All date formats are now set by single config option in site or page config

* Add post timestamp explainer and examples to example config file

* Add configurable timestamping value to frontmatter archetype

* Explain possible timezone rendering issue with new time formatting

* Fix bug concerning time/date tokens

* Convert datestamps to work with a partial

* Fix issue with lastmod being equal to date

* Add Updated prefix functionality

COMMUNITY-FEATURES.md

@@ -23,3 +23,12 @@ eg:
 - **Single Page Website** (https://github.com/justinnuwin/hugo-theme-terminal)
   - A layout where the homepage can render lists of pages and the navigation menu can link to sections on the homepage.
   - Justin Nguyen, software and hardware developer.
+
+- **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))

LICENSE.md

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 panr
+Copyright (c) 2024 panr
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

README.md

@@ -1,10 +1,14 @@
 # Terminal
 
+**Demo: https://panr.github.io/hugo-theme-terminal-demo/**
+
+**Create your own color scheme: https://panr.github.io/terminal-css/**
+
 ![Terminal](https://github.com/panr/hugo-theme-terminal/blob/master/images/terminal-theme.png?raw=true)
 
-**DEMO - https://panr.github.io/hugo-theme-terminal-demo/**
+---
 
-**⚠️ The theme needs at least Hugo **Extended** v0.90.x.**
+⚠️ The theme needs at least Hugo **Extended** v0.90.x.
 
 ---
 
@@ -24,7 +28,7 @@
 
 ## Features
 
-- fully customizable color schemes generated by [**terminal.css**](https://panr.github.io/terminal-css/).
+- fully customizable color schemes generated by [**Terminal.css**](https://panr.github.io/terminal-css/).
 - [**Fira Code**](https://github.com/tonsky/FiraCode) as default monospaced font. It's gorgeous!
 - **really nice duotone**, custom syntax highlighting based on [**PrismJS**](https://prismjs.com)
 - fully responsive
@@ -199,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

USERS.md

@@ -56,6 +56,13 @@
 - https://sir-photch.xyz **Sir-Photch** (ComSci-student. German Blog)
 - https://drewmorris.info **Drew Morris** (Mathematician && Computer Scientist)
 - https://blog.darkiiiiiice.com **MarioMang** (Software Developer)
+- https://www.sagbot.com **E. HADDAG** (Computer Scientist)
+- https://adamperkowski.dev **Adam Perkowski** (A Random Developer)
+- https://imortio.github.io **Azrul** (CompSci Student)
+- https://carmar.is **Carmaris** (Amateur Hacker)
+- https://ragonneau.github.io **Tom Ragonneau** (Engineer)
+- https://katiethe.dev **KatieTheDev** (Amateur porgrammer and tinkerer)
+- https://stefka.eu **Jiří Štefka** (Software Developer)
 
 <!--
  TEMPLATE:
@@ -64,3 +71,4 @@
 
  -->
 
+

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 = ""

assets/css/code.css

@@ -1,4 +1,3 @@
-/* _code.scss */
 pre {
   margin: 20px 0;
 }

assets/css/fonts.css

@@ -1,15 +1,19 @@
-/* _font.scss */
 @font-face {
   font-display: swap;
   font-family: "Fira Code";
   font-style: normal;
   font-weight: 400;
   src: url("../fonts/FiraCode-Regular.woff") format("woff");
+  font-feature-settings: "liga", "tnum", "ss01", "locl";
+  font-variant-ligatures: contextual;
 }
+
 @font-face {
   font-display: swap;
   font-family: "Fira Code";
   font-style: normal;
   font-weight: 800;
   src: url("../fonts/FiraCode-Bold.woff") format("woff");
+  font-feature-settings: "liga", "tnum", "ss01", "locl";
+  font-variant-ligatures: contextual;
 }

assets/css/footer.css

@@ -1,4 +1,3 @@
-/* _footer.scss */
 .footer {
   padding: 40px 0;
   flex-grow: 0;

assets/css/gist.css

@@ -1,4 +1,3 @@
-/* _gist.scss */
 body .gist .blob-num,
 body .gist .blob-code-inner {
   border: none;

assets/css/header.css

@@ -1,4 +1,3 @@
-/* _header.scss */
 .header {
   display: flex;
   flex-direction: column;

assets/css/main.css

@@ -1,4 +1,3 @@
-/* _main.scss */
 html {
   box-sizing: border-box;
 }
@@ -20,8 +19,6 @@ body {
   color: var(--foreground);
   text-rendering: optimizelegibility;
   -webkit-font-smoothing: antialiased;
-  font-feature-settings: "liga", "tnum", "zero", "ss01", "locl";
-  font-variant-ligatures: contextual;
   -webkit-overflow-scrolling: touch;
   text-size-adjust: 100%;
 }

assets/css/menu.css

@@ -1,4 +1,3 @@
-/* _menu.scss */
 .navigation-menu {
   display: flex;
   align-items: flex-start;

assets/css/pagination.css

@@ -1,4 +1,3 @@
-/* _pagination.scss */
 .pagination {
   margin-top: 50px;
 }

assets/css/post.css

@@ -1,4 +1,3 @@
-/* _post.scss */
 .index-content {
   margin-top: 20px;
 }

assets/css/prism.css

@@ -1,5 +1,3 @@
-/* _prism.scss */
-
 /* PrismJS 1.24.1
 https://prismjs.com/download.html#themes=prism-tomorrow&languages=markup+css+clike+javascript+actionscript+apacheconf+applescript+bash+c+csharp+cpp+cmake+coffeescript+csp+css-extras+diff+django+docker+elixir+elm+erlang+fsharp+flow+git+go+graphql+haml+handlebars+haskell+http+java+json+kotlin+latex+less+llvm+makefile+markdown+markup-templating+nasm+objectivec+ocaml+perl+php+php-extras+powershell+processing+pug+python+r+jsx+tsx+reason+ruby+rust+sass+scss+scala+scheme+sql+stylus+swift+textile+toml+twig+typescript+vim+visual-basic+wasm+yaml&plugins=line-highlight+line-numbers+jsonp-highlight+highlight-keywords+command-line+toolbar+copy-to-clipboard */
 

assets/css/syntax.css

@@ -1,4 +1,3 @@
-/* _syntax.scss */
 code.language-css,
 code.language-scss,
 .token.boolean,

assets/css/terminal.css

@@ -1,12 +1,10 @@
-@import url("https://fonts.googleapis.com/css2?family=Fira+Code&family=Fira+Code:wght@400;700&display=swap");
-
 :root {
-  --background: #222129;
+  --background: #1a170f;
-  --foreground: #ffffff;
+  --foreground: #eceae5;
-  --accent: #ffa86a;
+  --accent: #eec35e;
   --font-size: 1rem;
   --line-height: 1.54rem;
-  --radius: 0px;
+  --radius: 0;
 }
 
 html {
@@ -14,8 +12,8 @@ html {
 }
 
 *,
-*:before,
+*::before,
-*:after {
+*::after {
   box-sizing: inherit;
   margin: 0;
   padding: 0;
@@ -28,7 +26,7 @@ body {
     "Fira Code",
     Monaco,
     Consolas,
-    Ubuntu Mono,
+     "Ubuntu Mono",
     monospace;
   font-size: 1rem;
   font-weight: 400;
@@ -36,12 +34,10 @@ body {
   letter-spacing: -0.02em;
   background-color: var(--background);
   color: var(--foreground);
-  text-rendering: optimizeLegibility;
+  text-rendering: optimizelegibility;
   -webkit-font-smoothing: antialiased;
-  font-feature-settings: "liga", "tnum", "zero", "ss01", "locl";
-  font-variant-ligatures: contextual;
   -webkit-overflow-scrolling: touch;
-  -webkit-text-size-adjust: 100%;
+  text-size-adjust: 100%;
 }
 
 ::placeholder {
@@ -258,7 +254,7 @@ kbd {
     "Fira Code",
     Monaco,
     Consolas,
-    Ubuntu Mono,
+    "Ubuntu Mono",
     monospace !important;
   font-feature-settings: normal;
   background: color-mix(in srgb, var(--foreground) 5%, transparent);
@@ -333,7 +329,7 @@ blockquote {
   padding: 25px;
 }
 
-blockquote:before {
+blockquote::before {
   content: ">";
   display: block;
   position: absolute;

assets/css/terms.css

@@ -1,4 +1,3 @@
-/* _terms.scss */
 .terms h3 {
   font-size: initial;
 }

layouts/_default/index.html

@@ -23,7 +23,7 @@
         <div class="post-meta">
           {{- if .Date -}}
             <time class="post-date">
-              {{- .Date.Format "2006-01-02" -}}
+              {{- partial "post-date" . -}}
             </time>
           {{- end -}}
           {{- with .Params.Author -}}

layouts/_default/list.html

@@ -13,7 +13,7 @@
         <div class="post-meta">
           {{- if .Date -}}
             <time class="post-date">
-              {{- .Date.Format "2006-01-02" -}}
+              {{- partial "post-date" . -}}
             </time>
           {{- end -}}
           {{- with .Params.Author -}}
@@ -37,7 +37,7 @@
           {{ if .Params.showFullContent }}
             {{ .Content }}
           {{ else if .Description }}
-            {{ .Description | markdownify }}
+            <p>{{ .Description | markdownify }}</p>
           {{ else }}
             {{ .Summary }}
           {{ end }}
@@ -45,7 +45,7 @@
 
         {{ if not .Params.showFullContent }}
            <div>
-            <a class="read-more button" href="{{.RelPermalink}}">{{ $.Site.Params.ReadMore }} →</a>
+            <a class="read-more button inline" href="{{ .RelPermalink }}">{{ $.Site.Params.ReadMore }}</a>
           </div>
         {{ end }}
       </article>

layouts/_default/single.html

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

layouts/_default/term.html

@@ -38,7 +38,7 @@
           {{ if .Params.showFullContent }}
             {{ .Content }}
           {{ else if .Description }}
-            {{ .Description | markdownify }}
+            <p>{{ .Description | markdownify }}</p>
           {{ else }}
             {{ .Summary }}
           {{ end }}
@@ -46,7 +46,7 @@
 
         {{ if not .Params.showFullContent }}
           <div>
-            <a class="read-more button" href="{{.RelPermalink}}">{{ $.Site.Params.ReadMore }} →</a>
+            <a class="read-more button inline" href="{{ .RelPermalink }}">{{ $.Site.Params.ReadMore }}</a>
           </div>
         {{ end }}
       </article>

layouts/partials/post-date.html

@@ -0,0 +1,10 @@
+{{- $date := .Date -}}
+{{- with .Params.dateFormat -}}
+  {{- $date | time.Format . -}}
+{{- else -}}
+  {{- with .Site.Params.dateFormat -}}
+    {{- $date | time.Format . -}}
+  {{- else -}}
+    {{- $date | time.Format "2006-01-02" -}}
+  {{- end -}}
+{{- end -}}

layouts/partials/post-lastmod.html

@@ -0,0 +1,10 @@
+{{- $date := .Lastmod -}}
+{{- with .Params.dateFormat -}}
+  {{- $date | time.Format . -}}
+{{- else -}}
+  {{- with .Site.Params.dateFormat -}}
+    [{{- or $.Site.Params.updatedDatePrefix "Updated: " }} {{ $date | time.Format . -}}]
+  {{- else -}}
+    [{{- or $.Site.Params.updatedDatePrefix "Updated: " }} {{ $date | time.Format "2006-01-02" -}}]
+  {{- end -}}
+{{- end -}}