generateSections,generateLanguagesとlib/docsを統合してシンプルに

Author: na-trium-144

app/lib/docs.ts

@@ -90,17 +90,43 @@ export async function getPagesList(): Promise<LanguageEntry[]> {
   );
 }
 
+export async function getSectionsList(
+  lang: string,
+  pageId: string
+): Promise<string[]> {
+  if (isCloudflare()) {
+    const sectionsYml = await readPublicFile(
+      `docs/${lang}/${pageId}/sections.yml`
+    );
+    return yaml.load(sectionsYml) as string[];
+  } else {
+    function naturalSortMdFiles(a: string, b: string): number {
+      // -intro.md always comes first
+      if (a === "-intro.md") return -1;
+      if (b === "-intro.md") return 1;
+      // Sort numerically by leading N1-N2 prefix
+      const aMatch = a.match(/^(\d+)-(\d+)/);
+      const bMatch = b.match(/^(\d+)-(\d+)/);
+      if (aMatch && bMatch) {
+        const n1Diff = parseInt(aMatch[1]) - parseInt(bMatch[1]);
+        if (n1Diff !== 0) return n1Diff;
+        return parseInt(aMatch[2]) - parseInt(bMatch[2]);
+      }
+      return a.localeCompare(b);
+    }
+    return (await readdir(join(process.cwd(), "public", "docs", lang, pageId)))
+      .filter((f) => f.endsWith(".md"))
+      .sort(naturalSortMdFiles);
+  }
+}
 /**
  * public/docs/{lang}/{pageId}/ 以下のmdファイルを結合して MarkdownSection[] を返す。
  */
 export async function getMarkdownSections(
   lang: string,
   pageId: string
 ): Promise<MarkdownSection[]> {
-  const sectionsYml = await readPublicFile(
-    `docs/${lang}/${pageId}/sections.yml`
-  );
-  const files = yaml.load(sectionsYml) as string[];
+  const files = await getSectionsList(lang, pageId);
 
   const sections: MarkdownSection[] = [];
   for (const file of files) {

package.json

@@ -7,14 +7,13 @@
     "packages/*"
   ],
   "scripts": {
-    "dev": "npm run cf-typegen && npm run generateLanguages && npm run generateSections && npm run copyAllDTSFiles && npm run removeHinting && next dev",
-    "build": "npm run cf-typegen && npm run generateLanguages && npm run generateSections && npm run copyAllDTSFiles && npm run removeHinting && next build",
+    "dev": "npm run cf-typegen && npm run generateDocsMeta && npm run copyAllDTSFiles && npm run removeHinting && next dev",
+    "build": "npm run cf-typegen && npm run generateDocsMeta && npm run copyAllDTSFiles && npm run removeHinting && next build",
     "start": "next start",
     "lint": "npm run cf-typegen && next lint",
     "tsc": "npm run cf-typegen && tsc",
     "format": "prettier --write app/",
-    "generateLanguages": "tsx ./scripts/generateLanguagesList.ts",
-    "generateSections": "tsx ./scripts/generateSectionsList.ts",
+    "generateDocsMeta": "tsx ./scripts/generateDocsMeta.ts",
     "copyAllDTSFiles": "tsx ./scripts/copyAllDTSFiles.ts",
     "removeHinting": "tsx ./scripts/removeHinting.ts",
     "cf-preview": "opennextjs-cloudflare build && opennextjs-cloudflare preview --port 3000",

scripts/generateDocsMeta.ts

@@ -0,0 +1,31 @@
+// Generates public/docs/{lang}/{pageId}/sections.yml for each page directory.
+// Each sections.yml lists the .md files in that directory in display order.
+
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import yaml from "js-yaml";
+import { getPagesList, getSectionsList } from "@/lib/docs";
+
+const docsDir = join(process.cwd(), "public", "docs");
+
+const langEntries = await getPagesList();
+
+const yamlContent = yaml.dump(langEntries.map((lang) => lang.id));
+await writeFile(join(docsDir, "languages.yml"), yamlContent, "utf-8");
+console.log(`Generated languages.yml (${langEntries.length} languages: ${langEntries.map((lang) => lang.id).join(", ")})`);
+
+for (const lang of langEntries) {
+  for (const page of lang.pages) {
+    const files = await getSectionsList(lang.id, page.slug);
+    const yamlContent = yaml.dump(files);
+    await writeFile(
+      join(docsDir, lang.id, page.slug, "sections.yml"),
+      yamlContent,
+      "utf-8"
+    );
+    console.log(
+      `Generated ${lang.id}/${page.slug}/sections.yml (${files.length} files)`
+    );
+  }
+}
+