feat: 更新日期和时间格式化，替换 medium 为 long 避免上游错误

Author: tom2almighty

exampleSite/config/_default/params.yaml

@@ -233,23 +233,46 @@ readingProgress:
 #   1) Hugo localization tokens (recommended): ":date_full" / ":date_long" / ":date_medium" / ":date_short"
 #      Automatically localized based on the current language's locale
 #      (e.g., en → "January 2, 2006", zh-Hans → "2006年1月2日").
+#      NOTE: ":date_medium" currently has an upstream bug under en-GB (month is omitted except September),
+#      so the theme uses ":date_long" for places that previously used medium.
 #   2) Go time layout string: reference time is "Mon Jan 2 15:04:05 MST 2006". Examples:
 #        "2006-01-02"           → 2024-05-01
 #        "January 2, 2006"      → May 1, 2024
 #        "2006年1月2日"         → 2024年5月1日
 #        "Jan 2, 2006"          → May 1, 2024
 #        "02 Jan 2006"          → 01 May 2024
-# Usage:
-#   long   : Article detail page, homepage hero
-#   medium : List / card / timeline / JSON Feed
-#   short  : Archive page, previous/next article
+# Usage (which variants the theme actually renders):
+#   full   : reserved for opt-in custom usage
+#   long   : article detail page, homepage hero, list / card / timeline / JSON Feed,
+#            archive page, previous/next article (i.e. all theme-rendered dates)
+#   medium : not used by the theme by default (kept here for user customization)
+#   short  : not used by the theme by default (kept here for user customization)
 # Leave empty to keep the defaults below.
 # To configure per language, override via languages.<lang>.params.dateFormat in languages.yaml.
 dateFormat:
+  full: ":date_full"
   long: ":date_long"
   medium: ":date_medium"
   short: ":date_short"
   # Custom examples:
   # long: "January 2, 2006"
   # medium: "2006-01-02"
   # short: "01/02"
+
+# Time format (optional)
+#
+# Used by helpers/date.html when called with kind="time", e.g.:
+#   {{ partial "helpers/date.html" (dict "date" .Date "variant" "short" "kind" "time") }}
+# Same value rules as dateFormat: either Hugo localization tokens
+# (":time_full" / ":time_long" / ":time_medium" / ":time_short") or a Go time layout
+# string (e.g. "15:04", "3:04 PM"). The theme does not render time values out of the
+# box; this block exists so users / custom partials can use it without extra config.
+# Per-language override is also supported via languages.<lang>.params.timeFormat.
+timeFormat:
+  full: ":time_full"
+  long: ":time_long"
+  medium: ":time_medium"
+  short: ":time_short"
+  # Custom examples:
+  # long: "15:04:05"
+  # short: "3:04 PM"

layouts/_partials/content/card-base.html

@@ -72,7 +72,7 @@
           <div class="flex items-center gap-1.5">
             {{ partial "features/icon.html" (dict "name" "calendar" "size" "sm" "ariaLabel" "") }}
             <time datetime="{{ $page.Date.Format `2006-01-02` }}" class="font-medium">
-              {{ partial "helpers/date.html" (dict "date" $page.Date "variant" "medium") }}
+              {{ partial "helpers/date.html" (dict "date" $page.Date "variant" "long") }}
             </time>
           </div>
 

layouts/_partials/helpers/date.html

@@ -1,23 +1,42 @@
 {{- /*
-  日期格式化辅助 partial。
+  日期 / 时间格式化辅助 partial。
 
-  根据 site.Params.dateFormat 渲染日期，可被 languages.<lang>.params.dateFormat 覆盖。
-  支持两种格式：
-    - Hugo 本地化 token：":date_full" / ":date_long" / ":date_medium" / ":date_short"
-      （依据当前语言的 locale 自动本地化输出）
-    - Go 时间布局串：例如 "2006-01-02"、"January 2, 2006"、"2006年1月2日"
-      （按字面输出，不本地化）
+  根据 site.Params.dateFormat（kind=date）或 site.Params.timeFormat（kind=time）渲染输入值，
+  可被 languages.<lang>.params.dateFormat / .timeFormat 覆盖。
+
+  支持两种格式串：
+    - Hugo 本地化 token（依据当前语言的 locale 自动本地化）：
+        日期：":date_full" / ":date_long" / ":date_medium" / ":date_short"
+        时间：":time_full" / ":time_long" / ":time_medium" / ":time_short"
+    - Go 时间布局串（按字面输出，不本地化）：
+        例如 "2006-01-02"、"January 2, 2006"、"15:04"、"3:04 PM"
 
   入参 (dict)：
     date    : time.Time，必填
-    variant : "long" | "medium" | "short"，可选，默认 "medium"
+    variant : "full" | "long" | "medium" | "short"，可选，默认 "long"
+    kind    : "date" | "time"，可选，默认 "date"
 
   使用示例：
     {{ partial "helpers/date.html" (dict "date" .Date "variant" "long") }}
+    {{ partial "helpers/date.html" (dict "date" .Date "variant" "short" "kind" "time") }}
 */ -}}
 {{- $date := .date -}}
-{{- $variant := .variant | default "medium" -}}
-{{- $defaults := dict "long" ":date_long" "medium" ":date_medium" "short" ":date_short" -}}
-{{- $configured := site.Params.dateFormat | default dict -}}
-{{- $format := (index $configured $variant) | default (index $defaults $variant) -}}
+{{- $variant := .variant | default "long" -}}
+{{- $kind := .kind | default "date" -}}
+{{- $defaults := dict
+  "date" (dict
+    "full" ":date_full"
+    "long" ":date_long"
+    "medium" ":date_medium"
+    "short" ":date_short")
+  "time" (dict
+    "full" ":time_full"
+    "long" ":time_long"
+    "medium" ":time_medium"
+    "short" ":time_short")
+-}}
+{{- $configKey := cond (eq $kind "time") "timeFormat" "dateFormat" -}}
+{{- $configured := (index site.Params $configKey) | default dict -}}
+{{- $kindDefaults := index $defaults $kind -}}
+{{- $format := (index $configured $variant) | default (index $kindDefaults $variant) -}}
 {{- $date | time.Format $format -}}

layouts/index.json

@@ -13,7 +13,7 @@
     "content" .Plain
     "permalink" .RelPermalink
     "section" .Section
-    "date" (partial "helpers/date.html" (dict "date" .Date "variant" "medium"))
+    "date" (partial "helpers/date.html" (dict "date" .Date "variant" "long"))
     "readingTime" .ReadingTime
     "tags" (.Params.tags | default (slice))
     "categories" (.Params.categories | default (slice))

layouts/list.html

@@ -29,7 +29,7 @@ <h2 class="text-foreground mb-2 text-xl font-semibold">
             {{ if .Date }}
               <div class="text-muted-foreground mb-3 text-sm">
                 <time datetime="{{ .Date.Format ` 2006-01-02` }}">
-                  {{ partial "helpers/date.html" (dict "date" .Date "variant" "medium") }}
+                  {{ partial "helpers/date.html" (dict "date" .Date "variant" "long") }}
                 </time>
               </div>
             {{ end }}

layouts/projects/single.html

@@ -56,7 +56,7 @@ <h1 class="text-foreground mb-4 text-3xl font-bold md:text-4xl lg:text-5xl">
           <div class="flex flex-wrap items-center gap-3 text-sm font-semibold">
             <div class="text-foreground">
               <time datetime="{{ .Date.Format `2006-01-02` }}">
-                {{ partial "helpers/date.html" (dict "date" .Date "variant" "medium") }}
+                {{ partial "helpers/date.html" (dict "date" .Date "variant" "long") }}
               </time>
             </div>
 

layouts/timeline.html

@@ -13,7 +13,7 @@ <h1 class="text-foreground text-3xl font-bold">
         <div class="text-muted-foreground flex items-center gap-2 text-sm">
           {{ partial "features/icon.html" (dict "name" "calendar" "size" "sm" "ariaLabel" "") }}
           <time datetime="{{ .Format `2006-01-02` }}">
-            {{ partial "helpers/date.html" (dict "date" . "variant" "medium") }}
+            {{ partial "helpers/date.html" (dict "date" . "variant" "long") }}
           </time>
         </div>
       {{ end }}