Merge pull request #166 from ut-code/copilot/create-language-directories

Restructure public/docs/ into per-language directory hierarchy with app route migration

Author: na-trium-144

.gitignore

@@ -3,6 +3,12 @@
 /.open-next
 /cloudflare-env.d.ts
 
+# generated docs section file lists (regenerated by npm run generateSections)
+/public/docs/**/sections.yml
+
+# generated languages list (regenerated by npm run generateLanguages)
+/public/docs/languages.yml
+
 # dependencies
 /node_modules
 /.pnp

README.md

@@ -58,7 +58,49 @@ npm run lint
 現在は本番環境(my-code.utcode.net)はCoolifyでデプロイしています。
 Cloudflare Worker のビルドログとステータス表示が見れますが、そちらは使っていません。
 
-## ベースとなるドキュメントの作り方
+## ドキュメント
+
+* ドキュメントはセクション(見出し)ごとにわけ、 public/docs/言語id/ページid/並び替え用連番-セクション名.md に置く。
+* ページはディレクトリの名前によらず 言語id/index.yml に書かれている順で表示される。
+* セクションはセクションIDによらずファイル名順で表示される。
+* 各セクションのfrontmatter (各ページ最初のセクション(-intro.md)を除く)
+    ```yml
+    id: 一意なセクションID。ファイル名・ディレクトリ名と一致していなくても良い。バックエンドがこのセクションIDで識別するので、一度コミットしたら変更不可(ファイル名は何度変えても良い)
+    title: セクションタイトルと同じものをmd記法を使わずに書いた文字列
+    level: セクションの見出しレベル(2〜6が使用可)
+    ```
+* コード例はそれが配置されているセクションの内容と関連するようにする。
+    ````md
+    ## 制御構文
+    ### if
+    if文の説明…
+    ### switch
+    switch文の説明…
+
+    ifとswitch共通の注意事項... → ## 制御構文 に移す
+    ```
+    ifとswitchを使ったコード例… → 2つのコード例に分割する
+    (分割が難しい(かつ説明が短い)場合は、1つのセクションで全部説明してコード例を載せるのでもよい)
+    ```
+    ````
+* コード例や注意事項などを不必要に独立したセクションにするのは避ける
+    ````md
+    ## hoge
+    hogeの説明…
+    ### hogeの使用場面 →この見出しいらない
+    **hogeの使用場面** はok
+      - 説明
+      - 説明
+    ### hogeの使用例 →この見出しいらない
+    ```
+    hogeを使ったコード例…
+    ```
+    ````
+* REPLのコード例は1セクションに最大1つまで。
+    * コードエディターとコード実行ブロックはいくつでも置けます。
+* ページ0以外の各ページの最後はレベル2見出し「この章のまとめ」と、レベル3見出し「練習問題n」を置く
+
+### ベースとなるドキュメントの作り方
 
 - web版の ~~Gemini2.5Pro~~ Gemini3Pro を用いる。
 - 以下のプロンプトで章立てを考えさせる
@@ -107,7 +149,6 @@ Cloudflare Worker のビルドログとステータス表示が見れますが
         Hello
         ```
         ````
-    - 練習問題の見出しは「この章のまとめ」の直下のレベル3見出しで、 `### 練習問題n` または `### 練習問題n: タイトル` とする
     - 練習問題のファイル名は不都合がなければ `practice(章番号)_(問題番号).拡張子` で統一。空でもよいのでファイルコードブロックとexecコードブロックを置く
 - 1章にはたぶん練習問題要らない。
 

app/[docs_id]/page.tsx

@@ -8,7 +8,7 @@ import { useState, FormEvent, useEffect } from "react";
 // } from "../actions/questionExample";
 // import { getLanguageName } from "../pagesList";
 import { DynamicMarkdownSection } from "./pageContent";
-import { useEmbedContext } from "../terminal/embedContext";
+import { useEmbedContext } from "@/terminal/embedContext";
 import { useChatHistoryContext } from "./chatHistory";
 import { askAI } from "@/actions/chatActions";
 

app/[docs_id]/splitMarkdown.ts

@@ -2,8 +2,8 @@ import Markdown, { Components, ExtraProps } from "react-markdown";
 import remarkGfm from "remark-gfm";
 import removeComments from "remark-remove-comments";
 import remarkCjkFriendly from "remark-cjk-friendly";
-import { EditorComponent, getAceLang } from "../terminal/editor";
-import { ExecFile } from "../terminal/exec";
+import { EditorComponent, getAceLang } from "@/terminal/editor";
+import { ExecFile } from "@/terminal/exec";
 import { JSX, ReactNode } from "react";
 import { getRuntimeLang } from "@/terminal/runtime";
 import { ReplTerminal } from "@/terminal/repl";
@@ -64,6 +64,8 @@ export function Heading({
   children: ReactNode;
 }) {
   switch (level) {
+    case 0:
+      return null;
     case 1:
       return <h1 className="text-2xl font-bold my-4">{children}</h1>;
     case 2:

app/[docs_id]/chatForm.tsx app/[lang]/[pageId]/chatForm.tsxapp/[docs_id]/chatForm.tsx renamed to app/[lang]/[pageId]/chatForm.tsx

@@ -0,0 +1,63 @@
+import { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { PageContent } from "./pageContent";
+import { ChatHistoryProvider } from "./chatHistory";
+import { getChatFromCache, initContext } from "@/lib/chatHistory";
+import { getMarkdownSections, getPagesList } from "@/lib/docs";
+
+export async function generateMetadata({
+  params,
+}: {
+  params: Promise<{ lang: string; pageId: string }>;
+}): Promise<Metadata> {
+  const { lang, pageId } = await params;
+  const pagesList = await getPagesList();
+  const langEntry = pagesList.find((l) => l.id === lang);
+  const pageEntry = langEntry?.pages.find((p) => p.slug === pageId);
+  if (!langEntry || !pageEntry) notFound();
+
+  const sections = await getMarkdownSections(lang, pageId);
+  const description = sections[0].rawContent;
+
+  return {
+    title: `${langEntry!.name}-${pageEntry.index}. ${pageEntry.title}`,
+    description,
+  };
+}
+
+export default async function Page({
+  params,
+}: {
+  params: Promise<{ lang: string; pageId: string }>;
+}) {
+  const { lang, pageId } = await params;
+  const pagesList = await getPagesList();
+  const langEntry = pagesList.find((l) => l.id === lang);
+  const pageEntry = langEntry?.pages.find((p) => p.slug === pageId);
+  if (!langEntry || !pageEntry) notFound();
+
+  const docsId = `${lang}/${pageId}`;
+  const sections = await getMarkdownSections(lang, pageId);
+
+  // AI用のドキュメント全文（rawContentを結合）
+  const documentContent = sections.map((s) => s.rawContent).join("\n");
+
+  const context = await initContext();
+  const initialChatHistories = await getChatFromCache(docsId, context);
+
+  return (
+    <ChatHistoryProvider
+      initialChatHistories={initialChatHistories}
+      docs_id={docsId}
+    >
+      <PageContent
+        documentContent={documentContent}
+        splitMdContent={sections}
+        pageEntry={pageEntry}
+        docs_id={docsId}
+        lang={lang}
+        pageId={pageId}
+      />
+    </ChatHistoryProvider>
+  );
+}