快速配置

Docs 模块用于渲染 content/docs 下的 MDX 文档并生成侧边栏目录树，基于 Fumadocs 与 Fumadocs MDX 构建。本文介绍作用、入口与常用配置。

快速改动路径

文档别名

// src/config/index.ts
i18n: {
  locales: {
    en: {
      docsAlias: "Docs",
    },
    zh: {
      docsAlias: "文档",
    },
  },
}

导航里的 Docs 文案在 SwitchHeader 和 home.json，不在 headerMenuMap。

目录组织

// content/docs/meta.zh.json
{
  "title": "MuseMVP 文档",
  "icon": "BookOpen",
  "pages": ["index", "tech-stack", "development", "quick-build", "cms"]
}

pages 顺序

pages 数组决定左侧目录顺序。子分类（如 cms）需有对应的 content/docs/cms/meta.{locale}.json。

文档组织规则

cms-docs.zh.mdx

cms-blog.zh.mdx

meta.zh.json

index.zh.mdx

meta.zh.json

类型	路径	说明
文档正文	`content/docs/*/.mdx`	支持 `.zh.mdx`、`.en.mdx` 多语言
分类目录	`content/docs/<category>/meta.{locale}.json`	子分类的 pages 与 title
站点级目录	`content/docs/meta.{locale}.json`	根目录顺序与分组
图标	frontmatter `icon`	由 `docsSource.icon()` 映射到实际图标组件

底部配置详解

配置项	代码位置	默认值	影响
`config.i18n.locales.*.docsAlias`	`src/config/index.ts`	`"Docs"` / `"文档"`	文档站标题与页面标题后缀
导航 Docs 文案	`SwitchHeader` + `home.json`	`"Docs"` / `"文档"`	页头链接文案
`content/docs/meta.{locale}.json`	`content/docs`	无	控制左侧目录顺序、分组层级
`docsSource.icon()` 映射	`src/lib/docs-source.ts`	无	frontmatter `icon` 的实际图标与颜色

新增文档步骤

在 content/docs 或子目录下创建 *.zh.mdx、*.en.mdx 文件。

在 frontmatter 中添加 title、description、icon。

在对应 meta.{locale}.json 的 pages 数组中注册页面路径。