文档版本管理

Docusaurus 支持为文档维护多个版本。

创建一个版本

发布 1.0 版本：

npm run docusaurus docs:version 1.0

命令会生成 versioned_docs/version-1.0 和 versions.json。

此时会出现两个版本：

• 1.0： http://localhost:3000/docs/
• current： http://localhost:3000/docs/next/（开发中的版本）

添加版本切换下拉框

在 docusaurus.config.js 中加入：

docusaurus.config.js

export default {
  themeConfig: {
    navbar: {
      items: [
        {
          type: 'docsVersionDropdown',
        },
      ],
    },
  },
};

更新指定版本

• versioned_docs/version-1.0/hello.md 对应 http://localhost:3000/docs/hello
• docs/hello.md 对应 http://localhost:3000/docs/next/hello