サイトを翻訳する

docs/intro.mdをフランス語にしてみましょう

i18nを構成する

docusaurus.config.jsを編集してfrロケールをサポートするようにします:

docusaurus.config.js

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

ドキュメントの翻訳

docs/intro.mdファイルをi18n/frフォルダにコピーします:

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

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

i18n/fr/docusaurus-plugin-content-docs/current/intro.mdをフランス語に翻訳します。

ローカライズされたサイトを開始する

フランス語のロケールでサイトを開始します:

npm run start -- --locale fr

ローカライズされたサイトは http://localhost:3000/fr/ でアクセスでき、Getting Startedページが翻訳されています。

注意

開発中は、一度に1つのロケールしか使用できません。

ロケールのドロップダウンを追加する

言語をシームレスに切り替えるために、ロケールのドロップダウンを追加します。

docusaurus.config.jsファイルを修正します:

docusaurus.config.js

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

ロケールのドロップダウンがナビゲーションバーに表示されます:

ローカライズされたサイトをビルドする

特定のロケール向けにサイトをビルドします:

npm run build -- --locale fr

または、すべてのロケールを含むサイトを一度にビルドします:

npm run build