メインコンテンツへスキップ

docusaurusを翻訳する

Docusaurusでi18nをどう構成するかの例は、Frenglishのドキュメントを参考にしてください。

それでは、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