獨立模式

npx @fumadocs/openapi-standalone build ./openapi.yaml

npx @fumadocs/openapi-standalone serve ./openapi.yaml --port 8080

import type { Config } from '@fumadocs/openapi-standalone';

export default {
  input: ['./openapi.yaml'],
  outDir: 'out',
} satisfies Config;

import { generateStatic } from '@fumadocs/openapi-standalone';

await generateStatic({
  input: ['./openapi.yaml'],
  outDir: 'out',
});

out/
├── index.html                   # 文件總覽
├── pets/listPets/index.html     # 每個 operation 各有一個頁面
├── 404.html
└── _fumadocs/                   # 指令碼、樣式、文件與搜尋索引

import { Hono } from 'hono';
import { createApp } from '@fumadocs/openapi-standalone/hono';

const app = new Hono();

// 路由位於 `baseUrl` 之下
app.route(
  '/',
  createApp({
    input: ['./openapi.yaml'],
    baseUrl: '/docs',
    // 供 API 互動測試區使用的 CORS 代理伺服器，只會將請求轉發至 `servers` 中的絕對 URL
    proxy: true,
  }),
);

export default app;

await generateStatic({
  // 檔案路徑與 URL，或是文件 ID -> 檔案路徑、URL 或文件物件的對應表
  input: ['./openapi.yaml', './billing.yaml'],
  // 寫入前會先清空
  outDir: 'out',
  // 依每個 'operation'（預設）、'tag' 或 'file' 各產生一個頁面
  per: 'operation',
  // operation 頁面的資料夾分組方式：'tag'（operation 有標籤時為預設）、'route' 或 'none'
  groupBy: 'tag',
  // 文件提供服務的 URL 路徑，預設：'/'
  baseUrl: '/docs',
  // 預設：文件的 `info.title`
  title: 'Acme API',
  // 供 API 互動測試區使用的 `createProxy()` 路由
  proxyUrl: 'https://example.com/api/proxy',
});