Skip to content
Open
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
24 changes: 23 additions & 1 deletion deploy/multi-repo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@

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.

<Note>
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.
Expand Down Expand Up @@ -91,6 +91,28 @@
</Step>
</Steps>

## 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.

<Steps>
<Step title="Open Git settings">
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.
</Step>

<Step title="Set a new base source">
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.
</Step>
</Steps>

<Warning>
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.

Check warning on line 113 in deploy/multi-repo.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

deploy/multi-repo.mdx#L113

In general, use active voice instead of passive voice ('are unaffected').
</Warning>

## Example repository layout

In this example, each source has its own repository and its own `docs.json`.
Expand Down
26 changes: 25 additions & 1 deletion es/deploy/multi-repo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<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 @@ -97,6 +97,30 @@ El `docs.json` del primer repositorio configurado es el `docs.json` raíz de la
</Step>
</Steps>

<div id="change-the-base-source">
## Cambiar la fuente base
</div>

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.

<Steps>
<Step title="Abrir la configuración de Git">
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.
</Step>

<Step title="Establecer una nueva fuente base">
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.
</Step>
</Steps>

<Warning>
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.
</Warning>

<div id="example-repository-layout">
## Ejemplo de organización de repositorios
</div>
Expand Down
26 changes: 25 additions & 1 deletion fr/deploy/multi-repo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<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 @@ -97,6 +97,30 @@ Le `docs.json` du premier référentiel configuré sert de `docs.json` racine du
</Step>
</Steps>

<div id="change-the-base-source">
## Changer la source de base
</div>

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.

<Steps>
<Step title="Ouvrir les paramètres Git">
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.
</Step>

<Step title="Définir une nouvelle source de base">
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.
</Step>
</Steps>

<Warning>
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.
</Warning>

<div id="example-repository-layout">
## Exemple d’organisation des référentiels
</div>
Expand Down
26 changes: 25 additions & 1 deletion zh/deploy/multi-repo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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)

<Note>
多仓库部署不同于[monorepo 配置](/zh/deploy/monorepo)。当你将所有内容与源代码一起存放在单个仓库的子目录中时,请使用 monorepo 配置。当你将内容分散存放在不同的仓库中时,请使用多仓库部署。
Expand Down Expand Up @@ -97,6 +97,30 @@ docs.example.com/sdks
</Step>
</Steps>

<div id="change-the-base-source">
## 更改基础源
</div>

基础源为你的多仓库部署提供站点级配置。当你希望由另一个仓库的 `docs.json` 控制主题、颜色、站点名称和顶层导航等设置时,请更改基础源。

<Steps>
<Step title="打开 Git 设置">
在你的控制台中前往 [Git 设置](https://app.mintlify.com/settings/deployment/git-settings)。

当前的基础源会在仓库名称旁显示 **Base** 徽章。
</Step>

<Step title="设置新的基础源">
在你想用作基础的仓库上,选择 **Set as base**。

Mintlify 会立即更新基础源,并使用新基础仓库的 `docs.json` 作为站点级配置来排队进行一次部署。
</Step>
</Steps>

<Warning>
更改基础源会用新基础仓库 `docs.json` 中的值替换站点级设置,例如主题、颜色、Logo、站点名称和顶层导航。其他源的 URL 路径和内容不受影响。
</Warning>

<div id="example-repository-layout">
## 示例仓库布局
</div>
Expand Down
Loading