Intégrations
Connectez la traduction à vos dépôts et CMS, lancez la localisation en CI, recueillez des données depuis Crowdin ou analysez les retours dans Jira.
Utilisez Lingo.dev avec les outils dans lesquels votre équipe rédige, traduit et relit ses contenus. Chaque connexion remplit un rôle distinct. Certaines renvoient le contenu traduit vers son système d’origine ; d’autres recueillent des données ou aident à analyser les retours.
Traduire le contenu dans son système d’origine #
Ces connexions natives lisent le contenu source sélectionné, le traduisent avec un moteur de localisation et enregistrent le résultat dans le système d’origine en utilisant les accès que vous accordez auprès du fournisseur.
| Connexion | Ce qui déclenche le travail | Destination des traductions |
|---|---|---|
| GitHub | Événements du dépôt configurés ou commande de traduction à périmètre défini | Une demande de fusion contenant les traductions des modifications de la branche par défaut, ou des commits sur la branche d’une demande de fusion admissible. |
| Payload | Synchronisation manuelle ou notifications de modification du contenu source envoyées par le plugin | Les champs localisés des mêmes collections et globaux, dans les langues cibles sélectionnées. |
| WordPress | Synchronisation manuelle ou enregistrements de contenus publiés signalés par l’extension | La traduction Polylang ou WPML associée à chaque article dans les langues sélectionnées. |
| Centre d’aide Zendesk | Synchronisation manuelle | Les versions linguistiques des catégories, sections et articles sélectionnés. |
La configuration du fournisseur détermine le périmètre d’accès. Pour GitHub, sélectionnez les dépôts et les critères de correspondance des fichiers source. Pour Payload, sélectionnez les collections et les globaux comportant des champs localisés. Pour WordPress, sélectionnez les types de publication. Pour Zendesk, sélectionnez séparément les catégories, les sections et les articles : la sélection d’une catégorie ne sélectionne pas ses éléments enfants.
Le fonctionnement de la publication dépend aussi du fournisseur. Le mode Publier de Payload n’écrit pas dans un document publié contenant des modifications non publiées tant que celles-ci n’ont pas été publiées ou annulées, car la publication de la traduction les mettrait également en ligne. Dans Zendesk, une écriture en mode Brouillon peut retirer une version linguistique déjà en ligne jusqu’à sa republication. Consultez la section du fournisseur consacrée à la publication avant la première écriture, surtout si des traductions existent déjà.
Exécuter la traduction dans votre pipeline #
GitHub Actions, GitLab CI, Bitbucket Pipelines et Buildkite exécutent la CLI sur votre propre agent d’exécution. Les exemples de configuration utilisent d’abord des artefacts téléchargeables ou une seule branche de confiance, pour vous permettre d’examiner le résultat avant d’élargir les droits d’écriture sur le dépôt. Une fois .lingo/lock.json committé, lingo check fait échouer une demande de tirage ou de fusion si une source a été modifiée depuis sa dernière traduction ou si un fichier cible est manquant. Aucune clé API n’est nécessaire.
Votre pipeline gère la planification, les secrets, la conservation des résultats et la création des commits ou des demandes de fusion. La clé API Lingo.dev autorise la traduction ; les identifiants du fournisseur autorisent les écritures dans le dépôt. Automatiser les traductions en CI explique comment garder ensemble les révisions du contenu source, les résultats finalisés et les vérifications de l’application.
Mesurer les traductions ou analyser les retours #
Crowdin transmet à Radar les activités prises en charge au niveau des chaînes de texte. Utilisez cette connexion pour examiner les traductions produites dans Crowdin sans déplacer leur workflow de génération ou de relecture. Configurez une mesure en fonction de la question à laquelle vous souhaitez répondre, puis examinez le texte recueilli et le résultat de la mesure. Cette connexion ne synchronise pas les traductions corrigées vers Crowdin.
Jira part d’un problème signalé. L’ajout de l’étiquette lingo demande au workflow de triage d’examiner le ticket et de proposer des modifications du glossaire, des règles ou de la voix de marque. Les utilisateurs appliquent ou rejettent chaque suggestion, puis choisissent de retraduire ou non le contenu connecté concerné. Le triage Jira ne traduit pas le contenu du ticket comme s’il s’agissait d’un projet de localisation.
Terminer la première exécution avant d’élargir le périmètre #
Chaque page de fournisseur vous guide dans une première exécution à petite échelle : autorisation, configuration, examen des résultats et reprise en cas de problème. Profitez de cette exécution pour déterminer ce que la connexion lit et modifie. La disponibilité d’une connexion peut dépendre des autorisations de l’organisation et de l’accès aux fonctionnalités ; les identifiants d’un fournisseur ne suffisent pas à donner accès à un moteur de localisation.
Lorsque vous retirez une connexion, arrêtez les nouveaux déclenchements et gérez séparément les identifiants du fournisseur. La déconnexion n’annule ni le contenu livré, ni les commentaires publiés, ni les mesures enregistrées. La section du fournisseur consacrée à la reprise explique quel état est conservé et ce qui se passera lors d’une reconnexion.
Pour un workflow géré par votre application, consultez ensuite DevTools pour les interfaces API, CLI et JavaScript.