Locales prises en charge

Lingo.dev CLI prend en charge les codes de locale conformes aux normes internationales d'identification des langues. Vous pouvez utiliser des codes de langue simples, des variantes régionales et des formats spécifiques aux plateformes dans votre configuration i18n.json.

Le CLI accepte les codes de locale dans plusieurs formats pour s'adapter aux différentes exigences de projet et conventions de plateforme.

Formats de codes de locale

Lingo.dev CLI prend en charge plusieurs formats de codes de locale :

Codes de langue simples (ISO 639-1) :

{
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja", "zh"]
  }
}

Variantes régionales (BCP 47) :

{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-419", "fr-FR", "fr-CA"]
  }
}

Formats spécifiques aux plateformes :

{
  "locale": {
    "source": "en",
    "targets": ["en-rUS", "es-rES", "pt-rBR"]
  }
}

Vérification des locales prises en charge

Pour voir tous les codes de locale disponibles, utilisez les commandes CLI :

Liste des langues source prises en charge :

npx lingo.dev@latest show locale sources

Liste des langues cibles prises en charge :

npx lingo.dev@latest show locale targets

Ces commandes affichent la liste complète des codes de locale que vous pouvez utiliser dans votre configuration.

Exemples courants de locales

Langues principales :

• en - Anglais
• es - Espagnol
• fr - Français
• de - Allemand
• ja - Japonais
• zh - Chinois
• ko - Coréen
• pt - Portugais
• it - Italien
• ru - Russe

Variantes régionales :

• en-US - Anglais (États-Unis)
• en-GB - Anglais (Royaume-Uni)
• es-ES - Espagnol (Espagne)
• es-419 - Espagnol (Amérique latine)
• fr-FR - Français (France)
• fr-CA - Français (Canada)
• zh-CN - Chinois (simplifié)
• zh-TW - Chinois (traditionnel)

Variantes régionales

Les variantes régionales vous permettent de cibler des marchés spécifiques avec du contenu localisé qui tient compte des différences culturelles et linguistiques au sein d'une même langue.

Exemple de configuration :

{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-419", "pt-BR", "pt-PT"]
  }
}

Structure de fichiers générée :

locales/
  en-US.json    (source)
  en-GB.json    (anglais britannique)
  es-ES.json    (espagnol d'Espagne)
  es-419.json   (espagnol d'Amérique latine)
  pt-BR.json    (portugais brésilien)
  pt-PT.json    (portugais européen)

Chaque variante régionale reçoit des traductions optimisées pour la terminologie et le contexte culturel spécifiques à ce marché.

L'espagnol d'Amérique latine (es-419) couvre les pays hispanophones d'Amérique latine avec une terminologie et des expressions qui fonctionnent dans toute la région, plutôt que d'être spécifiques à des pays individuels.

Formats spécifiques aux plateformes

Certaines plateformes utilisent différentes conventions de codes de locale. Lingo.dev CLI prend en charge ces formats :

Répertoires de ressources Android :

{
  "locale": {
    "source": "en",
    "targets": ["es-rES", "pt-rBR", "zh-rCN"]
  },
  "buckets": {
    "android": {
      "include": ["android/values-[locale]/strings.xml"]
    }
  }
}

iOS Localizable.strings :

{
  "locale": {
    "source": "en",
    "targets": ["es", "pt-BR", "zh-Hans"]
  },
  "buckets": {
    "xcode-strings": {
      "include": ["ios/[locale].lproj/Localizable.strings"]
    }
  }
}

Variantes de script

Pour les langues avec plusieurs systèmes d'écriture, utilisez les codes de script :

• zh-Hans - Chinois (script simplifié)
• zh-Hant - Chinois (script traditionnel)
• sr-Cyrl - Serbe (script cyrillique)
• sr-Latn - Serbe (script latin)

Exemple de configuration :

{
  "locale": {
    "source": "en",
    "targets": ["zh-Hans", "zh-Hant", "sr-Cyrl", "sr-Latn"]
  }
}

Ajout de nouvelles locales

Lingo.dev CLI prend actuellement en charge plus de 80 locales et nous ajoutons rapidement la prise en charge de nouvelles locales suite aux demandes de la communauté.

Si le code de locale dont vous avez besoin n'est pas pris en charge, vous pouvez le demander en ouvrant une issue dans le dépôt Lingo.dev CLI. La plupart des demandes sont implémentées et publiées en quelques jours.