From bf5e3575c2da4f170b74f6ec519db89a79a2150a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 6 Aug 2026 23:49:40 +0000 Subject: [PATCH] docs: document sourceRef support inside tab menu arrays --- deploy/multi-repo.mdx | 4 +++- es/deploy/multi-repo.mdx | 4 +++- fr/deploy/multi-repo.mdx | 4 +++- zh/deploy/multi-repo.mdx | 4 +++- 4 files changed, 12 insertions(+), 4 deletions(-) diff --git a/deploy/multi-repo.mdx b/deploy/multi-repo.mdx index 873b51d424..5f25f86d7a 100644 --- a/deploy/multi-repo.mdx +++ b/deploy/multi-repo.mdx @@ -194,7 +194,9 @@ Add a `sourceRef` entry to a navigation array in the base source's `docs.json`. { "sourceRef": "acme/api-docs" } ``` -Mintlify supports `sourceRef` inside `anchors`, `tabs`, `groups`, `pages`, `products`, and arrays under `navigation.global`. Other navigation structures, including `menu` entries inside a tab, don't accept `sourceRef`. +Mintlify supports `sourceRef` inside `anchors`, `tabs`, `groups`, `pages`, `products`, `menu`, and arrays under `navigation.global`. + +When you place `sourceRef` inside a tab's `menu` array, Mintlify replaces the entry with the menu items the referenced source declares under `navigation.groups[*].menu` and prefixes each item's page paths with the referenced source's URL path. If the referenced source doesn't define any menu items under `navigation.groups`, the deployment fails. For example, to combine anchors from multiple repositories into a single anchor navigation: diff --git a/es/deploy/multi-repo.mdx b/es/deploy/multi-repo.mdx index 15bb70d293..64074cc720 100644 --- a/es/deploy/multi-repo.mdx +++ b/es/deploy/multi-repo.mdx @@ -214,7 +214,9 @@ Agrega una entrada `sourceRef` a un arreglo de navegación en el `docs.json` de { "sourceRef": "acme/api-docs" } ``` -Mintlify admite `sourceRef` dentro de `anchors`, `tabs`, `groups`, `pages`, `products` y los arreglos bajo `navigation.global`. Otras estructuras de navegación, incluidas las entradas de `menu` dentro de una pestaña, no aceptan `sourceRef`. +Mintlify admite `sourceRef` dentro de `anchors`, `tabs`, `groups`, `pages`, `products`, `menu` y los arreglos bajo `navigation.global`. + +Cuando colocas `sourceRef` dentro del arreglo `menu` de una pestaña, Mintlify sustituye la entrada por los elementos de menú que la fuente referenciada declara en `navigation.groups[*].menu` y antepone la ruta de URL de la fuente referenciada a la ruta de cada página. Si la fuente referenciada no define elementos de menú bajo `navigation.groups`, el despliegue falla. Por ejemplo, para combinar los anchors de varios repositorios en una sola navegación de anchors: diff --git a/fr/deploy/multi-repo.mdx b/fr/deploy/multi-repo.mdx index 42e92b99fc..7674eeca2c 100644 --- a/fr/deploy/multi-repo.mdx +++ b/fr/deploy/multi-repo.mdx @@ -214,7 +214,9 @@ Ajoutez une entrée `sourceRef` à un tableau de navigation dans le `docs.json` { "sourceRef": "acme/api-docs" } ``` -Mintlify prend en charge `sourceRef` dans `anchors`, `tabs`, `groups`, `pages`, `products` et les tableaux sous `navigation.global`. Les autres structures de navigation, y compris les entrées `menu` à l'intérieur d'un onglet, n'acceptent pas `sourceRef`. +Mintlify prend en charge `sourceRef` dans `anchors`, `tabs`, `groups`, `pages`, `products`, `menu` et les tableaux sous `navigation.global`. + +Lorsque vous placez `sourceRef` dans le tableau `menu` d'un onglet, Mintlify remplace l'entrée par les éléments de menu que la source référencée déclare sous `navigation.groups[*].menu` et préfixe le chemin de page de chaque élément avec le chemin d'URL de la source référencée. Si la source référencée ne définit aucun élément de menu sous `navigation.groups`, le déploiement échoue. Par exemple, pour combiner les anchors de plusieurs référentiels dans une seule navigation d'anchors : diff --git a/zh/deploy/multi-repo.mdx b/zh/deploy/multi-repo.mdx index 9349c780f3..3bfc2e30ae 100644 --- a/zh/deploy/multi-repo.mdx +++ b/zh/deploy/multi-repo.mdx @@ -214,7 +214,9 @@ See the [API reference](/api/reference/authentication) for details. { "sourceRef": "acme/api-docs" } ``` -Mintlify 支持在 `anchors`、`tabs`、`groups`、`pages`、`products` 以及 `navigation.global` 下的数组中使用 `sourceRef`。其他导航结构（包括标签页内的 `menu` 条目）不支持 `sourceRef`。 +Mintlify 支持在 `anchors`、`tabs`、`groups`、`pages`、`products`、`menu` 以及 `navigation.global` 下的数组中使用 `sourceRef`。 + +当你在标签页的 `menu` 数组中放置 `sourceRef` 时，Mintlify 会用被引用源在 `navigation.groups[*].menu` 下声明的菜单项替换该条目，并在每个菜单项的页面路径前加上被引用源的 URL 路径。如果被引用源没有在 `navigation.groups` 下定义菜单项，部署将失败。 例如，若要将多个仓库的 anchors 合并到单个 anchor 导航中：