mirror of
https://github.com/nagisa77/OpenIsle.git
synced 2026-02-06 23:21:16 +08:00
@@ -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,
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user