多源文档

为全局主题创建控制仓库

控制仓库是一个专用的 Fern 项目，保存你的全局主题——每个源仓库继承的共享 logo、颜色、字体、布局和站点级设置。在其 docs.yml 中定义这些设置，然后导出并上传主题：

$
fern docs theme export
$
fern docs theme upload --name my-org-theme

查看全局主题获取完整设置指南和主题控制的字段列表。

配置每个仓库

每个子路径都有自己的仓库（通常由不同团队拥有），与步骤 1 中的控制仓库分开。在每个仓库的 docs.yml 中：

• 通过名称引用全局主题：global-theme: my-org-theme。
• 声明一个带有 multi-source: true 和在共享域上唯一基础路径的实例。该基础路径必须出现在 url 和 custom-domain 的末尾。

例如，这里是同一共享域上的两个仓库——一个在 /product-a，一个在 /product-b：

1
global-theme: my-org-theme
2
3
instances:
4
  - url: example.docs.buildwithfern.com/product-a
5
    custom-domain: docs.example.com/product-a
6
    multi-source: true

从每个仓库发布

每个仓库独立发布：

$
fern generate --docs

只有该仓库拥有的子路径会被更新。其他所有子路径都不受影响。

在 Dashboard 中配置域设置

打开 Fern Dashboard 并选择你的顶级域（例如 docs.example.com）——这些设置适用于整个域，而不是每个子路径。在 Settings 标签页中，导航到 Multi-repo settings 卡片。

配置以下内容：

• 默认路径 （可选）——设置用户访问域的根目录时的着陆页。当 Fern 管理的页面应该作为根页面时设置此选项。例如，如果你的主页位于 /home 子路径，将默认路径设置为 /home，这样 docs.example.com 就会重定向到 docs.example.com/home。如果根目录不是 Fern 管理的，比如 NVIDIA 的 docs.nvidia.com（Fern 设置之外的单独营销站点），则跳过此设置。
• 搜索 / Ask AI 行为——控制 Ask Fern 和搜索如何在子路径之间工作。有两种模式可用：
  • 层级模式——在 /subpath 下的搜索仅返回来自 /subpath 及其下层的结果。当每个子路径涵盖不同产品且用户期望范围限定的结果时使用。
  • 统一模式——在任何子路径下的搜索返回来自所有子路径的结果。当子路径是单个产品的各个部分且用户受益于跨领域结果时使用。