> 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/creer-du-contenu/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 du contenu connexe pour les sujets ou domaines que vous couvrez.

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 un nouveau...** en bas de votre table des matières.
3. Cliquez sur **Page**.

Ou survolez l'espace entre les 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 à 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 %}

### Organisation de 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 où vous pouvez écrire et ajouter n'importe quel type de contenu.

Imbriquez des pages en faisant glisser une page sous une autre dans la table des matières. Cela crée une **sous-page**.

Si vous ajoutez des sous-pages à une page parente vide, GitBook génère automatiquement une page « contenu » 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 changez le titre d'une page, le slug de la page (la partie tout à la fin de l'URL, comme `/hello-world`) change également — sauf si vous avez déjà défini manuellement le slug de la page.

Pour changer le titre, le titre du lien ou le slug d'une page :

1. 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 **Modifier le titre et le slug**.

#### Titre du lien de la page

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

1. 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 **Modifier le titre et le slug**.
3. Dans le **Modifier la page** dialogue, 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 la page :

```markdown
# Table des matières

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

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

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

#### Groupes de pages

Les groupes de pages rassemblent des pages connexes dans la table des matières d'une section.

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

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

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

Pour changer le titre et le slug d'un groupe de pages :

1. Cliquez sur le **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 diriger les personnes directement vers le contenu lié.

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

### Icônes et emojis de page

Pour améliorer la visibilité pour les 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, ainsi qu'à 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 le **Options de page** menu, personnalisez l'apparence d'une page sélectionnée au sein d'une section et contrôlez sa visibilité.

#### Mise en page

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 le **Options de page** volet latéral, choisissez comment chaque page s'affiche pour les visiteurs de votre **publié** contenu. Trois préréglages de mise en page sont disponibles, ou vous pouvez créer une mise en page personnalisée.

Chaque préréglage de mise en page 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
* Tags

Associez à une page une ou plusieurs étiquettes provenant de **Bibliothèque** → **Tags**. Activez **Afficher les étiquettes sur la page** pour les afficher dans l'en-tête de la page. Ou choisissez une étiquette comme étiquette principale de la page, que GitBook peut afficher à côté de la page dans la table des matières. En savoir plus dans Étiquettes.

Définissez aussi la largeur globale de votre page depuis ce menu. Le choix de **Large** donne plus d'espace aux 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 attrayantes.

#### Visibilité

Choisissez quelles pages afficher ou masquer dans votre documentation publiée, ainsi que 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 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. Basculez **Masquer la page**.

Les pages masquées ne sont masquées que dans 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 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 (de référence) 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 pour le même contenu dans une autre variante. Par exemple, une autre version ou une autre langue. Elles aident les moteurs de recherche à regrouper les variantes au lieu de les considérer comme des doublons.

Les deux champs prennent en charge la sélection d'une autre page GitBook (recommandé) ou la saisie d'une URL externe.

{% hint style="info" %}
Une pratique courante pour la documentation versionnée consiste à définir les pages plus anciennes comme `1.0` → `2.0`canoniques vers la page équivalente la plus récente (par exemple,
{% endhint %}

#### Déplacer des pages entre les sections

GitBook ne prend pas encore en charge le déplacement de pages individuelles entre les sections dans l'application. Pour déplacer le contenu d'une page vers une autre section :

* **Copiez et collez** — sélectionnez le contenu de la page avec la `Échap` touche, puis copiez et collez-le dans la destination. Certains blocs peuvent devoir être reconfigurés ; les commentaires et l'historique de la page ne sont pas copiés, et les images doivent être téléversées à nouveau dans la nouvelle section.
* **Utilisez Git Sync** — si les deux sections se synchronisent avec des dépôts, copiez les fichiers entre les dépôts et ajoutez les titres des pages à `SUMMARY.md`. Voir [Git Sync](/docs/documentation/fr/documentation-as-code/git-sync.md).

### Couvertures 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. La taille idéale de l'image de couverture est de 1990 × 480 pixels — les couvertures sont verrouillées sur ce ratio d'aspect, de sorte que les proportions sont conservées quelle que soit la taille de l'écran. À 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 héro**

  Modifiez le style de la couverture de votre page pour qu'elle occupe toute la largeur de votre écran ou seulement celle 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/creer-du-contenu/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.
