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

サイトを翻訳する

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