# Pages

Une page est l’endroit où vous pouvez ajouter, modifier et intégrer du contenu. Les pages se trouvent toujours dans un [espace](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/creating-content/content-structure/space) , ce qui vous permet de regrouper du contenu مرتبط et de créer différentes sections pour les sujets ou domaines que vous traitez.

Lors de la publication de votre documentation, chaque espace sera son propre [site de documentation](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/publish-a-docs-site) ou [section du site](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/site-structure/site-sections) , et toutes les pages de l’espace apparaîtront sur ce site.

### Table des matières

Vous pouvez créer autant de pages que nécessaire dans un espace. Elles sont toutes visibles dans la barre latérale gauche de votre écran, dans le [table des matières](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/ressources/gitbook-ui#table-of-contents) de votre espace. La table des matières apparaîtra au même endroit lorsque vous publierez votre espace, sauf si [vous choisissez de la masquer](#page-options).

{% hint style="info" %}

### Page d’accueil du site de documentation

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

### Créer une nouvelle page

Lorsque vous êtes en [édition en direct](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/collaboration/live-edits) mode ou dans un [demande de modification](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/collaboration/change-requests), vous pouvez créer une nouvelle page en cliquant sur **Ajouter nouveau...** > **Page** en bas de votre table des matières. Vous pouvez aussi survoler l’espace entre les pages dans la table des matières et cliquer sur l’ **+** icône qui apparaît.

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FP0V046UJgzgtkrD1NiQG%2Fcreating-content-content-structure-page%402x%20(1).png?alt=media&#x26;token=69805dbf-4ce7-4a6b-ac4d-43fc958d62c4" 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>

### Vous ne voyez pas l’option permettant de créer une nouvelle page ?

{% hint style="warning" %}
Si [modifications en direct](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/collaboration/live-edits) sont désactivées pour votre espace, vous devrez créer ou modifier une [demande de modification](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/collaboration/change-requests). Une fois dans une demande de modification, le **Nouvelle page** bouton (qui vous permet de créer des pages, des groupes de pages et des liens) sera disponible dans la table des matières.

Sinon, il se peut que vous n’ayez pas les [autorisations](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/gestion-du-compte/member-management/permissions-and-inheritance) 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 comporte un titre, une description facultative et un espace où vous pouvez écrire et ajouter n’importe quel type de contenu.

Vous pouvez imbriquer 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érera automatiquement une page « sommaire » avec des liens vers toutes les sous-pages dans la version publiée de votre documentation.

{% hint style="info" %}
**Conseil :** Il n’y a pas de limite à l’imbrication des pages, mais nous vous recommandons d’éviter plus de trois niveaux d’imbrication afin d’éviter une navigation trop complexe.
{% endhint %}

Lorsque vous modifiez le titre d’une page, le slug de la page (la partie tout à la fin de l’URL, par exemple `/hello-world`) changera également — sauf si vous avez déjà défini manuellement le slug de la page auparavant.

Vous pouvez modifier à tout moment le titre, le titre du lien et le slug d’une page en ouvrant **menu d’actions** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> de la page et en choisissant **Modifier le titre et le slug**.

#### **Titre du lien de la page**

Si vous souhaitez que votre page ait un titre plus long, optimisé pour le SEO, tout en conservant un titre plus court pour l’entrée de navigation et les liens, vous pouvez définir facultativement un titre de lien.

Ouvrez **menu d’actions** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> et choisissez **Modifier le titre et le slug**de la page. Dans la boîte de dialogue **Modifier la page** , vous trouverez l’option permettant d’activer et de définir un titre de lien pour cette page.

Si vous utilisez Git Sync, le titre du lien de la page est défini dans le `SUMMARY.md` fichier 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 des liens de page sont utilisés dans la table des matières, les boutons de pagination en bas de chaque page et 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 manuellement, votre page utilisera par défaut le titre standard de la page.

#### Groupes de pages

Avec les groupes de pages, vous pouvez regrouper des pages en sections qui couvrent du contenu مرتبط.

Vous pouvez créer un nouveau groupe de pages en cliquant sur **Ajouter nouveau...** > **Groupe** en bas de votre table des matières.

Les groupes de pages ne peuvent se trouver qu’au **niveau supérieur** de la table des matières. Vous ne pouvez pas imbriquer des groupes de pages dans d’autres groupes de pages.

Pour modifier le titre et le slug d’un groupe de pages, cliquez sur **menu d’actions** icon <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> à côté du titre du groupe dans la table des matières et choisissez **Renommer**.

#### Liens externes <a href="#external-links" id="external-links"></a>

Vous pouvez aussi ajouter des liens à votre table des matières. En cliquant dessus, les utilisateurs iront directement vers le contenu lié.

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

### Icônes et émojis de page

Pour améliorer la visibilité pour les lecteurs lorsqu’ils parcourent rapidement votre table des matières, vous pouvez ajouter une icône ou un emoji facultatif à des pages individuelles. L’icône ou l’emoji apparaîtra 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 la **Options de page** menu, vous pouvez personnaliser l’apparence d’une page sélectionnée au sein d’un espace et contrôler sa visibilité.

#### **Mise en page**

Vous pouvez ouvrir le **Options de page** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FAsao5RY8jwAmcYhpVwPI%2Foptions.svg?alt=media&#x26;token=d962d9a8-0cd6-42e7-a7b7-50c68a74dfea" alt="The Page options menu icon in GitBook"></picture> menu ou modifiez la couverture d’une page en survolant son titre. Vous verrez les boutons apparaître juste au-dessus du titre de la page.

Dans la **Options de page** panneau latéral, vous pouvez sélectionner la façon dont chaque page est affichée aux personnes qui visitent votre **publié** contenu. Il existe trois préréglages de mise en page parmi lesquels choisir, ou vous pouvez créer une mise en page personnalisée.

Chaque préréglage de mise en page activera ou désactivera chacune des 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
* Étiquettes

Vous pouvez attribuer à une page une ou plusieurs étiquettes depuis **Bibliothèque** → **Étiquettes**. Activez **Afficher les étiquettes sur la page** pour les afficher dans l’en-tête de la page. Vous pouvez aussi choisir une étiquette comme étiquette principale de la page. GitBook peut l’afficher à côté de la page dans la table des matières. En savoir plus dans [Étiquettes](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/creating-content/content-structure/page/tags).

Vous pouvez aussi définir la largeur globale de votre page depuis ce menu. Choisir **Large** élargira automatiquement les blocs qui prennent en charge l’ **Pleine largeur** option — comme les tableaux, les cartes et les blocs de code — afin de leur donner plus d’espace lorsque la page est publiée. C’est idéal pour créer des pages d’accueil attrayantes !

#### Visibilité

Vous pouvez décider quelles pages vous souhaitez afficher/masquer dans votre documentation publiée, tout en décidant si vous souhaitez que la page soit indexée dans la recherche de votre documentation publiée, et/ou par les moteurs de recherche.

Vous pouvez masquer une page ou un groupe de pages de la table des matières de votre site en ouvrant **menu d’actions** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> et en activant/désactivant **Masquer la page**.

Si elle est masquée, ce qui suit apparaîtra dans le front matter du fichier markdown lors de l’utilisation de Git Sync :

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

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

Utiliser **Options de page → Métadonnées** pour contrôler la façon dont les moteurs de recherche comprennent les relations entre des pages similaires (par exemple : les versions de la documentation ou [des variantes de contenu](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/publishing-documentation/site-structure/variants)).

* **URL canonique**: l’URL préférée (faisant autorité) 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**: d’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 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 les documentations versionnées consiste à définir les anciennes pages comme canoniques vers la dernière page équivalente (par exemple, `1.0` → `2.0`), puis à lister les anciennes versions comme alternatives sur la dernière page.
{% endhint %}

### Couvertures de page

Vous pouvez également définir une couverture de page pour chaque page de votre documentation. Lorsque vous cliquez sur l’ **Couverture de page** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FI1Q5rfhHgy0toM2pUEH5%2Fimage.svg?alt=media&#x26;token=a3cf4181-880b-4698-9a1b-1a99f48bb03b" alt="The Page cover icon in GitBook"></picture> option, une couverture par défaut sera ajoutée immédiatement. À partir de là, vous pouvez :

* **Modifier l’image de couverture**

  Survolez la couverture de la page et cliquez sur **Modifier la couverture**, puis sélectionnez ou importez une image. Compte tenu de l’affichage actuel des couvertures de page, 1990 x 480 pixels est la taille idéale.
* **Repositionner l’image de couverture**

  Survolez la couverture de la page et ouvrez le **menu d’actions** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture>. Cliquez sur **Repositionner**, puis faites glisser l’image comme vous le souhaitez et cliquez sur **Enregistrer**.
* **Supprimer l’image de couverture**\
  Survolez la couverture de la page et ouvrez le **menu d’actions** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture>, puis cliquez sur **Supprimer**.
* **Pleine largeur et largeur héros**\
  Vous pouvez modifier le style de la couverture de votre page pour qu’elle occupe toute la largeur de votre écran ou seulement la largeur de votre contenu. Survolez la couverture de la page et ouvrez le **menu d’actions** <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture>, puis choisissez l’option de votre choix dans le menu.
