From 4456583d675c1e2807adcfb32e9720927a4a5c35 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 11 Jun 2026 15:14:16 +0000
Subject: [PATCH 1/2] docs: document multi-source navigation merging
---
deploy/multiple-sources.mdx | 114 +++++++++++++++++++++++++++++++++
docs.json | 1 +
es.json | 1 +
es/deploy/multiple-sources.mdx | 114 +++++++++++++++++++++++++++++++++
fr.json | 1 +
fr/deploy/multiple-sources.mdx | 114 +++++++++++++++++++++++++++++++++
zh.json | 1 +
zh/deploy/multiple-sources.mdx | 114 +++++++++++++++++++++++++++++++++
8 files changed, 460 insertions(+)
create mode 100644 deploy/multiple-sources.mdx
create mode 100644 es/deploy/multiple-sources.mdx
create mode 100644 fr/deploy/multiple-sources.mdx
create mode 100644 zh/deploy/multiple-sources.mdx
diff --git a/deploy/multiple-sources.mdx b/deploy/multiple-sources.mdx
new file mode 100644
index 0000000000..44ddc6079d
--- /dev/null
+++ b/deploy/multiple-sources.mdx
@@ -0,0 +1,114 @@
+---
+title: "Multiple sources"
+description: "Pull documentation from multiple git repositories into a single Mintlify deployment, with each source mounted under its own path."
+keywords: ["multi-source", "multiple repos", "git sources", "mount path", "products"]
+---
+
+Connect more than one git repository to a single Mintlify deployment. Each repository, called a _source_, contributes its own `docs.json` and content, and Mintlify merges them into one site at build time. Use multi-source deployments when documentation for related products lives in separate repositories but should appear under a single domain and navigation tree.
+
+## How sources are merged
+
+When a deployment has more than one source, Mintlify fetches each source's `docs.json` during every build and merges them into a single `navigation.products` tree:
+
+* The **first source listed on the deployment** is the _primary source_. Its `docs.json` provides the top-level configuration for the merged site, including `name`, `theme`, `colors`, `logo`, `favicon`, `redirects`, and any other top-level fields.
+* **Additional sources** contribute only their `navigation`. Other top-level fields in those configs (for example, `redirects` or `theme`) are ignored, and a warning is logged at build time listing the ignored keys.
+* Each source's `navigation` becomes one entry in the merged `navigation.products` array. The product's display name is the source's label, or its `docs.json` `name` if no label is set.
+
+The merged result is equivalent to a single `docs.json` that uses [products](/organize/navigation#products) as its top-level navigation division.
+
+
+A source's `docs.json` cannot itself use `navigation.products`. Products only exist at the merged top level, so each source must use a non-product navigation (for example, `groups`, `tabs`, `versions`, or `anchors`).
+
+
+## Mount paths
+
+Every source on a multi-source deployment must have a non-empty **mount path**. The mount path is the URL prefix that the source's content is served under, and it is prepended to every reference in that source's `docs.json` during the merge:
+
+* Page paths in `pages`, `root`, and `href` fields. For example, `quickstart` from a source mounted at `eng` resolves to `eng/quickstart`.
+* OpenAPI and AsyncAPI references in `openapi` and `asyncapi` fields, including `source` and `directory` properties.
+* `href` values in global navigation entries such as `anchors` and `tabs`.
+
+Absolute URLs (`https://…`) and in-page anchors (`#section`) are left unchanged. Mount paths cannot overlap between sources on the same deployment.
+
+The resulting URLs in your live site include the mount path. A page authored as `quickstart.mdx` in a source mounted at `eng` is served at `/eng/quickstart`.
+
+## Example
+
+A deployment with two sources — one mounted at `platform`, one mounted at `eng` — produces a merged config that looks like this:
+
+**Primary source `docs.json` (mounted at `platform`):**
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ "theme": "mint",
+ "name": "Acme Docs",
+ "colors": { "primary": "#0D9373" },
+ "favicon": "/favicon.svg",
+ "redirects": [{ "source": "/old", "destination": "/new" }],
+ "navigation": {
+ "groups": [
+ { "group": "Get started", "pages": ["index", "setup"] }
+ ]
+ }
+}
+```
+
+**Second source `docs.json` (mounted at `eng`):**
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ "name": "Engineering",
+ "navigation": {
+ "groups": [
+ { "group": "Guides", "pages": ["quickstart"] }
+ ]
+ }
+}
+```
+
+**Merged config Mintlify builds and serves:**
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ "theme": "mint",
+ "name": "Acme Docs",
+ "colors": { "primary": "#0D9373" },
+ "favicon": "/favicon.svg",
+ "redirects": [{ "source": "/old", "destination": "/new" }],
+ "navigation": {
+ "products": [
+ {
+ "product": "Platform",
+ "groups": [
+ { "group": "Get started", "pages": ["platform/index", "platform/setup"] }
+ ]
+ },
+ {
+ "product": "Engineering",
+ "groups": [
+ { "group": "Guides", "pages": ["eng/quickstart"] }
+ ]
+ }
+ ]
+ }
+}
+```
+
+## Build failures
+
+The build fails and the deployment is not updated if:
+
+* Any source is missing a `docs.json`, or a source's `docs.json` is invalid.
+* Any source has an empty mount path.
+* Two sources have overlapping mount paths.
+* A source's `navigation` uses `products` at the top level.
+
+The build error names the source that caused the failure so you can fix it in that repository.
+
+## Related
+
+* [Monorepo setup](/deploy/monorepo) — pointing a single source at a subdirectory of a larger repository.
+* [Products](/organize/navigation#products) — the navigation division that multi-source deployments produce.
diff --git a/docs.json b/docs.json
index f2051ed4c1..5540b0d474 100644
--- a/docs.json
+++ b/docs.json
@@ -206,6 +206,7 @@
]
},
"deploy/monorepo",
+ "deploy/multiple-sources",
"deploy/vercel-external-proxies",
"deploy/ci",
"deploy/github",
diff --git a/es.json b/es.json
index 241008091c..3cc45556f2 100644
--- a/es.json
+++ b/es.json
@@ -174,6 +174,7 @@
]
},
"es/deploy/monorepo",
+ "es/deploy/multiple-sources",
"es/deploy/vercel-external-proxies",
"es/deploy/ci",
"es/deploy/github",
diff --git a/es/deploy/multiple-sources.mdx b/es/deploy/multiple-sources.mdx
new file mode 100644
index 0000000000..c7a7582353
--- /dev/null
+++ b/es/deploy/multiple-sources.mdx
@@ -0,0 +1,114 @@
+---
+title: "Múltiples fuentes"
+description: "Extrae documentación desde varios repositorios de git hacia un único despliegue de Mintlify, con cada fuente montada bajo su propia ruta."
+keywords: ["multi-source", "multiple repos", "git sources", "mount path", "products"]
+---
+
+Conecta más de un repositorio de git a un único despliegue de Mintlify. Cada repositorio, llamado _fuente_, aporta su propio `docs.json` y su contenido, y Mintlify los combina en un solo sitio durante la compilación. Usa despliegues de múltiples fuentes cuando la documentación de productos relacionados vive en repositorios separados pero debe aparecer bajo un único dominio y árbol de navegación.
+
+## Cómo se combinan las fuentes
+
+Cuando un despliegue tiene más de una fuente, Mintlify obtiene el `docs.json` de cada fuente en cada compilación y los combina en un único árbol `navigation.products`:
+
+* La **primera fuente listada en el despliegue** es la _fuente principal_. Su `docs.json` proporciona la configuración de nivel superior para el sitio combinado, incluidos `name`, `theme`, `colors`, `logo`, `favicon`, `redirects` y cualquier otro campo de nivel superior.
+* Las **fuentes adicionales** solo aportan su `navigation`. Los demás campos de nivel superior en esas configuraciones (por ejemplo, `redirects` o `theme`) se ignoran, y se registra una advertencia durante la compilación que lista las claves ignoradas.
+* El `navigation` de cada fuente se convierte en una entrada del arreglo `navigation.products` combinado. El nombre visible del producto es la etiqueta de la fuente, o el `name` de su `docs.json` si no se ha establecido una etiqueta.
+
+El resultado combinado equivale a un único `docs.json` que usa [products](/organize/navigation#products) como su división de navegación de nivel superior.
+
+
+El `docs.json` de una fuente no puede usar `navigation.products`. Los products solo existen en el nivel superior combinado, por lo que cada fuente debe usar una navegación que no sea de products (por ejemplo, `groups`, `tabs`, `versions` o `anchors`).
+
+
+## Rutas de montaje
+
+Cada fuente en un despliegue de múltiples fuentes debe tener una **ruta de montaje** no vacía. La ruta de montaje es el prefijo de URL bajo el cual se sirve el contenido de la fuente, y se antepone a cada referencia en el `docs.json` de esa fuente durante la combinación:
+
+* Rutas de página en los campos `pages`, `root` y `href`. Por ejemplo, `quickstart` de una fuente montada en `eng` se resuelve como `eng/quickstart`.
+* Referencias de OpenAPI y AsyncAPI en los campos `openapi` y `asyncapi`, incluidas las propiedades `source` y `directory`.
+* Valores `href` en entradas de navegación globales como `anchors` y `tabs`.
+
+Las URLs absolutas (`https://…`) y los anclas dentro de la página (`#section`) se dejan sin cambios. Las rutas de montaje no pueden superponerse entre fuentes del mismo despliegue.
+
+Las URLs resultantes en tu sitio publicado incluyen la ruta de montaje. Una página creada como `quickstart.mdx` en una fuente montada en `eng` se sirve en `/eng/quickstart`.
+
+## Ejemplo
+
+Un despliegue con dos fuentes —una montada en `platform` y otra montada en `eng`— produce una configuración combinada que se ve así:
+
+**`docs.json` de la fuente principal (montada en `platform`):**
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ "theme": "mint",
+ "name": "Acme Docs",
+ "colors": { "primary": "#0D9373" },
+ "favicon": "/favicon.svg",
+ "redirects": [{ "source": "/old", "destination": "/new" }],
+ "navigation": {
+ "groups": [
+ { "group": "Get started", "pages": ["index", "setup"] }
+ ]
+ }
+}
+```
+
+**`docs.json` de la segunda fuente (montada en `eng`):**
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ "name": "Engineering",
+ "navigation": {
+ "groups": [
+ { "group": "Guides", "pages": ["quickstart"] }
+ ]
+ }
+}
+```
+
+**Configuración combinada que Mintlify compila y sirve:**
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ "theme": "mint",
+ "name": "Acme Docs",
+ "colors": { "primary": "#0D9373" },
+ "favicon": "/favicon.svg",
+ "redirects": [{ "source": "/old", "destination": "/new" }],
+ "navigation": {
+ "products": [
+ {
+ "product": "Platform",
+ "groups": [
+ { "group": "Get started", "pages": ["platform/index", "platform/setup"] }
+ ]
+ },
+ {
+ "product": "Engineering",
+ "groups": [
+ { "group": "Guides", "pages": ["eng/quickstart"] }
+ ]
+ }
+ ]
+ }
+}
+```
+
+## Fallos de compilación
+
+La compilación falla y el despliegue no se actualiza si:
+
+* A alguna fuente le falta un `docs.json`, o el `docs.json` de una fuente no es válido.
+* Alguna fuente tiene una ruta de montaje vacía.
+* Dos fuentes tienen rutas de montaje superpuestas.
+* El `navigation` de una fuente usa `products` en el nivel superior.
+
+El error de compilación indica el nombre de la fuente que causó el fallo para que puedas corregirlo en ese repositorio.
+
+## Relacionado
+
+* [Configuración de monorepo](/deploy/monorepo) — apuntar una única fuente a un subdirectorio de un repositorio más grande.
+* [Products](/organize/navigation#products) — la división de navegación que producen los despliegues de múltiples fuentes.
diff --git a/fr.json b/fr.json
index ce442dd89f..870e639e27 100644
--- a/fr.json
+++ b/fr.json
@@ -174,6 +174,7 @@
]
},
"fr/deploy/monorepo",
+ "fr/deploy/multiple-sources",
"fr/deploy/vercel-external-proxies",
"fr/deploy/ci",
"fr/deploy/github",
diff --git a/fr/deploy/multiple-sources.mdx b/fr/deploy/multiple-sources.mdx
new file mode 100644
index 0000000000..2e1234b546
--- /dev/null
+++ b/fr/deploy/multiple-sources.mdx
@@ -0,0 +1,114 @@
+---
+title: "Sources multiples"
+description: "Récupérez la documentation depuis plusieurs référentiels git au sein d’un même déploiement Mintlify, chaque source étant montée sous son propre chemin."
+keywords: ["multi-source", "multiple repos", "git sources", "mount path", "products"]
+---
+
+Connectez plusieurs référentiels git à un seul déploiement Mintlify. Chaque référentiel, appelé _source_, fournit son propre `docs.json` ainsi que son contenu, et Mintlify les fusionne en un seul site au moment de la compilation. Utilisez les déploiements multi-sources lorsque la documentation de produits liés se trouve dans des référentiels distincts mais doit apparaître sous un même domaine et une même arborescence de navigation.
+
+## Comment les sources sont fusionnées
+
+Lorsqu’un déploiement comporte plusieurs sources, Mintlify récupère le `docs.json` de chaque source à chaque compilation et les fusionne en une seule arborescence `navigation.products` :
+
+* La **première source listée sur le déploiement** est la _source principale_. Son `docs.json` fournit la configuration de niveau supérieur du site fusionné, notamment `name`, `theme`, `colors`, `logo`, `favicon`, `redirects` et tout autre champ de niveau supérieur.
+* Les **sources additionnelles** ne contribuent qu’à leur `navigation`. Les autres champs de niveau supérieur de ces configurations (par exemple, `redirects` ou `theme`) sont ignorés, et un avertissement est consigné lors de la compilation, listant les clés ignorées.
+* La `navigation` de chaque source devient une entrée dans le tableau `navigation.products` fusionné. Le nom d’affichage du produit est le libellé de la source, ou son `name` dans `docs.json` si aucun libellé n’est défini.
+
+Le résultat fusionné équivaut à un unique `docs.json` qui utilise les [products](/organize/navigation#products) comme division de navigation de niveau supérieur.
+
+
+Le `docs.json` d’une source ne peut pas lui-même utiliser `navigation.products`. Les produits n’existent qu’au niveau supérieur fusionné, donc chaque source doit utiliser une navigation autre que par produit (par exemple, `groups`, `tabs`, `versions` ou `anchors`).
+
+
+## Chemins de montage
+
+Chaque source d’un déploiement multi-sources doit avoir un **chemin de montage** non vide. Le chemin de montage est le préfixe d’URL sous lequel le contenu de la source est servi, et il est ajouté en préfixe à chaque référence dans le `docs.json` de cette source lors de la fusion :
+
+* Les chemins de page dans les champs `pages`, `root` et `href`. Par exemple, `quickstart` provenant d’une source montée sur `eng` est résolu en `eng/quickstart`.
+* Les références OpenAPI et AsyncAPI dans les champs `openapi` et `asyncapi`, y compris les propriétés `source` et `directory`.
+* Les valeurs `href` dans les entrées de navigation globale telles que `anchors` et `tabs`.
+
+Les URL absolues (`https://…`) et les ancres internes à la page (`#section`) sont laissées inchangées. Les chemins de montage ne peuvent pas se chevaucher entre les sources d’un même déploiement.
+
+Les URL résultantes sur votre site en ligne incluent le chemin de montage. Une page créée en tant que `quickstart.mdx` dans une source montée sur `eng` est servie à l’adresse `/eng/quickstart`.
+
+## Exemple
+
+Un déploiement avec deux sources — une montée sur `platform`, une montée sur `eng` — produit une configuration fusionnée qui ressemble à ceci :
+
+**`docs.json` de la source principale (montée sur `platform`) :**
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ "theme": "mint",
+ "name": "Acme Docs",
+ "colors": { "primary": "#0D9373" },
+ "favicon": "/favicon.svg",
+ "redirects": [{ "source": "/old", "destination": "/new" }],
+ "navigation": {
+ "groups": [
+ { "group": "Get started", "pages": ["index", "setup"] }
+ ]
+ }
+}
+```
+
+**`docs.json` de la seconde source (montée sur `eng`) :**
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ "name": "Engineering",
+ "navigation": {
+ "groups": [
+ { "group": "Guides", "pages": ["quickstart"] }
+ ]
+ }
+}
+```
+
+**Configuration fusionnée que Mintlify compile et sert :**
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ "theme": "mint",
+ "name": "Acme Docs",
+ "colors": { "primary": "#0D9373" },
+ "favicon": "/favicon.svg",
+ "redirects": [{ "source": "/old", "destination": "/new" }],
+ "navigation": {
+ "products": [
+ {
+ "product": "Platform",
+ "groups": [
+ { "group": "Get started", "pages": ["platform/index", "platform/setup"] }
+ ]
+ },
+ {
+ "product": "Engineering",
+ "groups": [
+ { "group": "Guides", "pages": ["eng/quickstart"] }
+ ]
+ }
+ ]
+ }
+}
+```
+
+## Échecs de compilation
+
+La compilation échoue et le déploiement n’est pas mis à jour si :
+
+* Une source n’a pas de `docs.json`, ou le `docs.json` d’une source est invalide.
+* Une source a un chemin de montage vide.
+* Deux sources ont des chemins de montage qui se chevauchent.
+* La `navigation` d’une source utilise `products` au niveau supérieur.
+
+L’erreur de compilation indique le nom de la source à l’origine de l’échec afin que vous puissiez la corriger dans ce référentiel.
+
+## Ressources connexes
+
+* [Configuration d’un monorepo](/deploy/monorepo) — pointer une seule source vers un sous-répertoire d’un référentiel plus large.
+* [Products](/organize/navigation#products) — la division de navigation que produisent les déploiements multi-sources.
diff --git a/zh.json b/zh.json
index 3ff13485a6..b7aeb1e3d5 100644
--- a/zh.json
+++ b/zh.json
@@ -173,6 +173,7 @@
]
},
"zh/deploy/monorepo",
+ "zh/deploy/multiple-sources",
"zh/deploy/vercel-external-proxies",
"zh/deploy/ci",
"zh/deploy/github",
diff --git a/zh/deploy/multiple-sources.mdx b/zh/deploy/multiple-sources.mdx
new file mode 100644
index 0000000000..ea51c3eb3d
--- /dev/null
+++ b/zh/deploy/multiple-sources.mdx
@@ -0,0 +1,114 @@
+---
+title: "多源部署"
+description: "将多个 git 仓库的文档汇入一个 Mintlify 部署，每个源挂载在各自的路径下。"
+keywords: ["multi-source", "multiple repos", "git sources", "mount path", "products"]
+---
+
+将多个 git 仓库连接到同一个 Mintlify 部署。每个仓库称为一个 _源_，提供自己的 `docs.json` 和内容，Mintlify 在构建时将它们合并为一个站点。当相关产品的文档位于不同仓库中，但需要在同一个域名和导航树下展示时，可以使用多源部署。
+
+## 源的合并方式
+
+当部署包含多个源时，Mintlify 会在每次构建时拉取每个源的 `docs.json`，并将其合并为一棵 `navigation.products` 树：
+
+* **部署中列出的第一个源** 是 _主源_。它的 `docs.json` 为合并后的站点提供顶层配置，包括 `name`、`theme`、`colors`、`logo`、`favicon`、`redirects` 以及其他所有顶层字段。
+* **其他源** 仅贡献它们的 `navigation`。这些配置中的其他顶层字段（例如 `redirects` 或 `theme`）将被忽略，并在构建时记录一条警告，列出被忽略的键。
+* 每个源的 `navigation` 都会成为合并后的 `navigation.products` 数组中的一项。该产品的显示名称为源的标签，若未设置标签，则使用其 `docs.json` 中的 `name`。
+
+合并后的结果等价于一个使用 [products](/organize/navigation#products) 作为顶层导航划分的 `docs.json`。
+
+
+源自身的 `docs.json` 不能使用 `navigation.products`。products 仅存在于合并后的顶层，因此每个源必须使用非 product 的导航形式（例如 `groups`、`tabs`、`versions` 或 `anchors`）。
+
+
+## 挂载路径
+
+多源部署中的每个源都必须设置一个非空的 **挂载路径**。挂载路径是该源内容所提供服务的 URL 前缀，合并时会被添加到该源 `docs.json` 中的每个引用前：
+
+* `pages`、`root` 和 `href` 字段中的页面路径。例如，挂载在 `eng` 的源中的 `quickstart` 会解析为 `eng/quickstart`。
+* `openapi` 和 `asyncapi` 字段中的 OpenAPI 与 AsyncAPI 引用，包括 `source` 和 `directory` 属性。
+* 全局导航条目（如 `anchors` 和 `tabs`）中的 `href` 值。
+
+绝对 URL（`https://…`）和页面内锚点（`#section`）保持不变。同一部署中各源的挂载路径不能重叠。
+
+最终上线站点中的 URL 会包含挂载路径。在挂载于 `eng` 的源中作为 `quickstart.mdx` 编写的页面，访问地址为 `/eng/quickstart`。
+
+## 示例
+
+一个包含两个源（分别挂载在 `platform` 和 `eng`）的部署，会生成如下合并配置：
+
+**主源 `docs.json`（挂载于 `platform`）：**
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ "theme": "mint",
+ "name": "Acme Docs",
+ "colors": { "primary": "#0D9373" },
+ "favicon": "/favicon.svg",
+ "redirects": [{ "source": "/old", "destination": "/new" }],
+ "navigation": {
+ "groups": [
+ { "group": "Get started", "pages": ["index", "setup"] }
+ ]
+ }
+}
+```
+
+**第二个源 `docs.json`（挂载于 `eng`）：**
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ "name": "Engineering",
+ "navigation": {
+ "groups": [
+ { "group": "Guides", "pages": ["quickstart"] }
+ ]
+ }
+}
+```
+
+**Mintlify 实际构建并提供服务的合并配置：**
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ "theme": "mint",
+ "name": "Acme Docs",
+ "colors": { "primary": "#0D9373" },
+ "favicon": "/favicon.svg",
+ "redirects": [{ "source": "/old", "destination": "/new" }],
+ "navigation": {
+ "products": [
+ {
+ "product": "Platform",
+ "groups": [
+ { "group": "Get started", "pages": ["platform/index", "platform/setup"] }
+ ]
+ },
+ {
+ "product": "Engineering",
+ "groups": [
+ { "group": "Guides", "pages": ["eng/quickstart"] }
+ ]
+ }
+ ]
+ }
+}
+```
+
+## 构建失败
+
+在以下情况下，构建将失败，部署不会被更新：
+
+* 任一源缺少 `docs.json`，或源的 `docs.json` 无效。
+* 任一源的挂载路径为空。
+* 两个源的挂载路径相互重叠。
+* 某个源的 `navigation` 在顶层使用了 `products`。
+
+构建错误信息会指出导致失败的源，便于你在对应的仓库中进行修复。
+
+## 相关内容
+
+* [Monorepo 设置](/deploy/monorepo) — 将单个源指向大型仓库中的子目录。
+* [Products](/organize/navigation#products) — 多源部署所生成的导航划分形式。
From 9d92f9f16a0b78613fa07be9d742e5ad9fe83a9d Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 11 Jun 2026 15:16:33 +0000
Subject: [PATCH 2/2] docs: apply translation conventions to multiple-sources
page
---
es/deploy/multiple-sources.mdx | 26 ++++++++++++++++++--------
fr/deploy/multiple-sources.mdx | 26 ++++++++++++++++++--------
zh/deploy/multiple-sources.mdx | 26 ++++++++++++++++++--------
3 files changed, 54 insertions(+), 24 deletions(-)
diff --git a/es/deploy/multiple-sources.mdx b/es/deploy/multiple-sources.mdx
index c7a7582353..44fc7678db 100644
--- a/es/deploy/multiple-sources.mdx
+++ b/es/deploy/multiple-sources.mdx
@@ -6,7 +6,9 @@ keywords: ["multi-source", "multiple repos", "git sources", "mount path", "produ
Conecta más de un repositorio de git a un único despliegue de Mintlify. Cada repositorio, llamado _fuente_, aporta su propio `docs.json` y su contenido, y Mintlify los combina en un solo sitio durante la compilación. Usa despliegues de múltiples fuentes cuando la documentación de productos relacionados vive en repositorios separados pero debe aparecer bajo un único dominio y árbol de navegación.
-## Cómo se combinan las fuentes
+
+ ## Cómo se combinan las fuentes
+
Cuando un despliegue tiene más de una fuente, Mintlify obtiene el `docs.json` de cada fuente en cada compilación y los combina en un único árbol `navigation.products`:
@@ -14,13 +16,15 @@ Cuando un despliegue tiene más de una fuente, Mintlify obtiene el `docs.json` d
* Las **fuentes adicionales** solo aportan su `navigation`. Los demás campos de nivel superior en esas configuraciones (por ejemplo, `redirects` o `theme`) se ignoran, y se registra una advertencia durante la compilación que lista las claves ignoradas.
* El `navigation` de cada fuente se convierte en una entrada del arreglo `navigation.products` combinado. El nombre visible del producto es la etiqueta de la fuente, o el `name` de su `docs.json` si no se ha establecido una etiqueta.
-El resultado combinado equivale a un único `docs.json` que usa [products](/organize/navigation#products) como su división de navegación de nivel superior.
+El resultado combinado equivale a un único `docs.json` que usa [products](/es/organize/navigation#products) como su división de navegación de nivel superior.
El `docs.json` de una fuente no puede usar `navigation.products`. Los products solo existen en el nivel superior combinado, por lo que cada fuente debe usar una navegación que no sea de products (por ejemplo, `groups`, `tabs`, `versions` o `anchors`).
-## Rutas de montaje
+
+ ## Rutas de montaje
+
Cada fuente en un despliegue de múltiples fuentes debe tener una **ruta de montaje** no vacía. La ruta de montaje es el prefijo de URL bajo el cual se sirve el contenido de la fuente, y se antepone a cada referencia en el `docs.json` de esa fuente durante la combinación:
@@ -32,7 +36,9 @@ Las URLs absolutas (`https://…`) y los anclas dentro de la página (`#section`
Las URLs resultantes en tu sitio publicado incluyen la ruta de montaje. Una página creada como `quickstart.mdx` en una fuente montada en `eng` se sirve en `/eng/quickstart`.
-## Ejemplo
+
+ ## Ejemplo
+
Un despliegue con dos fuentes —una montada en `platform` y otra montada en `eng`— produce una configuración combinada que se ve así:
@@ -97,7 +103,9 @@ Un despliegue con dos fuentes —una montada en `platform` y otra montada en `en
}
```
-## Fallos de compilación
+
+ ## Fallos de compilación
+
La compilación falla y el despliegue no se actualiza si:
@@ -108,7 +116,9 @@ La compilación falla y el despliegue no se actualiza si:
El error de compilación indica el nombre de la fuente que causó el fallo para que puedas corregirlo en ese repositorio.
-## Relacionado
+
+ ## Relacionado
+
-* [Configuración de monorepo](/deploy/monorepo) — apuntar una única fuente a un subdirectorio de un repositorio más grande.
-* [Products](/organize/navigation#products) — la división de navegación que producen los despliegues de múltiples fuentes.
+* [Configuración de monorepo](/es/deploy/monorepo) — apuntar una única fuente a un subdirectorio de un repositorio más grande.
+* [Products](/es/organize/navigation#products) — la división de navegación que producen los despliegues de múltiples fuentes.
diff --git a/fr/deploy/multiple-sources.mdx b/fr/deploy/multiple-sources.mdx
index 2e1234b546..7eea9d1b52 100644
--- a/fr/deploy/multiple-sources.mdx
+++ b/fr/deploy/multiple-sources.mdx
@@ -6,7 +6,9 @@ keywords: ["multi-source", "multiple repos", "git sources", "mount path", "produ
Connectez plusieurs référentiels git à un seul déploiement Mintlify. Chaque référentiel, appelé _source_, fournit son propre `docs.json` ainsi que son contenu, et Mintlify les fusionne en un seul site au moment de la compilation. Utilisez les déploiements multi-sources lorsque la documentation de produits liés se trouve dans des référentiels distincts mais doit apparaître sous un même domaine et une même arborescence de navigation.
-## Comment les sources sont fusionnées
+
+ ## Comment les sources sont fusionnées
+
Lorsqu’un déploiement comporte plusieurs sources, Mintlify récupère le `docs.json` de chaque source à chaque compilation et les fusionne en une seule arborescence `navigation.products` :
@@ -14,13 +16,15 @@ Lorsqu’un déploiement comporte plusieurs sources, Mintlify récupère le `doc
* Les **sources additionnelles** ne contribuent qu’à leur `navigation`. Les autres champs de niveau supérieur de ces configurations (par exemple, `redirects` ou `theme`) sont ignorés, et un avertissement est consigné lors de la compilation, listant les clés ignorées.
* La `navigation` de chaque source devient une entrée dans le tableau `navigation.products` fusionné. Le nom d’affichage du produit est le libellé de la source, ou son `name` dans `docs.json` si aucun libellé n’est défini.
-Le résultat fusionné équivaut à un unique `docs.json` qui utilise les [products](/organize/navigation#products) comme division de navigation de niveau supérieur.
+Le résultat fusionné équivaut à un unique `docs.json` qui utilise les [products](/fr/organize/navigation#products) comme division de navigation de niveau supérieur.
Le `docs.json` d’une source ne peut pas lui-même utiliser `navigation.products`. Les produits n’existent qu’au niveau supérieur fusionné, donc chaque source doit utiliser une navigation autre que par produit (par exemple, `groups`, `tabs`, `versions` ou `anchors`).
-## Chemins de montage
+
+ ## Chemins de montage
+
Chaque source d’un déploiement multi-sources doit avoir un **chemin de montage** non vide. Le chemin de montage est le préfixe d’URL sous lequel le contenu de la source est servi, et il est ajouté en préfixe à chaque référence dans le `docs.json` de cette source lors de la fusion :
@@ -32,7 +36,9 @@ Les URL absolues (`https://…`) et les ancres internes à la page (`#section`)
Les URL résultantes sur votre site en ligne incluent le chemin de montage. Une page créée en tant que `quickstart.mdx` dans une source montée sur `eng` est servie à l’adresse `/eng/quickstart`.
-## Exemple
+
+ ## Exemple
+
Un déploiement avec deux sources — une montée sur `platform`, une montée sur `eng` — produit une configuration fusionnée qui ressemble à ceci :
@@ -97,7 +103,9 @@ Un déploiement avec deux sources — une montée sur `platform`, une montée su
}
```
-## Échecs de compilation
+
+ ## Échecs de compilation
+
La compilation échoue et le déploiement n’est pas mis à jour si :
@@ -108,7 +116,9 @@ La compilation échoue et le déploiement n’est pas mis à jour si :
L’erreur de compilation indique le nom de la source à l’origine de l’échec afin que vous puissiez la corriger dans ce référentiel.
-## Ressources connexes
+
+ ## Ressources connexes
+
-* [Configuration d’un monorepo](/deploy/monorepo) — pointer une seule source vers un sous-répertoire d’un référentiel plus large.
-* [Products](/organize/navigation#products) — la division de navigation que produisent les déploiements multi-sources.
+* [Configuration d’un monorepo](/fr/deploy/monorepo) — pointer une seule source vers un sous-répertoire d’un référentiel plus large.
+* [Products](/fr/organize/navigation#products) — la division de navigation que produisent les déploiements multi-sources.
diff --git a/zh/deploy/multiple-sources.mdx b/zh/deploy/multiple-sources.mdx
index ea51c3eb3d..358b646ae8 100644
--- a/zh/deploy/multiple-sources.mdx
+++ b/zh/deploy/multiple-sources.mdx
@@ -6,7 +6,9 @@ keywords: ["multi-source", "multiple repos", "git sources", "mount path", "produ
将多个 git 仓库连接到同一个 Mintlify 部署。每个仓库称为一个 _源_，提供自己的 `docs.json` 和内容，Mintlify 在构建时将它们合并为一个站点。当相关产品的文档位于不同仓库中，但需要在同一个域名和导航树下展示时，可以使用多源部署。
-## 源的合并方式
+
+ ## 源的合并方式
+
当部署包含多个源时，Mintlify 会在每次构建时拉取每个源的 `docs.json`，并将其合并为一棵 `navigation.products` 树：
@@ -14,13 +16,15 @@ keywords: ["multi-source", "multiple repos", "git sources", "mount path", "produ
* **其他源** 仅贡献它们的 `navigation`。这些配置中的其他顶层字段（例如 `redirects` 或 `theme`）将被忽略，并在构建时记录一条警告，列出被忽略的键。
* 每个源的 `navigation` 都会成为合并后的 `navigation.products` 数组中的一项。该产品的显示名称为源的标签，若未设置标签，则使用其 `docs.json` 中的 `name`。
-合并后的结果等价于一个使用 [products](/organize/navigation#products) 作为顶层导航划分的 `docs.json`。
+合并后的结果等价于一个使用 [products](/zh/organize/navigation#products) 作为顶层导航划分的 `docs.json`。
源自身的 `docs.json` 不能使用 `navigation.products`。products 仅存在于合并后的顶层，因此每个源必须使用非 product 的导航形式（例如 `groups`、`tabs`、`versions` 或 `anchors`）。
-## 挂载路径
+
+ ## 挂载路径
+
多源部署中的每个源都必须设置一个非空的 **挂载路径**。挂载路径是该源内容所提供服务的 URL 前缀，合并时会被添加到该源 `docs.json` 中的每个引用前：
@@ -32,7 +36,9 @@ keywords: ["multi-source", "multiple repos", "git sources", "mount path", "produ
最终上线站点中的 URL 会包含挂载路径。在挂载于 `eng` 的源中作为 `quickstart.mdx` 编写的页面，访问地址为 `/eng/quickstart`。
-## 示例
+
+ ## 示例
+
一个包含两个源（分别挂载在 `platform` 和 `eng`）的部署，会生成如下合并配置：
@@ -97,7 +103,9 @@ keywords: ["multi-source", "multiple repos", "git sources", "mount path", "produ
}
```
-## 构建失败
+
+ ## 构建失败
+
在以下情况下，构建将失败，部署不会被更新：
@@ -108,7 +116,9 @@ keywords: ["multi-source", "multiple repos", "git sources", "mount path", "produ
构建错误信息会指出导致失败的源，便于你在对应的仓库中进行修复。
-## 相关内容
+
+ ## 相关内容
+
-* [Monorepo 设置](/deploy/monorepo) — 将单个源指向大型仓库中的子目录。
-* [Products](/organize/navigation#products) — 多源部署所生成的导航划分形式。
+* [Monorepo 设置](/zh/deploy/monorepo) — 将单个源指向大型仓库中的子目录。
+* [Products](/zh/organize/navigation#products) — 多源部署所生成的导航划分形式。