快速开始

文档系统概述

本项目的文档系统建立在 TanStack Start 与 fumadocs 之上。TanStack Start 负责路由与 SSR，fumadocs 负责 MDX 内容模型与文档 UI。

fumadocs 让基于 MDX 的文档写作、页面树生成和文档界面搭建都变得很直接。

fumadocs 无需单独的 CMS 或数据库。文档与代码并存，便于版本管理、审查和维护。基于文件的方式意味着你可以使用自己喜欢的编辑器和 Git 工作流。

pnpm add fumadocs-core fumadocs-ui fumadocs-mdx

在 content/docs/ 目录下创建 MDX 文件：

---
title: 我的页面
description: 一个文档页面
---

# 我的页面

在这里使用 MDX 语法编写内容。

使用 meta.json 文件控制侧边栏导航：

{
  "title": "章节标题",
  "pages": ["page-one", "page-two"]
}

在这个 starter 中，文档系统通过 source.config.ts、src/lib/source.ts 与 src/routes/{-$locale}/_docs/docs/$.tsx 这条 catch-all 路由接入应用。