From 75d4ae34b37f626e0f9f9878538dced3c69554cc Mon Sep 17 00:00:00 2001
From: FishAlchemist <48265002+FishAlchemist@users.noreply.github.com>
Date: Sun, 2 Feb 2025 17:53:36 +0800
Subject: [PATCH 1/4] Added mkdocs-git-revision-date-localized-plugin for show
 last updated

---
 docs/requirements.in  |  1 +
 docs/requirements.txt | 15 ++++++++++++++-
 mkdocs.public.yml     |  5 +++++
 3 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/docs/requirements.in b/docs/requirements.in
index 79fa08bd710ae..5f504e015dc83 100644
--- a/docs/requirements.in
+++ b/docs/requirements.in
@@ -6,3 +6,4 @@ mdformat>=0.7.17
 mdformat-mkdocs>=2.0.4
 mdformat-admon>=2.0.2
 mkdocs-redirects>=1.2.2
+mkdocs-git-revision-date-localized-plugin>=1.3.0
diff --git a/docs/requirements.txt b/docs/requirements.txt
index db42984670bf4..6392a30a58014 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,7 +1,9 @@
 # This file was autogenerated by uv via the following command:
 #    uv pip compile docs/requirements.in -o docs/requirements.txt --universal -p 3.12
 babel==2.15.0
-    # via mkdocs-material
+    # via
+    #   mkdocs-git-revision-date-localized-plugin
+    #   mkdocs-material
 black==24.4.2
     # via -r docs/requirements.in
 certifi==2024.7.4
@@ -19,6 +21,10 @@ colorama==0.4.6
     #   mkdocs-material
 ghp-import==2.1.0
     # via mkdocs
+gitdb==4.0.12
+    # via gitpython
+gitpython==3.1.44
+    # via mkdocs-git-revision-date-localized-plugin
 idna==3.7
     # via requests
 jinja2==3.1.4
@@ -72,10 +78,13 @@ mergedeep==1.3.4
 mkdocs==1.6.0
     # via
     #   -r docs/requirements.in
+    #   mkdocs-git-revision-date-localized-plugin
     #   mkdocs-material
     #   mkdocs-redirects
 mkdocs-get-deps==0.2.0
     # via mkdocs
+mkdocs-git-revision-date-localized-plugin==1.3.0
+    # via -r docs/requirements.in
 mkdocs-material==9.5.29
     # via -r docs/requirements.in
 mkdocs-material-extensions==1.3.1
@@ -106,6 +115,8 @@ pymdown-extensions==10.8.1
     # via mkdocs-material
 python-dateutil==2.9.0.post0
     # via ghp-import
+pytz==2025.1
+    # via mkdocs-git-revision-date-localized-plugin
 pyyaml==6.0.1
     # via
     #   mkdocs
@@ -120,6 +131,8 @@ requests==2.32.3
     # via mkdocs-material
 six==1.16.0
     # via python-dateutil
+smmap==5.0.2
+    # via gitdb
 uc-micro-py==1.0.3
     # via linkify-it-py
 urllib3==2.2.2
diff --git a/mkdocs.public.yml b/mkdocs.public.yml
index a8c0b99c8a208..e098bdb0bdde3 100644
--- a/mkdocs.public.yml
+++ b/mkdocs.public.yml
@@ -2,6 +2,11 @@ INHERIT: mkdocs.template.yml
 # Omit the `typeset` plugin which is only available in the Insiders version.
 plugins:
   - search
+  - git-revision-date-localized:
+      exclude:
+          - "reference/cli.md"
+          - "reference/settings.md"
+          - "configuration/environment.md"
 validation:
   anchors: warn
 watch:

From 1df24854a37949278d996c9df5a0d45bc513a518 Mon Sep 17 00:00:00 2001
From: FishAlchemist <48265002+FishAlchemist@users.noreply.github.com>
Date: Sun, 2 Feb 2025 19:04:24 +0800
Subject: [PATCH 2/4] Get the correct time for Google

---
 docs/.overrides/main.html | 4 ++++
 mkdocs.public.yml         | 7 ++++---
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/docs/.overrides/main.html b/docs/.overrides/main.html
index 07cd6bc02dc9c..774eb6d2c3081 100644
--- a/docs/.overrides/main.html
+++ b/docs/.overrides/main.html
@@ -21,6 +21,10 @@
 <meta name="robots" content="index,follow"/>
 <script type="application/ld+json">
     {
+        {% if page and page.meta.git_revision_date_localized_raw_iso_datetime %}
+        "datePublished": "{{ page.meta.git_revision_date_localized_raw_iso_datetime }}Z",
+        "dateModified": "{{ page.meta.git_revision_date_localized_raw_iso_datetime  }}Z",
+        {% endif %}
         "@context": "https://schema.org",
         "@type": "WebSite",
         "name": "Astral Docs",
diff --git a/mkdocs.public.yml b/mkdocs.public.yml
index e098bdb0bdde3..89f7a4fcf761e 100644
--- a/mkdocs.public.yml
+++ b/mkdocs.public.yml
@@ -3,10 +3,11 @@ INHERIT: mkdocs.template.yml
 plugins:
   - search
   - git-revision-date-localized:
+      timezone: UTC # It can only be in UTC unless the ISO time can include timezone.
       exclude:
-          - "reference/cli.md"
-          - "reference/settings.md"
-          - "configuration/environment.md"
+        - "reference/cli.md"
+        - "reference/settings.md"
+        - "configuration/environment.md"
 validation:
   anchors: warn
 watch:

From 3314a726cd3a32115a9e4b33491861a1a73a9446 Mon Sep 17 00:00:00 2001
From: FishAlchemist <48265002+FishAlchemist@users.noreply.github.com>
Date: Sun, 2 Feb 2025 20:52:45 +0800
Subject: [PATCH 3/4] Build the document with fetch-depth set to 0.

---
 .github/workflows/publish-docs.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/publish-docs.yml b/.github/workflows/publish-docs.yml
index 85900bda63431..5a8993a7a9218 100644
--- a/.github/workflows/publish-docs.yml
+++ b/.github/workflows/publish-docs.yml
@@ -26,6 +26,7 @@ jobs:
       - uses: actions/checkout@v4
         with:
           ref: ${{ inputs.ref }}
+          fetch-depth: 0
 
       - uses: actions/setup-python@v5
         with:

From 855021e384907b4442d5a22562a2d3eb577de404 Mon Sep 17 00:00:00 2001
From: FishAlchemist <48265002+FishAlchemist@users.noreply.github.com>
Date: Tue, 4 Feb 2025 11:05:17 +0800
Subject: [PATCH 4/4] Revoke the exclusion of automatically generated
 documents.

---
 mkdocs.public.yml | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/mkdocs.public.yml b/mkdocs.public.yml
index 89f7a4fcf761e..e919cf7761b98 100644
--- a/mkdocs.public.yml
+++ b/mkdocs.public.yml
@@ -4,10 +4,6 @@ plugins:
   - search
   - git-revision-date-localized:
       timezone: UTC # It can only be in UTC unless the ISO time can include timezone.
-      exclude:
-        - "reference/cli.md"
-        - "reference/settings.md"
-        - "configuration/environment.md"
 validation:
   anchors: warn
 watch: