Migrer vers GitBook

Comment importer du contenu existant dans GitBook depuis Confluence, Notion, Git et plus encore

Vous pouvez migrer et unifier la documentation existante dans GitBook à l’aide de l’outil d’importation.

Vous avez la possibilité d’importer une ou plusieurs pages à l’aide de notre outil d’importation intégré — ou l’intégralité d’un dépôt Git à l’aide de Git Sync.

Utiliser le panneau d’importation

Le panneau d’importation facilite la migration de votre contenu vers votre organisation GitBook depuis un autre site de documentation ou depuis des fichiers existants.

Lorsque vous choisissez d’importer depuis un autre site de documentation en ligne, il vous suffit d’ajouter l’URL du site et GitBook s’occupe du reste.

Par défaut, GitBook utilise l’IA pour simplifier le processus d’importation. Elle affinera et nettoiera intelligemment le contenu importé qui ne correspond pas parfaitement aux formats de GitBook — ce qui signifie que le résultat sera plus soigné et exploitera plus efficacement les blocs de GitBook. Vous pouvez désactiver cela depuis le menu.

Formats d’importation pris en charge

GitBook prend en charge les importations depuis des sites de documentation ou des fichiers dans les formats suivants :

• Markdown (.md ou .markdown)
• HTML (.html)
• Microsoft Word (.docx)

GitBook prend également en charge les importations depuis :

• Confluence
• Notion
• GitHub Wiki
• Quip
• Dropbox Paper
• Google Docs

Si vous souhaitez importer plusieurs pages, vous pouvez téléverser un fichier ZIP contenant des fichiers HTML ou Markdown, ou utiliser l’option Docs en ligne d’importation.

GitBook est basé sur Markdown, donc l’importation de contenu au format Markdown donnera les meilleurs résultats. Si vos outils actuels prennent en charge l’exportation en Markdown, nous vous recommandons d’utiliser ce format pour un processus d’importation plus fluide.

Le panneau d’importation

Le panneau d’importation dans GitBook.

Lorsque vous créez une nouvelle section, vous aurez la possibilité d’importer du contenu dans la fenêtre modale qui apparaît. Si vous créez une section vide, vous pouvez également importer à l’aide de la Quickstart section en bas de la nouvelle page vide lorsque vous cliquez sur Modifier.

Sinon, vous pouvez toujours importer une page ou une sous-page en sélectionnant Ajouter > Importer des pages en bas de la table des matières, ou en ouvrant le menu Actions d’une page et en choisissant Importer des sous-pages.

Après avoir choisi une source d’entrée, vous pouvez sélectionner le fichier que vous souhaitez importer.

GitBook importe du contenu provenant de diverses sources, mais les différences entre les fonctionnalités du produit et les formats de document peuvent entraîner des variations du contenu importé par rapport à la source originale.

Limites

GitBook impose actuellement les limites suivantes pour le contenu importé :

• Le nombre maximal de pages pouvant être téléversées lors d’une seule importation est 20.
• Le nombre maximal de fichiers (images etc.) pouvant être téléversés lors d’une seule importation est 20.

GitBook ne peut pas augmenter ces limites d’importation. Pour importer davantage de contenu en une seule fois, utilisez Git Sync, qui prend en charge jusqu’à 5 000 pages Markdown.

---

Importer depuis un dépôt GitHub ou GitLab à l’aide de Git Sync

Lorsque vous importez de grands volumes de contenu dans GitBook, nous vous recommandons d’utiliser Git Sync. Bien que notre outil de migration intégré puisse gérer la plupart des importations, Git Sync est mieux adapté pour gérer efficacement les migrations plus volumineuses.

Vous trouverez ci-dessous les étapes essentielles pour importer votre contenu. Pour des étapes plus détaillées et une démonstration vidéo, consultez notre guide dédié sur l’importation de contenu dans GitBook à l’aide de Git Sync.

1

Convertir votre contenu en Markdown

GitBook est basé sur Markdown, donc l’importation de contenu au format Markdown donnera les meilleurs résultats. Si vos outils actuels prennent en charge l’exportation en Markdown, nous vous recommandons d’utiliser ce format pour un processus d’importation plus fluide.

Si votre contenu n’est pas déjà dans des fichiers Markdown, nous vous recommandons d’utiliser un script (comme Markitdown) ou un outil en ligne pour convertir votre contenu.

2

Organiser votre contenu dans GitHub ou GitLab

Lors de la configuration de votre site GitBook, il est essentiel d’organiser efficacement votre contenu dans votre dépôt GitHub ou GitLab. Comme Git Sync s’effectue au niveau de la section, planifiez soigneusement la manière de regrouper votre contenu. Créez plusieurs dépôts ou dossiers, en veillant à ce que les fichiers Markdown nécessaires se trouvent aux bons emplacements.

3

Configurer les sections et Git Sync

Pour organiser votre contenu, créez une ou plusieurs sections dans GitBook selon vos besoins. Installez les intégrations GitHub Sync ou GitLab Sync dans votre organisation et configurez-les pour ces sections. Vous devrez synchroniser votre section avec le dossier ou le dépôt configuré à l’étape précédente.

4

Lancer Git Sync dans la direction GitHub → GitBook

Lors du processus de configuration, veillez à sélectionner la direction GitHub → GitBook. Cela permettra de transférer le contenu de votre dossier ou dépôt depuis GitHub ou GitLab vers GitBook.

Exporter votre contenu

Vous pouvez exporter votre contenu GitBook de deux façons :

• Au format Markdown, en synchronisant avec un dépôt Git. Il n’existe pas d’exportation Markdown directe dans l’application — synchronisez la section que vous souhaitez exporter avec un dépôt GitHub ou GitLab vide à l’aide de Git Sync, et le dépôt devient votre export Markdown. Certains blocs n’ont pas de représentation Markdown et apparaissent en HTML dans l’export.
• Au format PDF, depuis le menu Actions de la page ou de la section. Voir Exportation PDF. Vous pouvez atteindre des limites lors de l’exportation de sections très volumineuses.