> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/fr/manage-your-site/site-structure.md).

# Structure du site

Organisez votre documentation publiée avec des sections, des variantes et des liens externes

Le contenu de votre site se trouve dans ses [sections](https://gitbook.com/docs/documentation/fr/creer-du-contenu/content-structure/space.md). Vous pouvez ajouter une ou plusieurs sections. GitBook publiera chacune d’elles et gérera la navigation entre elles.

## Types de contenu

Le contenu de votre site peut servir comme l’un de deux types de contenu différents, qui déterminent la façon dont GitBook le traite et l’affiche aux visiteurs.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-type="image">Image de couverture (sombre)</th><th data-hidden data-card-cover data-type="image">Image de couverture</th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden><select></select></th><th data-hidden data-card-cover-dark data-type="image">Image de couverture (sombre)</th></tr></thead><tbody><tr><td><strong>Sections</strong></td><td>Divisez votre site en parties distinctes — idéal pour plusieurs produits ou différentes parties de votre organisation.</td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-12ea6e551e1e565fa8de101106fd0171c5de2f5b%2F25_08_29_site_sections.svg?alt=media">25_08_29_site_sections.svg</a></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-ec53f8f7499d7ad408a21dbad800676453bb3026%2F25_12_10_site_sections_1.png?alt=media">25_12_10_site_sections_1.png</a></td><td><a href="https://gitbook.com/docs/documentation/fr/manage-your-site/site-structure/site-sections.md">Sections</a></td><td></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-da4dae17d68633634557ef1231d752e7ad5f93ff%2F25_12_10_site_sections.png?alt=media">25_12_10_site_sections.png</a></td></tr><tr><td><strong>Variantes de contenu</strong></td><td>Publiez plusieurs versions du même contenu — idéal pour la localisation, le versionnage, et plus encore.</td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-deae71cbecc45bb8df4a45ac759fbce15ef71308%2F25_08_29_content_variants.svg?alt=media">25_08_29_content_variants.svg</a></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-c5b1ce79a08b476db23db7c01de73249ce6d3dce%2F25_12_10_content_variants_1.png?alt=media">25_12_10_content_variants_1.png</a></td><td><a href="https://gitbook.com/docs/documentation/fr/manage-your-site/site-structure/variants.md">Variantes de contenu</a></td><td></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-f650b6888150ed69e6a055ea47f9732332e64092%2F25_12_10_content_variants.png?alt=media">25_12_10_content_variants.png</a></td></tr></tbody></table>

## Gestion de la structure de votre site

En gérant la structure de votre site, vous pouvez également gérer la barre de navigation supérieure de votre site. Cette barre de navigation permet aux visiteurs d’ouvrir des sections, des groupes et des liens externes.

Ouvrez l’éditeur de structure depuis **Structure du site** dans la barre latérale du site. Vous pouvez y consulter les sections, les variantes et les liens externes de votre site.

Votre site commence avec une seule section contenant le nom de votre site et une seule variante avec le contenu que vous avez créé lors de la configuration de votre site.

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-b13c3123b0d22ce9fce674e4d650a32ac78b5078%2F25_12_10_structure_light.png?alt=media" alt="A GitBook screenshot showing a docs site&#x27;s structure"><figcaption><p>La structure d’un site de documentation publié.</p></figcaption></figure>

### Ajouter une section à votre site de documentation

Pour ajouter une [section](https://gitbook.com/docs/documentation/fr/manage-your-site/site-structure/site-sections.md), cliquez sur le bouton **Ajouter une section** situé sous le tableau, puis choisissez le contenu à ajouter. La nouvelle section est alors ajoutée au tableau et apparaît sous forme d’onglet en haut de votre site pour les visiteurs.

Pour ajouter une [variante](https://gitbook.com/docs/documentation/fr/manage-your-site/site-structure/variants.md), cliquez sur le bouton **Ajouter une variante** dans la section à laquelle vous souhaitez l’ajouter, puis choisissez le contenu à ajouter. La nouvelle variante est alors ajoutée à la liste des variantes de la section choisie et apparaît dans le menu déroulant des variantes de votre site pour les visiteurs.

Lorsque vous ajoutez du contenu — en tant que variante ou section — un nom et un slug seront générés à partir de son titre.

### Ajouter un lien externe

Les liens externes ajoutent à la navigation des destinations situées en dehors de votre site. Ajoutez un lien comme élément de navigation à part entière, ou placez-le dans un groupe de sections avec des sections associées.

Pour ajouter un lien externe :

1. Dans la barre latérale du site, ouvrez **Structure du site**.
2. Dans le menu d’ajout, sélectionnez **Lien externe**.
3. Saisissez le libellé du lien et l’URL de destination.
4. Choisissez d’ajouter le lien séparément ou à un groupe de sections.
5. Cliquez sur **Enregistrer**.

Le lien apparaît dans la navigation de votre site publié à l’emplacement que vous choisissez.

### Modifier des sections ou des variantes

<div data-full-width="false"><figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-006e95ace860b31f7ec4f29b24eca552ea2c0dcf%2F25_12_10_edit_variant_light.png?alt=media" alt="A GitBook screenshot showing how to edit a variant"><figcaption><p>Mettre à jour une section ou une variante du site.</p></figcaption></figure></div>

Vous pouvez modifier le nom et le slug de chaque section et variante en cliquant sur le bouton **Modifier** <picture><source srcset="broken://files/kN09oTFtAuyaxNIwWuCt" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-d28f11ed4dfafb06aa9c6ae92db8017d94014317%2F25_01_10_edit_icon_light.svg?alt=media" alt="The Edit icon in GitBook"></picture> dans la ligne du tableau correspondant à l’élément à modifier. Une fenêtre modale s’ouvre alors. Modifiez le ou les champs souhaités, puis cliquez sur le bouton **Enregistrer** pour enregistrer vos modifications.

{% hint style="info" %}
Modifier le slug d’une section modifie son URL canonique. GitBook crée automatiquement une redirection de l’ancienne URL vers la nouvelle. Vous pouvez également [créer des redirections manuellement](https://gitbook.com/docs/documentation/fr/publish/site-redirects.md).
{% endhint %}

{% hint style="info" %}
Les slugs sont uniques dans l’ensemble de votre organisation — chaque chemin ne peut être utilisé que sur un seul site, même entre différents sites. Si vous voyez l’erreur « path is already taken », un autre site utilise déjà ce slug. Choisissez un slug légèrement différent, mais toujours pertinent pour votre contenu.
{% endhint %}

Pour remplacer une section ou une variante, supprimez-la d’abord en cliquant sur son bouton **Modifier** <picture><source srcset="broken://files/kN09oTFtAuyaxNIwWuCt" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-d28f11ed4dfafb06aa9c6ae92db8017d94014317%2F25_01_10_edit_icon_light.svg?alt=media" alt="The Edit icon in GitBook"></picture> , puis cliquez sur le bouton **Supprimer** en bas à gauche de la fenêtre modale. Une fois l’élément supprimé, cliquez sur le bouton **Ajouter une section** ou **Ajouter une variante** pour l’ajouter de nouveau.

### Réorganiser des sections ou des variantes

Sur votre site, les sections et les variantes s’affichent dans l’ordre où elles apparaissent dans le tableau **Structure du site** . Vous pouvez modifier leur ordre en saisissant la **Poignée de déplacement** <picture><source srcset="broken://files/QLUQj6waZRiK6FpSqrt6" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-23f3e8f05326b0d239d32d28bba99c1d46f204f7%2F25_01_10_options_light.svg?alt=media" alt="The Options menu icon in GitBook"></picture> et en la faisant glisser vers le haut ou vers le bas. Le nouvel ordre est immédiatement appliqué à votre site.

Vous pouvez également utiliser le clavier pour sélectionner et déplacer du contenu. Sélectionnez une section ou une variante avec la barre d’espace, puis utilisez les flèches pour la déplacer vers le haut ou vers le bas. Appuyez à nouveau sur la barre d’espace pour confirmer la nouvelle position.

### Définir le contenu par défaut

Si votre site comporte plusieurs sections, l’une d’elles sera marquée comme **Par défaut**. Cette section s’affiche lorsque les visiteurs arrivent sur votre site et est accessible depuis l’URL racine de votre site. Les autres sections ont chacune un slug ajouté à l’URL racine.

Si vous avez plusieurs variantes dans une section, l’une d’elles sera marquée comme variante par défaut. Comme pour les sections, la variante par défaut s’affiche lorsque les visiteurs arrivent sur votre site ou lorsqu’ils visitent une section. Les autres variantes ont chacune un slug ajouté à l’URL de la section.

Pour définir une section ou une variante par défaut, cliquez sur le **menu Actions** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture> dans la ligne correspondante du tableau, puis cliquez sur **Définir par défaut**.

{% hint style="info" %}
Définir du contenu comme défaut supprime son champ slug, car il sera alors servi depuis la racine de la section. GitBook redirige l’ancien slug vers le chemin approprié afin de garantir que les visiteurs continuent de voir votre contenu.
{% endhint %}

### Supprimer du contenu d’un site

Pour supprimer une section ou une variante d’un site, ouvrez l’éditeur de structure depuis **Structure du site** dans la barre latérale du site, puis recherchez le contenu à supprimer.

Ouvrez le **menu Actions** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture> du contenu à supprimer, puis choisissez **Supprimer**.

{% hint style="success" %}
La suppression de contenu de votre site le retirera du site publié, mais **ne supprimera pas le contenu lui-même** — vous pourrez toujours le retrouver dans [Tout le contenu](https://gitbook.com/docs/documentation/fr/creer-du-contenu/content-structure/all-content.md).
{% endhint %}

Si vous supprimez entièrement le contenu d’une section, le site — ainsi que ses paramètres et personnalisations — reste disponible. Le contenu supprimé reste dans la **Corbeille** pendant sept jours avant d’être définitivement supprimé. Si la section supprimée était la section par défaut de votre site, vérifiez que celle-ci est toujours correctement définie.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/manage-your-site/site-structure.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
