Migration automatisée
Le CLI de migration migre automatiquement votre site web v1 vers un site web v2.
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
todocusaurus.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 :
-
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. -
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
- 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.
- npm
- Yarn
- pnpm
cd ./v2-website
npm install
npm start
cd ./v2-website
yarn install
yarn start
cd ./v2-website
pnpm install
pnpm start
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é.
Nom | Description |
---|---|
--mdx | Ajouter ce drapeau pour convertir automatiquement Markdown en MDX |
--page | Ajouter ce drapeau pour migrer automatiquement les pages |
# exemple en utilisant les options
npx @docusaurus/migrate migrate --mdx --page ./v1-website ./v2-website
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.