Aller au contenu principal

Traduire votre site

Traduisons docs/intro.md en français-canadien.

Configurer l'i18n​

Modifiez docusaurus.config.js pour ajouter la prise en charge du français (fr-ca) :

docusaurus.config.js
export default {
  i18n: {
    defaultLocale: 'en',
    locales: ['en', 'fr-ca'],
  },
};

Traduire un document​

Copiez le fichier docs/intro.md Copiez le fichier i18n/fr-ca :

mkdir -p i18n/fr-ca/docusaurus-plugin-content-docs/current/

cp docs/intro.md i18n/fr-ca/docusaurus-plugin-content-docs/current/intro.md

Traduisez i18n/fr/docusaurus-plugin-content-docs/current/intro.md en français.

Démarrer votre site localisé​

Lancez votre site en français :

npm run start -- --locale fr-ca

Votre site en français est accessible à l'adresse http://localhost:3000/fr/ et la page "Getting Started" est traduite.

attention

En mode développement, vous ne pouvez utiliser qu'une seule langue (locale) à la fois.

Ajouter un menu déroulant des langues​

Pour naviguer facilement entre les langues, ajoutez un menu déroulant.

Modifiez le fichier docusaurus.config.js :

docusaurus.config.js
export default {
  themeConfig: {
    navbar: {
      items: [
        {
          type: 'localeDropdown',
        },
      ],
    },
  },
};

Le menu déroulant des langues apparaît maintenant dans votre barre de navigation :

Locale Dropdown

Construire votre site localisé​

Générez votre site pour une langue spécifique :

npm run build -- --locale fr

Ou générez votre site pour inclure toutes les langues en une seule fois :

npm run build