Aller au contenu principal
Version: Canary 🚧

Migration automatisée

Le CLI de migration migre automatiquement votre site web v1 vers un site web v2.

info

Un travail manuel est toujours nécessaire après avoir utilisé le CLI, car nous ne pouvons pas automatiser une migration complète

Le CLI de migration migre :

  • Site configurations (from siteConfig.js to docusaurus.config.js)
  • package.json
  • sidebars.json
  • /docs
  • /blog
  • /static
  • versioned_sidebar.json and /versioned_docs if your site uses versioning

Pour utiliser la CLI de migration, suivez ces étapes :

  1. Before using the migration CLI, ensure that /docs, /blog, /static, sidebars.json, siteConfig.js, package.json follow the structure shown at the start of this page.

  2. Pour migrer votre site web v1, exécutez le CLI de migration avec les chemins appropriés du système de fichiers :

# migration command format
npx @docusaurus/migrate migrate <v1 website directory> <desired v2 website directory>

# example
npx @docusaurus/migrate migrate ./v1-website ./v2-website
  1. Pour consulter votre nouveau site Web localement, allez dans le répertoire de votre site web v2 et démarrez votre serveur de développement.
cd ./v2-website
npm install
npm start
danger

Le CLI de migration met à jour les fichiers existants. Assurez-vous de les avoir d'abord « committés » !

Options

Vous pouvez ajouter des options à la CLI de migration pour migrer automatiquement le contenu du Markdown et les pages vers la v2. Il est probable que vous devrez encore apporter des modifications manuelles pour obtenir le résultat souhaité.

NomDescription
--mdxAjouter ce drapeau pour convertir automatiquement Markdown en MDX
--pageAjouter ce drapeau pour migrer automatiquement les pages
# exemple en utilisant les options
npx @docusaurus/migrate migrate --mdx --page ./v1-website ./v2-website
danger

La migration des pages et du MDX est toujours en chantier.

We recommend you to try to run the pages without these options, commit, and then try to run the migration again with the --page and --mdx options.

De cette façon, vous pourrez facilement inspecter et réparer les différences.