Gérer les locales

Aperçu

Ce document fournit des conseils sur la façon de gérer les locales dans votre application Next.js avec gt-next. Nous vous guiderons à travers la configuration de la liste des locales que vous souhaitez prendre en charge, puis le déclenchement de la génération des traductions.

Cette bibliothèque utilise la norme BCP-47 pour définir les locales. Consultez la liste des locales actuellement prises en charge ici.

Configuration des locales

Il existe deux façons de modifier vos locales pour la production :

1. L'outil CLI
2. Le fichier gt.config.json (préféré)

Pour que la traduction soit effectuée, vous devez ajouter la commande translate à votre script de build :

{
  "scripts": {
    "build": "npx gtx-cli translate && next build"
  }
}

Cela générera les traductions nécessaires et les stockera dans le cloud ou dans votre système de fichiers local selon votre configuration.

Gestion des locales avec l'outil CLI

La façon la plus simple de gérer les locales est de les spécifier via la commande npx gtx-cli translate en utilisant l'option --locales.

{
  "scripts": {
    "build": "npx gtx-cli translate --locales en-US zh jp && <YOUR_BUILD_COMMAND>"
  }
}

Cela générera des traductions pour le chinois (zh) et le japonais (jp).

Utilisation de gt.config.json (préféré)

Une façon plus robuste de gérer les locales est d'utiliser le fichier gt.config.json. Vous pouvez spécifier la liste des locales que vous souhaitez prendre en charge avec la propriété locales.

{
  "locales": ["zh", "jp"],
}

Locales sur liste blanche

En tant que fonctionnalité optionnelle, vous pouvez ajouter une liste de locales sur liste blanche. Cette option est accessible via le tableau de bord dans la page Locales du Projet. Si vous activez cette fonctionnalité, toute tentative d'appeler npx translate avec des locales non autorisées échouera.

Notes

• Vous pouvez gérer les locales via le tableau de bord, le fichier gt.config.json ou l'outil CLI.
• L'utilisation du fichier gt.config.json ou de l'outil CLI pour gérer les locales désactivera la fonctionnalité Gérer les locales dans le tableau de bord.

Prochaines étapes

• En savoir plus sur la syntaxe des paramètres régionaux dans la référence Chaînes de paramètres régionaux.