> 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/docs-site/site-structure/site-sections.md).

# Sections du site

<figure><img src="/files/acb964c3e903919452402c0ef8bbf03cae0818f1" alt="A GitBook screenshot showing site sections on a docs site"><figcaption><p>Exemple d’un site GitBook avec des sections de site</p></figcaption></figure>

Avec les sections de site, vous pouvez centraliser toute votre documentation et offrir une expérience fluide à vos utilisateurs.

Les sections de site sont idéales pour organiser votre documentation — que vous gériez des produits distincts ou que vous vous adressiez à la fois aux utilisateurs finaux et aux développeurs avec un contenu adapté à chacun.

Vous pouvez aussi [regrouper des sections de site](#create-a-site-section-group). Cela créera un menu déroulant dans votre barre de navigation — idéal pour ajouter de la hiérarchie à vos sections de site.

{% hint style="info" %}
**Sections ou variantes ?**

Chaque section de site est un espace dans GitBook. Vous pouvez créer des sections de site à partir de n’importe quel espace, mais nous vous recommandons d’utiliser les sections pour des parties sémantiquement différentes de votre documentation.

Si vous souhaitez ajouter des variations du même contenu — comme des localisations ou des versions historiques du même produit — envisagez plutôt d’utiliser [des variantes de contenu](/docs/documentation/fr/docs-site/site-structure/variants.md) à la place.
{% endhint %}

### Ajouter une section à votre site de documentation

Depuis le tableau de bord de votre site de documentation, ouvrez l’onglet **Paramètres** dans l’en-tête du site, puis cliquez sur **Structure**. Vous pouvez y voir tout le contenu de votre site.

Pour ajouter une section de site, cliquez sur le **Nouvelle section** bouton sous le tableau et choisissez un espace à associer comme section. La nouvelle section est alors ajoutée au tableau et sera disponible pour les visiteurs sous forme d’onglet en haut de votre site.

<figure><img src="/files/fd0dde778fe589b639ad64098b41f6c91a4f4132" alt="A GitBook screenshot showing site section structure"><figcaption><p>Ajoutez de la structure à votre documentation avec des sections de site.</p></figcaption></figure>

### Créer un groupe de sections de site

Vous pouvez regrouper des sections de site sous un seul titre. Les groupes de sections de site apparaîtront comme un menu déroulant dans la navigation de votre site. Les sections de site d’un groupe peuvent également inclure une description facultative, qui apparaît sous le titre de la section dans le menu déroulant.

Pour créer un groupe, cliquez sur la flèche à côté du **Nouvelle section** bouton et choisissez **Nouveau groupe de sections**. Donnez un nom à votre nouveau groupe, puis cliquez sur **Ajouter une section** dans la fenêtre modale pour ajouter des sections à votre groupe. Vous pouvez ajouter au nouveau groupe des sections existantes de votre site, ou sélectionner un autre espace à ajouter à l’aide du menu.

Si votre site prend en charge plusieurs langues, vous pouvez également traduire les titres des groupes de sections, ainsi que les titres et les descriptions des sections. Voir [Sections multilingues](/docs/documentation/fr/docs-site/site-structure/multilingual-sections.md).

### Modifier une section

Vous pouvez modifier le nom, l’icône et le slug de chacune de vos sections en cliquant sur le <picture><source srcset="/files/kN09oTFtAuyaxNIwWuCt" media="(prefers-color-scheme: dark)"><img src="/files/d88960ed8c82a80ff93fd8b09221f5abdfd2108d" alt="The Edit icon in GitBook"></picture> **Modifier** bouton dans la ligne du tableau de la section que vous souhaitez modifier. Cela ouvrira une fenêtre modale. Modifiez le ou les champs que vous souhaitez changer, puis cliquez sur le **Enregistrer** bouton. Vous pouvez également supprimer la variante en cliquant sur le **Supprimer la variante** bouton en bas à gauche.

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

Les sections de site d’un groupe peuvent également afficher facultativement une description, qui apparaîtra dans le menu déroulant de la barre de navigation de votre site lorsque le groupe de sections est survolé. Consultez l’image en haut de cette page pour voir un exemple de l’apparence que cela peut avoir dans votre documentation publiée.

Si votre site prend en charge plusieurs langues, vous pouvez traduire les titres et les descriptions des sections afin qu’ils correspondent à la langue sélectionnée par le lecteur. Voir [Sections multilingues](/docs/documentation/fr/docs-site/site-structure/multilingual-sections.md).

### Réorganiser les sections

Votre site affiche les sections dans l’ordre dans lequel elles apparaissent dans votre tableau de structure du site. Les sections peuvent être réorganisées en saisissant la **poignée de déplacement** <picture><source srcset="/files/QLUQj6waZRiK6FpSqrt6" media="(prefers-color-scheme: dark)"><img src="/files/a8fb7b2b9f8482b7286cc5fc535d675ecfc5a7d9" alt="The Options menu icon in GitBook"></picture> et en la déplaçant vers le haut ou vers le bas. Tous les espaces contenus dans cette section seront déplacés avec elle. L’ordre modifié sera reflété immédiatement sur votre site.

Vous pouvez également utiliser le clavier pour sélectionner et déplacer du contenu : sélectionnez une section avec la barre d’espace, puis utilisez les touches fléchées 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 une section par défaut

Si votre site comporte plusieurs sections, l’une d’elles sera marquée comme section par défaut avec une icône de maison<i class="fa-house">:house:</i>. 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 qui est ajouté à l’URL racine.

Pour définir une section comme section par défaut, cliquez sur le **menu Actions** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/e908f759f6ce659d2a006882f5c4b45d5934010f" alt="The Actions menu icon in GitBook"></picture> dans la ligne du tableau de la section, puis cliquez sur **Définir comme défaut**.

### Supprimer une section

Pour supprimer une section d’un site, cliquez sur le **Paramètres** <picture><source srcset="/files/CG9bVSmdbJnQxrYiNbRI" media="(prefers-color-scheme: dark)"><img src="/files/2a76779430a3fcc834e20d4187948d61c0f3062b" alt="The Settings icon in GitBook"></picture> bouton depuis le tableau de bord de votre site de documentation, puis cliquez sur **Structure** pour trouver le contenu que vous souhaitez supprimer. Cliquez sur le **Modifier** <picture><source srcset="/files/kN09oTFtAuyaxNIwWuCt" media="(prefers-color-scheme: dark)"><img src="/files/d88960ed8c82a80ff93fd8b09221f5abdfd2108d" alt="The Edit icon in GitBook"></picture> bouton à côté de la section que vous souhaitez supprimer, puis cliquez sur le **Supprimer** bouton en bas à gauche de la fenêtre modale. Cela supprimera la section, ainsi que toutes les variantes qu’elle contient, du site publié. Cela ne supprimera pas les espaces eux-mêmes, ni le contenu qu’ils contiennent.

Pour supprimer une section d’un site, ouvrez l’onglet **Paramètres** depuis le tableau de bord de votre site de documentation, puis cliquez sur **Structure** pour trouver le contenu que vous souhaitez supprimer.

Ouvrez le **menu Actions** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/e908f759f6ce659d2a006882f5c4b45d5934010f" alt="The Actions menu icon in GitBook"></picture> de l’espace que vous souhaitez supprimer et choisissez **Supprimer**.

{% hint style="success" %}
La suppression d’une section de votre site la retirera — ainsi que toutes les variantes qu’elle contient — du site publié, mais **ne supprimera aucun des espaces ni le contenu qu’ils contiennent**.
{% endhint %}


---

# 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 dynamically by asking a question.

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

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
