From c4058528fccbaea10527e97e88219eba4d92d84a Mon Sep 17 00:00:00 2001
From: kurihada <kurihada@qq.com>
Date: Thu, 4 Jun 2026 12:04:13 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=87=E7=AB=A0=E9=A1=B6=E9=83=A8?=
 =?UTF-8?q?=E8=87=AA=E5=8A=A8=E6=98=BE=E7=A4=BA=E5=85=83=E6=95=B0=E6=8D=AE?=
 =?UTF-8?q?=E6=A0=8F=EF=BC=88=E5=88=9B=E5=BB=BA=E6=97=A5=E6=9C=9F=E3=80=81?=
 =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=97=A5=E6=9C=9F=E3=80=81=E5=AD=97=E6=95=B0?=
 =?UTF-8?q?=E3=80=81=E9=98=85=E8=AF=BB=E6=97=B6=E9=97=B4=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 安装 mkdocs-git-revision-date-localized-plugin，自动提取 git 提交日期
- 覆盖 content.html，在标题下方注入元数据栏
- JavaScript 自动统计中英文字数并估算阅读时间（400 字/分钟）
- 适配 Material SPA 导航 (document$.subscribe)，页面切换时自动更新
- 深色模式兼容
---
 docs/overrides/partials/content.html | 91 ++++++++++++++++++++++++++++
 mkdocs.yml                           |  4 ++
 2 files changed, 95 insertions(+)
 create mode 100644 docs/overrides/partials/content.html

diff --git a/docs/overrides/partials/content.html b/docs/overrides/partials/content.html
new file mode 100644
index 0000000..751a9e8
--- /dev/null
+++ b/docs/overrides/partials/content.html
@@ -0,0 +1,91 @@
+{#-
+  Override Material theme content partial
+  Adds page metadata bar: creation date, update date, word count, reading time
+-#}
+{% include "partials/tags.html" %}
+{% include "partials/actions.html" %}
+{% if "<h1" not in page.content %}
+  <h1>{{ page.title | d(config.site_name, true)}}</h1>
+{% endif %}
+
+{#- Metadata bar #}
+{% if page.meta and (page.meta.git_revision_date_localized or page.meta.git_creation_date_localized) %}
+<div class="md-page-metadata">
+  <span class="md-page-metadata__item">
+    <span class="twemoji">{% include ".icons/material/calendar-plus.svg" %}</span>
+    创建：{{ page.meta.git_creation_date_localized }}
+  </span>
+  <span class="md-page-metadata__item">
+    <span class="twemoji">{% include ".icons/material/calendar-edit.svg" %}</span>
+    更新：{{ page.meta.git_revision_date_localized }}
+  </span>
+  <span class="md-page-metadata__item" id="word-count">
+    <span class="twemoji">{% include ".icons/material/text-short.svg" %}</span>
+    字数：<span id="word-count-value">...</span>
+  </span>
+  <span class="md-page-metadata__item" id="reading-time">
+    <span class="twemoji">{% include ".icons/material/clock-outline.svg" %}</span>
+    阅读：<span id="reading-time-value">...</span>
+  </span>
+</div>
+{% endif %}
+
+{{ page.content }}
+{% include "partials/source-file.html" %}
+{% include "partials/feedback.html" %}
+{% include "partials/comments.html" %}
+
+{#- Word count & reading time script (SPA-aware) #}
+<script>
+function updateMeta() {
+  var article = document.querySelector('.md-content__inner') || document.querySelector('.md-content');
+  if (!article) return;
+  var text = article.textContent || '';
+  // Chinese characters
+  var chineseChars = (text.match(/[一-鿿㐀-䶿]/g) || []).length;
+  // English/other words
+  var englishWords = text.replace(/[一-鿿㐀-䶿]/g, ' ')
+    .split(/\s+/)
+    .filter(function(w) { return w.length > 0; }).length;
+  var totalWords = chineseChars + englishWords;
+  var minutes = Math.max(1, Math.round(totalWords / 400));
+  var wordEl = document.getElementById('word-count-value');
+  var timeEl = document.getElementById('reading-time-value');
+  if (wordEl) wordEl.textContent = totalWords.toLocaleString();
+  if (timeEl) timeEl.textContent = minutes + ' 分钟';
+}
+// SPA-compatible: run on load and on navigation
+if (typeof document$ !== 'undefined') {
+  document$.subscribe(function() { updateMeta(); });
+} else {
+  document.addEventListener('DOMContentLoaded', updateMeta);
+}
+</script>
+
+{#- CSS for metadata bar #}
+<style>
+.md-page-metadata {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem 1.5rem;
+  margin: 0 0 1.5rem 0;
+  padding-bottom: 0.75rem;
+  border-bottom: 1px solid var(--md-default-fg-color--lightest);
+  font-size: 0.7rem;
+  color: var(--md-default-fg-color--light);
+}
+.md-page-metadata__item {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.2rem;
+  white-space: nowrap;
+}
+.md-page-metadata__item .twemoji {
+  width: 0.9rem;
+  height: 0.9rem;
+}
+.md-page-metadata__item .twemoji svg {
+  width: 100%;
+  height: 100%;
+}
+</style>
diff --git a/mkdocs.yml b/mkdocs.yml
index a37aa60..064b82c 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -52,6 +52,10 @@ markdown_extensions:
 plugins:
   - search:
       lang: zh                # 中文搜索优化
+  - git-revision-date-localized:
+      enable_creation_date: true
+      type: date
+      locale: zh
 
 extra:
   social: