사이트 번역하기

docs/intro.md를 한국어로 번역해 봅시다.

i18n 구성하기

docusaurus.config.js를 수정하여 ko 로케일 지원을 추가합니다.

docusaurus.config.js

export default {
  i18n: {
    defaultLocale: 'en',
    locales: ['en', 'ko'],
  },
};

문서 번역하기

docs/intro.md 파일을 i18n/ko 폴더로 복사합니다.

mkdir -p i18n/ko/docusaurus-plugin-content-docs/current/

cp docs/intro.md i18n/ko/docusaurus-plugin-content-docs/current/intro.md

i18n/ko/docusaurus-plugin-content-docs/current/intro.md를 한국어로 번역합니다.

로컬라이즈된 사이트 시작하기

한국어 로케일로 사이트를 시작합니다.

npm run start -- --locale ko

로컬라이즈된 사이트는 http://localhost:3000/ko/에서 접속 가능하며 시작하기 페이지가 번역된 것을 볼 수 있습니다.

주의

개발 모드에서는 한 번에 하나의 로케일만 사용할 수 있습니다.

로케일 드롭다운 추가하기

언어 간을 원활하게 탐색하려면 로케일 드롭다운을 추가하세요.

docusaurus.config.js 파일을 수정합니다.

docusaurus.config.js

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

이제 내비게이션 바에 로케일 드롭다운이 나타납니다.

로컬라이즈된 사이트 빌드하기

특정 로케일을 위해 사이트를 빌드합니다.

npm run build -- --locale ko

또는 모든 로케일을 한 번에 포함하여 사이트를 빌드합니다.

npm run build