自动迁移

迁移 CLI 可以自动将您的 v1 网站迁移到 v2 网站。

信息

使用迁移 CLI 后仍然需要手动工作，因为我们无法完全自动化迁移

迁移 CLI 迁移：

• 站点配置（从 siteConfig.js 到 docusaurus.config.js）
• package.json
• sidebars.json
• /docs
• /blog
• /static
• versioned_sidebar.json 和 /versioned_docs（如果您的站点使用版本控制）

要使用迁移 CLI，请按照以下步骤操作：

1. 在使用迁移 CLI 之前，请确保 /docs、/blog、/static、sidebars.json、siteConfig.js、package.json 遵循预期的结构。

2. 要迁移您的 v1 网站，请使用适当的文件系统路径运行迁移 CLI：

# 迁移命令格式
npx @docusaurus/migrate migrate <v1 网站目录> <期望的 v2 网站目录>

# 示例
npx @docusaurus/migrate migrate ./v1-website ./v2-website

3. 要在本地查看您的新网站，请进入 v2 网站目录并启动开发服务器。

npm

cd ./v2-website
npm install
npm start

Yarn

cd ./v2-website
yarn install
yarn start

pnpm

cd ./v2-website
pnpm install
pnpm start

Bun

cd ./v2-website
bun install
bun start

危险

迁移 CLI 会更新现有文件。请确保已提交它们！

选项

您可以为迁移 CLI 添加选项标志，以自动将 Markdown 内容和页面迁移到 v2。很可能您仍需要进行一些手动更改以获得理想的结果。

名称	描述
--mdx	添加此标志以自动将 Markdown 转换为 MDX
--page	添加此标志以自动迁移页面

# 使用选项的示例
npx @docusaurus/migrate migrate --mdx --page ./v1-website ./v2-website

危险

页面和 MDX 的迁移仍在进行中。

我们建议您尝试在不使用这些选项的情况下运行页面，提交，然后再尝试使用 --page 和 --mdx 选项运行迁移。

这样，您可以轻松检查和修复差异。