Migrer la documentation vers Mintlify depuis un export ZIP

Mintlify n’a pas de fonctionnalité directe d’« import ZIP ». Mintlify construit votre site à partir des fichiers d’un dépôt Git, donc migrer depuis un export ZIP consiste à convertir les fichiers exportés en pages Markdown ou MDX dans votre dépôt de documentation. Le bon chemin dépend de la plateforme qui a produit le ZIP.

Suivez le guide de migration Document360 dédié. Il explique comment exporter chaque espace de travail et chaque langue sous forme de ZIP de projet, puis convertir les articles, catégories, médias et contenus réutilisables.

Suivez le guide de migration ReadMe dédié. Il couvre la structure d’un export ZIP ReadMe, y compris les guides, recettes, pages personnalisées et fichiers OpenAPI. Notez que les exports ZIP de ReadMe référencent les images hébergées par URL au lieu d’inclure les fichiers d’images, donc téléchargez ces ressources séparément.

Utilisez le flux de migration manuelle :

1. Décompressez l’export et conservez le ZIP d’origine inchangé comme instantané source. Effectuez le travail de conversion dans une copie.
2. Créez un inventaire des pages avec la source, le chemin de destination et le statut de migration de chaque page.
3. Convertissez le contenu exporté en Markdown, HTML ou JSON en pages MDX.
4. Recréez votre navigation dans docs.json et vérifiez les pages pour repérer la syntaxe résiduelle de la plateforme source.

Si le site source est aussi accessible publiquement, le scraping peut être plus rapide que la conversion des fichiers exportés. Consultez Convertir des pages individuelles.

Si vous cherchez la direction inverse, une archive ZIP de votre documentation Mintlify publiée pour une consultation hors ligne ou une diffusion privée, utilisez mint export. Consultez Export hors ligne. Les exportations hors ligne nécessitent une offre Enterprise.