+
Connectez GitLab à PTC pour une localisation continue. Recevez des traductions via des merge requests automatiques à chaque modification de votre code.
Comment intégrer GitLab à PTC
PTC se connecte à votre dépôt GitLab et maintient vos fichiers de ressources traduits au fur et à mesure de votre travail. Poussez les modifications à votre code et PTC les détectera automatiquement, traduira les chaînes mises à jour et ouvrira une demande de fusion.
1
Connecter votre Dépôt GitLab
PTC prend en charge GitLab.com ainsi que les dépôts GitLab auto-hébergés. Selon l’étape de votre workflow, deux options s’offrent à vous pour démarrer :
- Lors de la création d’un nouveau projet dans PTC, sélectionnez Intégration Git dans l’assistant de configuration.
- Pour faire passer un projet existant des téléversements manuels de fichiers à un flux de travail continu basé sur Git, accédez à Paramètres → Merge Requests et cliquez sur Ajouter une intégration Git.
Dans les deux cas, vous verrez un écran où vous pourrez saisir l’URL de votre projet dans le dépôt. PTC détectera automatiquement que vous utilisez GitLab.
2
S’authentifier avec GitLab
Pour connecter votre dépôt, vous pouvez utiliser un jeton d’accès (recommandé) ou vous connecter via OAuth. PTC prend en charge les jetons d’accès de projet et les jetons d’accès de groupe.
PTC a besoin d’un accès aux webhooks pour détecter les changements dans votre dépôt. Si vous utilisez un jeton d’accès, le rôle et les portées nécessaires dépendent de la manière dont vous souhaitez configurer le webhook :
Stockez le jeton de manière sécurisée et ajoutez-le à PTC. PTC vérifiera vos autorisations et vous permettra de choisir les branches et les fichiers de ressources à surveiller.
3
Traduire votre projet avec PTC
Une fois votre dépôt GitLab connecté, poursuivez les étapes de configuration afin de fournir du contexte sur votre application ou logiciel et de choisir vos langues cibles.
PTC traduira ensuite les fichiers de ressources dans la branche GitLab connectée. Si votre dépôt contient déjà des fichiers de traduction, PTC peut les détecter et les réutiliser.
4
Examiner la merge request contenant les traductions
PTC traduit en quelques minutes et envoie une merge request avec les traductions directement dans votre dépôt GitLab. Lorsque vous êtes prêt, fusionnez-la simplement — aucune autre action n’est nécessaire.
Ensuite, à chaque fois que vous pousserez des modifications de code, PTC les détectera et enverra de nouvelles merge requests avec des traductions mises à jour, afin de maintenir votre logiciel entièrement localisé dans la durée.
Générer manuellement de nouvelles merge requests
En plus des mises à jour automatiques, vous pouvez générer une nouvelle merge request à tout moment pour synchroniser les traductions que vous avez modifiées ou retraduites.
Pour ce faire, accédez à l’onglet Traductions. Vous pouvez y examiner les textes traduits qui dépassent la limite de longueur et soit les modifier manuellement, soit laisser PTC générer une version plus courte. Une fois terminé, cliquez sur Générer une MR pour pousser les traductions mises à jour vers votre dépôt.
5
Donner à PTC l’accès aux nouveaux fichiers de ressources au fur et à mesure que vous les ajoutez
Si vous ajoutez de nouveaux fichiers de ressources à votre dépôt après l’intégration initiale, vous pouvez demander à PTC de les rechercher.
- Accédez à Paramètres → Fichiers surveillés et cliquez sur Analyser à nouveau votre dépôt. PTC analysera votre dépôt et affichera les fichiers nouvellement détectés en tant que brouillons.
- Cliquez sur l’icône + à côté d’un fichier pour l’inclure dans la traduction, puis cliquez sur Enregistrer avec traduction pour confirmer.
Pour ignorer entièrement la revue manuelle, cochez la case Inclure automatiquement les nouveaux fichiers de traduction. À partir de ce moment, PTC récupérera et surveillera automatiquement tout nouveau fichier de ressources détecté, sans que vous n’ayez besoin de les confirmer.
Pour ajuster d’autres paramètres, comme les branches et les langues surveillées, parcourez les onglets Gestion des branches, Fichiers surveillés et Langues.
Pourquoi localiser des projets GitLab avec PTC
Traduction automatisée des fichiers
PTC détecte et traduit automatiquement vos fichiers de ressources, et livre les traductions via des merge requests. Vous gardez le contrôle en utilisant le workflow GitLab que vous connaissez déjà et auquel vous faites confiance — et sans avoir besoin de créer le moindre script.
Moins de travail manuel
PTC fait gagner du temps de développement et accélère les mises en production en surveillant votre dépôt et en mettant à jour les fichiers de traduction à mesure que vous poussez des changements.
Précision de traduction améliorée
PTC élimine le risque d’erreurs humaines telles que des clés mal placées ou des traductions obsolètes. Vous obtenez des traductions très précises et fidèles à votre marque.
