Intégration de GitLab avec PTC
Connectez GitLab à PTC pour une localisation continue. Recevez vos traductions via des merge requests automatiques dès que votre code change.
Comment intégrer GitLab avec PTC
PTC se connecte à votre dépôt GitLab et maintient vos fichiers de ressources traduits au fur et à mesure de votre travail. Poussez vos modifications de code et PTC les détectera automatiquement, traduira les chaînes mises à jour et ouvrira une merge request.
L’intégration GitLab est une fonctionnalité Pro. Elle devient disponible dès que vous activez le Pay-As-You-Go.
Connectez votre dépôt GitLab
PTC prend en charge les dépôts GitLab.com et les instances GitLab auto-hébergées. Selon l’étape de votre flux de travail, il existe deux façons de commencer :
- Lors de la création d’un nouveau projet dans PTC, sélectionnez Git Integration dans l’assistant de configuration.
- Pour faire passer un projet existant de l’import manuel de fichiers à un flux de travail continu basé sur Git, allez dans Settings → Merge Requests et cliquez sur Add Git Integration.
Dans les deux cas, un écran s’affichera pour vous permettre de saisir l’URL de votre projet au sein du dépôt. PTC détectera automatiquement que vous utilisez GitLab.
Authentifiez-vous auprès de 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 nécessite 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 (scopes) nécessaires dépendent de la manière dont vous souhaitez configurer le webhook :
| Configuration automatique du webhook | Configuration manuelle du webhook | |
|---|---|---|
| Fonctionnement | PTC crée et configure le webhook dans GitLab pour vous lors du flux d’intégration. | PTC vous fournit une URL de rappel 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 Merge request comme déclencheurs. |
| Création du jeton | Dans votre projet, allez dans Settings → Access Tokens. Donnez un nom au jeton, une description facultative, et définissez une expiry date (recommandé pour la sécurité). | Dans votre groupe, allez dans Settings → Access Tokens. Donnez un nom au jeton, une description facultative, et définissez une expiry date (recommandé pour la sécurité). |
| Rôle requis | Maintainer | Developer (ou équivalent) |
| Portées (Scopes) | api → Permet à PTC de lire et de pousser vers le dépôt |
read_repository + write_repository |
Conservez le jeton en toute sécurité et ajoutez-le à PTC. PTC vérifiera vos permissions et vous permettra de 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 changements dans vos fichiers de ressources et l’accès en écriture pour livrer les traductions via des pull requests. PTC n’interagit qu’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 qu’il puisse retraduire automatiquement les chaînes concernées. Sans accès aux webhooks, PTC ne peut pas surveiller les mises à jour de vos branches.
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 choisissez 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 sur votre dépôt GitLab. Dès que vous êtes prêt, fusionnez-la simplement — aucune autre action n’est requise.
À partir de là, chaque fois que vous pousserez des modifications dans votre code, PTC les détectera et enverra de nouvelles merge requests avec les traductions mises à jour, maintenant 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, allez dans l’onglet Translations. De là, vous pouvez réviser 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 Generate MR pour pousser les traductions mises à jour vers votre dépôt.
Donnez accès à PTC aux nouveaux fichiers de ressources au fur et à mesure de leur ajout
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.
- Allez dans Settings → Monitored Files et cliquez sur Rescan your repository. PTC scannera votre dépôt et affichera tous les fichiers nouvellement découverts en tant que 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 tout nouveau fichier de ressources qu’il trouvera, sans nécessiter de confirmation de votre part.
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 des projets GitLab avec PTC
Traduction automatisée de fichiers
PTC détecte et traduit automatiquement vos fichiers de ressources, livrant les traductions via des merge requests. Vous gardez le contrôle en utilisant le flux de travail GitLab que vous connaissez et maîtrisez déjà — 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 sorties de versions en surveillant votre dépôt et en mettant à jour les fichiers de traduction dès 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 hautement précises et respectueuses de votre image de marque.
La localisation suit le rythme du développement logiciel et mobile
PTC est conçu pour les équipes créant des produits logiciels et des applications mobiles qui souhaitent que la localisation suive le rythme du développement. Une fois votre dépôt GitLab connecté, PTC détecte automatiquement les chaînes nouvelles et mises à jour et renvoie les traductions via une merge request, sans 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 l’intégration de PTC 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 la connexion à GitLab. Plutôt qu’un modèle d’abonnement, PTC utilise une tarification simple en 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 des tarifs de PTC.
Fonctionne aussi avec GitHub et Bitbucket
En plus de GitLab, PTC s’intègre à GitHub et Bitbucket, offrant les mêmes flux de travail et fonctionnalités de localisation automatisée pour chaque plateforme.