Intégration de Git avec PTC

L'intégration de Git connecte PTC (Private Translation Cloud) directement à votre dépôt GitHub, GitLab ou Bitbucket, de sorte que vos fichiers de ressources sont traduits là où votre code se trouve déjà. Au lieu d'exporter des chaînes, de les traduire ailleurs et d'importer les résultats, vous gardez la localisation à l'intérieur du flux de pull requests que votre équipe utilise déjà.

L'intégration de Git est une fonctionnalité Pro. Elle devient disponible dès que vous activez Pay-As-You-Go.

Comment fonctionne la traduction continue via Git

Une fois que vous connectez un dépôt, PTC surveille les fichiers de ressources que vous choisissez et transforme chaque modification en traductions finalisées :

• Vous orientez PTC vers votre dépôt et sélectionnez les branches et les fichiers de ressources à surveiller, ainsi que vos langues source et cibles. PTC utilise la langue source pour choisir le bon moteur et pour ignorer les chaînes qui doivent rester non traduites.
• PTC détecte les chaînes nouvelles et modifiées chaque fois que vous effectuez un push vers une branche surveillée.
• PTC traduit les chaînes mises à jour et relit le résultat, puis ouvre une pull request ou une merge request contenant les fichiers traduits.
• Vous relisez et fusionnez la demande comme n'importe quelle autre modification. PTC continue de surveiller et ouvre une nouvelle demande chaque fois que votre texte change à nouveau.

Le résultat est une localisation continue : vos traductions suivent le développement au lieu de s'accumuler en une tâche distincte avant chaque version.

La localisation reste dans le flux de relecture que vous utilisez déjà

PTC fournit les traductions sous forme de pull requests ou de merge requests, et non sous forme de fichiers dans un portail distinct que vous devez rapprocher à la main. Votre équipe relit la modification, exécute les mêmes contrôles qu'elle exécute sur n'importe quelle branche, et fusionne lorsqu'elle est prête. Comme PTC relit chaque traduction en contexte et la renvoie prête à publier, la plupart des demandes peuvent être fusionnées sans passe distincte d'assurance qualité linguistique. Consultez la relecture visuelle des traductions pour découvrir comment fonctionne cette relecture.

Les traductions restent synchronisées à chaque commit

Après la première fusion, PTC continue de surveiller votre dépôt. Lorsque vous ajoutez ou modifiez des chaînes, il ouvre une nouvelle demande contenant uniquement ces mises à jour. Lorsque vous ajoutez de nouveaux fichiers de ressources, vous pouvez demander à PTC de réanalyser le dépôt et de les prendre en compte. Si une traduction doit tenir dans un espace restreint, PTC peut la retraduire dans la limite d'une limite de longueur de traduction, afin qu'une langue plus longue ne casse pas votre mise en page.

Configurer l'intégration de Git sur GitHub, GitLab ou Bitbucket

Le flux de travail est le même sur chaque plateforme ; seule la façon de créer un jeton d'accès et de connecter le dépôt diffère. Chaque guide détaille l'authentification et la connexion pour cette plateforme :

• Intégration de GitHub avec PTC connecte un dépôt GitHub et traduit via des pull requests.
• Intégration de GitLab avec PTC connecte un projet GitLab et traduit via des merge requests.
• Intégration de Bitbucket avec PTC connecte un dépôt Bitbucket et traduit via des pull requests.

Ce dont vous avez besoin pour connecter un dépôt

Pour configurer l'intégration de Git, vous indiquez à PTC l'URL de votre projet dans le dépôt et vous autorisez l'accès au moyen d'un jeton d'accès (recommandé) ou en vous connectant. PTC détecte la plateforme que vous utilisez, vérifie l'accès dont il dispose, puis vous laisse choisir les branches à surveiller et les langues vers lesquelles traduire. Le type de jeton et les autorisations exacts sont détaillés dans le guide de chaque plateforme ci-dessus.