toMedia

导航

配置 Fumadocs 的导航结构

Fumadocs UI 提供多种布局选项用于内容展示,导航通过布局设置进行配置。有两个关键的导航组件:

  • 布局链接:在布局中启用导航链接,用于频繁访问的资源,如展示页和定价页
  • 侧边栏项:侧边栏使用页面树结构显示文档页面链接

版本管理策略

文档概述了两种管理多版本文档的方式:

部分版本控制

当只有部分文档需要不同版本时,此方式通过文件夹分离版本化内容。例如,SDK 可能有独立的 v1v2 文件夹,各自有自己的入门文件。侧边栏标签页可以将这些显示为可选选项。

完整版本控制

对于完整的网站版本控制,推荐的方式是创建独立的 Git 分支,并将每个版本部署到不同的子域名(如 v2.my-site.com)。

此方式的优势包括:

  • 旧版文档分支不受新版迭代或依赖升级的影响
  • 一致性不仅限于文档,还扩展到落地页和其他站点内容

On this page