DevTools
Traduisez des fichiers, appelez l’API depuis votre serveur et affichez des applications multilingues grâce aux bibliothèques JavaScript.
La localisation relie deux types de code : celui qui produit les traductions et celui qui les utilise. Un serveur peut demander du contenu traduit lorsqu’un enregistrement est modifié. Une compilation peut rassembler des fichiers traduits. Un composant React peut lire un catalogue existant sans envoyer la moindre requête de traduction.
Commencez par la partie que vous souhaitez mettre en œuvre. Chaque section vous guide dans une première tâche de bout en bout, puis présente les contrats nécessaires pour poursuivre.
API #
Utilisez l’API si votre serveur dispose déjà du contenu et doit décider quand demander une traduction, où la stocker et quand l’utiliser. Soumettez du contenu JSON ou des fichiers téléversés sous forme de tâche de traduction, lancez-la, puis récupérez chaque version cible une fois terminée. Le moteur pilote les étapes de traduction et de relecture.
Effectuer votre première requête vous montre comment envoyer un petit volume de données et enregistrer les données traduites en local. Ce guide pratique détaille l’identifiant d’accès, le choix du moteur de localisation, les champs de la réponse et les vérifications à effectuer avant de raccorder le tout au stockage de votre application.
CLI #
Utilisez la CLI lorsque votre contenu se trouve dans des fichiers. Configurez les chemins des fichiers sources et les langues cibles, soumettez les éléments sélectionnés, puis récupérez les fichiers cibles dans votre projet. La CLI enregistre des versions de référence des sources pour que les exécutions suivantes puissent traiter les modifications plutôt que de considérer chaque fichier comme nouveau.
Traduire votre premier fichier vous guide dans l’installation, l’authentification, la configuration et la récupération. La même CLI peut extraire les messages React explicites pour les placer dans des catalogues ; cette extraction s’effectue en local, sans demander de traduction.
JavaScript #
Les bibliothèques JavaScript prennent en charge les clients côté serveur, l’affichage des messages React et le routage par langue. Choisissez un client pour envoyer des requêtes de traduction ou une bibliothèque d’affichage pour les messages déjà disponibles dans l’application. L’affichage dans le navigateur ne nécessite aucune clé d’API de traduction.
La documentation React présente un exemple pour afficher un premier message en local, le chargement des catalogues, les variantes grammaticales, le texte enrichi et l’intégration propre à chaque framework. La négociation de l’URL et le texte traduit relèvent de responsabilités distinctes : la documentation de référence sur le routage explique donc comment garder la langue sélectionnée et les messages chargés en phase.
Intégrer un projet existant #
La section Formats explique ce que chaque gestionnaire traduit et reconstitue. Consultez également la liste des formats de l’outil qui l’appelle : un gestionnaire disponible pour une intégration côté serveur n’est pas nécessairement un format de fichier configuré dans la CLI.
Les projets utilisant i18n.json ou LingoDotDevEngine disposent d’une documentation de référence versionnée pour la CLI v0 et le SDK v0. Conservez la version installée pendant la préparation de la migration ; la configuration, l’état conservé et les valeurs de retour peuvent changer d’une génération à l’autre.
Pour un assistant qui travaille sur des fichiers locaux ou sur la configuration du compte, utilisez MCP. Pour relier la traduction à un dépôt, à un CMS ou à un centre d’aide, utilisez les Intégrations. Chaque connexion définit comment le travail démarre, sur quelles autorisations il s’appuie et où les résultats sont renvoyés.