Migrer vers GitBook

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

Vous pouvez migrer et unifier la documentation existante dans GitBook en utilisant l’outil d’importation.

Vous avez la possibilité d’importer une ou plusieurs pages en utilisant notre outil d’import intégré — ou un dépôt Git entier en utilisant Git Sync.

Utilisation du 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’occupera du reste.

Par défaut, GitBook utilise l’IA pour simplifier le processus d’importation. Cela raffinera 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 utilisera 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 aux formats suivants :

• Markdown (.md ou .markdown)

• HTML (.html)

• Microsoft Word (.docx)

GitBook prend également en charge les importations depuis :

• Confluence

• Notion

• Wiki GitHub

• Quip

• Dropbox Paper

• Google Docs

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

GitBook est basé sur Markdown, donc l’importation de contenu au format Markdown donnera les meilleurs résultats. Si vos outils actuels permettent d’exporter en Markdown, nous 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 un nouvel espace, vous aurez la possibilité d’importer du contenu dans la fenêtre modale qui s’affiche. Si vous créez un espace vide, vous pouvez également importer en utilisant le Démarrage rapide section en bas de la nouvelle page vide lorsque vous cliquez Modifier.

Alternativement, vous pouvez toujours importer une page ou une sous-page en sélectionnant Ajouter > Importer des pages en bas du table des matières, ou en ouvrant le menu Actions pour 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 depuis diverses sources, mais des différences dans les fonctionnalités du produit et les formats de documents peuvent entraîner des variations dans le contenu importé par rapport à la source d’origine.

Limitations

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

• Le nombre maximum de pages qui peut être téléversé lors d’un seul import est 20.

• Le nombre maximum de fichiers (images, etc.) qui peut être téléversé lors d’un seul import est 20.

---

Importer depuis un dépôt GitHub ou GitLab en utilisant Git Sync

Lors de l’importation de grands volumes de contenu dans GitBook, nous recommandons d’utiliser Synchronisation Git. Bien que notre outil de migration intégré puisse gérer la plupart des importations, Git Sync est mieux adapté pour gérer des migrations plus importantes de manière efficace.

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

1

Convertissez 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 permettent d’exporter en Markdown, nous recommandons d’utiliser ce format pour un processus d’importation plus fluide.

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

2

Organisez votre contenu dans GitHub ou GitLab

Lors de la configuration de votre site GitBook, il est crucial d’organiser efficacement votre contenu dans votre dépôt GitHub ou GitLab. Étant donné que Git Sync se fait au niveau de l’espace, planifiez soigneusement la manière de regrouper votre contenu. Créez plusieurs dépôts ou dossiers, en vous assurant que les fichiers Markdown nécessaires sont aux bons emplacements.

3

Créez des espaces et configurez Git Sync

Pour organiser votre contenu, créez un ou plusieurs espaces dans GitBook selon vos besoins. Installez les GitHub Sync ou Intégrations GitLab Sync dans votre organisation et configurez‑les pour ces espaces. Vous devrez synchroniser votre espace avec le dossier ou le dépôt que vous avez configuré à l’étape précédente.

4

Exécutez Git Sync dans la direction GitHub → GitBook

Lors du suivi du processus de configuration, assurez‑vous de sélectionner la direction GitHub → GitBook. Cela entraînera l’importation du contenu de votre dossier ou dépôt depuis GitHub ou GitLab vers GitBook.