From a62ee59cd6dc2387a3418d529e8c3dad06f9c1b4 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 29 Jun 2026 23:55:06 +0000 Subject: [PATCH] docs: document base source selection for multi-repo deployments --- deploy/multi-repo.mdx | 24 +++++++++++++++++++++++- es/deploy/multi-repo.mdx | 26 +++++++++++++++++++++++++- fr/deploy/multi-repo.mdx | 26 +++++++++++++++++++++++++- zh/deploy/multi-repo.mdx | 26 +++++++++++++++++++++++++- 4 files changed, 98 insertions(+), 4 deletions(-) diff --git a/deploy/multi-repo.mdx b/deploy/multi-repo.mdx index 12b48c0504..c4aa51b35b 100644 --- a/deploy/multi-repo.mdx +++ b/deploy/multi-repo.mdx @@ -30,7 +30,7 @@ Each repository in a multi-repository deployment has its own: During deployment, Mintlify reads each repository and combines the configured sources into one site. Each source appears under its configured URL path. -The first configured repository's `docs.json` is the root `docs.json` for the deployment. Its site-level configuration controls the combined site, including settings such as theme, colors, logo, integrations, SEO, and other top-level fields. The other sources contribute their navigation and content under their configured URL paths. +One repository acts as the **base source** for the deployment. Its `docs.json` is the root `docs.json` and controls site-level configuration, including theme, colors, logo, site name, top-level navigation, integrations, SEO, and other top-level fields. Every other source contributes only its own navigation and content under its configured URL path. The first repository you configure is the base source by default, and you can [change which source is the base](#change-the-base-source) at any time. Multi-repository deployments are different from a [monorepo setup](/deploy/monorepo). Use a monorepo setup when you store all content in a subdirectory alongside source code in a single repository. Use multi-repository deployments when you store content across separate repositories. @@ -91,6 +91,28 @@ The first configured repository's `docs.json` is the root `docs.json` for the de +## Change the base source + +The base source provides the site-wide configuration for your multi-repository deployment. Change the base source when you want a different repository's `docs.json` to control settings like theme, colors, site name, and top-level navigation. + + + + Navigate to [Git settings](https://app.mintlify.com/settings/deployment/git-settings) in your dashboard. + + The current base source shows a **Base** badge next to the repository name. + + + + On the repository you want to use as the base, select **Set as base**. + + Mintlify updates the base source immediately and queues a deployment using the new base repository's `docs.json` for site-level configuration. + + + + + Changing the base source replaces site-level settings such as theme, colors, logo, site name, and top-level navigation with the values from the new base repository's `docs.json`. URL paths and content from other sources are unaffected. + + ## Example repository layout In this example, each source has its own repository and its own `docs.json`. diff --git a/es/deploy/multi-repo.mdx b/es/deploy/multi-repo.mdx index e1788bb1f2..5e5fa6999d 100644 --- a/es/deploy/multi-repo.mdx +++ b/es/deploy/multi-repo.mdx @@ -32,7 +32,7 @@ Cada repositorio en una implementación multi-repositorio tiene su propio: Durante la implementación, Mintlify lee cada repositorio y combina las fuentes configuradas en un único sitio. Cada fuente aparece bajo su ruta de URL configurada. -El `docs.json` del primer repositorio configurado es el `docs.json` raíz de la implementación. Su configuración a nivel de sitio controla el sitio combinado, incluyendo opciones como el tema, los colores, el logotipo, las integraciones, el SEO y otros campos de nivel superior. Las demás fuentes aportan su navegación y contenido bajo sus rutas de URL configuradas. +Un repositorio actúa como la **fuente base** de la implementación. Su `docs.json` es el `docs.json` raíz y controla la configuración a nivel de sitio, incluyendo el tema, los colores, el logotipo, el nombre del sitio, la navegación de nivel superior, las integraciones, el SEO y otros campos de nivel superior. Las demás fuentes aportan únicamente su propia navegación y contenido bajo su ruta de URL configurada. El primer repositorio que configures es la fuente base de manera predeterminada, y puedes [cambiar qué fuente es la base](#change-the-base-source) en cualquier momento. Las implementaciones multi-repositorio son distintas a una [configuración de monorepo](/es/deploy/monorepo). Usa una configuración de monorepo cuando almacenes todo el contenido en un subdirectorio junto con el código fuente en un único repositorio. Usa implementaciones multi-repositorio cuando almacenes el contenido en repositorios distintos. @@ -97,6 +97,30 @@ El `docs.json` del primer repositorio configurado es el `docs.json` raíz de la +
+ ## Cambiar la fuente base +
+ +La fuente base proporciona la configuración a nivel de sitio para tu implementación multi-repositorio. Cambia la fuente base cuando quieras que el `docs.json` de un repositorio distinto controle ajustes como el tema, los colores, el nombre del sitio y la navegación de nivel superior. + + + + Ve a la [configuración de Git](https://app.mintlify.com/settings/deployment/git-settings) en tu panel. + + La fuente base actual muestra una insignia **Base** junto al nombre del repositorio. + + + + En el repositorio que quieras usar como base, selecciona **Set as base**. + + Mintlify actualiza la fuente base de inmediato y pone en cola una implementación que usa el `docs.json` del nuevo repositorio base para la configuración a nivel de sitio. + + + + + Cambiar la fuente base reemplaza la configuración a nivel de sitio (como el tema, los colores, el logotipo, el nombre del sitio y la navegación de nivel superior) por los valores del `docs.json` del nuevo repositorio base. Las rutas de URL y el contenido de las demás fuentes no se ven afectados. + +
## Ejemplo de organización de repositorios
diff --git a/fr/deploy/multi-repo.mdx b/fr/deploy/multi-repo.mdx index 9c841686b2..50e2b6f727 100644 --- a/fr/deploy/multi-repo.mdx +++ b/fr/deploy/multi-repo.mdx @@ -32,7 +32,7 @@ Chaque référentiel d’un déploiement multi-référentiels possède : Lors du déploiement, Mintlify lit chaque référentiel et combine les sources configurées en un seul site. Chaque source apparaît sous son chemin d’URL configuré. -Le `docs.json` du premier référentiel configuré sert de `docs.json` racine du déploiement. Sa configuration au niveau du site contrôle le site combiné, y compris les paramètres tels que le thème, les couleurs, le logo, les intégrations, le SEO et les autres champs de premier niveau. Les autres sources fournissent leur navigation et leur contenu sous leurs chemins d’URL respectifs. +Un référentiel sert de **source de base** pour le déploiement. Son `docs.json` est le `docs.json` racine et contrôle la configuration au niveau du site, y compris le thème, les couleurs, le logo, le nom du site, la navigation de premier niveau, les intégrations, le SEO et les autres champs de premier niveau. Chaque autre source ne fournit que sa propre navigation et son propre contenu sous son chemin d’URL configuré. Le premier référentiel que vous configurez est la source de base par défaut, et vous pouvez [changer la source de base](#change-the-base-source) à tout moment. Les déploiements multi-référentiels sont différents d’une [configuration monorepo](/fr/deploy/monorepo). Utilisez une configuration monorepo lorsque vous stockez tout le contenu dans un sous-répertoire à côté du code source d’un même référentiel. Utilisez les déploiements multi-référentiels lorsque vous stockez le contenu dans des référentiels distincts. @@ -97,6 +97,30 @@ Le `docs.json` du premier référentiel configuré sert de `docs.json` racine du +
+ ## Changer la source de base +
+ +La source de base fournit la configuration au niveau du site pour votre déploiement multi-référentiels. Changez la source de base lorsque vous souhaitez que le `docs.json` d’un autre référentiel contrôle les paramètres tels que le thème, les couleurs, le nom du site et la navigation de premier niveau. + + + + Accédez aux [paramètres Git](https://app.mintlify.com/settings/deployment/git-settings) dans votre tableau de bord. + + La source de base actuelle affiche un badge **Base** à côté du nom du référentiel. + + + + Sur le référentiel que vous souhaitez utiliser comme base, sélectionnez **Set as base**. + + Mintlify met immédiatement à jour la source de base et met en file d’attente un déploiement qui utilise le `docs.json` du nouveau référentiel de base pour la configuration au niveau du site. + + + + + Changer la source de base remplace les paramètres au niveau du site (tels que le thème, les couleurs, le logo, le nom du site et la navigation de premier niveau) par les valeurs du `docs.json` du nouveau référentiel de base. Les chemins d’URL et le contenu des autres sources ne sont pas affectés. + +
## Exemple d’organisation des référentiels
diff --git a/zh/deploy/multi-repo.mdx b/zh/deploy/multi-repo.mdx index 8809d7b2b0..d04e441ada 100644 --- a/zh/deploy/multi-repo.mdx +++ b/zh/deploy/multi-repo.mdx @@ -32,7 +32,7 @@ docs.example.com/sdks 在部署期间，Mintlify 会读取每个仓库并将已配置的源合并到一个站点中。每个源会显示在其配置的 URL 路径下。 -第一个配置的仓库的 `docs.json` 是部署的根 `docs.json`。其站点级配置控制合并后的站点，包括主题、颜色、Logo、集成、SEO 以及其他顶层字段等设置。其他源在其配置的 URL 路径下贡献各自的导航和内容。 +其中一个仓库作为部署的**基础源**。其 `docs.json` 是根 `docs.json`，控制站点级配置，包括主题、颜色、Logo、站点名称、顶层导航、集成、SEO 以及其他顶层字段。其他每个源仅在其配置的 URL 路径下贡献各自的导航和内容。你配置的第一个仓库默认就是基础源，你可以随时[更改作为基础的源](#change-the-base-source)。 多仓库部署不同于[monorepo 配置](/zh/deploy/monorepo)。当你将所有内容与源代码一起存放在单个仓库的子目录中时，请使用 monorepo 配置。当你将内容分散存放在不同的仓库中时，请使用多仓库部署。 @@ -97,6 +97,30 @@ docs.example.com/sdks +
+ ## 更改基础源 +
+ +基础源为你的多仓库部署提供站点级配置。当你希望由另一个仓库的 `docs.json` 控制主题、颜色、站点名称和顶层导航等设置时，请更改基础源。 + + + + 在你的控制台中前往 [Git 设置](https://app.mintlify.com/settings/deployment/git-settings)。 + + 当前的基础源会在仓库名称旁显示 **Base** 徽章。 + + + + 在你想用作基础的仓库上，选择 **Set as base**。 + + Mintlify 会立即更新基础源，并使用新基础仓库的 `docs.json` 作为站点级配置来排队进行一次部署。 + + + + + 更改基础源会用新基础仓库 `docs.json` 中的值替换站点级设置，例如主题、颜色、Logo、站点名称和顶层导航。其他源的 URL 路径和内容不受影响。 + +
## 示例仓库布局