メインコンテンツまでスキップ

サイトを翻訳する

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