# Monorepos

GitBook prend en charge les monorepos. Un monorepo est un dépôt qui contient plus d’un projet logique (par exemple, un client iOS et une application web).

GitBook peut synchroniser plusieurs répertoires du même dépôt avec plusieurs espaces. Lorsque vous activez la synchronisation Git sur un espace, vous pouvez configurer un « répertoire du projet ». Il sera utilisé pour rechercher le `.gitbook.yaml` fichier du répertoire à synchroniser avec cet espace.

Exemple de structure de dépôt :

```
/
  package.json
  packages/
     styleguide/
        .gitbook.yaml
        README.md
        SUMMARY.md
     app/
        README.md
        SUMMARY.md
     api/
        .gitbook.yaml
        README.md
        SUMMARY.md
```

Dans cet exemple, 3 espaces peuvent être créés sur GitBook et configurés avec différents répertoires racine :

* `packages/styleguide`
* `packages/app`
* `packages/api`

L’option « Répertoire du projet » au niveau de la synchronisation Git diffère du [`root` option](/docs/documentation/fr/getting-started/git-sync/content-configuration.md#root) dans le menu `.gitbook.yaml` fichier de configuration. Le premier est utilisé pour rechercher `.gitbook.yaml` lui-même, puis les deux sont combinés pour rechercher le reste des fichiers dans le répertoire. Si aucun `.gitbook.yaml` n’existe dans le « Répertoire du projet », la synchronisation utilisera la configuration par défaut limitée à ce répertoire.

## Mettre à jour le répertoire du projet <a href="#updating" id="updating"></a>

{% hint style="info" %}
Dans la plupart des cas, nous recommandons l’étape suivante pour mettre à jour le répertoire du projet :

1. Désactiver la synchronisation Git existante
2. Déplacer les fichiers du dépôt Git vers le répertoire du projet
3. Reconfigurer la synchronisation Git avec le nouveau répertoire du projet
   {% endhint %}

Dans certains cas, vous avez peut-être commencé avec un dépôt classique synchronisé avec un seul espace, puis décidé de passer à un monorepo avec plusieurs espaces s’y synchronisant ; ou vous avez peut-être besoin de renommer le répertoire du projet.

Modifier le répertoire du projet sur une synchronisation Git existante peut avoir un impact inattendu sur le contenu ; la modification ne sera propagée qu’à la prochaine synchronisation (modification effectuée sur GitBook ou nouveau commit dans le dépôt Git).

#### **Si la prochaine opération est une importation depuis le dépôt Git**:

GitBook s’attendra à trouver les pages et les fichiers dans le répertoire du projet. Si les fichiers n’ont pas déjà été déplacés dans le répertoire du projet du dépôt, le résultat de la synchronisation serait un espace vide sans contenu.

Nous recommandons que la prochaine opération soit un commit déplaçant tous les fichiers liés à GitBook (fichiers markdown, README/SUMMARY et ressources) dans le dépôt vers leur nouvel emplacement correct, dans le répertoire du projet.

**Si la prochaine opération est une exportation de GitBook vers le dépôt Git**:

GitBook générera ou mettra à jour de nouveaux fichiers dans le nouveau répertoire du projet. Les fichiers synchronisés avec GitBook seront déplacés vers le nouveau répertoire du projet (au mieux) ; cela peut entraîner des effets secondaires si d’autres parties de votre système dépendent de ces fichiers.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.com/docs/documentation/fr/getting-started/git-sync/monorepos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.