fix: restore document update dates

Author: ryosukeeeeee

.github/workflows/pages.yml

@@ -26,6 +26,8 @@ jobs:
     steps:
       - name: Check out repository
         uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
 
       - name: Set up Node.js
         uses: actions/setup-node@v6

.gitignore

@@ -1,3 +1,4 @@
 node_modules/
 dist/
 *.log
+docs/last-updated.json

docs/index.html

@@ -119,7 +119,7 @@
     </noscript>
 
     <script src="./vendor/gitalk.min.js"></script>
-    <script src="./scripts/site.js?v=20260716-10"></script>
+    <script src="./scripts/site.js?v=20260716-11"></script>
     <script src="./vendor/docsify.min.js"></script>
     <script src="./vendor/prism-bash.min.js"></script>
     <script src="./vendor/search.min.js"></script>

docs/scripts/site.js

@@ -3,7 +3,7 @@
 
   const REPOSITORY = "https://github.com/ArchLinuxStudio/ArchLinuxTutorial";
   const THEME_STORAGE_KEY = "archtutorial-theme";
-  const updateCache = new Map();
+  let lastUpdatedManifestPromise;
   let activeMarkdown = "";
   let activeFile = "README.md";
 
@@ -78,30 +78,21 @@
   }
 
   async function fetchLastUpdated(file) {
-    const normalized = normalizeFile(file);
-    if (updateCache.has(normalized)) return updateCache.get(normalized);
-
-    const storageKey = `archtutorial-updated:${normalized}`;
-    const cached = sessionStorage.getItem(storageKey);
-    if (cached) {
-      updateCache.set(normalized, cached);
-      return cached;
+    if (!lastUpdatedManifestPromise) {
+      lastUpdatedManifestPromise = fetch(new URL("last-updated.json", document.baseURI), {
+        cache: "no-cache",
+        headers: { Accept: "application/json" },
+      }).then((response) => {
+        if (!response.ok) throw new Error(`Last-updated metadata responded with ${response.status}`);
+        return response.json();
+      });
     }
 
-    const endpoint =
-      "https://api.github.com/repos/ArchLinuxStudio/ArchLinuxTutorial/commits" +
-      `?per_page=1&path=docs/${encodedFilePath(normalized)}`;
-    const response = await fetch(endpoint, {
-      headers: { Accept: "application/vnd.github+json" },
-    });
-    if (!response.ok) throw new Error(`GitHub responded with ${response.status}`);
-
-    const commits = await response.json();
-    const date = commits?.[0]?.commit?.committer?.date?.slice(0, 10);
-    if (!date) throw new Error("No commit date returned");
-
-    updateCache.set(normalized, date);
-    sessionStorage.setItem(storageKey, date);
+    const dates = await lastUpdatedManifestPromise;
+    const date = dates[normalizeFile(file)];
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(date || "")) {
+      throw new Error(`No last-updated date for ${file}`);
+    }
     return date;
   }
 
@@ -313,6 +304,9 @@
     homepage: "README.md",
     loadNavbar: false,
     loadSidebar: true,
+    alias: {
+      "/.*/_sidebar.md": "/_sidebar.md",
+    },
     auto2top: true,
     routerMode: "hash",
     notFoundPage: true,
@@ -321,7 +315,6 @@
     topMargin: 88,
     externalLinkTarget: "_blank",
     externalLinkRel: "noopener noreferrer",
-    formatUpdated: "{YYYY}-{MM}-{DD}",
     search: {
       paths: "auto",
       depth: 4,

package.json

@@ -13,8 +13,8 @@
     "node": ">=20"
   },
   "scripts": {
-    "dev": "node scripts/sync-vendor.mjs && node node_modules/serve/build/main.js docs -l 3000 --no-clipboard",
-    "start": "node scripts/sync-vendor.mjs && node node_modules/serve/build/main.js docs -l 3000 --no-clipboard",
+    "dev": "node scripts/sync-vendor.mjs && node scripts/generate-last-updated.mjs && node node_modules/serve/build/main.js docs -l 3000 --no-clipboard",
+    "start": "node scripts/sync-vendor.mjs && node scripts/generate-last-updated.mjs && node node_modules/serve/build/main.js docs -l 3000 --no-clipboard",
     "sync:vendor": "node scripts/sync-vendor.mjs",
     "check": "node scripts/validate-site.mjs",
     "build": "node scripts/sync-vendor.mjs && node scripts/build.mjs"

scripts/build.mjs

@@ -2,13 +2,15 @@ import { cpSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import "./validate-site.mjs";
+import { writeLastUpdatedManifest } from "./generate-last-updated.mjs";
 
 const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const output = resolve(root, "dist");
 
 rmSync(output, { recursive: true, force: true });
 mkdirSync(output, { recursive: true });
 cpSync(resolve(root, "docs"), output, { recursive: true });
+writeLastUpdatedManifest(resolve(output, "last-updated.json"));
 writeFileSync(resolve(output, ".nojekyll"), "");
 
 console.log("Static site built in dist/.");

scripts/generate-last-updated.mjs

@@ -0,0 +1,49 @@
+import { execFileSync } from "node:child_process";
+import { mkdirSync, readdirSync, writeFileSync } from "node:fs";
+import { dirname, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const docsDirectory = resolve(root, "docs");
+
+function markdownFiles(directory) {
+  return readdirSync(directory, { withFileTypes: true }).flatMap((entry) => {
+    const path = resolve(directory, entry.name);
+    if (entry.isDirectory()) return markdownFiles(path);
+    return entry.name.toLowerCase().endsWith(".md") ? [path] : [];
+  });
+}
+
+export function collectLastUpdatedDates() {
+  const dates = {};
+
+  for (const file of markdownFiles(docsDirectory)) {
+    const documentPath = relative(docsDirectory, file).replaceAll("\\", "/");
+    const repositoryPath = `docs/${documentPath}`;
+    const date = execFileSync(
+      "git",
+      ["log", "-1", "--follow", "--format=%cs", "--", repositoryPath],
+      { cwd: root, encoding: "utf8" },
+    ).trim();
+
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(date)) {
+      throw new Error(`Could not determine the last commit date for ${repositoryPath}.`);
+    }
+
+    dates[documentPath] = date;
+  }
+
+  return Object.fromEntries(Object.entries(dates).sort(([left], [right]) => left.localeCompare(right)));
+}
+
+export function writeLastUpdatedManifest(outputFile) {
+  const dates = collectLastUpdatedDates();
+  mkdirSync(dirname(outputFile), { recursive: true });
+  writeFileSync(outputFile, `${JSON.stringify(dates, null, 2)}\n`, "utf8");
+  console.log(`Generated last-updated metadata for ${Object.keys(dates).length} documents.`);
+}
+
+const invokedDirectly = process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+if (invokedDirectly) {
+  writeLastUpdatedManifest(resolve(process.argv[2] || resolve(docsDirectory, "last-updated.json")));
+}

scripts/validate-site.mjs

@@ -21,12 +21,20 @@ const files = walk(docsDirectory);
 const markdownFiles = files.filter((file) => extname(file).toLowerCase() === ".md");
 const index = readFileSync(resolve(docsDirectory, "index.html"), "utf8");
 const siteScript = readFileSync(resolve(docsDirectory, "scripts/site.js"), "utf8");
+const workflow = readFileSync(resolve(root, ".github/workflows/pages.yml"), "utf8");
+const packageSource = readFileSync(resolve(root, "package.json"), "utf8");
 
 assert(markdownFiles.length === 23, `Expected 23 Chinese Markdown files, found ${markdownFiles.length}.`);
 assert(index.includes('lang="zh-CN"'), "The document language must remain zh-CN.");
 assert(index.includes("./vendor/docsify.min.js"), "The local Docsify bundle is not linked.");
 assert(index.includes("./scripts/site.js"), "The site controller is not linked.");
 assert(!/darkreader|unpkg\.com|fonts\.googleapis\.com/i.test(index), "Unexpected remote UI dependency found in index.html.");
+assert(siteScript.includes('new URL("last-updated.json", document.baseURI)'), "Local last-updated metadata is not loaded.");
+assert(!siteScript.includes("api.github.com/repos/"), "Last-updated dates must not depend on the GitHub API at runtime.");
+assert(siteScript.includes('"/.*/_sidebar.md": "/_sidebar.md"'), "Nested routes must reuse the root sidebar.");
+assert(!siteScript.includes("formatUpdated:"), "Unused Docsify update formatting must stay removed.");
+assert(workflow.includes("fetch-depth: 0"), "The deployment checkout must include full Git history.");
+assert(packageSource.includes("scripts/generate-last-updated.mjs"), "The local preview does not generate last-updated metadata.");
 
 const commentInvariants = [
   'clientID: "296c581fc4b2a837a1e3"',