> 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/creating-content/content-structure/page.md).

# Pages

Une page est l’endroit où vous pouvez ajouter, modifier et intégrer du contenu. Les pages vivent toujours dans une section, ce qui vous permet de regrouper le contenu مرتبط aux sujets ou aux domaines que vous traitez.

Lorsque vous publiez votre site, chaque section apparaît dans la navigation de votre site, et toutes les pages qu’elle contient apparaissent sous cette section.

### Table des matières

Créez autant de pages que nécessaire dans une section. Elles sont toutes visibles dans la barre latérale gauche de votre écran, dans la table des matières de votre section. La table des matières apparaît au même endroit sur votre site publié, sauf si [vous choisissez de la masquer](#page-options).

{% hint style="info" %}
**Page d’accueil de la section**

La première page de votre table des matières est toujours la page d’accueil de votre section, même si elle est masquée dans la table des matières.
{% endhint %}

### Créer une nouvelle page

1. Passez en mode d’édition en direct ou ouvrez une demande de modification.
2. Cliquez sur **Ajouter nouveau...** au bas de votre table des matières.
3. Cliquez sur **Page**.

Ou survolez l’espace entre des pages dans la table des matières et cliquez sur l’ **+** icône qui apparaît.

<figure><img src="/files/4d6f4d8e047f7677e9082155f196f6914b7bbc1e" alt="A GitBook screenshot showing an empty page listed in the table of contents"><figcaption><p>Une page vide dans GitBook. Vous pouvez la voir listée dans la table des matières sur le côté gauche.</p></figcaption></figure>

### Option Nouvelle page manquante

{% hint style="warning" %}
Si les modifications en direct sont désactivées pour votre section, créez ou modifiez une demande de modification. Dans une demande de modification, le **Nouvelle page** bouton — qui crée des pages, des groupes de pages et des liens — est disponible dans la table des matières.

Il se peut aussi que vous n’ayez pas les autorisations nécessaires pour modifier une page.
{% endhint %}

### Organiser votre contenu

Il existe trois façons d’organiser votre contenu dans la table des matières :

#### Pages

Une page a un titre, une description facultative et une zone dans laquelle vous pouvez écrire et ajouter tout type de contenu.

Imbriquez des pages en faisant glisser une page sous une autre dans la table des matières. Cette פעולה crée une **sous-page**.

Si vous ajoutez des sous-pages à une page parente vide, GitBook génère automatiquement une page « contents » avec des liens vers toutes les sous-pages dans la version publiée de votre documentation.

{% hint style="info" %}
**Astuce :** Il n’y a pas de limite à l’imbrication des pages, mais évitez de dépasser trois niveaux pour garder une navigation simple.
{% endhint %}

Lorsque vous modifiez le titre d’une page, le slug de la page (la partie tout au bout de l’URL, comme `/hello-world`) change aussi — sauf si vous avez déjà défini manuellement le slug de la page auparavant.

Pour modifier le titre, le titre du lien ou le slug d’une page :

1. Ouvrez l’ **menu d’actions** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/e908f759f6ce659d2a006882f5c4b45d5934010f" alt="The Actions menu icon in GitBook"></picture>.
2. Cliquez sur **Modifier le titre et le slug**.

#### Titre du lien de page

Pour donner à votre page un titre plus long, optimisé pour le SEO, tout en conservant un titre plus court pour votre entrée de navigation et vos liens, définissez un titre de lien.

1. Ouvrez l’ **menu d’actions** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/e908f759f6ce659d2a006882f5c4b45d5934010f" alt="The Actions menu icon in GitBook"></picture>.
2. Cliquez sur **Modifier le titre et le slug**.
3. Dans la **boîte de dialogue Modifier la page** activez et définissez un titre de lien pour cette page.

Si vous utilisez Git Sync, définissez le titre du lien de la page dans `SUMMARY.md` sur le lien de page :

```markdown
# Table des matières

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

{% hint style="info" %}
**Remarque :** Les titres des liens de page apparaissent dans la table des matières, les boutons de pagination au bas de chaque page, ainsi que dans tous les liens relatifs que vous ajoutez à cette page.
{% endhint %}

Les titres des liens de page sont facultatifs — si vous n’en ajoutez pas, la page utilise son titre standard.

#### Groupes de pages

Les groupes de pages réunissent des pages connexes dans la table des matières d’une section.

{% hint style="info" %}
Les groupes de pages organisent **les pages** au sein d’une seule section. Pour organiser le **sections** de votre site, utilisez plutôt des groupes.
{% endhint %}

Créez un groupe de pages en cliquant sur **Ajouter nouveau...** > **Groupe** au bas de votre table des matières.

Les groupes de pages existent uniquement au **niveau supérieur** de la table des matières — vous ne pouvez pas imbriquer les groupes de pages les uns dans les autres.

Pour modifier le titre et le slug d’un groupe de pages :

1. Cliquez sur l’ **menu d’actions** icône <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/e908f759f6ce659d2a006882f5c4b45d5934010f" alt="The Actions menu icon in GitBook"></picture> à côté du titre du groupe dans la table des matières.
2. Cliquez sur **Renommer**.

#### Liens externes

Ajoutez des liens à votre table des matières pour amener les lecteurs directement vers le contenu lié.

Créez un lien externe en cliquant sur **Ajouter nouveau...** > **Lien externe** au bas de votre table des matières.

### Icônes et emojis de page

Pour améliorer la visibilité des lecteurs lorsqu’ils parcourent rapidement votre table des matières, ajoutez une icône ou un emoji facultatif à des pages individuelles. L’icône ou l’emoji apparaît dans la table des matières et à côté du titre en haut de la page.

Pour ajouter une icône ou un emoji, cliquez sur le **Ajouter une icône** bouton lorsque vous survolez le titre de la page, ou sur le bouton emoji à gauche du titre.

### Options de page

Dans la **Options de page** menu, personnalisez l’apparence d’une page sélectionnée au sein d’une section et contrôlez sa visibilité.

#### Disposition

Ouvrez le **Options de page** <picture><source srcset="/files/tb21SaZbz1g0fv6lzP83" media="(prefers-color-scheme: dark)"><img src="/files/0e5d27680e2566a8bffd0aae80845680cd9f5533" alt="The Page options menu icon in GitBook"></picture> menu ou modifiez la couverture d’une page en survolant le titre de la page. Les boutons apparaissent juste au-dessus du titre de la page.

Dans la **Options de page** panneau latéral, choisissez comment chaque page s’affiche pour les visiteurs de votre **contenu** publié. Il existe trois préréglages de disposition parmi lesquels choisir, ou vous pouvez créer une disposition personnalisée.

Chaque préréglage de disposition active ou désactive les parties suivantes de la page :

* Titre de la page
* Description de la page
* Table des matières
* Plan de la page
* Liens suivant/précédent
* Métadonnées de la page
* Balises

Ajoutez une ou plusieurs balises à une page depuis **Bibliothèque** → **Balises**. Activez **Afficher les balises sur la page** pour les afficher dans l’en-tête de la page. Vous pouvez aussi choisir une balise comme balise principale de la page, que GitBook peut afficher à côté de la page dans la table des matières. En savoir plus dans Balises.

Définissez aussi la largeur globale de votre page depuis ce menu. Choisir **Large** donne plus d’espace à des blocs tels que les tableaux, les cartes et les blocs de code sur la page publiée. Utilisez cette option pour des pages d’accueil percutantes.

#### Visibilité

Choisissez quelles pages afficher ou masquer dans votre documentation publiée, et déterminez si chaque page apparaît dans la recherche de votre site et dans les moteurs de recherche.

Pour masquer une page ou un groupe de pages de la table des matières de votre site :

1. Ouvrez l’ **menu d’actions** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/e908f759f6ce659d2a006882f5c4b45d5934010f" alt="The Actions menu icon in GitBook"></picture>.
2. Basculer **Masquer la page**.

Les pages masquées sont seulement cachées de la table des matières publiée. Elles restent accessibles via le serveur MCP du site et dans `llms-full.txt`.

Si vous utilisez Git Sync, les pages masquées incluent le front matter suivant dans le fichier Markdown :

<pre class="language-markdown" data-title="page.md"><code class="lang-markdown">---
hidden: true
<strong>---
</strong></code></pre>

{% hint style="warning" %}
Masquer **Titre de la page** ou **Description de la page** ne masque que l’en-tête de la page dans le contenu publié. Cela ne supprime pas les titres à l’intérieur du corps de la page. En savoir plus sur les niveaux de titre dans Titres.
{% endhint %}

#### Métadonnées (SEO)

Utilisez **Options de la page → Métadonnées** pour contrôler la manière dont les moteurs de recherche comprennent les relations entre des pages similaires (par exemple : versions de documentation ou variantes de contenu).

* **URL canonique**: l’URL préférée (officielle) pour cette page. Les moteurs de recherche la considèrent comme la « source de vérité ». Utilisez-la lorsque plusieurs URL affichent le même contenu.
* **URL alternatives**: autres URL du même contenu dans une autre variante. Par exemple, une autre version ou langue. Elles aident les moteurs de recherche à regrouper les variantes au lieu de les traiter comme des doublons.

Les deux champs permettent de sélectionner une autre page GitBook (recommandé) ou de saisir une URL externe.

{% hint style="info" %}
Une pratique courante pour une documentation versionnée consiste à définir les anciennes pages comme canoniques vers la dernière page équivalente (par exemple, `1.0` → `2.0`), puis à répertorier les anciennes versions comme alternatives sur la dernière page.
{% endhint %}

### Couvercles de page

Définissez une couverture de page pour chaque page de votre documentation. Lorsque vous cliquez sur l’ **Couverture de page** <picture><source srcset="/files/m3pW0fk37zO88JKWr4U5" media="(prefers-color-scheme: dark)"><img src="/files/550ac63e24d28a056dbe670f018c76600aa5d810" alt="The Page cover icon in GitBook"></picture> option, GitBook ajoute immédiatement une couverture par défaut. À partir d’ici, vous pouvez :

* **Modifier l’image de couverture**
  1. Survolez la couverture de la page et cliquez sur **Modifier la couverture**.
  2. Choisissez ou téléversez une image. La taille idéale est de 1990 × 480 pixels.
* **Repositionner l’image de couverture**
  1. Survolez la couverture de la page et ouvrez le **menu d’actions** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/e908f759f6ce659d2a006882f5c4b45d5934010f" alt="The Actions menu icon in GitBook"></picture>.
  2. Cliquez sur **Repositionner**.
  3. Faites glisser l’image pour la placer, puis cliquez sur **Enregistrer**.
* **Supprimer l’image de couverture**
  1. Survolez la couverture de la page et ouvrez le **menu d’actions** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/e908f759f6ce659d2a006882f5c4b45d5934010f" alt="The Actions menu icon in GitBook"></picture>.
  2. Cliquez sur **Supprimer**.
* **Pleine largeur et largeur hero**

  Modifiez le style de la couverture de votre page pour qu’elle s’étende sur toute la largeur de votre écran ou seulement sur la largeur de votre contenu.

  1. Survolez la couverture de la page et ouvrez le **menu d’actions** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/e908f759f6ce659d2a006882f5c4b45d5934010f" alt="The Actions menu icon in GitBook"></picture>.
  2. Cliquez sur l’option de votre choix.


---

# 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/creating-content/content-structure/page.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.
