fix: publish document update metadata

Author: ryosukeeeeee

.gitignore

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

docs/last-updated.json

@@ -0,0 +1,25 @@
+{
+  "_404.md": "2022-02-08",
+  "_sidebar.md": "2022-07-08",
+  "about.md": "2022-07-09",
+  "advanced/beAdmin.md": "2026-01-28",
+  "advanced/beauty.md": "2024-04-07",
+  "advanced/troubleshooting.md": "2022-12-04",
+  "advanced/undervoltage.md": "2022-07-09",
+  "contribution.md": "2022-07-08",
+  "exclusive/code.md": "2023-11-21",
+  "exclusive/media.md": "2022-08-25",
+  "exclusive/mine.md": "2022-08-31",
+  "play&office/android.md": "2023-07-08",
+  "play&office/media.md": "2022-12-29",
+  "play&office/office.md": "2024-06-25",
+  "play&office/play.md": "2024-02-20",
+  "postscript.md": "2022-05-29",
+  "README.md": "2024-02-22",
+  "rookie/archlinux_pre_install.md": "2022-08-17",
+  "rookie/basic_install.md": "2024-04-07",
+  "rookie/DE&App.md": "2024-03-16",
+  "rookie/fxckGFW.md": "2023-01-19",
+  "rookie/graphic_driver.md": "2024-02-11",
+  "rookie/transparentProxy.md": "2022-02-08"
+}

scripts/build.mjs

@@ -6,11 +6,12 @@ import { writeLastUpdatedManifest } from "./generate-last-updated.mjs";
 
 const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 const output = resolve(root, "dist");
+const lastUpdatedManifest = resolve(root, "docs/last-updated.json");
 
+writeLastUpdatedManifest(lastUpdatedManifest);
 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/validate-site.mjs

@@ -23,6 +23,7 @@ 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");
+const lastUpdated = JSON.parse(readFileSync(resolve(docsDirectory, "last-updated.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.");
@@ -37,6 +38,17 @@ assert(!siteScript.includes("topMargin:"), "Deprecated topMargin must not offset
 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 expectedMetadataFiles = markdownFiles
+  .map((file) => file.slice(docsDirectory.length + 1).replaceAll("\\", "/"))
+  .sort();
+assert(
+  JSON.stringify(Object.keys(lastUpdated).sort()) === JSON.stringify(expectedMetadataFiles),
+  "Last-updated metadata must cover every Chinese Markdown file.",
+);
+for (const [file, date] of Object.entries(lastUpdated)) {
+  assert(/^\d{4}-\d{2}-\d{2}$/.test(date), `Invalid last-updated date for ${file}.`);
+}
+
 const commentInvariants = [
   'clientID: "296c581fc4b2a837a1e3"',
   'clientSecret: "7e7f0ad1809fa4a1915430ade04835f6849ab56a"',