Aller au contenu principal

Ciblage Géographique et Internationalisation

Docusaurus supporte le ciblage géographique et le contenu multilingue nativement. Ce guide couvre le fonctionnement de ces fonctionnalités dans votre site de documentation Yundera.

Balises méta géographiques​

Le site inclut des balises méta géographiques qui aident les moteurs de recherche à comprendre la pertinence géographique :

<meta name="geo.region" content="FR">
<meta name="geo.placename" content="France">

Elles sont configurées dans docusaurus.config.js sous themeConfig.metadata.

Personnaliser pour votre région​

Pour cibler une région différente, mettez à jour les valeurs dans votre config :

metadata: [
  { name: 'geo.region', content: 'US' },      // Code pays ISO 3166-1
  { name: 'geo.placename', content: 'United States' },
],

Codes régionaux courants : FR (France), US (États-Unis), DE (Allemagne), KR (Corée du Sud), JP (Japon).

Support multilingue (i18n)​

Docusaurus a un support i18n intégré. La configuration actuelle utilise l'anglais uniquement :

i18n: {
  defaultLocale: 'en',
  locales: ['en'],
},

Ajouter une nouvelle langue​

  1. Mettez à jour la config pour inclure la nouvelle locale :
i18n: {
  defaultLocale: 'en',
  locales: ['en', 'fr', 'ko'],
  localeConfigs: {
    en: { label: 'English', htmlLang: 'en-US' },
    fr: { label: 'Français', htmlLang: 'fr-FR' },
    ko: { label: '한국어', htmlLang: 'ko-KR' },
  },
},
  1. Créez les fichiers de traduction avec le CLI Docusaurus :
npx docusaurus write-translations --locale fr
  1. Traduisez les docs en créant des copies spécifiques à la locale :
i18n/
  fr/
    docusaurus-plugin-content-docs/
      current/
        intro.md
        getting-started/
          ...
  1. Construisez le site multilingue :
npm run build

Docusaurus génère automatiquement :

  • Un sélecteur de langue dans la barre de navigation
  • Des balises hreflang pour le SEO
  • Des sitemaps séparés par locale
  • Des URLs spécifiques par locale (/fr/docs/, /ko/docs/)

Comment cela aide le SEO​

  • Les balises hreflang indiquent à Google quelle version linguistique afficher dans chaque région
  • Les balises méta géo signalent l'audience géographique principale
  • Les sitemaps par locale garantissent que toutes les versions linguistiques sont indexées
  • La balise méta content-language déclare la langue de la page pour les robots

Traductions du Yundera App Store​

L'App Store lui-même supporte les traductions pour les descriptions d'applications dans docker-compose.yml :

x-casaos:
  description:
    en_us: English description
    fr_fr: Description en français
    ko_kr: 한국어 설명

Ceci est séparé de l'i18n Docusaurus mais suit le même principe.

Voir aussi​