diff options
| author | shu <nvcsadjkojf@outlook.com> | 2026-09-05 21:00:25 +0800 |
|---|---|---|
| committer | shu <nvcsadjkojf@outlook.com> | 2026-09-05 21:00:25 +0800 |
| commit | 7295f4e7408934a1cabc915256ea476a930c4a65 (patch) | |
| tree | 542816243742c71b2f0b5ea1fd359896538c81ec /docs/tutorial-extras/translate-your-site.mdx | |
| parent | efb449041e030c8d9ec06a4f4cfbf5554c868a93 (diff) | |
Diffstat (limited to 'docs/tutorial-extras/translate-your-site.mdx')
| -rw-r--r-- | docs/tutorial-extras/translate-your-site.mdx | 88 |
1 files changed, 0 insertions, 88 deletions
diff --git a/docs/tutorial-extras/translate-your-site.mdx b/docs/tutorial-extras/translate-your-site.mdx deleted file mode 100644 index b5a644a..0000000 --- a/docs/tutorial-extras/translate-your-site.mdx +++ /dev/null @@ -1,88 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Translate your site - -Let's translate `docs/intro.md` to French. - -## Configure i18n - -Modify `docusaurus.config.js` to add support for the `fr` locale: - -```js title="docusaurus.config.js" -export default { - i18n: { - defaultLocale: 'en', - locales: ['en', 'fr'], - }, -}; -``` - -## Translate a doc - -Copy the `docs/intro.md` file to the `i18n/fr` folder: - -```bash -mkdir -p i18n/fr/docusaurus-plugin-content-docs/current/ - -cp docs/intro.md i18n/fr/docusaurus-plugin-content-docs/current/intro.md -``` - -Translate `i18n/fr/docusaurus-plugin-content-docs/current/intro.md` in French. - -## Start your localized site - -Start your site on the French locale: - -```bash -npm run start -- --locale fr -``` - -Your localized site is accessible at [http://localhost:3000/fr/](http://localhost:3000/fr/) and the `Getting Started` page is translated. - -:::caution - -In development, you can only use one locale at a time. - -::: - -## Add a Locale Dropdown - -To navigate seamlessly across languages, add a locale dropdown. - -Modify the `docusaurus.config.js` file: - -```js title="docusaurus.config.js" -export default { - themeConfig: { - navbar: { - items: [ - // highlight-start - { - type: 'localeDropdown', - }, - // highlight-end - ], - }, - }, -}; -``` - -The locale dropdown now appears in your navbar: - - - -## Build your localized site - -Build your site for a specific locale: - -```bash -npm run build -- --locale fr -``` - -Or build your site to include all the locales at once: - -```bash -npm run build -``` |
