> 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 le site de documentation de votre premier projet 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 %}

#### Créez votre compte

[Créer un compte](https://app.gitbook.com/join) pour commencer votre premier site de documentation.
{% endstep %}

{% step %}

#### Créez votre premier site

1. Depuis votre organisation **Accueil**, cliquez sur le **+** à côté de **Sites** dans la barre latérale.
2. Donnez à votre site un nom que vos visiteurs reconnaîtront.
3. Cliquez sur **Créer**.
   {% endstep %}

{% step %}

#### Choisissez comment vous souhaitez commencer

GitBook vous souhaite la bienvenue sur votre nouveau site et vous demande comment vous souhaitez commencer.

<table><thead><tr><th width="200">Point de départ</th><th>Idéal pour</th></tr></thead><tbody><tr><td><strong>Modèle de documentation</strong></td><td>Partir d’une mise en page de documentation prête à l’emploi avec des sections factices — le moyen le plus rapide de voir un site complet fonctionner.</td></tr><tr><td><strong>Importer</strong></td><td>Importer du contenu existant depuis des docs en ligne, Markdown ou HTML.</td></tr><tr><td><strong>OpenAPI</strong></td><td>Générer une documentation de référence API interactive à partir d’une spécification OpenAPI.</td></tr><tr><td><strong>Vide</strong></td><td>Partir d’une section vide et construire à partir de zéro.</td></tr><tr><td><strong>Synchroniser avec Git</strong></td><td>Garder votre documentation synchronisée avec un dépôt GitHub ou GitLab.</td></tr></tbody></table>

Ou bien, vous pouvez choisir parmi le contenu existant de votre organisation si vous avez déjà du travail dans GitBook.

Ce guide suit l’option du modèle :

1. Cliquez sur **Modèle de documentation** et vérifiez l’aperçu.
2. Cliquez sur **Utiliser le modèle de documentation** pour l’appliquer.
   {% endstep %}

{% step %}

#### Explorez votre nouveau site

Votre site s’ouvre non publié, afin que vous puissiez tout modifier, personnaliser et prévisualiser avant sa mise en ligne. La barre latérale affiche :

<table><thead><tr><th width="160">Zone de la barre latérale</th><th>Ce que vous trouverez</th></tr></thead><tbody><tr><td><strong>En-tête du site</strong></td><td>Le nom de votre site, son état de publication et le <strong>Aperçu</strong> et <strong>Publier</strong> .</td></tr><tr><td><strong>Général</strong></td><td><strong>Vue d’ensemble</strong>, <strong>Demandes de modification</strong>, <strong>Structure du site</strong>, et <strong>Paramètres</strong>.</td></tr><tr><td><strong>Outils</strong></td><td><strong>Guide de style</strong>, <strong>menu Personnaliser</strong>, <strong>Analyser</strong>, et <strong>Étendre</strong>.</td></tr><tr><td><strong>Contenu</strong></td><td>Voici les sections de votre site — pour le modèle de documentation : Accueil, Documentation, Référence API, Journal des modifications et Centre d’aide. Utilisez les icônes sur le <strong>Contenu</strong> en-tête pour trouver, renommer et ajouter des sections.</td></tr></tbody></table>

{% 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. Cliquez **Publier** pour le mettre en ligne immédiatement.

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

{% step %}

#### Modifiez votre contenu

Le modèle de documentation vous propose des sections factices dans la **Contenu** partie de la barre latérale. Cliquez sur n’importe quelle section pour l’ouvrir et voir son contenu factice.

Il existe deux façons de modifier et de mettre à jour votre contenu dans GitBook — dans notre éditeur visuel, ou en suivant un flux de travail docs-as-code. **Vous pouvez choisir l’un ou l’autre, ou combiner les deux.** Quel que soit le flux de travail que vous préférez, vous modifierez votre contenu à l’aide d’un **flux de modification basé sur des branches**. En savoir plus sur [la page Concepts](/docs/documentation/fr/reference/concepts.md).

{% tabs %}
{% tab title="Éditeur visuel" icon="hand-pointer" %}
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 à quoi ressemble votre contenu au fur et à mesure. Il est idéal si vous ne souhaitez pas travailler dans un éditeur de code, ou si vous avez l’habitude d’outils comme Notion ou Google Docs.

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

1. Dans le **Contenu** section de la barre latérale, cliquez sur une section — comme Documentation — pour l’ouvrir.
2. Cliquez sur **Modifier** dans le coin supérieur droit. Cela ouvre une demande de modification dans laquelle vous pouvez modifier le contenu de la section.
3. Cliquez sur **Ajouter un nouveau…** > **Page** dans la table des matières sur le côté gauche.
4. Donnez un titre à votre nouvelle page.

**Prévisualisez vos modifications**

En haut de l’application web, vous verrez des onglets pour **Éditeur**, **Modifications**, et **Aperçu**. Ils permettent de basculer entre différentes vues de votre contenu. Cliquez **Aperçu** pour voir à quoi ressemble votre site de documentation avec toutes les modifications de votre demande de modification, sur ordinateur et sur mobile.

**Fusionnez vos modifications**

Une fois que vos modifications vous conviennent, cliquez sur le bouton **Fusionner** dans le coin supérieur droit. Cela met à 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 se met à jour immédiatement.
{% endtab %}

{% tab title="Agent IA" icon="robot" %}
Synchronisez votre documentation avec un dépôt GitHub ou GitLab pour permettre une édition basée sur le code dans votre environnement de développement habituel. C’est idéal pour les utilisateurs techniques qui préfèrent gérer la documentation en parallèle d’autres codebases.

**Configurer la synchronisation Git**

1. Ouvrez la section que vous souhaitez synchroniser depuis la **Contenu** partie de la barre latérale.
2. Cliquez sur le **Configurer** bouton de l’indicateur de synchronisation Git dans la barre supérieure.
3. Suivez les instructions pour synchroniser la section avec le dépôt Git de votre choix. Rendez-vous sur les [pages de synchronisation Git](/docs/documentation/fr/documentation-as-code/git-sync.md) pour en savoir plus.

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

Une fois votre section synchronisée avec votre dépôt Git :

1. Ouvrez le dépôt.
2. Créez une pull request.
3. Apportez les modifications souhaitées.

{% hint style="info" %}
GitBook prend en charge [Modification Markdown](/docs/documentation/fr/creer-du-contenu/formatting/markdown.md), vous pouvez donc créer et formater du contenu à l’aide d’une syntaxe courante.

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

**Prévisualisez vos modifications**

Vous pouvez [prévisualiser vos modifications](/docs/documentation/fr/documentation-as-code/git-sync/github-pull-request-preview.md) sur votre site de documentation publié à partir de la pull request dans GitHub ou GitLab. Votre pull request affiche un statut avec une URL d’aperçu unique. Cliquez sur **Détails** sur ce statut pour l’ouvrir et voir à quoi ressemblera votre site une fois fusionné.

**Fusionnez vos modifications**

Fusionnez votre pull request et vos mises à jour de contenu seront appliquées à 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 pull request fusionnée se synchronisent avec votre section sous forme de mises à jour dans l’historique des versions.
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

#### Personnalisez votre documentation

**Organisez la navigation de votre site**

Ajoutez à tout moment davantage de contenu à votre site — une référence API, un centre d’aide, un journal des modifications — et organisez la barre de navigation de votre site pour que les visiteurs trouvent ce qu’ils recherchent. Rendez-vous sur [Structure du site](/docs/documentation/fr/gerer-votre-site/site-structure.md) pour en savoir plus sur les sections, les groupes et les variantes.

**Personnalisez l’apparence**

Votre site est superbe dès le départ — et sous **menu Personnaliser**, vous pouvez définir votre propre [logo, couleurs et police](/docs/documentation/fr/gerer-votre-site/customization/icons-colors-and-themes.md), ajuster la mise en page et mettre à jour la [visibilité du site](/docs/documentation/fr/gerer-votre-site/site-settings.md#audience).
{% endstep %}

{% step %}

#### Publiez votre documentation <a href="#publish-your-documentation" id="publish-your-documentation"></a>

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

1. Ouvrez votre site depuis votre organisation **Accueil**.
2. Cliquez sur **Publier** dans l’en-tête du site.

Une fois votre site en ligne, l’ **Vue d’ensemble** écran se met à jour avec un lien vers le site en ligne.

{% 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 %}
{% endstep %}
{% endstepper %}

#### Ajouter un domaine personnalisé

Par défaut, votre site est publié avec une URL unique au format suivant :

{% code title="URL par défaut de votre site" %}

```
https://[organization-name].gitbook.io/[site-title]
```

{% endcode %}

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

1. Développer **Paramètres** dans la barre latérale de votre site.
2. Cliquez sur **Domaine et URL**.
3. Choisissez l’option souhaitée.
4. Suivez les instructions pour configurer les paramètres DNS avec votre fournisseur de domaine.

{% hint style="info" %}
Les modifications DNS peuvent prendre jusqu’à 48 heures pour prendre effet — même si elles se propagent généralement beaucoup plus rapidement.
{% endhint %}

#### É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 permissions</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 avec des liens de partage et un 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 traductions automatiques</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 pile et étendez les fonctionnalités grâce à 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, mise à jour automatiquement, à partir d’une spécification 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>


---

# 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.