> 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/concepts.md).

# Concepts fondamentaux

Apprenez les bases de GitBook afin de créer et publier une documentation exceptionnelle pour vos utilisateurs

<div data-full-width="false"><figure><picture><source srcset="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-c8fbd83e198347ff1386b0c4517e61c97a6d4db6%2F25_12_10_editor_and_block_palette.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-5274ea5cac7b60eeb7e4dd89a52f25496b9c3e2a%2F25_12_10_editor_and_block_palette_1.png?alt=media" alt="An illustration showing the block palette open in the GitBook editor. The window is floating on a pastel yellow and pink background"></picture><figcaption></figcaption></figure></div>

## Organiser le contenu

### Section <a href="#space" id="space"></a>

Une section est un projet qui vous permet de travailler sur un ensemble de pages liées. Au sein d’une section, vous pouvez rédiger du contenu, organiser vos pages à l’aide de groupes de pages et de sous-pages, installer des intégrations, et plus encore.

Les sections appartiennent à un site de documentation, et vous pouvez ajouter autant de sections que vous le souhaitez à un site de documentation. Ainsi, lorsque vous construisez votre contenu, vous pouvez créer des sections distinctes pour la documentation de votre produit, la référence de l’API, le journal des modifications, le centre d’aide, et tout autre élément que vous souhaitez inclure dans votre documentation — puis les publier toutes sur un seul site de documentation.

Vous pouvez également vouloir créer des versions traduites de votre documentation principale, ou des docs séparées pour différentes versions de votre produit. Chacune d’elles aura également sa propre section et pourra être ajoutée à votre site de documentation unique pour être consultée par les utilisateurs.

#### Groupe <a href="#collection" id="collection"></a>

Les groupes fonctionnent comme des dossiers dans l’application GitBook, vous permettant de conserver ensemble les sections liées afin de faciliter l’organisation et le stockage de votre contenu.

En plus de vous aider à organiser le contenu, les groupes facilitent également la gestion des permissions au niveau du contenu à grande échelle. Vous pouvez remplacer les permissions au niveau de l’organisation sur plusieurs sections en les ajoutant à un groupe et en définissant des permissions pour l’ensemble du groupe.

### section du site de documentation

Vous pouvez publier votre contenu sous forme de site de documentation. Vos docs seront publiées et accessibles à l’audience que vous avez choisie, sous la forme d’un site web que vous pouvez personnaliser avec votre propre image de marque, vos analyses et votre domaine personnalisé.

Vous pouvez créer autant de sites de documentation que vous le souhaitez. Ils figurent tous sur la page **Accueil**. Ouvrez un site pour modifier ses paramètres et ses options de personnalisation depuis la barre latérale du site.

Le contenu de votre site se trouve dans ses sections. Lorsque vous créez un nouveau site de documentation, vous pouvez créer une nouvelle section ou ajouter du contenu existant. Un site de documentation peut contenir une section, ou plusieurs sections contenant différents contenus — y compris des traductions et d’anciennes versions du produit.

## Modification du contenu

L’éditeur visuel de GitBook vous permet d’utiliser une interface de type WYSIWYG (ce que vous voyez est ce que vous obtenez) pour ajouter du contenu à une section.

La modification est disponible sur les appareils de bureau et les ordinateurs portables. Vous pouvez consulter votre organisation et votre contenu depuis un smartphone, mais la modification nécessite un ordinateur de bureau ou portable.

### Pages

Une page est l’endroit où vous ajoutez, modifiez et intégrez du contenu. Les pages se trouvent toujours à l’intérieur d’une section, et vous pouvez ajouter autant de pages que vous le souhaitez à une section.

Les pages de votre section apparaissent dans la table des matières sur le côté gauche de l’éditeur. Ici, vous pouvez ajouter de nouvelles pages, créer des groupes de pages et imbriquer des pages dans d’autres pages pour créer des sous-pages.

{% hint style="info" %}

#### Vous ne voyez pas comment modifier ou ajouter une page ?

Si votre site est publié, vous devez créer une demande de modification avant de pouvoir modifier le contenu d’une section. [En savoir plus sur les demandes de modification ci-dessous](#change-requests).
{% endhint %}

### Blocs

GitBook est un éditeur basé sur des blocs. Cela signifie que vous pouvez ajouter différents types de blocs à votre page — du texte et des images standard aux blocs interactifs plus avancés. Vos pages peuvent inclure n’importe quelle combinaison de blocs que vous souhaitez, et il n’y a aucune limite au nombre de blocs que vous pouvez avoir sur une page.

L’édition basée sur des blocs facilite la réorganisation de votre contenu par glisser-déposer, ou l’ajout de nouveaux blocs au milieu d’un contenu existant. Vous pouvez créer de nouveaux blocs à l’aide de l’interface de l’éditeur, ou créer et mettre en forme des blocs à l’aide de Markdown.

Découvrez tous les blocs que vous pouvez utiliser dans GitBook [dans la section Blocs](https://gitbook.com/docs/documentation/fr/creer-du-contenu/blocks.md).

#### la modification en Markdown

L’éditeur de GitBook vous permet de créer et de mettre en forme des blocs de contenu à l’aide de Markdown.

Markdown est une syntaxe de balisage populaire, largement connue pour sa simplicité. GitBook le prend en charge comme une manière pratique au clavier d’écrire un texte riche et structuré — tous les blocs de GitBook peuvent être rédigés à l’aide de la syntaxe Markdown.

{% hint style="info" %}
Pour en savoir plus sur Markdown, consultez [CommonMark](https://commonmark.org/help/).
{% endhint %}

### Git Sync

Git Sync permet aux équipes de synchroniser des dépôts GitHub ou GitLab avec GitBook et de transformer des fichiers Markdown en une documentation belle et facile à utiliser. Une fois configuré, il maintient tout votre contenu synchronisé entre l’application GitBook et votre base de code.

Git Sync est bidirectionnel, donc les changements que vous apportez dans l’éditeur visuel de GitBook sont synchronisés automatiquement — tout comme les commits effectués sur GitHub ou GitLab. Cela permet aux développeurs de committer directement depuis GitHub ou GitLab, tandis que les autres membres de l’équipe modifient et laissent des retours sur les changements directement dans GitBook.

Git Sync débloque également de nombreux autres flux de travail utiles dans votre documentation GitBook, comme les modifications groupées, le linting et bien plus encore. Pour en savoir plus, consultez [notre section Git Sync](https://gitbook.com/docs/documentation/fr/docs-as-code/git-sync.md).

## Le flux de modification

### Demandes de modification

Une demande de modification est une [**branche**](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell) de votre contenu principal que vous pouvez utiliser pour effectuer des modifications simultanées tout en conservant l’historique de vos versions. Son fonctionnement sera familier à toute personne qui utilise les demandes de tirage dans GitHub ou les demandes de fusion dans GitLab.

Si vous souhaitez modifier le contenu de votre site de documentation publié, vous devrez d’abord ouvrir une demande de modification dans votre section.

Dans une demande de modification, vous pouvez ajouter, modifier et supprimer du contenu dans une section, puis demander une révision à votre équipe et fusionner vos modifications dans votre contenu principal pour mettre à jour votre site de documentation publié.

{% hint style="info" %}

#### Le branchement en bref

Ouvrir une demande de modification crée une copie de votre contenu à ce moment précis, parfois appelée une « branche ». Toutes les modifications que vous apporterez n’apparaîtront pas dans votre contenu principal tant que vous n’aurez pas choisi de fusionner votre demande de modification.

L’avantage du branchement est que vos coéquipiers peuvent créer, modifier et fusionner leurs propres demandes de modification en même temps que vous, sans se gêner mutuellement. Et si quelqu’un modifie le même contenu que vous, GitBook vous guidera pour résoudre tout conflit avant la fusion.
{% endhint %}

#### Révisions

Les révisions encouragent la supervision et aident à améliorer la qualité et la précision de votre documentation.

Vous pouvez demander une révision pour votre demande de modification avant de fusionner et de rendre les changements visibles sur votre site de documentation. Ajouter un titre et une description à votre demande de modification donne à vos relecteurs un peu de contexte.

Les réviseurs peuvent consulter le diff de votre demande de modification, qui met en évidence tout ce qui est nouveau, modifié ou supprimé dans votre demande de modification. Ils peuvent également laisser des commentaires directement sur la page grâce à la fonctionnalité de commentaires intégrée — puis approuver votre demande de modification ou demander d’autres changements.

#### Fusion

La fusion d’une demande de modification ajoutera tout le contenu de votre demande de modification à la branche principale du contenu — et ces changements seront également publiés sur votre site de documentation.

Lorsque vous fusionnez votre demande de modification, une nouvelle version est également créée dans l’historique des versions de la section.

## Publication de la documentation

Lorsque vous publiez votre contenu sous la forme d’un [site de documentation](#docs-site), vous pouvez ajouter du contenu à votre site, modifier son audience et personnaliser son apparence ainsi que d’autres paramètres.

### Structurer votre site de documentation

Si vous souhaitez ajouter du contenu supplémentaire à votre site, deux options s’offrent à vous, chacune conçue pour des cas d’usage différents : les sections et les variantes.

#### Les sections dans la structure de votre site <a href="#site-section" id="site-section"></a>

Les sections vous permettent d’ajouter **plusieurs types de documentation à un même site de documentation**. Par exemple, vous pouvez utiliser un seul site pour héberger la documentation de votre produit, sa référence d’API, votre centre d’aide et son journal des modifications, comme nous le faisons sur ce site de documentation.

En ajoutant de nouvelles sections, vous développez la barre de navigation en haut de votre site, chaque section ayant sa propre entrée dans la barre. Vous pouvez également regrouper des sections dans un [groupe](#collection) pour créer un menu déroulant dans la barre de navigation, idéal pour organiser votre site de façon hiérarchique.

#### Variante

Les variantes vous permettent d’ajouter **plusieurs versions d’une même documentation à un seul site de documentation**. Par exemple, vous pouvez traduire l’ensemble de votre documentation dans plusieurs langues ou documenter les versions précédentes de votre produit pour les utilisateurs qui ne l’ont pas encore mis à jour.

Vos utilisateurs finaux peuvent passer d’une variante à l’autre sur votre site de documentation à l’aide du sélecteur de langue ou du sélecteur de variante en haut de la table des matières, sur le côté gauche de votre site.

<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%2Fgit-blob-b13c3123b0d22ce9fce674e4d650a32ac78b5078%2F25_12_10_structure_light.png?alt=media" alt="A screenshot of the Roboflow Documentation site, with a navigation bar along the top and an open drop-down menu at the top of the table of contents showing different language variants for the site."><figcaption><p>Les sections créent une barre de navigation le long du haut de votre site, tandis que les utilisateurs peuvent passer d’une variante à l’autre à l’aide d’un menu dans la table des matières.</p></figcaption></figure></div>

### Audience du site

Vous pouvez choisir qui verra votre documentation lorsque vous la publierez. Par défaut, les nouveaux sites sont publiés publiquement et indexés par les moteurs de recherche.

Toutefois, si vous souhaitez mieux contrôler qui peut accéder à votre site, vous pouvez choisir de restreindre l’audience à l’aide de **liens de partage** ou de **l’accès authentifié**.

Grâce aux liens de partage, vous pouvez partager votre contenu en privé avec des clients ou des partenaires sans avoir besoin de les inviter dans votre organisation, en créant un lien privé et en le leur partageant directement. Toute personne disposant du lien peut accéder à votre site.

Si vous souhaitez encore plus de contrôle, l’accès authentifié vous permet de publier votre contenu tout en exigeant une authentification de la part de tous les visiteurs qui souhaitent le consulter. Lorsqu’il est activé, GitBook laisse votre fournisseur d’authentification gérer qui a accès au contenu. C’est idéal pour du contenu privé ou pour publier une base de connaissances interne qui ne devrait être accessible qu’aux membres de votre équipe.

Vous pouvez également contrôler qui voit certaines pages ou certains blocs grâce à une fonctionnalité appelée contenu adaptatif. Une fois configurée, elle affiche ou masque du contenu en fonction des attributs des utilisateurs que vous avez définis. Pour en savoir plus, consultez [les pages sur le contenu adaptatif](https://gitbook.com/docs/documentation/fr/publish/adaptive-content.md).

### Personnalisation du site

GitBook inclut des options de personnalisation intégrées pour les sites de documentation, vous aidant à adapter l’apparence de votre documentation à votre produit ou à votre marque.

Même si vous n’appliquez aucune personnalisation, vos docs seront déjà très belles. Mais vous avez la possibilité de personnaliser les logos, les icônes et les couleurs, d’ajouter des polices personnalisées ou de choisir parmi certains thèmes intégrés qui aident vos docs à être aussi belles que votre produit.

<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%2Fgit-blob-b5176c44bacdad5f68cf9d1e7801920a2d8446dc%2F25_07_16_customization_demo.png?alt=media" alt="An illustration showing five docs sites hosted in GitBook, each with distinct visual customizations"><figcaption><p>Vous pouvez personnaliser votre documentation pour l’aligner sur votre marque avec vos propres logos, couleurs, polices, images et bien plus encore.</p></figcaption></figure></div>

### Optimisations SEO et IA

La documentation publiée dans GitBook est automatiquement optimisée pour la recherche (SEO) et pour les systèmes d’IA comme ChatGPT, Claude et Google AI Overview (GEO). Tout cela est géré en arrière-plan, donc tout ce que vous avez à faire est de rédiger du contenu incluant les mots-clés et les termes que vous souhaitez cibler.

Les pages récupèrent les métadonnées du titre et de la description de chaque page, et votre contenu est mis en forme pour être responsive. GitBook crée automatiquement un sitemap basé sur votre table des matières, et les pages sont mises en cache et diffusées via notre CDN mondial pour améliorer les performances. Tout cela aide votre documentation à obtenir un bon classement dans les moteurs de recherche.

De même, GitBook optimise également les outils d’IA en suivant toutes les normes du secteur à mesure qu’elles évoluent rapidement.

GitBook crée automatiquement des versions .md de chaque page, ce qui permet aux grands modèles de langage (LLM) de les analyser plus facilement. Nous mettons également à disposition un serveur Model Context Protocol (MCP) pour chaque site publié, afin que les outils d’IA puissent découvrir et récupérer vos documents sous forme de ressources structurées — sans avoir à extraire le contenu du site. De plus, votre site génère également `llms.txt` et `llms-full.txt` conçus pour être ingérés par l’IA.

## Gestion d’équipe

### Organisation

Une organisation GitBook contient tout le contenu et tous les sites de documentation d’une entreprise. Avec votre compte unique, vous pouvez être membre d’une ou de plusieurs organisations et passer de l’une à l’autre à l’aide du menu d’organisation en haut de la barre latérale.

### Membres

Les membres sont des utilisateurs individuels au sein de votre organisation. Vous pouvez avoir autant de membres que vous le souhaitez dans une organisation, chacun disposant de permissions adaptées à ses besoins d’accès spécifiques.

Chaque compte membre appartient à une seule personne et ne doit pas être partagé. Invitez chaque collaborateur et attribuez-lui plutôt le rôle approprié. Pour obtenir des conseils sur la protection du compte et la récupération de l’accès, consultez [Paramètres personnels](https://gitbook.com/docs/documentation/fr/compte-et-facturation/account-settings.md#account-protection-and-sign-in-recovery).

#### Autorisations

Les autorisations vous permettent de définir le niveau d’accès des membres de votre organisation. Lorsqu’un membre rejoint votre organisation, vous lui attribuez un rôle — comme Éditeur ou Lecteur. Ces rôles définissent leurs autorisations pour l’ensemble du contenu de votre organisation. Mais vous pouvez aussi remplacer ces autorisations au niveau du contenu. Par exemple :

* Vous pouvez donner à une personne ayant le rôle de Lecteur un accès en modification à un élément de contenu particulier
* Vous pouvez limiter l’accès à un contenu confidentiel ou privé spécifique et n’accorder l’accès qu’à certains membres de votre organisation.

Pour en savoir plus, consultez [la page sur les autorisations et l’héritage](https://gitbook.com/docs/documentation/fr/collaborate/member-management/permissions-and-inheritance.md).


---

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/reference/concepts.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
