Pular para o conteúdo principal

Traduzir seu site

Vamos traduzir docs/intro.md para o francês.

Configurar i18n​

Modifique o arquivo docusaurus.config.js para adicionar suporte à localidade fr:

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

Traduzir um documento​

Copie o arquivo docs/intro.md para a pasta i18n/fr:

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

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

Traduza i18n/fr/docusaurus-plugin-content-docs/current/intro.md para o francês.

Inicie seu site localizado​

Inicie seu site na localidade francesa:

npm run start -- --locale fr

Seu site localizado está acessível em http://localhost:3000/fr/ e a página Primeiros Passos está traduzida.

cuidado

No desenvolvimento, você só pode usar uma localidade de cada vez.

Adicionar um menu suspenso de localidade​

Para navegar de forma transparente entre os idiomas, adicione um menu suspenso de localidade.

Modifique o arquivo docusaurus.config.js:

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

O menu suspenso de localidade agora aparece em sua barra de navegação:

Menu suspenso de localidade

Construa seu site localizado​

Construa seu site para uma localidade específica:

npm run build -- --locale fr

Ou construa seu site para incluir todas as localidades de uma só vez:

npm run build