> 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/reference/gitbook-ui.md).

# Interface GitBook

Apprenez à naviguer dans GitBook

GitBook s’organise autour de vos sites de documentation. Vous commencez sur la page de votre organisation **Accueil**, ouvrez un site pour travailler sur son contenu et modifiez les pages dans les sections. Cette page présente chaque partie de l’interface.

### Accueil

<div data-with-frame="true"><figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FMINl0qBtvGV3pt8G3bnZ%2FCleanShot%202025-12-10%20at%2010.02.40.png?alt=media&amp;token=57f3871d-67b0-432e-b646-8b5e5a073aaa" alt=""><figcaption><p>La page d’accueil de votre organisation vous donne accès aux sites, au contenu et aux contrôles de l’organisation.</p></figcaption></figure></div>

Lorsque vous ouvrez GitBook, vous arrivez sur votre organisation **Accueil**: tous les sites de documentation de votre organisation, réunis au même endroit. Depuis cette page, vous pouvez ouvrir un site, en créer un nouveau ou ajuster les paramètres à l’échelle de l’organisation. L’accueil contient :

* **Sélecteur**\
  Revenez à **Accueil** depuis n’importe où à l’aide du sélecteur en haut de la barre latérale. Si vous faites partie de plusieurs organisations, vous pouvez les consulter et passer de l’une à l’autre ici, ou créer une nouvelle organisation.
* **Notifications**\
  Lorsque vous êtes identifié dans un commentaire ou une conversation, ou lorsqu’une activité importante a lieu dans une section sur laquelle vous travaillez, vous recevez une [notification](/docs/documentation/fr/collaborer/notifications.md) pour vous indiquer les nouveautés.
* **Demander ou rechercher**\
  Propulsé par [GitBook Agent](/docs/documentation/fr/creer-du-contenu/searching-your-content/gitbook-ai.md), posez des questions en langage naturel ou effectuez des recherches dans les sites et le contenu de votre organisation.
* **Liste des sites**\
  Affichez tous les sites de documentation de votre organisation. Cliquez sur un site pour l’ouvrir.
* **Tout le contenu**\
  Si votre organisation possède du contenu qui ne fait partie d’aucun site, il apparaît dans une **Tout le contenu** section à côté de vos sites, sous forme d’arborescence. Si chaque élément de contenu appartient à un site, cette section n’apparaît pas.
* **Paramètres**\
  [Paramètres de l’organisation](/docs/documentation/fr/compte-et-facturation/organization-settings.md) et [paramètres du compte](/docs/documentation/fr/compte-et-facturation/account-settings.md) partagent un écran dédié. Il regroupe les paramètres par **Compte** et **Organisation**.

  **Compte** inclut **Général**, **Notifications**, **Organisations**, et **Outils de développement**. **Organisation** inclut **Général**, **Membres**, **Règles de fusion**, **GitBook Agent**, **Intégrations**, **OpenAPI**, **Traductions**, **Liens d’invitation**, **Équipes**, **SSO**, et **Facturation**. Cliquez sur **Retour à l’application** pour reprendre votre travail.
* **Guides de style**\
  Affichez chaque [guide de style](/docs/documentation/fr/gerer-votre-site/site-structure.md) de votre organisation et les sites qui l’utilisent.
* **Corbeille**\
  Les sections supprimées apparaissent dans **Corbeille**. Vous pouvez les restaurer pendant un maximum de sept jours ; après cela, elles sont définitivement supprimées.

### Barre latérale du site

L’ouverture d’un site remplace la barre latérale par le contenu et les outils de ce site : la même structure que celle que les visiteurs voient sur votre site publié. La barre latérale du site contient :

* **En-tête du site**\
  Le nom et le statut de publication de votre site, ainsi que les boutons **Aperçu** et **Publier** .
* **Général**\
  **Vue d’ensemble**, **Demandes de modification**, **Structure du site**, et **Paramètres**.
* **Outils**\
  **Guide de style**, **Personnaliser**, **Analyser**, et **Étendre**. Chacun s’ouvre dans la vue principale.
* **Contenu**\
  Les [sections](/docs/documentation/fr/gerer-votre-site/site-structure/site-sections.md) et groupes de votre site, dans l’ordre de publication. Cliquez sur une section pour la modifier.

  L’arborescence est en lecture seule. Réorganisez-la dans l’ [éditeur de structure](/docs/documentation/fr/gerer-votre-site/site-structure.md). Utilisez les icônes de recherche, de modification et **+** dans l’ **Contenu** en-tête pour rechercher, renommer et ajouter des sections.

### Table des matières <a href="#the-table-of-contents" id="the-table-of-contents"></a>

<div data-with-frame="true"><figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FZYKSwnzcZOkqVA2xgRlX%2FCleanShot%202025-12-10%20at%2010.07.01.png?alt=media&amp;token=47cb70e3-4cee-4fdd-8247-28a04e75f92e" alt=""><figcaption><p>La table des matières répertorie toutes les pages et tous les liens de la section sélectionnée.</p></figcaption></figure></div>

Par défaut, la table des matières répertorie les [pages, liens et groupes de pages](/docs/documentation/fr/creer-du-contenu/content-structure/page.md#organizing-your-content) de la section sélectionnée. Elle se trouve à droite de la barre latérale.

Vous pouvez également gérer le [contenu réutilisable](/docs/documentation/fr/creer-du-contenu/reusable-content.md) et [fichiers](/docs/documentation/fr/creer-du-contenu/blocks/insert-files.md) de la section.

Depuis l’onglet **Pages** de la table des matières, vous pouvez :

* Créer de nouvelles [pages](#pages) et sous-pages.
* Créer des [groupes de pages](#groups).
* Ajouter des [liens externes](#external-links).
* Accéder à [au menu Actions](#the-actions-menu) <picture><source srcset="/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%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&amp;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt=""></picture> pour les pages individuelles.

Dans l’onglet **Bibliothèque** , vous pouvez :

* Afficher et rechercher du contenu réutilisable, des variables, des images et des fichiers dans la section.
* Afficher et insérer du contenu réutilisable provenant d’autres sections.
* Créer ou importer de nouveaux éléments de la bibliothèque.
* Glisser-déposer des éléments de la bibliothèque sur la page.
* Double-cliquer sur un élément de la bibliothèque pour le renommer.
* Prévisualiser les images.
* Gérer et télécharger les images et les fichiers.

Voici une courte vidéo montrant ce que vous pouvez faire avec la table des matières, en particulier l’onglet Bibliothèque :

{% embed url="<https://youtu.be/gg-VZP2wl-I>" %}

Pour vous concentrer sur le contenu de la page, survolez la zone à côté de la table des matières et cliquez sur **Masquer** <picture><source srcset="/files/t7RZoZXBNdmA75mANdIQ" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F0goJ97jfVBvH656kUK0d%2Fpanel%20left.svg?alt=media&amp;token=cb31d43b-804c-4c4f-b5bb-e71db0d03860" alt="The Hide button icon in GitBook"></picture>. Pour l’afficher de nouveau, survolez le bord de la page et cliquez sur **Afficher** <picture><source srcset="/files/Vxv06rO6ZJQJWLfW9YHZ" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FwOFmEqy96fMvDPjqjAED%2Fpanel%20right.svg?alt=media&amp;token=2f39279a-cd05-48a3-8985-d07ec08663ba" alt="The Show button icon in GitBook"></picture>.

### En-tête de section <a href="#space-header" id="space-header"></a>

<div data-with-frame="true"><figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F2Z5NSb3mmbMRoWqONncm%2FCleanShot%202025-12-10%20at%2010.08.48.png?alt=media&amp;token=da8f53b3-d134-46e1-84d1-db3c1e1eb3cd" alt=""><figcaption><p>L’en-tête de section se trouve en haut de l’éditeur et propose des options qui s’appliquent à l’ensemble de la section.</p></figcaption></figure></div>

L’en-tête de section contient des informations sur la section que vous consultez actuellement. Il vous permet d’afficher les commentaires et l’historique, de configurer [la synchronisation GitHub ou GitLab](/docs/documentation/fr/la-documentation-comme-code/git-sync.md), et bien plus encore.

{% hint style="info" %}
**L’en-tête de section est adaptable**, et change selon la section et le mode dans lesquels vous vous trouvez actuellement.

Par exemple, si vous modifiez une [demande de modification](/docs/documentation/fr/collaborer/change-requests.md), vous voyez un aperçu de la demande de modification, ainsi que des options pour ouvrir l’éditeur, afficher les modifications et fusionner votre demande de modification.

Si vous consultez une section en lecture seule, vous devez ouvrir une nouvelle demande de modification pour modifier la page, car les modifications en direct sont verrouillées.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FrTr3IxB9SPupw4YedgqL%2FCleanShot%202025-12-10%20at%2010.11.01.png?alt=media&amp;token=772809ef-1b4b-453f-9ce4-64883cfc292c" alt=""><figcaption><p>L’en-tête de section dans une demande de modification.</p></figcaption></figure></div>

L’en-tête de section inclut :

* **L’emoji ou l’icône de la section**\
  Choisissez un emoji ou une icône pour votre section afin de l’identifier dans la barre latérale.
* **Le nom de la section**\
  Ce nom apparaît dans la barre latérale et sur votre site publié.
* **Le fil d’Ariane de la section**\
  Le site — et le groupe, s’il y en a un — auquel appartient la section.
* **Menu Actions**\
  Propose des actions pour votre section. Comme pour les [actions de page](#the-actions-menu), les actions disponibles varient selon le mode de modification.
* **Vue d’ensemble**\
  Dans une demande de modification, consultez son titre, sa description, ses participants, ses réviseurs, ses modifications et ses commentaires.
* **Vue Éditeur**\
  Modifiez du contenu avec l’éditeur de GitBook basé sur des blocs.
* **Vue Modifications**\
  Cette vue [met en évidence les modifications](/docs/documentation/fr/collaborer/change-requests.md#diff-mode) dans une demande de modification à l’aide d’une vue différentielle. Examinez les modifications avant de les fusionner.
* **Aperçu**\
  Prévisualisez le contenu avant de fusionner une demande de modification.
* **Collaborateurs**\
  Affichez les avatars des personnes qui lisent les pages de la section. Cliquez sur un avatar pour ouvrir la page qu’elles consultent.
* **Configuration de Git Sync**\
  Configurez GitHub et GitLab [Synchronisation](/docs/documentation/fr/la-documentation-comme-code/git-sync.md) de la section.
* **Le menu Partager**\
  Publiez et partagez votre section, ou invitez d’autres personnes à collaborer.
* **Variables**\
  Créez des [variables](/docs/documentation/fr/creer-du-contenu/variables-and-expressions.md) de la section.
* **GitBook Agent**\
  Collaborez sur les modifications de la section avec [GitBook Agent](broken://pages/76f00ca5d2740ff5447164219345857871d7dd1a).
* **Commentaires**\
  Afficher les [commentaires et discussions](/docs/documentation/fr/collaborer/comments.md) sur le contenu de la section.
* **Demandes de modification**\
  Créez, mettez à jour et supprimez des [demandes de modification](/docs/documentation/fr/collaborer/change-requests.md).
* **Historique de la section**\
  Afficher les [historique des versions](/docs/documentation/fr/creer-du-contenu/version-control.md) pour la section ou la demande de modification.
* **Le bouton Modifier**\
  Si une section est publiée ou que les [modifications en direct](/docs/documentation/fr/collaborer/live-edits.md) sont verrouillées, **Modifier** crée une [demande de modification](/docs/documentation/fr/collaborer/change-requests.md).

### Outils du site <a href="#site-headers" id="site-headers"></a>

Les outils du site s’ouvrent depuis la barre latérale du site dans la vue principale. L’en-tête du site conserve **Aperçu** et **Publier**.

Sous **Général**:

* **Vue d’ensemble**\
  Les informations essentielles du site, y compris son URL, son statut de publication, son audience, son contenu et les principales informations analytiques. Une fois votre site en ligne, **Vue d’ensemble** renvoie vers celui-ci.
* **Demandes de modification**\
  Les demandes de modification dans les sections de votre site.
* **Structure du site**\
  Utilisez l’ [éditeur de structure](/docs/documentation/fr/gerer-votre-site/site-structure.md) pour ajouter, réorganiser, publier et supprimer des sections et des groupes.
* **Paramètres**\
  [Paramètres du site](/docs/documentation/fr/gerer-votre-site/site-settings.md) incluent **Général**, **Membres**, **Agents**, **Audience**, **Domaine et URL**, **Redirections**, et **Forfait**.

Sous **Outils**:

* **Guide de style**\
  Le [guide de style](/docs/documentation/fr/gerer-votre-site/site-structure.md) de votre site définit les règles et conventions de rédaction. GitBook Agent les suit lorsqu’il rédige, modifie ou révise du contenu.
* **Personnaliser**\
  [Personnalisez votre site](/docs/documentation/fr/gerer-votre-site/customization.md) avec **Thème**, **Mise en page**, **Assistant IA**, et **Configurez les** options.
* **Analyser**\
  **Informations IA** et **Analyses** fournissent des [analyses détaillées](/docs/documentation/fr/analytique/insights.md) sur votre site et ses performances.
* **Étendre**\
  **Connexions**, **Canaux**, **Intégration de documentation**, **Accès MCP**, et [**Intégrations**](/docs/documentation/fr/gerer-votre-site/install-an-integration.md).

### Éditeur de contenu

<div data-with-frame="true"><figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FxpmoPcLU6kfep6QsXlxi%2FCleanShot%202025-12-10%20at%2010.18.49.png?alt=media&amp;token=af2b3315-f6e0-4a12-b853-1cbbd5e0e0e9" alt=""><figcaption><p>Rédigez du contenu et ajoutez des blocs dans l’éditeur GitBook.</p></figcaption></figure></div>

L’éditeur est la partie principale de votre section. Rédigez et insérez du contenu, puis collaborez avec votre équipe en temps réel.

Insérer des [blocs de contenu](/docs/documentation/fr/creer-du-contenu/blocks.md), écrire en [Markdown](/docs/documentation/fr/creer-du-contenu/formatting/markdown.md), [intégrer du contenu](/docs/documentation/fr/creer-du-contenu/blocks/embed-a-url.md), et collaborer avec [GitBook Agent](broken://pages/76f00ca5d2740ff5447164219345857871d7dd1a).

Vous pouvez également commenter les blocs et identifier des coéquipiers.

### Titre et description de la page <a href="#page-title" id="page-title"></a>

En haut de chaque page, définissez un titre, ajoutez un emoji facultatif et rédigez une description. Le titre apparaît dans la table des matières et constitue le slug d’URL publié.

La description de votre page peut contenir jusqu’à 200 caractères. Elle apparaît comme texte d’aperçu dans les moteurs de recherche.

{% hint style="info" %}
Pour modifier le slug d’URL d’une page, ouvrez le [Menu Actions](#the-actions-menu) de la page **Modifier le titre et le slug**.
{% endhint %}

### Menu Actions de la page <a href="#the-actions-menu" id="the-actions-menu"></a>

Le **Menu Actions** <picture><source srcset="/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%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&amp;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> de la page vous permet de dupliquer, renommer ou supprimer une page.

Dans la table des matières, survolez une page et cliquez sur l’icône <picture><source srcset="/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%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&amp;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> . Vous pouvez également cliquer sur l’icône située à côté du titre de la page.

{% hint style="info" %}
Les actions disponibles dépendent de votre utilisation de [la modification en direct](/docs/documentation/fr/collaborer/live-edits.md) ou d’une [demande de modification](/docs/documentation/fr/collaborer/change-requests.md).
{% endhint %}

### Options de la page <a href="#page-options" id="page-options"></a>

<div data-with-frame="true"><figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FquMiRmEYl2L5vg76GJWT%2FCleanShot%202025-12-10%20at%2010.24.19.png?alt=media&amp;token=b29ba1c2-0f5f-4d35-9e40-dcc6a27165d3" alt=""><figcaption><p>Le <strong>Options de la page</strong> panneau latéral offre des options de personnalisation pour votre documentation et votre navigation.</p></figcaption></figure></div>

Utilisez les options de page pour personnaliser la mise en page et la navigation de la documentation. Les options de page sont disponibles uniquement lors de la modification.

Ouvrez **Options de la page** depuis le **Menu Actions** <picture><source srcset="/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%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&amp;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> de la page en sélectionnant **Options**. Vous pouvez également survoler le titre de la page et cliquer sur **Options de la page**.

{% hint style="info" %}
Certaines modifications, telles que la désactivation de la table des matières, apparaissent uniquement dans la documentation publiée.
{% endhint %}

### Plan de la page

<div data-with-frame="true"><figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F29FlwGeQG1m2s6nQ8yBv%2FCleanShot%202025-12-10%20at%2010.26.57.png?alt=media&amp;token=6b4e1658-1526-4089-bea4-5bfe5f5656e7" alt=""><figcaption><p>Le plan de la page affiche les titres H1 et H2, ce qui vous permet d’accéder rapidement à une section spécifique d’une page individuelle.</p></figcaption></figure></div>

Le plan de la page se trouve sur le côté droit de l’éditeur. Il vous permet d’accéder à une section de la page.

Le plan répertorie les [titres](/docs/documentation/fr/creer-du-contenu/blocks/heading.md) H1 et H2 de la page.

Le plan de la page apparaît également sur votre site publié. Activez-le ou désactivez-le dans le [Options de la page](#page-options) panneau latéral.

{% hint style="info" %}
Si la colonne de droite n’est pas visible, la largeur de la fenêtre de votre navigateur est peut-être inférieure à 1 430 pixels. Utilisez une fenêtre d’au moins 1 430 pixels de large pour afficher et utiliser le plan de la page.
{% 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/reference/gitbook-ui.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.
