mirror of
https://github.com/nagisa77/OpenIsle.git
synced 2026-06-01 07:27:34 +08:00
@@ -4,40 +4,7 @@ import { openapi } from "@/lib/openapi";
|
|||||||
void generateFiles({
|
void generateFiles({
|
||||||
input: openapi,
|
input: openapi,
|
||||||
output: "./content/docs/openapi/(generated)",
|
output: "./content/docs/openapi/(generated)",
|
||||||
|
// we recommend to enable it
|
||||||
// 1) 每个接口(method+path)生成一个独立 MDX 页面
|
// make sure your endpoint description doesn't break MDX syntax.
|
||||||
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,增强站内搜索可见性
|
|
||||||
includeDescription: true,
|
includeDescription: true,
|
||||||
|
|
||||||
// 为索引卡片导航注入必须的 imports(官方建议)
|
|
||||||
imports: [
|
|
||||||
{ names: ["source"], from: "@/lib/source" },
|
|
||||||
{ names: ["getPageTreePeers"], from: "fumadocs-core/server" },
|
|
||||||
],
|
|
||||||
|
|
||||||
// 在文件头加上“自动生成”注释
|
|
||||||
addGeneratedComment: true,
|
|
||||||
});
|
});
|
||||||
|
|||||||
Reference in New Issue
Block a user