---
title: Synchroniser plusieurs dossiers GitHub
slug: docs/fr/synchroniser-plusieurs-dossiers-github
createdAt: 2024-05-31T09:33:54.800Z
---

Si vous avez plusieurs dossiers dans votre dépôt que vous utilisez pour votre documentation, vous pouvez désormais tous les synchroniser avec Archbee.

:::hint{type="warning"}
Rappel sur la façon d’intégrer Archbee et GitHub :
:::

Au cas où vous auriez besoin de vous remémorer comment [intégrer les deux](https://docs.archbee.com/github#jJpEV), voici un guide complet à ce sujet.

Jusqu’à présent, vous ne pouviez utiliser le fichier `.archbee.yaml` que dans un seul dossier et pour un seul projet de documentation. Désormais, vous pouvez le faire avec plusieurs dossiers.

Si Archbee trouve un fichier `.archbee.yaml` dans la racine du dépôt ou dans tout autre dossier, nous l’utilisons pour organiser le contenu. C’est le même fichier dans tous les dossiers où votre documentation est stockée.

Voici un exemple de configuration de votre dépôt Git afin qu’Archbee puisse récupérer le contenu et l’organiser correctement dans notre logiciel > [dépôt git Archbee](https://github.com/dragosbulugean/slate)


## Configurer le dépôt

Veuillez vous référer à notre dépôt Archbee mentionné ci-dessus.

Si le système trouve un fichier `.archbee.yaml` à la racine du dépôt comme [celui-ci](https://github.com/dragosbulugean/slate/blob/master/.archbee.yaml), alors nous l’utilisons pour organiser le contenu. Sinon, nous appliquerons des valeurs par défaut.

### Créer un fichier .yaml pour plusieurs dossiers

Créez un fichier `.archbee.yaml` avec la structure de variables suivante.

:::hint{type="info"}
Vous devez placer le fichier dans le dossier racine de votre ou de vos dépôts. Assurez-vous que le fichier reste à cet emplacement, car il s’agit de votre chemin par défaut pour tous les autres dossiers.
:::

- `root: ./docs` définit le répertoire contenant la documentation (peut être remplacé par `docsPath: ./docs`)
- `structure :`
  - `résumé : summary.md` reconstruit l’arborescence des documents dans le panneau de navigation gauche d’Archbee. S’il n’y en a pas, nous considérons les dossiers comme des catégories et imitons la structure de fichiers interne.
  - `actifs : actifs`
     le dossier assets est relatif à docsPath. Archbee importera tous les fichiers trouvés dans ce dossier.
- \# Cela inclura tous les fichiers de code de votre dépôt
- `shadowDocs` définit les fichiers/dossiers de code à inclure comme Shadow Docs
- `publishSpace` booléen, définissez sur `vrai` pour publier l’espace sur le portail de production après chaque commit

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/ARwFXBxpMGGn8Y8Ce1OhI_git-sync-light.png)

Ci-dessous se trouve un exemple de fichier de configuration `archbee.yaml` avec le chemin ***par défaut*** (dossier).

:::CodeblockTabs
.archbee.yaml

```yaml
root: ./docs
structure:
  summary: summary.md
  assets: assets
publishSpace: true
headerIncludes:  |
  <script>
  document.getElementById("demo").innerHTML = "Hello JavaScript!";
  </script> 
```
:::

Exemple de fichier de configuration `archbee.yaml` avec des ***sous-chemins*** :

```javascript
root: folderx
structure:
  summary: summary.md
  assets: assets
publishSpace: true
headerIncludes:  |
  <script>
  document.getElementById("demo").innerHTML = "Hello JavaScript!";
  </script> 
```

Une fois que vous avez terminé, retournez dans Archbee et vérifiez si vous pouvez sélectionner plusieurs dossiers dans le menu déroulant :

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/KLw-OyxXwYqareQUJNNUC_git-select-light.png "Sélectionner le dépôt GitHub")

Nous recommandons également que vous créiez un fichier `summary.md`. Ce fichier reconstruit l’arborescence du document dans le panneau de navigation de gauche dans Archbee. Et il peut vous aider à organiser votre contenu proprement.

Voyez un exemple de fichier `summary.md` ci‑dessous :

:::CodeblockTabs
summary.md

```markdown
- [Introduction](1.md)

## Table of contents

- [Init](init.md)
- [Configure App](config.md)
- [Config Database](config-database.md)
- [Config Redis](config-redis.md)
- [Config Elastic Search](config-es.md)
- [Swagger](swagger-v2.json)

```
:::

## Synchronisation dans Archbee

Lorsque vous créez un nouvel espace, sélectionnez votre dépôt, les modifications sont automatiquement synchronisées dans Archbee.

Si cela ne fonctionne pas automatiquement, vous pouvez forcer la synchronisation en naviguant vers **Paramètres de l'espace** > **Intégration GitHub&#x20;**> cliquez sur le bouton **Synchroniser avec le dépôt**.

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/0yk-oP4X5jVKXKxVdWJlZ_settings-light.png "Synchroniser avec le dépôt")