mirror of https://github.com/facebook/docusaurus.git synced 2025-06-24 21:48:02 +02:00

refactor(init): share common files between templates (#5315 )

* Create shared folder & update init logic

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Restore needed links

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Prevent copying symlinks

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Reuse some FB files

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Minor tweak

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Minor refactors

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Fix bootstrap url

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Add path alias

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* Handle facebook template more gracefully

Signed-off-by: Josh-Cena <sidachen2003@gmail.com>

* minor refactor: extract getTypeScriptBaseTemplate

Co-authored-by: slorber <lorber.sebastien@gmail.com>

2021-08-10 16:26:59 +02:00

1.5 KiB

Raw Blame History

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:

module.exports = {
  i18n: {
    defaultLocale: 'en',
    locales: ['en', 'fr'],
  },
};

Translate a doc

Copy the docs/intro.md file to the i18n/fr folder:

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:

npm run start -- --locale fr

Your localized site is accessible at http://localhost:3000/fr/ and the Getting Started page is translated.

:::caution

In development, you can only use one locale at a same time.

:::

To navigate seamlessly across languages, add a locale dropdown.

Modify the docusaurus.config.js file:

module.exports = {
  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:

npm run build -- --locale fr

Or build your site to include all the locales at once:

npm run build

1.5 KiB Raw Blame History