Migrer vers Mintlify - Mintlify

Migrez votre documentation en utilisant le package @mintlify/scraping. Ce package extrait votre contenu et le convertit pour utiliser les composants Mintlify.

Plateformes prises en charge

Si votre documentation est hébergée sur une autre plateforme, consultez les étapes de migration manuelle.

Installation du scraper

Installez le package @mintlify/scraping pour commencer.

npm install @mintlify/scraping@latest -g

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 des sections plus petites progressivement plutôt que l’ensemble du site d’un seul coup.Migrer des sections entières :

mintlify-scrape section https://your-docs-site.com/docs

Migrer des pages individuelles :

mintlify-scrape page https://your-docs-site.com/docs/getting-started

Filtrer des chemins spécifiques :Utilisez l’option --filter (ou -f) pour extraire uniquement les URL correspondant à un préfixe de chemin spécifique.

mintlify-scrape section https://your-docs-site.com --filter=/docs

Le filtre correspond au chemin spécifié et à tous les chemins imbriqués. Par exemple, --filter=/docs correspond à /docs, /docs/getting-started, /docs/api/reference, etc.Vous pouvez également utiliser la commande CLI :

mint scrape site https://your-docs-site.com --filter=/docs

Migrer les spécifications OpenAPI :

mintlify-scrape openapi-file [openApiFilename]

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.Vérifiez que toutes vos pages ont bien été migrées, puis ajoutez ces fichiers au référentiel de documentation que vous avez créé lors de la configuration initiale. Il s’agit généralement d’un référentiel GitHub.

Migrez votre documentation depuis n’importe quelle plateforme en gardant un contrôle total sur le processus.

Migration du contenu

Pour migrer votre contenu vers Mintlify, vous aurez besoin de :

  • D’un docs.json valide pour les paramètres de votre site et la navigation. Voir Paramètres globaux et Navigation pour plus d’informations.
  • D’un fichier Markdown (.md ou .mdx) pour chaque page de votre documentation. MDX est le format recommandé. Voir Pages pour plus d’informations.
  • (Facultatif) D’une spécification OpenAPI pour les pages d’endpoints de votre API. Voir OpenAPI setup pour plus d’informations.
  1. Si votre contenu est déjà au format Markdown, copiez-le dans votre projet Mintlify. Sinon, convertissez votre contenu au format MDX.
  2. Créez votre docs.json en y faisant référence aux chemins vers vos pages Markdown.
  3. Si vous avez des spécifications OpenAPI, ajoutez-les à votre docs.json et configurez le bac à sable d’API.

Migration des ressources

  1. Copiez les ressources dans le répertoire images/ de votre référentiel.
  2. Mettez à jour les références dans vos fichiers Markdown : 
    ![Alt text](/images/screenshot.png)