跳至主要内容

管理文档版本

Docusaurus 可以管理多个版本的文档。

创建文档版本​

发布项目 1.0 版本

npm run docusaurus docs:version 1.0

docs 文件夹被复制到 versioned_docs/version-1.0 中，并创建了 versions.json。

您的文档现在有两个版本

  • 1.0 在 http://localhost:3000/docs/ 中，用于 1.0 版本的文档
  • current 在 http://localhost:3000/docs/next/ 中，用于 **即将发布的未发布文档**

添加版本下拉菜单​

为了在不同版本之间无缝导航，请添加一个版本下拉菜单。

修改 docusaurus.config.js 文件

docusaurus.config.js
export default {
  themeConfig: {
    navbar: {
      items: [
        {
          type: 'docsVersionDropdown',
        },
      ],
    },
  },
};

文档版本下拉菜单将显示在您的导航栏中

Docs Version Dropdown

更新现有版本​

可以在各自的文件夹中编辑已版本化的文档

  • versioned_docs/version-1.0/hello.md 更新 http://localhost:3000/docs/hello
  • docs/hello.md 更新 http://localhost:3000/docs/next/hello