Chuyển tới nội dung chính

Quản lý Phiên bản Tài liệu

Docusaurus có thể quản lý nhiều phiên bản tài liệu của bạn.

Tạo một phiên bản tài liệu​

Phát hành phiên bản 1.0 cho dự án của bạn:

npm run docusaurus docs:version 1.0

Thư mục docs được sao chép vào versioned_docs/version-1.0 và versions.json được tạo.

Tài liệu của bạn hiện có 2 phiên bản:

  • 1.0 tại http://localhost:3000/docs/ cho tài liệu phiên bản 1.0
  • current tại http://localhost:3000/docs/next/ cho tài liệu sắp tới, chưa được phát hành

Thêm Menu thả xuống Phiên bản​

Để điều hướng liền mạch giữa các phiên bản, hãy thêm menu thả xuống phiên bản.

Sửa đổi tệp docusaurus.config.js:

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

Menu thả xuống phiên bản tài liệu sẽ xuất hiện trong thanh điều hướng của bạn:

Menu thả xuống phiên bản tài liệu

Cập nhật một phiên bản hiện có​

Bạn có thể chỉnh sửa các tài liệu đã phân phiên bản trong thư mục tương ứng của chúng:

  • versioned_docs/version-1.0/hello.md cập nhật http://localhost:3000/docs/hello
  • docs/hello.md cập nhật http://localhost:3000/docs/next/hello