概述

本指南将引导您完成将现有 Docusaurus 1 站点迁移到 Docusaurus 2 的过程。

我们努力使此过程尽可能简单，并提供了一个迁移 CLI。

主要区别

Docusaurus 1 是一个纯文档站点生成器，使用 React 作为服务器端模板引擎，但在浏览器中不加载 React。

Docusaurus 2 从头开始重建，生成一个单页面应用程序，在浏览器中使用 React 的全部功能。它允许进行更多自定义，但保留了 Docusaurus 1 最好的部分——易于上手、版本化文档和国际化。

除此之外，Docusaurus 2 还是一个**高性能静态站点生成器**，可用于极快地创建常见的基于内容的网站（例如文档、博客、产品着陆页和营销页面等）。

虽然我们的主要关注点仍然是帮助您正确且完善地编写文档，但可以使用 Docusaurus 2 构建任何类型的网站，因为它只是一个 React 应用程序。**Docusaurus 现在可以用于构建任何网站，而不仅仅是文档网站。**

Docusaurus 1 结构

您的 Docusaurus 1 站点应具有以下结构

├── docs
└── website
    ├── blog
    ├── core
    │   └── Footer.js
    ├── package.json
    ├── pages
    ├── sidebars.json
    ├── siteConfig.js
    └── static

Docusaurus 2 结构

迁移后，您的 Docusaurus 2 站点可能如下所示

├── docs
└── website
    ├── blog
    ├── src
    │   ├── components
    │   ├── css
    │   └── pages
    ├── static
    ├── package.json
    ├── sidebars.json
    ├── docusaurus.config.js

信息

此迁移不会更改/docs文件夹的位置，但 Docusaurus v2 站点通常在/website内部具有/docs文件夹。

迁移到 v2 后，您可以将/docs文件夹放在任何您想要的位置。

迁移过程

要获得完全功能的 Docusaurus 2 网站，需要迁移多个方面。

• 包
• CLI 命令
• 站点配置
• Markdown 文件
• 侧边栏文件
• 页面、组件和 CSS
• 版本化文档
• 国际化支持 🚧

自动迁移过程

迁移 CLI 将为您处理许多迁移事项。

但是，某些部分不容易自动化，您需要回退到手动过程。

注意

我们建议运行迁移 CLI，并借助手动迁移过程完成缺少的部分。

手动迁移过程

某些迁移部分无法自动化（特别是页面），您需要手动迁移它们。

手动迁移指南 将为您提供所有手动步骤。

支持

如有任何疑问，您可以在 #migration-v1-to-v2 Discord 频道 中提问。

如果您希望我们查看，请随时在任何迁移 PR 中标记 @slorber 。

我们也有志愿者愿意 帮助您迁移 v1 站点 。

迁移 PR 示例

您可能希望参考我们针对 Create React App 和 Flux 的迁移 PR，作为基本 Docusaurus v1 站点迁移方式的示例。