|Labs
Réserver une démoPlateforme
React (Lingo Compiler)
Alpha
React (MCP)React (i18n)CLI historique (v0)
Déconseillé

Lingo.dev CLI

  • Fonctionnement
  • Installation
  • Démarrage rapide
  • Monorepos

Configuration

  • Formats pris en charge
  • i18n.json
  • i18n.lock
  • Langues prises en charge

Fonctionnalités

  • Traductions existantes
  • Ajouter des langues
  • Surcharges
  • Notes de traduction
  • Clés de traduction
  • Renommage des clés
  • Verrouillage des clés
  • Ignorer des clés
  • Préservation des clés
  • Extraire des clés avec l’IA

Performance

  • Projets d’envergure
  • Traitement parallèle
  • Estimation des coûts

Retraduction

  • Retraduction automatique
  • Retraduction
  • Supprimer des traductions

Cette documentation couvre le CLI historique (v0) et est déconseillée. Le CLI actuel est la v1. Voir la documentation du CLI actuel

Ajouter des langues

Ajoutez de nouvelles langues cibles en mettant à jour le tableau targets dans i18n.json, puis en lançant le CLI. Des fichiers de traduction complets sont générés pour les nouvelles langues, tandis que les traductions existantes restent inchangées.

Ajouter une langue#

Mettez à jour votre configuration i18n.json :

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

Exécutez le CLI :

bash
npx lingo.dev@latest run

Le CLI crée des fichiers de traduction complets pour chaque nouvelle langue :

text
locales/
  en.json    (source - unchanged)
  es.json    (existing - unchanged)
  fr.json    (existing - unchanged)
  de.json    (new - fully translated)

Langues existantes et nouvelles langues#

Le CLI traite différemment les langues existantes et les nouvelles langues :

Langues existantesNouvelles langues
ComportementSeules les clés manquantes sont traduitesDes fichiers complets sont générés de zéro
Contenu existantConservéN/A

Variantes régionales#

Le CLI prend en charge les variantes régionales d’une langue à l’aide des balises BCP 47 :

json
{
  "locale": {
    "source": "en-US",
    "targets": ["en-GB", "es-ES", "es-MX", "fr-FR", "fr-CA", "pt-BR", "pt-PT"]
  }
}

Chaque variante obtient un fichier de traduction distinct, avec une terminologie, une orthographe et un ton adaptés à la région.

Génération ciblée#

Générez les traductions d’une langue spécifique sans traiter toutes les cibles :

bash
npx lingo.dev@latest run --target-locale de

C’est pratique lorsque vous ajoutez les langues une par une afin d’en relire la qualité avant d’aller plus loin.

Supprimer des langues#

Supprimez une langue du tableau targets et le CLI cesse de la traiter. Les fichiers existants ne sont pas supprimés. Supprimez-les manuellement si nécessaire.

Étapes suivantes#

Traductions existantes
Intégrez des projets qui disposent déjà de traductions
Traitement parallèle
Traitez plusieurs langues en parallèle
Grands projets
Stratégies pour passer à l’échelle en localisation
i18n.json
Référence complète de la configuration

Cette page vous a-t-elle été utile ?

Max PrilutskiyMax Prilutskiy·Mis à jour il y a 1 jour·1 min de lecture