> 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/getting-started/quickstart.md).

# Démarrage rapide

Ce guide de démarrage rapide explique comment configurer GitBook et publier votre premier site de documentation en quelques minutes.

À la fin de ce guide, vous disposerez d’un site de documentation en ligne, prêt à être développé et personnalisé.

{% stepper %}
{% step %}
**Premiers pas**

Vous devrez [créer un compte](https://app.gitbook.com/join) avant de pouvoir commencer avec votre premier site de documentation.

Après la création de votre compte, vous verrez automatiquement un nouveau site de documentation prêt à être modifié et personnalisé. Choisissez comment vous souhaitez ajouter du contenu à votre site avant de publier, parmi les options affichées à l’écran.

{% hint style="success" %}
Votre contenu n’est pas encore publié — vous pouvez donc modifier, personnaliser et prévisualiser votre site de documentation avant de le mettre en ligne. Appuyez sur **Publier** pour le mettre en ligne immédiatement.

<i class="fa-arrow-down">:arrow-down:</i> [Accédez à la section « Publication » sur cette page](#publish-your-documentation)
{% endhint %}
{% endstep %}

{% step %}
**Modifiez votre contenu**

Il existe deux façons de modifier et de mettre à jour votre contenu dans GitBook — dans notre éditeur visuel, ou en suivant un workflow docs-as-code. **Vous pouvez choisir l’une d’elles, ou combiner les deux**.

Quel que soit le workflow que vous préférez, vous modifierez votre contenu en utilisant un **flux de modification basé sur les branches**. En savoir plus sur [la page Concepts](/docs/documentation/fr/ressources/concepts.md).

<details>

<summary>Utiliser l’éditeur visuel</summary>

L’éditeur WYSIWYG de GitBook vous permet de modifier le contenu visuellement, de faire glisser des blocs de contenu pour les réorganiser et de voir l’apparence de votre contenu au fur et à mesure de votre travail.

Ce flux de travail de modification visuelle est idéal pour les utilisateurs qui ne souhaitent pas travailler dans un éditeur de code, ou qui ont de l’expérience avec des outils comme Notion ou Google Docs.

**1. Modifiez votre documentation dans une demande de modification**

Commencez par trouver votre site de documentation dans la barre latérale, puis cliquez sur l’élément en dessous. Cela vous amène à l’espace où se trouve votre contenu.

Cliquez sur **Modifier** en haut à droite. Cela ouvre une demande de modification dans laquelle vous pouvez modifier le contenu de l’espace.

Cliquez sur **Ajouter un nouveau…** dans la table des matières à gauche pour ajouter une page, puis donnez-lui un titre.

<div data-with-frame="true"><figure><img src="/files/1d47a8fa3d2385bd90c37ab1738dffb385935c0f" alt="A screenshot of the Editor in the GitBook app, zoomed in to show the menu that lets you add new pages, groups, links and more to a GitBook space."><figcaption></figcaption></figure></div>

**2. Prévisualisez vos modifications**

En haut de l’application web, vous verrez des onglets pour **Éditeur**, **Modifications** et **Aperçu**. Ils permettent de passer d’une vue à l’autre pour votre contenu.

Cliquez sur **Aperçu** pour voir un aperçu en direct de l’apparence de votre site de documentation avec toutes les modifications de votre demande de modification, sur ordinateur et sur mobile.

<div data-with-frame="true"><figure><img src="/files/4ad5c67825e187354ec56022078bd7edaf4ca613" alt="A screenshot of the GitBook app with the Preview tab open, showing a docs site being previewed on a mobile-size display"><figcaption></figcaption></figure></div>

**3. Fusionnez vos modifications**

Une fois que vous êtes satisfait de vos modifications, cliquez sur le bouton **Fusionner** en haut à droite.

Cela mettra à jour la version principale de votre contenu avec toutes les modifications de la demande de modification. Si le contenu fait partie d’un site de documentation en ligne, le site sera mis à jour immédiatement.

</details>

<details>

<summary>Modification basée sur le code</summary>

Synchronisez votre documentation avec un dépôt GitHub ou GitLab pour activer la modification basée sur le code. Une fois synchronisée, vous pouvez modifier votre documentation dans votre environnement de développement habituel.

Ce flux de travail est idéal pour les utilisateurs techniques qui ne souhaitent pas changer d’outil et préfèrent gérer leur documentation en même temps que leur autre code.

**1. Configurez Git Sync**

Si vous n’avez pas encore configuré Git Sync lors de la création de votre site, trouvez d’abord votre site de documentation dans la barre latérale et cliquez sur le nom du contenu en dessous. Cela vous amène à l’espace où se trouve votre contenu.

Cliquez sur le **Configurer Git Sync** bouton en haut à droite, puis suivez les instructions pour synchroniser votre espace avec le dépôt Git de votre choix.

Rendez-vous sur les [pages Git Sync](/docs/documentation/fr/getting-started/git-sync.md) pour en savoir plus.

**2. Modifiez votre documentation depuis votre environnement de développement**

Une fois votre espace synchronisé avec votre dépôt Git, vous pouvez mettre à jour le contenu de votre documentation à partir de ce dépôt dans votre environnement de développement.

Ouvrez le dépôt, créez une demande d’extraction et apportez les modifications souhaitées.

{% hint style="info" %}

#### Modification en Markdown

GitBook prend en charge [Modification en Markdown](/docs/documentation/fr/creating-content/formatting/markdown.md), vous pouvez donc créer et mettre en forme du contenu à l’aide d’une syntaxe courante.

Chaque bloc standard de GitBook peut être rédigé et mis en forme à l’aide de la syntaxe Markdown.
{% endhint %}

**3. Prévisualisez vos modifications**

Vous pouvez [prévisualiser vos modifications](/docs/documentation/fr/getting-started/git-sync/github-pull-request-preview.md) sur votre site de documentation publié à partir de la demande d’extraction dans GitHub ou GitLab.

Dans votre demande d’extraction, vous verrez un état avec une URL d’aperçu unique. Cliquez sur **Détails** dans cet état pour ouvrir l’URL d’aperçu et voir à quoi ressemblera votre site lorsque la demande d’extraction sera fusionnée et que votre site sera mis à jour.

**4. Fusionnez vos modifications**

Vous êtes prêt. Fusionnez votre demande d’extraction et votre contenu sera mis à jour à la fois dans l’application GitBook et sur votre site de documentation, s’il est en ligne.

Dans l’application GitBook, chaque commit et votre demande d’extraction fusionnée seront synchronisés avec votre espace sous forme de mises à jour dans l’historique des versions.

<div data-with-frame="true"><figure><img src="/files/49f3b9d71c2b56d70b42bbeef06eb9df30acfd2b" alt="A screenshot of the GitBook app showing the version history side panel open. In the side panel the highlighted entry shows a pull request from GitHub that was merged as part of the history, with a link to view the pull request on GitHub."><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}
**Personnalisez votre documentation**

<details>

<summary>Organisez la navigation de votre site</summary>

Vous pouvez ajouter à tout moment du contenu supplémentaire à votre site — comme une référence d’API, un centre d’aide ou un journal des modifications. Lorsque vous ajoutez du contenu, vous pouvez organiser la barre de navigation de votre site afin d’aider les utilisateurs à trouver facilement ce qu’ils cherchent.

Rendez-vous sur [la page Concepts](/docs/documentation/fr/ressources/concepts.md) pour en savoir plus sur la navigation du site.

Rendez-vous sur [la page Structure du site](/docs/documentation/fr/docs-site/site-structure.md) pour en savoir plus sur l’ajout de contenu à votre site.

<div data-with-frame="true"><figure><img src="/files/e18184daa0690c8c9297d38715c5b8f8f5deb80d" alt="A screenshot of a published docs site hosted on GitBook. The top of the site has a navigation bar, and the cursor is hovering over a drop-down in that bar, with a submenu open below it showing links to more pages"><figcaption></figcaption></figure></div>

</details>

<details>

<summary>Personnalisez l’apparence de votre site de documentation</summary>

Votre site de documentation sera superbe dès le départ, mais vous pouvez aussi personnaliser de nombreux paramètres qui modifient l’apparence et le style de votre site publié.

Vous pouvez personnaliser le [logo, les couleurs et la police](/docs/documentation/fr/docs-site/customization/icons-colors-and-themes.md)de votre site, ajouter à la barre de navigation de votre site à l’aide de [sections du site](/docs/documentation/fr/docs-site/site-structure/site-sections.md) et [variantes](/docs/documentation/fr/docs-site/site-structure/variants.md), mettre à jour les [paramètres de visibilité](/docs/documentation/fr/docs-site/site-settings.md#audience) de votre site et bien plus encore.

<div data-with-frame="true"><figure><img src="/files/a16ac5def2cb0efd9241e3bce4603522bac76ad9" alt="An illustration showing five docs sites hosted in GitBook, each with distinct visual customizations"><figcaption></figcaption></figure></div>

</details>
{% endstep %}

{% step %}
**Publiez votre documentation**

<details>

<summary>Publier votre documentation</summary>

Vous pouvez publier votre site en un clic à tout moment.

Ouvrez le tableau de bord de votre site en cliquant sur le nom du site dans la barre latérale. Puis cliquez sur **Publier** en haut à droite pour le mettre en ligne.

Une fois votre site en ligne, le tableau de bord sera mis à jour avec un lien vers le site en ligne.

<div data-with-frame="true"><figure><img src="/files/2759080b0bac9552adde07e101b17f5093a5fcd9" alt="A screenshot of the GitBook app showing a dashboard for a docs site. The dashboard shows the public URL, site status, site content, some top-level analytics for the site, and other options in tabs along the top of the screen."><figcaption></figcaption></figure></div>

{% hint style="success" %}
Vous souhaitez explorer la publication plus en détail ? Consultez [notre guide complet pour créer et publier du contenu dans GitBook](/docs/guides/editing-and-publishing-documentation/complete-guide-to-publishing-docs-gitbook.md).
{% endhint %}

</details>

<details>

<summary>Ajouter un domaine personnalisé</summary>

Par défaut, votre site sera publié avec une URL unique dans ce format :

```
https://[nom-de-l’organisation].gitbook.io/[titre-du-site]
```

Bien que cela puisse convenir à certaines équipes, beaucoup choisissent de modifier leur URL pour [un domaine personnalisé](/docs/documentation/fr/docs-site/custom-domain.md) ou [un sous-répertoire personnalisé](/docs/documentation/fr/docs-site/custom-domain/setting-a-custom-subdirectory.md).

Pour ce faire, ouvrez le tableau de bord de votre site en cliquant sur le nom du site dans la barre latérale, puis ouvrez l’onglet **Paramètres** et choisissez **Domaine et URL**.

<figure><img src="/files/5a9cf97e716900583585db35e200f0c09316ad79" alt="A screenshot of the GitBook app showing the menu that guides you through the process of setting up a custom domain for your docs site."><figcaption></figcaption></figure>

Utilisez les boutons à l’écran pour choisir l’option souhaitée, puis suivez les instructions pour configurer les paramètres DNS avec votre fournisseur de domaine.

{% hint style="info" %}
La propagation des modifications DNS peut prendre jusqu’à 48 heures — bien qu’elle soit généralement beaucoup plus rapide.
{% endhint %}

</details>
{% endstep %}
{% endstepper %}

### Étapes suivantes

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">Image de couverture</th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-type="image">Image de couverture (sombre)</th><th data-hidden data-type="image">Image de couverture (sombre)</th><th data-hidden data-type="image">Image de couverture (sombre)</th><th data-hidden data-type="image">Image de couverture (sombre)</th><th data-hidden data-card-cover-dark data-type="image">Image de couverture (sombre)</th></tr></thead><tbody><tr><td><strong>Invitez votre équipe à collaborer</strong></td><td>Ajoutez des membres à votre organisation et définissez les autorisations</td><td><a href="/files/e1576c62c11b47d039c12b9aa07f5a8f64609995">/files/e1576c62c11b47d039c12b9aa07f5a8f64609995</a></td><td><a href="/pages/2f15956d71f759079cd715b161e06a3254a9097e">/pages/2f15956d71f759079cd715b161e06a3254a9097e</a></td><td><a href="/files/79708f7ab0ff93541e089a59718ca950feafecd2">/files/79708f7ab0ff93541e089a59718ca950feafecd2</a></td><td><a href="/files/79708f7ab0ff93541e089a59718ca950feafecd2">/files/79708f7ab0ff93541e089a59718ca950feafecd2</a></td><td></td><td></td><td></td></tr><tr><td><strong>Modifier la visibilité du site</strong></td><td>Contrôlez qui peut voir votre contenu grâce aux liens de partage et à l’accès authentifié</td><td><a href="/files/2c1835b377635fdb159826bc3aedf62039fad56a">/files/2c1835b377635fdb159826bc3aedf62039fad56a</a></td><td><a href="/pages/4e899e869211e700fd565379d061de3d858b0f02#publish-a-docs-site">/pages/4e899e869211e700fd565379d061de3d858b0f02#publish-a-docs-site</a></td><td><a href="/files/701f4cf6dfc581aaa7219d8ec1d92c6f85a7ffbd">/files/701f4cf6dfc581aaa7219d8ec1d92c6f85a7ffbd</a></td><td></td><td><a href="/files/701f4cf6dfc581aaa7219d8ec1d92c6f85a7ffbd">/files/701f4cf6dfc581aaa7219d8ec1d92c6f85a7ffbd</a></td><td><a href="/files/701f4cf6dfc581aaa7219d8ec1d92c6f85a7ffbd">/files/701f4cf6dfc581aaa7219d8ec1d92c6f85a7ffbd</a></td><td></td></tr><tr><td><strong>Ajouter des auto-traductions</strong></td><td>Créez des traductions en un clic qui se mettent à jour automatiquement</td><td><a href="/files/57f9d3cd7ee4d841f3e7d3fabd66732a74ffa9e2">/files/57f9d3cd7ee4d841f3e7d3fabd66732a74ffa9e2</a></td><td><a href="/pages/552868c182462d7bf906b1c496844a6035d50e43">/pages/552868c182462d7bf906b1c496844a6035d50e43</a></td><td><a href="/files/d4163acf8b847aee1f15cf1858f0412ea2b07301">/files/d4163acf8b847aee1f15cf1858f0412ea2b07301</a></td><td></td><td></td><td><a href="/files/d4163acf8b847aee1f15cf1858f0412ea2b07301">/files/d4163acf8b847aee1f15cf1858f0412ea2b07301</a></td><td></td></tr><tr><td><strong>Installer des intégrations</strong></td><td>Intégrez votre stack et étendez les fonctionnalités avec de puissantes intégrations</td><td><a href="/files/2caafe6489c2bd38637c61aba8e73bcd27cff866">/files/2caafe6489c2bd38637c61aba8e73bcd27cff866</a></td><td><a href="/pages/e75bc0915e6dc08280a2cd972f26e51dd624ec57">/pages/e75bc0915e6dc08280a2cd972f26e51dd624ec57</a></td><td><a href="/files/abdc9042e61d55cb4ad22d9364d94d3f0a3d8a48">/files/abdc9042e61d55cb4ad22d9364d94d3f0a3d8a48</a></td><td></td><td></td><td></td><td><a href="/files/abdc9042e61d55cb4ad22d9364d94d3f0a3d8a48">/files/abdc9042e61d55cb4ad22d9364d94d3f0a3d8a48</a></td></tr><tr><td><strong>Ajouter une référence API</strong></td><td>Créez une documentation de référence API interactive et mise à jour automatiquement à partir d’une spécification d’API</td><td><a href="/files/f651075feaa02de9ac2330637c779fa5e4a96142">/files/f651075feaa02de9ac2330637c779fa5e4a96142</a></td><td><a href="/pages/919a4c155a9625416a98ceb19aa5982e89b0436a">/pages/919a4c155a9625416a98ceb19aa5982e89b0436a</a></td><td><a href="/files/7ed0227494115fa816697f1bc48f8f15da9bf696">/files/7ed0227494115fa816697f1bc48f8f15da9bf696</a></td><td></td><td></td><td></td><td></td></tr><tr><td><strong>Suivre les statistiques de la documentation</strong></td><td>Utilisez les analyses intégrées pour mesurer le succès et comprendre le comportement des utilisateurs</td><td><a href="/files/1ff0951555223b0e80fed944b284441d5b7723de">/files/1ff0951555223b0e80fed944b284441d5b7723de</a></td><td><a href="/pages/e20716c31dc73f89aaf65ee4a016c8e62e4de42e">/pages/e20716c31dc73f89aaf65ee4a016c8e62e4de42e</a></td><td><a href="/files/aa085c32ef5d94d8d15b011bd485fad1f29c4e24">/files/aa085c32ef5d94d8d15b011bd485fad1f29c4e24</a></td><td></td><td></td><td></td><td></td></tr></tbody></table>

### FAQ

<details>

<summary>Qu’est-ce que GitBook ?</summary>

GitBook est une plateforme de documentation collaborative, native à l’IA, où les équipes peuvent créer, réviser et publier des documentations de marque sous forme de sites web. Les sites de documentation hébergés sur GitBook peuvent offrir un Assistant IA intégré et se connecter à d’autres outils d’IA via MCP.

Vous pouvez modifier le contenu à l’aide de l’éditeur visuel avancé utilisant Markdown, synchroniser votre documentation avec un dépôt Git pour un workflow docs as code — ou utiliser une combinaison des deux. Quelle que soit la façon dont votre équipe choisit d’utiliser GitBook, vous utiliserez un workflow de branches de type Git avec un historique complet des versions, ce qui protège votre contenu principal tout en favorisant la collaboration et les retours dans toute votre équipe.

</details>

<details>

<summary>Comment publier de la documentation avec GitBook ?</summary>

La publication dans GitBook est un processus simple une fois que votre contenu est prêt à être mis en ligne :

1. Créez un nouveau site de documentation (ou ouvrez-en un existant) et choisissez le contenu que vous souhaitez publier.
2. Choisissez votre public cible. Vous pouvez publier pour tout le monde avec le **public** paramètre, ou limiter le public avec **des liens de partage** ou **l’accès authentifié**.
3. (Facultatif) Personnalisez l’image de marque, le domaine et le thème à l’aide des options intégrées.
4. Cliquez sur **Publier**. Félicitations — votre documentation est en ligne ! Vous pourrez ajouter d’autres espaces plus tard en tant que sections du site ou variantes.

Pour en savoir plus, consultez [notre guide de démarrage rapide](#getting-started) ci-dessus, ou lisez [le guide complet pour créer et publier de la documentation dans GitBook](/docs/guides/editing-and-publishing-documentation/complete-guide-to-publishing-docs-gitbook.md).

</details>

<details>

<summary>GitBook est-il open source ?</summary>

GitBook lui-même n’est pas open source. Cependant, la plateforme de publication de documentation de GitBook — qui est utilisée pour héberger et afficher la documentation sur un site de documentation — est open source. Vous pouvez [visiter le dépôt](https://github.com/GitbookIO/gitbook) pour voir le code et soumettre des modifications pour examen.

Bien que GitBook lui-même ne soit pas open source, **les projets open source peuvent publier gratuitement leur documentation sur GitBook**. Les équipes peuvent s’inscrire à [l’offre Community](/docs/documentation/fr/gestion-du-compte/plans/community.md) et publier du contenu à l’aide d’ [une offre de site sponsorisé](/docs/documentation/fr/gestion-du-compte/plans/community/sponsored-site-plan.md), qui sont toutes deux gratuites pour les équipes éligibles.

</details>

<details>

<summary>Quelle est la différence entre un site et un espace dans GitBook ?</summary>

Dans GitBook, un **site de documentation** est votre centre de documentation global, hébergeant tout le contenu accessible à votre audience et proposant des options personnalisables comme le thème et le domaine.

Chaque site contient un ou plusieurs **espaces**, qui servent de sections individuelles au sein du site, en organisant le contenu associé pour une meilleure modularité et une gestion plus facile. Les espaces vous permettent de concentrer votre collaboration sur des sujets précis, et vous pouvez combiner plusieurs espaces sur un seul site pour structurer le contenu ou activer des options comme les traductions (pour une documentation localisée) ou la prise en charge de plusieurs produits.

</details>

<details>

<summary>Quelles sont les différences entre l’éditeur visuel de GitBook et Git Sync ?</summary>

GitBook propose deux principales méthodes pour modifier la documentation — l’éditeur visuel et Git Sync. L’ **éditeur visuel** est un éditeur avancé basé sur des blocs qui vous permet de créer et de modifier du contenu directement dans GitBook à l’aide d’une interface utilisateur traditionnelle incluant la prise en charge de Markdown. Il est idéal pour ceux qui préfèrent une expérience d’édition plus intuitive et pratique, sans avoir à manipuler directement du code.

**Git Sync** intègre votre workflow de documentation à un dépôt Git, permettant une approche « docs as code ». Cette option est idéale pour les développeurs et les équipes qui préfèrent gérer la documentation en même temps que leur base de code, en utilisant des commandes et des workflows Git familiers.

Votre équipe peut choisir l’un de ces workflows, ou utiliser une combinaison des deux. Et quelle que soit la méthode choisie, la modification suit un workflow de branches cohérent, de type Git, avec un historique complet des versions et un processus de relecture du contenu. Cela ne favorise pas seulement la collaboration et la qualité dans toute votre documentation — cela protège également le contenu principal contre les modifications accidentelles.

</details>


---

# 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/getting-started/quickstart.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.