版本化文档

版本化文档让一个 Geistdocs 项目服务多个文档集合。可用于稳定版、预发布版、旧主版本，或基于域名的版本切换。

配置 source collection

在 source.config.ts 中为每个版本创建一个 Fumadocs collection：

source.config.ts

import { defineConfig, defineDocs } from "fumadocs-mdx/config";

export const v4docs = defineDocs({
  dir: "content/docs/v4",
  docs: {
    postprocess: {
      includeProcessedMarkdown: true,
    },
  },
});

export const v5docs = defineDocs({
  dir: "content/docs/v5",
  docs: {
    postprocess: {
      includeProcessedMarkdown: true,
    },
  },
});

export default defineConfig({});

创建版本化 sources

在 lib/geistdocs/source.ts 中使用 createVersionedSources：

lib/geistdocs/source.ts

import { createVersionedSources } from "@vercel/geistdocs/source";
import { v4docs, v5docs } from "@/.source/server";
import { config } from "./config";

export const versions = createVersionedSources({
  config,
  current: "v4",
  versions: [
    { id: "v4", label: "v4", docs: v4docs, baseUrl: "/docs" },
    {
      id: "v5",
      label: "v5 pre-release",
      docs: v5docs,
      baseUrl: "/docs",
      routePrefix: "/v5",
    },
  ],
});

渲染版本化页面

当前版本可以用于 /docs，特定版本可以用于带版本前缀的路由：

app/[lang]/v5/docs/[[...slug]]/page.tsx

import { createDocsPage } from "@vercel/geistdocs/pages/docs";
import { config } from "@/lib/geistdocs/config";
import { versions } from "@/lib/geistdocs/source";

const docsPage = createDocsPage({
  config,
  source: versions.byId.v5,
  getPageUrl: ({ page }) => `/v5${page.url}`,
});

当公开 URL 和 source 的 baseUrl 不一致时，使用 getPageUrl 保持页面操作和 Markdown 链接指向公开 URL。

添加版本选择器

在本地布局适配器中使用 GeistdocsVersionSelect：

components/geistdocs/docs-layout.tsx

import { GeistdocsVersionSelect } from "@vercel/geistdocs/versions";

<GeistdocsVersionSelect
  current="v4"
  versions={[
    { id: "v4", label: "v4" },
    { id: "v5", label: "v5 pre-release", routePrefix: "/v5" },
  ]}
/>

对于基于域名的版本，使用 href：

<GeistdocsVersionSelect
  current="v6"
  versions={[
    { id: "v6", label: "v6 latest" },
    { id: "v5", label: "v5", href: "https://v5.example.com/:path*" },
  ]}
/>

下一步

阅读 Proxy 和 Markdown 路由，将版本化页面连接到 .md、.mdx 和 AI agent 重写。
阅读 llms.txt，为多个 source 配置完整文档的 Markdown 输出。