문서 버전 관리

Docusaurus는 문서의 여러 버전을 관리할 수 있습니다.

문서 버전 만들기

프로젝트의 1.0 버전을 출시합니다.

npm run docusaurus docs:version 1.0

docs 폴더가 versioned_docs/version-1.0으로 복사되고 versions.json이 생성됩니다.

이제 문서는 2개의 버전을 갖게 됩니다.

• 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',
        },
      ],
    },
  },
};

내비게이션 바에 문서 버전 드롭다운이 나타납니다.

기존 버전 업데이트하기

각 폴더에서 버전 관리되는 문서를 수정할 수 있습니다.

• versioned_docs/version-1.0/hello.md를 수정하면 http://localhost:3000/docs/hello가 업데이트됩니다.
• docs/hello.md를 수정하면 http://localhost:3000/docs/next/hello가 업데이트됩니다.