> For the complete documentation index, see [llms.txt](https://smedai.aivd.ch/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smedai.aivd.ch/applications/gitbook/commencer/demarrage-rapide.md). # Démarrage rapide Démarrez 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 étendu et personnalisé. {% stepper %} {% step %} **Premiers pas** Vous devez être invité par un administrateur pour pouvoir **éditer** du contenu. Après avoir accepté l’invitation, vous verrez le site de docs dans la barre latérale. Ouvrez-le pour accéder à l’espace et commencer à proposer des modifications. {% hint style="success" %} Votre contenu n’est pas encore publié — vous pouvez donc modifier, personnaliser et prévisualiser votre site de docs avant de le mettre en ligne. La mise en ligne est effectuée par l’équipe SIC. {% endhint %} {% endstep %} {% step %} **Modifiez votre contenu** Il existe deux manières d’éditer et de mettre à jour votre contenu dans GitBook — dans notre éditeur visuel, ou en suivant un flux de travail docs-as-code. **Vous pouvez en choisir une, ou utiliser une combinaison des deux**. Quelle que soit la méthode que vous préférez, vous modifierez votre contenu en utilisant un **flux d’édition basé sur des branches**. En savoir plus sur [la page Concepts](/applications/gitbook/commencer/concepts.md).
Utiliser l’éditeur visuel L’éditeur WYSIWYG (ce que vous voyez est ce que vous obtenez) de GitBook vous permet d’éditer le contenu visuellement, de faire glisser des blocs de contenu pour les réorganiser et de voir à quoi ressemblera votre contenu pendant que vous travaillez. Ce flux de travail d’édition visuelle est idéal pour les utilisateurs qui ne veulent pas travailler dans un éditeur de code, ou qui ont de l’expérience avec des outils comme Notion ou Google Docs. **1. Modifiez vos docs dans une demande de changement** Tout d’abord, trouvez votre site de docs dans la barre latérale et cliquez sur l’élément en dessous. Cela vous conduit à l’espace où vit votre contenu. Sélectionnez **Modifier** en haut à droite. Cela ouvre une demande de changement où vous pouvez modifier le contenu de l’espace. Sélectionnez **Ajouter…** dans la table des matières à gauche, puis ajoutez une page et donnez-lui un titre.
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.
**2. Prévisualisez vos modifications** En haut de l’application web, vous verrez des onglets pour **Éditeur**, **Modifications** et **Aperçu**. Ceux-ci basculent entre différentes vues de votre contenu. Cliquez **Aperçu** pour voir un aperçu en direct de l’apparence de votre site de docs avec toutes les modifications de votre demande de changement, sur ordinateur et mobile.
A screenshot of the GitBook app with the Preview tab open, showing a docs site being previewed on a mobile-size display
**3. Fusionnez vos modifications** Une fois vos modifications terminées, sélectionnez le bouton **Fusionner** en haut à droite. Cela mettra à jour la version principale de votre contenu avec toutes les modifications de la demande de changement. Si le contenu fait partie d’un site de docs en ligne, le site sera mis à jour immédiatement.
Édition basée sur le code Synchronisez votre documentation avec un dépôt GitHub ou GitLab pour activer l’édition basée sur le code. Une fois synchronisé, vous pouvez modifier vos docs dans votre environnement de développement existant. Ce flux de travail est idéal pour les utilisateurs techniques qui ne veulent pas changer d’outils et préfèrent gérer leur documentation aux côtés du reste du code. **1. Configurez la synchronisation Git** Si vous n’avez pas déjà configuré la synchronisation Git lors de la création de votre site, trouvez d’abord votre site de docs dans la barre latérale et cliquez sur le nom du contenu en dessous. Cela vous conduit à l’espace où vit votre contenu. Sélectionnez le bouton **Configurer la synchronisation Git** en haut à droite, puis suivez les instructions pour synchroniser votre espace avec le dépôt Git choisi. Rendez-vous sur les [pages de synchronisation Git](https://gitbook.com/docs/documentation/fr/getting-started/git-sync) pour en savoir plus. **2. Modifiez vos docs depuis votre environnement de développement** Une fois que vous avez synchronisé votre espace avec votre dépôt Git, vous pouvez mettre à jour le contenu de vos docs depuis ce dépôt dans votre environnement de développement. Ouvrez le dépôt, créez une pull request et effectuez les modifications souhaitées. {% hint style="info" %} #### Édition Markdown GitBook prend en charge [Édition Markdown](https://gitbook.com/docs/documentation/fr/creating-content/formatting/markdown), vous permettant de créer et de formater du contenu en utilisant une syntaxe courante. Chaque bloc standard dans GitBook peut être écrit et formaté en utilisant la syntaxe Markdown. {% endhint %} **3. Prévisualisez vos modifications** Vous pouvez [prévisualiser vos modifications](https://gitbook.com/docs/documentation/fr/getting-started/git-sync/github-pull-request-preview) sur votre site de docs publié depuis la pull request dans GitHub ou GitLab. Dans votre pull request, vous verrez un statut avec une URL d’aperçu unique. Cliquez sur **Détails** sur ce statut pour ouvrir l’URL d’aperçu et voir à quoi ressemblera votre site lorsque la pull request sera fusionnée et que votre site sera mis à jour. **4. Fusionnez vos modifications** Vous êtes prêt. Fusionnez votre pull request et votre contenu sera mis à jour à la fois dans l’application GitBook et sur votre site de docs, s’il est en ligne. Dans l’application GitBook, chaque commit et votre pull request fusionnée seront synchronisés dans votre espace comme des mises à jour dans l’historique des versions.
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.
{% endstep %} {% step %} **Personnalisez vos docs**
Organisez la navigation de votre site Vous pouvez ajouter plus de contenu à votre site — comme une référence d’API, un centre d’aide ou un journal des modifications — à tout moment. Lorsque vous ajoutez du contenu, vous pouvez organiser la barre de navigation de votre site pour aider les utilisateurs à trouver facilement ce qu’ils recherchent. Rendez-vous sur [la page Concepts](/applications/gitbook/commencer/concepts.md) pour en savoir plus sur la navigation du site. Rendez-vous sur [la page Structure du site](https://gitbook.com/docs/documentation/fr/publishing-documentation/site-structure) pour en savoir plus sur l’ajout de contenu à votre site.
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
Personnalisez l’apparence de votre site de docs Votre site de docs aura fière allure dès le départ, mais vous pouvez aussi personnaliser de nombreux paramètres qui modifient l’apparence et la convivialité de votre site publié. Vous pouvez personnaliser le [logo, les couleurs et la police](https://gitbook.com/docs/documentation/fr/publishing-documentation/customization/icons-colors-and-themes), ajouter à la barre de navigation de votre site en utilisant [sections du site](https://gitbook.com/docs/documentation/fr/publishing-documentation/site-structure/site-sections) et [variantes](https://gitbook.com/docs/documentation/fr/publishing-documentation/site-structure/variants), mettre à jour la [visibilité du site](https://gitbook.com/docs/documentation/fr/publishing-documentation/site-settings#audience) les paramètres et bien plus.
An illustration showing five docs sites hosted in GitBook, each with distinct visual customizations
{% endstep %} {% step %} **Publiez votre documentation**
Publiez vos docs La publication du site est réalisée par l’équipe SIC. Quand votre contenu est prêt, demandez la mise en ligne à l’équipe SIC. L’équipe publiera ensuite la version principale.
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.
{% hint style="success" %} Vous voulez explorer la publication plus en détail ? Consultez [notre guide complet sur la création et la publication de contenu dans GitBook](https://gitbook.com/docs/guides/editing-and-publishing-documentation/complete-guide-to-publishing-docs-gitbook). {% endhint %}
Ajouter un domaine personnalisé Par défaut, votre site sera publié avec une URL unique au format suivant : ``` https://[organization-name].gitbook.io/[site-title] ``` Bien que cela puisse convenir à certaines équipes, beaucoup choisissent de changer leur URL en [un domaine personnalisé](https://gitbook.com/docs/documentation/fr/publishing-documentation/custom-domain) ou [un sous-répertoire personnalisé](https://gitbook.com/docs/documentation/fr/publishing-documentation/setting-a-custom-subdirectory). 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**.
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.
Utilisez les boutons à l’écran pour choisir l’option souhaitée et suivez les instructions pour configurer les paramètres DNS auprès de votre fournisseur de domaine. {% hint style="info" %} La propagation des modifications DNS peut prendre jusqu’à 48 heures — bien qu’elles se propagent généralement beaucoup plus rapidement. {% endhint %}
{% endstep %} {% endstepper %} ### Étapes suivantes (en construction)
Image de couvertureImage de couverture (sombre)Image de couverture (sombre)Image de couverture (sombre)Image de couverture (sombre)Image de couverture (sombre)
Invitez votre équipe à collaborerAjoutez des membres à votre organisation et définissez des autorisationsInvite your team to collaborate.pngBroken linkInvite your team to collaborate (1).pngInvite your team to collaborate (1).png
Modifier la visibilité du siteContrôlez qui peut voir votre contenu avec des liens de partage et un accès authentifiéChange site visibility.pngBroken linkChange site visibility (1).pngChange site visibility (1).pngChange site visibility (1).png
Ajouter des traductions automatiquesCréez des traductions en un clic qui se mettent à jour automatiquementAdd auto translations.pngBroken linkAdd auto translations (1).pngAdd auto translations (1).png
Installer des intégrationsIntégrez à votre stack et étendez les fonctionnalités avec des intégrations puissantesInstall integrations.pngBroken linkInstall integrations (1).pngInstall integrations (1).png
Ajouter une référence d’APICréez des documents de référence d’API interactifs et auto-mise-à-jour à partir d’une spécification d’APIAdd an API reference.pngBroken linkAdd an API reference (1).png
Suivre les analyses des docsUtilisez les insights intégrés pour mesurer le succès et comprendre le comportement des utilisateursTrack docs analytics.pngBroken linkTrack docs analytics (1).png
### FAQ
Qu’est-ce que GitBook ? GitBook est une plateforme de documentation collaborative, native IA, où les équipes peuvent créer, relire et publier des docs de marque sous forme de sites web. Les sites de docs hébergés sur GitBook peuvent proposer un assistant IA intégré et se connecter à d’autres outils IA via MCP. Vous pouvez modifier le contenu en utilisant l’éditeur visuel avancé avec prise en charge de Markdown, synchroniser vos docs avec un dépôt Git pour un flux de travail docs-as-code — ou utiliser une combinaison des deux. Quelle que soit la manière dont votre équipe choisit d’utiliser GitBook, vous utiliserez un flux de travail de branchement semblable à Git avec un historique complet des versions, ce qui protège votre contenu principal tout en encourageant la collaboration et les retours au sein de toute votre équipe.
Comment publiez-vous de la documentation avec GitBook ? Dans notre contexte, la mise en ligne est effectuée par l’équipe SIC une fois le contenu validé. De façon générale, 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 docs (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 réglage **public** ou limiter l’audience avec **liens de partage** ou **accès authentifié**. 3. (Optionnel) Personnalisez l’image de marque, le domaine et le thème en utilisant les options intégrées. 4. Cliquez **Publier**. Félicitations — vos docs sont en ligne ! Vous pouvez 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](https://gitbook.com/docs/guides/editing-and-publishing-documentation/complete-guide-to-publishing-docs-gitbook).
GitBook est-il open source ? GitBook lui‑même n’est pas open source. Cependant, la plateforme de docs publiée de GitBook — qui est utilisée pour héberger et afficher la documentation sur un site de docs — 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 leur documentation sur GitBook gratuitement**. Les équipes peuvent s’inscrire au [plan Communauté](https://gitbook.com/docs/documentation/fr/gestion-du-compte/plans/community) et publier du contenu en utilisant [un plan de site sponsorisé](https://gitbook.com/docs/documentation/fr/gestion-du-compte/plans/community/sponsored-site-plan), qui sont tous deux gratuits pour les équipes éligibles.
Quelle est la différence entre un site et un espace dans GitBook ? Dans GitBook, un **site de docs** est votre hub 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, organisant le contenu lié pour une meilleure modularité et une gestion facilitée. Les espaces vous permettent de concentrer la collaboration sur des sujets spécifiques, et vous pouvez combiner plusieurs espaces sur un même site pour structurer le contenu ou activer des options comme les traductions (pour la documentation localisée) ou la prise en charge multi-produits.
Quelles sont les différences entre l’éditeur visuel de GitBook et la synchronisation Git ? GitBook propose deux méthodes principales pour éditer la documentation — l’éditeur visuel et la synchronisation Git. 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 en utilisant 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 manipuler directement le code. **La synchronisation Git** intègre votre flux de travail de documentation avec 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 aux côtés de leur base de code, en utilisant des commandes et des flux de travail Git familiers. Votre équipe peut choisir l’un de ces flux de travail, ou utiliser une combinaison des deux. Et quelle que soit la méthode choisie, l’édition suit un flux de travail de branchement cohérent, semblable à Git, avec un historique complet des versions et un processus de relecture du contenu. Cela ne favorise pas seulement la collaboration et la qualité de vos docs — cela protège également le contenu principal contre les modifications accidentelles.
--- # 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://smedai.aivd.ch/applications/gitbook/commencer/demarrage-rapide.md?ask=&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.