Intégration de GitLab avec PTC
Connectez GitLab à PTC pour une localisation continue. Obtenez des traductions livrées 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 de votre code et PTC les détectera automatiquement, traduira les chaînes mises à jour et ouvrira une merge request.
L'intégration de GitLab est une fonctionnalité Pro. Elle devient disponible lorsque vous activez le Pay-As-You-Go.
Connectez votre dépôt GitLab
PTC prend en charge GitLab.com et les dépôts GitLab auto-hébergés. Selon l'étape où vous vous trouvez dans votre flux de travail, il existe deux façons de commencer :
- 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 Git continu, accédez à Paramètres → Merge Requests et cliquez sur Add Git Integration.
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.
Authentifiez-vous avec GitLab
Pour connecter votre dépôt, vous pouvez utiliser un jeton d'accès (recommandé) ou vous connecter avec OAuth. PTC prend en charge à la fois les jetons d'accès de projet et les jetons d'accès de groupe.
PTC nécessite un accès par webhook pour détecter les modifications dans votre dépôt. Lors de l'utilisation d'un jeton d'accès, le rôle et les scopes dont vous avez besoin dépendent de la façon dont vous souhaitez que le webhook soit configuré :
| Configuration automatique du webhook | Configuration manuelle du webhook | |
|---|---|---|
| Comment ça fonctionne | PTC crée et configure le webhook dans GitLab en votre nom pendant le processus d'intégration. | PTC vous fournit une URL de callback et un jeton secret. Vous créez un webhook dans vos paramètres GitLab à l'aide de ces informations, avec les événements Push et les événements de Merge request comme déclencheurs. |
| Création du jeton | Dans votre projet, accédez à Paramètres → Jetons d'accès. Donnez un nom au jeton, une description facultative, et définissez une date d'expiration (recommandé pour la sécurité). | Dans votre groupe, accédez à Paramètres → Jetons d'accès. Donnez un nom au jeton, une description facultative, et définissez une date d'expiration (recommandé pour la sécurité). |
| Rôle requis | Mainteneur | Développeur (ou équivalent) |
| Scopes | api → Permet à PTC de lire et de pousser vers le dépôt |
read_repository + write_repository |
Stockez le jeton en toute sécurité et ajoutez-le à PTC. Il vérifiera vos autorisations et vous laissera choisir les branches et les fichiers de ressources à surveiller.
L'accès reste limité aux fichiers que PTC traduit
PTC utilise l'accès en lecture pour détecter les modifications dans vos fichiers de ressources et l'accès en écriture pour livrer les traductions via des merge requests. PTC interagit uniquement avec les fichiers qu'il gère pour la traduction et n'apporte aucune modification aux autres parties de votre dépôt.
Les webhooks maintiennent les traductions synchronisées automatiquement
Les webhooks permettent à PTC d'être notifié lorsque vous poussez des modifications vers votre dépôt, afin de pouvoir retraduire automatiquement les chaînes affectées. Sans accès par webhook, PTC ne peut pas surveiller vos branches pour y détecter des mises à jour.
Traduisez votre projet avec PTC
Une fois votre dépôt GitLab connecté, poursuivez les étapes de configuration pour fournir du contexte sur votre application ou logiciel et choisir vos langues cibles.
PTC traduira ensuite les fichiers de ressources dans votre 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.
Révisez 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. Une fois que vous êtes prêt, il vous suffit de la fusionner — aucune autre action n'est requise.
À partir de ce moment, à mesure que vous poussez des modifications dans votre code, PTC les détectera et enverra de nouvelles merge requests avec les traductions mises à jour, maintenant ainsi votre logiciel entièrement localisé au fil du temps.
Générer de nouvelles Merge Requests manuellement
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 Translations. De là, vous pouvez réviser le texte traduit qui dépasse la limite de longueur et soit le modifier manuellement, soit laisser PTC générer une version plus courte. Une fois terminé, cliquez sur Generate MR pour pousser les traductions mises à jour vers votre dépôt.
Donnez à PTC l'accès aux nouveaux fichiers de ressources à 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 → Monitored Files et cliquez sur Rescan your repository. PTC analysera votre dépôt et affichera tous les fichiers nouvellement découverts sous forme de brouillons.
- Cliquez sur l'icône + à côté d'un fichier pour l'inclure dans la traduction, puis cliquez sur Save with translation pour confirmer.
Pour ignorer complètement la révision manuelle, cochez la case Automatically include new translation files. À partir de ce moment, PTC détectera et surveillera automatiquement tous les nouveaux fichiers de ressources qu'il trouvera, sans vous demander de les confirmer.
Pour ajuster d'autres paramètres tels que les branches surveillées et les langues, naviguez dans les onglets Branch Management, Monitored Files et Languages.
Pourquoi localiser les projets GitLab avec PTC
Traduction automatisée des fichiers
PTC détecte et traduit automatiquement vos fichiers de ressources, en livrant les traductions via des merge requests. Vous gardez le contrôle en utilisant le flux de travail GitLab que vous connaissez et auquel vous faites déjà confiance — et sans avoir besoin de créer de script.
Moins de travail manuel
PTC fait gagner du temps de développement et accélère les publications en surveillant votre dépôt et en mettant à jour les fichiers de traduction à mesure que vous poussez des modifications.
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.
La localisation suit le rythme du développement de logiciels et d'applications mobiles
PTC est conçu pour les équipes développant des produits logiciels et des applications mobiles qui souhaitent que la localisation suive le rythme du développement. Une fois que vous connectez votre dépôt GitLab, PTC détecte automatiquement les chaînes nouvelles et mises à jour et livre les traductions en retour via une merge request, sans aucun transfert manuel requis.
Les formats courants dans les projets logiciels et mobiles — comme les fichiers PO et les fichiers JSON — sont entièrement pris en charge. Pour en savoir plus sur la façon dont PTC s'intègre dans ces flux de travail, consultez nos pages sur la localisation de logiciels et la localisation d'applications mobiles.
Connectez GitLab sans frais supplémentaires
Il n'y a pas de frais supplémentaires pour connecter GitLab. Plutôt qu'un modèle d'abonnement, PTC utilise une tarification simple au Pay-As-You-Go : vous n'êtes facturé que pour les mots que vous traduisez, et les 500 premiers mots de chaque mois sont gratuits. Tous les détails se trouvent sur la page de tarification de PTC.
Fonctionne également avec GitHub et Bitbucket
En plus de GitLab, PTC s'intègre à GitHub et Bitbucket, offrant les mêmes flux de travail de localisation automatisée et les mêmes fonctionnalités pour chaque plateforme.