문서 버전 관리하기

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 업데이트