# Configuration du contenu

Si vous souhaitez configurer davantage Git Sync, vous pouvez ajouter un `.gitbook.yaml` fichier à la racine de votre dépôt pour indiquer à GitBook comment analyser votre dépôt Git.

{% code title=".gitbook.yaml" %}

```yaml
root: ./

​structure :
  readme: README.md
  summary: SUMMARY.md​

redirects:
  previous/page: new-folder/page.md
```

{% endcode %}

### Racine

Le chemin à rechercher pour votre documentation correspond par défaut au répertoire racine du dépôt. Voici comment indiquer à GitBook de regarder dans un `./docs` dossier :

{% code title=".gitbook.yaml" %}

```yaml
root: ./docs/
```

{% endcode %}

{% hint style="warning" %}
**Toutes les autres options qui spécifient des chemins seront relatives à ce dossier racine**. Donc, si vous définissez root comme `./docs/` et ensuite `structure.summary` comme `./product/SUMMARY.md`, GitBook recherchera en fait un fichier dans `./docs/product/SUMMARY.md`.‌
{% endhint %}

### ​Structure‌ <a href="#structure" id="structure"></a>

La structure accepte deux propriétés :‌

* **`readme`**: La première page de votre documentation. Sa valeur par défaut est `./README.md`
* **`summary`**: La table des matières de votre documentation. Sa valeur par défaut est `./SUMMARY.md`

La valeur de ces propriétés est un chemin vers les fichiers correspondants. Le chemin est relatif à l’option « root ». Par exemple, voici comment indiquer à GitBook de regarder dans un `./product` dossier pour la première page et le résumé :

{% code title=".gitbook.yaml" %}

```yaml
structure:
  readme: ./product/README.md
  summary: ./product/SUMMARY.md
```

{% endcode %}

{% hint style="warning" %}
Lorsque Git Sync est activé, **n’oubliez pas de créer ou de modifier les fichiers readme** via l’interface utilisateur de GitBook. Le fichier readme doit être géré exclusivement dans votre dépôt GitHub/GitLab afin d’éviter les conflits et les problèmes de duplication.
{% endhint %}

### Résumé‌ <a href="#summary" id="summary"></a>

La `summary` fichier est un fichier Markdown (`.md`) qui doit avoir la structure suivante :

{% code title="./SUMMARY.md" %}

```markdown
‌# Résumé​

## Utilisez des titres pour créer des groupes de pages comme celui-ci​

* [Titre de la première page](page1/README.md)
    * [Une page enfant](page1/page1-1.md)
    * [Une autre page enfant](part1/page1-2.md)

* [Titre de la deuxième page](page2/README.md)
    * [Une page enfant](page2/page2-1.md)
    * [Une autre page enfant](part2/page2-2.md)

## Un groupe de pages de deuxième niveau​

* [Une autre page](another-page.md)
```

{% endcode %}

Fournir un fichier résumé personnalisé est facultatif. Par défaut, GitBook recherchera un fichier nommé `SUMMARY.md` dans votre `root` dossier si celui-ci est spécifié dans votre fichier de configuration, ou à la racine du dépôt dans le cas contraire.

Si vous ne spécifiez pas de résumé et que GitBook ne trouve pas de fichier `SUMMARY.md` à la racine de votre documentation, GitBook déduira la table des matières à partir de la structure des dossiers et des fichiers Markdown ci-dessous.‌

{% hint style="info" %}
Le fichier Markdown du résumé est **un miroir de la** **table des matières** de votre espace GitBook. Ainsi, même lorsqu’aucun fichier de résumé n’est fourni lors d’une importation initiale, GitBook en créera un et/ou le mettra à jour chaque fois que vous modifierez votre contenu à l’aide de l’éditeur GitBook.

Pour cette raison, il n’est pas possible de référencer deux fois le même fichier Markdown dans votre `SUMMARY.md` fichier, car cela impliquerait qu’une seule page se trouve à deux URL différentes dans votre espace GitBook.
{% endhint %}

#### Titres de la table des matières (barre latérale) <a href="#sidebar-titles" id="sidebar-titles"></a>

Si vous souhaitez que vos pages aient un titre différent dans la barre latérale de la table des matières que sur la page elle-même, vous pouvez définir un **titre du lien de page** dans votre `SUMMARY.md` fichier.

Si vous utilisez Git Sync, le titre du lien de page est défini sur le lien de la page :

{% code title="./SUMMARY.md" %}

```markdown
# Résumé

* [Titre principal de la page](page.md "Titre du lien de la page")
```

{% endcode %}

Le texte entre les guillemets (`"Titre du lien de page"`) sera utilisé :

* Dans la table des matières (barre latérale)
* Dans les boutons de pagination en bas de chaque page
* Dans tous les liens relatifs que vous ajoutez à cette page

Les titres de lien de page sont facultatifs — si vous n’en ajoutez pas manuellement, GitBook utilisera par défaut le titre standard de la page partout.