Aller au contenu principal

Traduction

remarque

À partir de la version v1.20.0, la commande de traduction est supprimée de @logto/cli et maintenue en tant que package autonome @logto/translate dans le monorepo Logto. Veuillez vous référer au CLI de traduction pour plus de détails.

Utiliser CLI pour gérer les traductions i18n. Ces commandes sont destinées aux développeurs qui souhaitent contribuer à Logto. Si vous souhaitez simplement utiliser Logto avec une traduction personnalisée, veuillez vous référer à ce guide.

Synchroniser les clés​

Disons que nous avons apporté quelques modifications aux clés de traduction dans le dossier en du package phrases. Nous voulons synchroniser ces modifications avec le dossier pt-BR. Exécutez la commande ci-dessous pour synchroniser les clés de traduction et la structure des fichiers :

pnpm cli translate sync-keys --target pt-BR

Cette commande lira toutes les clés de traduction du dossier de langue source (en par défaut) et les synchronisera avec le dossier de langue cible (pt-BR dans cet exemple).

  • Si le dossier de langue cible n'existe pas, il sera créé automatiquement ;
  • Si le dossier de langue cible existe déjà, il sera mis à jour avec de nouvelles clés et les clés obsolètes seront supprimées.

Pour chaque clé de traduction :

  • Si une clé est manquante dans la cible, elle sera ajoutée avec un commentaire pour indiquer que la phrase n'est pas traduite (marquée avec /** UNTRANSLATED */) ;
  • Si une clé est manquante dans la ligne de base, elle sera supprimée de la cible ;
  • Si une clé existe à la fois dans la ligne de base et la cible, la valeur de la cible sera utilisée.

Pour synchroniser les clés pour toutes les langues dans le package phrases, exécutez la commande ci-dessous :

pnpm cli translate sync-keys --target all

Ainsi, nous pouvons nous concentrer sur la mise à jour des clés de traduction dans le dossier de langue source, et les clés de traduction dans d'autres langues seront mises à jour automatiquement.

info

Cette commande s'exécute pour le package phrases par défaut. Vous pouvez spécifier le nom du package avec l'option --package. Par exemple, utilisez --package phrases-experience pour synchroniser les clés pour le package phrases-experience.

Après avoir synchronisé les clés, nous pouvons traduire les clés en utilisant l'API ChatGPT.

Traduire les clés en utilisant ChatGPT​

Exécutez la commande ci-dessous pour traduire les clés en utilisant ChatGPT :

pnpm cli translate sync

Cette commande traduira toutes les clés non traduites (marquées avec /** UNTRANSLATED */) dans toutes les langues des packages phrases et phrases-experience. Notez qu'une variable d'environnement OPENAI_API_KEY est requise pour exécuter cette commande.