Traduire votre site
Traduisons docs/intro.md
en français.
Configurer i18n
Modifiez docusaurus.config.js
pour ajouter la prise en charge de la langue fr
:
export default {
i18n: {
defaultLocale: 'en',
locales: ['en', 'fr'],
},
};
Traduire un document
Copiez le fichier docs/intro.md
dans le dossier i18n/fr
:
mkdir -p i18n/fr/docusaurus-plugin-content-docs/current/
cp docs/intro.md i18n/fr/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é
Démarrez votre site en français :
npm run start -- --locale fr
Votre site localisé est accessible à l'adresse http://localhost:3000/fr/ et la page Pour commencer
est traduite.
En développement, vous ne pouvez utiliser qu'une seule langue à la fois.
Ajouter un menu déroulant des langues
Pour naviguer facilement entre les langues, ajoutez un menu déroulant pour les locales.
Modifiez le fichier docusaurus.config.js
:
export default {
themeConfig: {
navbar: {
items: [
{
type: 'localeDropdown',
},
],
},
},
};
Le menu déroulant des langues apparaît maintenant dans votre barre de navigation :
Construire votre site localisé
Construisez votre site pour une langue spécifique :
npm run build -- --locale fr
Ou construisez votre site pour inclure toutes les langues à la fois :
npm run build
.