From 062b289f7ae6b9bbde62935d1c6280380ab240ad Mon Sep 17 00:00:00 2001 From: Tim Date: Fri, 19 Sep 2025 17:47:41 +0800 Subject: [PATCH] =?UTF-8?q?Revert=20"fix:=20=E6=96=B0=E5=A2=9EopenAPI?= =?UTF-8?q?=E9=85=8D=E7=BD=AE=E9=80=89=E9=A1=B9"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit c1dc77f6db7f8913bfca67dce23edb989020d53f. --- docs/scripts/generate-docs.ts | 37 ++--------------------------------- 1 file changed, 2 insertions(+), 35 deletions(-) diff --git a/docs/scripts/generate-docs.ts b/docs/scripts/generate-docs.ts index 4c96d65ae..449e28d15 100644 --- a/docs/scripts/generate-docs.ts +++ b/docs/scripts/generate-docs.ts @@ -4,40 +4,7 @@ import { openapi } from "@/lib/openapi"; void generateFiles({ input: openapi, output: "./content/docs/openapi/(generated)", - - // 1) 每个接口(method+path)生成一个独立 MDX 页面 - per: "operation", - - // 2) 生成的文件不再深藏在 tag 目录里,避免“点进去才看到” - // 如果你更喜欢按路由分组,也可以用 'route' - groupBy: "none", - - // 3) 生成一个索引页,列出所有接口卡片(标题里会含 方法 与 路径) - index: { - url: { - // 你的文档真实访问前缀(按你的站点路由调整) - baseUrl: "/docs/openapi/(generated)", - // 生成文件所在磁盘目录(与 output 一致) - contentDir: "./content/docs/openapi/(generated)", - }, - items: [ - { - // 索引页文件名,访问就是 /openapi/(generated)/ - path: "index.mdx", - description: "All API endpoints", - }, - ], - }, - - // 让接口描述体也写入 MDX,增强站内搜索可见性 + // we recommend to enable it + // make sure your endpoint description doesn't break MDX syntax. includeDescription: true, - - // 为索引卡片导航注入必须的 imports(官方建议) - imports: [ - { names: ["source"], from: "@/lib/source" }, - { names: ["getPageTreePeers"], from: "fumadocs-core/server" }, - ], - - // 在文件头加上“自动生成”注释 - addGeneratedComment: true, });