Choisissez votre méthode de migration
Migration automatisée
Si vous passez de Docusaurus, ReadMe ou GitBook à Mintlify, utilisez nos outils pour automatiser la migration.
Migration manuelle
Si vous venez d’une autre plateforme, suivez notre guide pour migrer votre contenu.
- Migration automatisée
- Migration manuelle
Migrez votre documentation en utilisant le package @mintlify/scraping. Ce package extrait votre contenu et le convertit pour utiliser les composants Mintlify.Si votre documentation est hébergée sur une autre plateforme, consultez les étapes de migration manuelle.Migrer des pages individuelles :Migrer les spécifications OpenAPI :
Plateformes prises en charge
Docusaurus
ReadMe
GitBook (bêta)
Installation du scraper
Installez le package@mintlify/scraping pour commencer.Extraction de pages et de sections
L’outil de migration détecte automatiquement votre plateforme de documentation et convertit votre contenu. Les fichiers préparés sont stockés localement dans./docs par défaut.Pour les sites de documentation volumineux, migrez de petites sections à la fois plutôt que l’ensemble du site en une seule fois.Migrer des sections entières :Ajouter le contenu préparé à votre projet Mintlify
Après avoir extrait le contenu de votre plateforme de documentation existante, vous êtes prêt à créer votre documentation sur Mintlify.Confirmez que toutes vos pages ont été migrées, puis ajoutez ces fichiers au référentiel de documentation que vous avez créé lors du processus d’intégration. Il s’agit généralement d’un référentiel GitHub.Liste de contrôle post‑migration
- Toutes les pages s’affichent
- La navigation fonctionne comme prévu
- Les liens internes pointent correctement
- Les images et les ressources se chargent correctement
- Les code blocks s’affichent avec une coloration syntaxique appropriée
- La recherche fonctionne
- Le déploiement est configuré
- Le domaine personnalisé est configuré