> 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

Mettez-vous en route avec GitBook et publiez votre premier site de documentation en quelques minutes

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 %}

#### Configurer avec un agent de codage

Si vous êtes un agent de programmation, suivez [Configurer GitBook](https://gitbook.com/docs/documentation/fr/setup.md). Ce guide explique comment connecter GitBook, les étapes qui nécessitent l’intervention de la personne que vous aidez et la publication du site.

Pour confier la configuration à votre agent, collez-lui cette instruction :&#x20;

{% prompt description="Set up GitBook" %}

```markdown
Configure GitBook pour moi en suivant https://gitbook.com/docs/setup.md.
```

{% endprompt %}

Si vous suivez ce guide dans l’application GitBook, passez à l’étape suivante.
{% endstep %}

{% step %}

#### Créez votre compte

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

{% step %}

#### Créez votre premier site

1. Depuis la page **Accueil**, cliquez sur le bouton **+** à 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 voulez 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>Commencer à partir d’une mise en page de documentation prête à l’emploi avec des sections d’espace réservé — le moyen le plus rapide de voir un site complet fonctionner.</td></tr><tr><td><strong>Importer</strong></td><td>Intégrer du contenu existant provenant de documentation en ligne, de Markdown ou de HTML.</td></tr><tr><td><strong>OpenAPI</strong></td><td>Générer des documents de référence d’API interactifs à partir d’une spécification OpenAPI.</td></tr><tr><td><strong>Vide</strong></td><td>Commencer à partir d’une section vide et construire de zéro.</td></tr><tr><td><strong>Synchroniser avec Git</strong></td><td>Conserver 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 le parcours du modèle :

1. Cliquez sur **Modèle de documentation** et examinez 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 en mode 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 statut de publication, ainsi que les boutons <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>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 Docs : Accueil, Documentation, Référence de l’API, Journal des modifications et Centre d’aide. Utilisez les icônes de l’en-tête <strong>Contenu</strong> pour rechercher, renommer et ajouter des sections.</td></tr></tbody></table>

{% hint style="success" %}
Votre contenu n’est pas encore publié : vous pouvez donc modifier et personnaliser votre site de documentation, et en afficher un aperçu avant sa mise en ligne. Cliquez sur **Publier** pour le mettre immédiatement en ligne.

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

{% step %}

#### Modifiez votre contenu

Le modèle de documentation propose des sections provisoires dans la partie **Contenu** de la barre latérale. Cliquez sur une section pour l’ouvrir et afficher son contenu provisoire.

Dans GitBook, vous pouvez modifier et mettre à jour votre contenu de deux façons : avec notre éditeur visuel ou en suivant un flux de travail de documentation comme code. **Vous pouvez choisir l’une de ces méthodes ou les combiner.** Quel que soit le flux de travail choisi, vous modifierez votre contenu à l’aide d’un **flux de modification basé sur des branches**. Pour en savoir plus, consultez [la page Concepts](https://gitbook.com/docs/documentation/fr/reference/concepts.md).

{% tabs %}
{% tab title="Éditeur visuel" icon="hand-pointer" %}
L’éditeur WYSIWYG (ce que vous voyez est ce que vous obtenez) 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. Il est idéal si vous ne voulez pas travailler dans un éditeur de code, ou si vous êtes habitué à des outils comme Notion ou Google Docs.

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

1. Dans la section **Contenu** de la barre latérale, cliquez sur une section, par exemple Documentation, pour l’ouvrir.
2. Cliquez sur **Modifier** dans le coin supérieur droit. Une demande de modification s’ouvre ; vous pouvez alors modifier le contenu de la section.
3. Cliquez sur **Ajouter…** > **une page** dans la table des matières, à gauche.
4. Donnez un titre à votre nouvelle page.

**Prévisualisez vos modifications**

En haut de l’application Web, vous trouverez les onglets **Éditeur**, **Modifications**et **Aperçu**. Ils permettent de passer d’une vue à l’autre de votre contenu. Cliquez sur **Aperçu** pour voir à quoi ressemble votre site de documentation sur ordinateur et sur mobile, avec toutes les modifications de votre demande de modification.

**Fusionnez vos modifications**

Lorsque vos modifications vous conviennent, cliquez sur le bouton **Fusionner** dans le coin supérieur droit. La version principale de votre contenu est alors mise à jour avec toutes les modifications de la demande. Si le contenu fait partie d’un site de documentation en ligne, celui-ci est mis à jour immédiatement.
{% endtab %}

{% tab title="Git Sync" icon="robot" %}
Synchronisez votre documentation avec un dépôt GitHub ou GitLab pour activer l’édition basée sur le code dans votre environnement de développement existant. C’est idéal pour les utilisateurs techniques qui préfèrent gérer la documentation en parallèle de leur autre code.

**Configurer Git Sync**

1. Ouvrez la section que vous souhaitez synchroniser dans la partie **Contenu** de la barre latérale.
2. Cliquez sur le bouton **Configurer** de l’indicateur Git Sync dans la barre supérieure.
3. Suivez les instructions pour synchroniser la section avec le dépôt Git de votre choix. Consultez les [pages Git Sync](https://gitbook.com/docs/documentation/fr/docs-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 la [modification en Markdown](https://gitbook.com/docs/documentation/fr/creer-du-contenu/formatting/markdown.md), ce qui vous permet de créer et de 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 Markdown.
{% endhint %}

**Prévisualisez vos modifications**

Vous pouvez [prévisualiser vos modifications](https://gitbook.com/docs/documentation/fr/docs-as-code/git-sync/github-pull-request-preview.md) sur votre site de documentation publié, depuis la demande de fusion GitHub ou GitLab. Celle-ci affiche un état accompagné d’une URL d’aperçu unique. Cliquez sur **Détails** dans cet état pour l’ouvrir et voir à quoi ressemblera votre site une fois les modifications fusionnées.

**Fusionnez vos modifications**

Fusionnez votre pull request et vos mises à jour de contenu à 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 d’autres contenus à votre site — une référence d’API, un centre d’aide, un journal des modifications — et organisez la barre de navigation de votre site pour aider les visiteurs à trouver ce qu’ils cherchent. Consultez [Structure du site](https://gitbook.com/docs/documentation/fr/manage-your-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 sa création. Dans la section **Personnaliser**, vous pouvez définir votre propre [logo, vos couleurs et votre police](https://gitbook.com/docs/documentation/fr/manage-your-site/customization/icons-colors-and-themes.md), ajuster la mise en page et modifier la [visibilité de votre site](https://gitbook.com/docs/documentation/fr/manage-your-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 d’un clic à tout moment.

1. Ouvrez le site depuis la page d’accueil de votre organisation **Accueil**.
2. Cliquez sur **Publier** dans l’en-tête du site.

Une fois votre site en ligne, l’écran **Vue d’ensemble** affiche un lien vers le site en ligne.

{% hint style="success" %}
Vous souhaitez en savoir plus sur la publication ? Consultez [notre guide complet pour créer et publier du contenu dans GitBook](https://gitbook.com/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 %}

Même si cela convient à certaines équipes, beaucoup choisissent de remplacer leur URL par [un domaine personnalisé](https://gitbook.com/docs/documentation/fr/publish/custom-domain.md) ou [un sous-répertoire personnalisé](https://gitbook.com/docs/documentation/fr/publish/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 être prises en compte — bien qu’elles se propagent généralement beaucoup plus vite.
{% 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 de l’équipe à votre organisation et définissez les autorisations</td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-123daffcaaa78d9872cc99ad659478c6d97c6de3%2F25_12_10_invite_your_team_to_collaborate_1.png?alt=media">25_12_10_invite_your_team_to_collaborate_1.png</a></td><td><a href="https://gitbook.com/docs/documentation/fr/collaborate/member-management/invite-members-to-your-organization.md">Gérer ou supprimer des membres</a></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-fd07e38f01279522faf61b71c083505ccb41c051%2F25_12_10_invite_your_team_to_collaborate.png?alt=media">25_12_10_invite_your_team_to_collaborate.png</a></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-fd07e38f01279522faf61b71c083505ccb41c051%2F25_12_10_invite_your_team_to_collaborate.png?alt=media">25_12_10_invite_your_team_to_collaborate.png</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="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-f7064cff1c9aa2b8b21a496533e4257e2692a88f%2F25_12_10_change_site_visibility_1.png?alt=media">25_12_10_change_site_visibility_1.png</a></td><td><a href="https://gitbook.com/docs/documentation/fr/publish/publish-a-docs-site.md#publish-a-docs-site">Publier un site de documentation</a></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-a6cb2d0c9e0bfb53580801c20768eacac87459d9%2F25_12_10_change_site_visibility.png?alt=media">25_12_10_change_site_visibility.png</a></td><td></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-a6cb2d0c9e0bfb53580801c20768eacac87459d9%2F25_12_10_change_site_visibility.png?alt=media">25_12_10_change_site_visibility.png</a></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-a6cb2d0c9e0bfb53580801c20768eacac87459d9%2F25_12_10_change_site_visibility.png?alt=media">25_12_10_change_site_visibility.png</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="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-a1584c50b44ab46eec5ed3f0898eeffd2e6bc94d%2F25_12_10_add_auto_translations_1.png?alt=media">25_12_10_add_auto_translations_1.png</a></td><td><a href="https://gitbook.com/docs/documentation/fr/manage-your-site/site-settings.md">Paramètres du site</a></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-5f37c8f0398c9168c41f5c06b3957ae3df682c76%2F25_12_10_add_auto_translations.png?alt=media">25_12_10_add_auto_translations.png</a></td><td></td><td></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-5f37c8f0398c9168c41f5c06b3957ae3df682c76%2F25_12_10_add_auto_translations.png?alt=media">25_12_10_add_auto_translations.png</a></td><td></td></tr><tr><td><strong>Installer des intégrations</strong></td><td>Intégrez-vous à votre stack et étendez les fonctionnalités avec de puissantes intégrations</td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-86da4bb2cc94f3a9a1849fdcfbead0c75891e9c9%2F25_12_10_install_integrations_1.png?alt=media">25_12_10_install_integrations_1.png</a></td><td><a href="https://gitbook.com/docs/documentation/fr/manage-your-site/install-an-integration.md">Installer et gérer des intégrations</a></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-b20ed0ab68355cdbd6eb8f5d0eb08a67207b42a3%2F25_12_10_install_integrations.png?alt=media">25_12_10_install_integrations.png</a></td><td></td><td></td><td></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-b20ed0ab68355cdbd6eb8f5d0eb08a67207b42a3%2F25_12_10_install_integrations.png?alt=media">25_12_10_install_integrations.png</a></td></tr><tr><td><strong>Ajouter une référence API</strong></td><td>Créez des documents de référence API interactifs, mis à jour automatiquement, à partir d’une spécification API</td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-ac12806b3cbcd4be3a3758a21acf8d8109a02343%2F25_12_10_add_an_api_reference_1.png?alt=media">25_12_10_add_an_api_reference_1.png</a></td><td><a href="https://gitbook.com/docs/documentation/fr/creer-du-contenu/openapi.md">Documenter une API</a></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-165161ef7a07d68f272b9ba34596e895f704ee19%2F25_12_10_add_an_api_reference.png?alt=media">25_12_10_add_an_api_reference.png</a></td><td></td><td></td><td></td><td></td></tr><tr><td><strong>Suivre les analyses 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="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-b583de47e273a882ffa5ea4797456c3787018ee3%2F25_12_10_track_docs_analytics_1.png?alt=media">25_12_10_track_docs_analytics_1.png</a></td><td><a href="https://gitbook.com/docs/documentation/fr/analytics/insights.md">Statistiques du site</a></td><td><a href="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-a2e88c6a0eb12a917de55c439724c76a5ac9bbf0%2F25_12_10_track_docs_analytics.png?alt=media">25_12_10_track_docs_analytics.png</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 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/getting-started/quickstart.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.
