Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 12 additions & 1 deletion es/deploy/multi-repo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,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.

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.
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 su propia navegación y contenido bajo su ruta de URL configurada, además de cualquier [variable](#variables-across-sources) que la fuente base no defina. 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.

<Note>
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.
Expand Down Expand Up @@ -188,6 +188,17 @@ No uses URLs completas con `https://` para enlaces internos entre fuentes: las r

Cuando una fuente usa la ruta de URL raíz, sus páginas pueden compartir la misma URL final que las páginas de otra fuente. Si dos fuentes producen la misma ruta de página, Mintlify sirve la página desde la fuente con la ruta de URL más específica y registra una advertencia de conflicto en la actualización de la implementación. Para evitar conflictos, procura que los nombres de archivo de la fuente raíz no se superpongan con las rutas de URL configuradas para otras fuentes.

<div id="variables-across-sources">
## Variables entre fuentes
</div>

Mintlify combina las [`variables`](/es/organize/settings-reference#variables) definidas en el `docs.json` de cada repositorio fuente en un único conjunto para el sitio implementado. Las páginas de cualquier fuente pueden hacer referencia a cualquier variable combinada con la sintaxis `{{variableName}}`.

Cuando más de una fuente define la misma clave de variable:

- El valor de la fuente base siempre tiene prioridad.
- Si dos fuentes no base definen la misma clave con valores distintos y la fuente base no la define, Mintlify usa el valor de la fuente configurada primero y registra una advertencia en la implementación para actualizar los nombres en conflicto en las fuentes no base.

<div id="reference-navigation-from-another-source">
## Referenciar la navegación desde otra fuente
</div>
Expand Down
13 changes: 12 additions & 1 deletion fr/deploy/multi-repo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,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é.

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.
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 fournit sa propre navigation et son propre contenu sous son chemin d’URL configuré, ainsi que toutes les [variables](#variables-across-sources) que la source de base ne définit pas. 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.

<Note>
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.
Expand Down Expand Up @@ -188,6 +188,17 @@ N’utilisez pas d’URL complètes `https://` pour les liens internes entre sou

Lorsqu’une source utilise le chemin d’URL racine, ses pages peuvent partager la même URL finale que des pages d’une autre source. Si deux sources produisent le même chemin de page, Mintlify diffuse la page depuis la source dont le chemin d’URL est le plus spécifique et enregistre un avertissement de conflit dans la mise à jour du déploiement. Pour éviter les conflits, veillez à ce que les noms de fichiers de la source racine ne chevauchent pas les chemins d’URL configurés pour les autres sources.

<div id="variables-across-sources">
## Variables entre les sources
</div>

Mintlify fusionne les [`variables`](/fr/organize/settings-reference#variables) définies dans le `docs.json` de chaque référentiel source en un seul ensemble pour le site déployé. Les pages de n’importe quelle source peuvent référencer n’importe quelle variable fusionnée avec la syntaxe `{{variableName}}`.

Lorsque plusieurs sources définissent la même clé de variable :

- La valeur de la source de base est toujours prioritaire.
- Si deux sources non-base définissent la même clé avec des valeurs différentes et que la source de base ne la définit pas, Mintlify utilise la valeur de la source configurée en premier et enregistre un avertissement dans le déploiement pour mettre à jour les noms en conflit dans les sources non-base.

<div id="reference-navigation-from-another-source">
## Référencer la navigation d'une autre source
</div>
Expand Down
13 changes: 12 additions & 1 deletion zh/deploy/multi-repo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ docs.example.com/sdks

在部署期间,Mintlify 会读取每个仓库并将已配置的源合并到一个站点中。每个源会显示在其配置的 URL 路径下。

其中一个仓库作为部署的**基础源**。其 `docs.json` 是根 `docs.json`,控制站点级配置,包括主题、颜色、Logo、站点名称、顶层导航、集成、SEO 以及其他顶层字段。其他每个源仅在其配置的 URL 路径下贡献各自的导航和内容。你配置的第一个仓库默认就是基础源,你可以随时[更改作为基础的源](#change-the-base-source)。
其中一个仓库作为部署的**基础源**。其 `docs.json` 是根 `docs.json`,控制站点级配置,包括主题、颜色、Logo、站点名称、顶层导航、集成、SEO 以及其他顶层字段。其他每个源在其配置的 URL 路径下贡献各自的导航和内容,以及基础源未定义的任何[变量](#variables-across-sources)。你配置的第一个仓库默认就是基础源,你可以随时[更改作为基础的源](#change-the-base-source)。

<Note>
多仓库部署不同于[monorepo 配置](/zh/deploy/monorepo)。当你将所有内容与源代码一起存放在单个仓库的子目录中时,请使用 monorepo 配置。当你将内容分散存放在不同的仓库中时,请使用多仓库部署。
Expand Down Expand Up @@ -188,6 +188,17 @@ See the [API reference](/api/reference/authentication) for details.

当某个源使用根 URL 路径时,其页面可能会与另一个源中的页面产生相同的最终 URL。如果两个源生成了相同的页面路径,Mintlify 会从 URL 路径更具体的源提供该页面,并在部署更新中记录一条冲突警告。为避免冲突,请勿让根源中的文件名与其他源配置的 URL 路径重叠。

<div id="variables-across-sources">
## 跨源的变量
</div>

Mintlify 会将每个源仓库的 `docs.json` 中定义的 [`variables`](/zh/organize/settings-reference#variables) 合并为部署站点的单一集合。任何源中的页面都可以使用 `{{variableName}}` 语法引用任何已合并的变量。

当多个源定义了相同的变量键时:

- 基础源的值始终优先。
- 如果两个非基础源以不同的值定义相同的键,且基础源未定义该键,则 Mintlify 使用最先配置的源的值,并在部署中记录一条警告,提示更新非基础源中冲突的名称。

<div id="reference-navigation-from-another-source">
## 从其他源引用导航
</div>
Expand Down