Intégration de GitLab avec PTC
Connectez GitLab à PTC pour une localisation continue. Recevez des traductions livrées via des merge requests automatiques à chaque modification de votre code.
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 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 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 les dépôts 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 passer un projet existant des téléversements manuels de fichiers à un flux de travail Git continu, allez dans Paramètres → Merge Requests et cliquez sur Add Git Integration.
Dans les deux cas, vous verrez un écran où vous pourrez entrer 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 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 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 configurer le webhook :
| 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 parcours d'intégration. | PTC vous fournit une URL de callback et un jeton secret. Vous créez un webhook dans vos paramètres GitLab en utilisant ces informations, avec les événements Push et Merge request comme déclencheurs. |
| Création du jeton | Allez dans Settings → Access Tokens, dans votre projet ou votre groupe. Donnez un nom au jeton, une description facultative, et définissez une date d'expiration (recommandé pour la sécurité). | Allez dans Settings → Access Tokens, dans votre projet ou votre groupe. Donnez un nom au jeton, une description facultative, et définissez une date d'expiration (recommandé pour la sécurité). |
| Rôle requis | Maintainer | Developer (ou équivalent) |
| Scopes | api → Permet à PTC de lire et de pousser vers le dépôt |
read_repository + write_repository |
Un jeton de projet et un jeton de groupe fonctionnent tous deux dans chaque colonne — PTC lit le niveau d'accès le plus élevé. Ce qui sépare les deux colonnes est le rôle, et cela découle de ce que fait chaque configuration : la configuration automatique gère un webhook de projet pour vous, ce que GitLab réserve au rôle Maintainer, tandis que la configuration manuelle ne fait que lire le dépôt et pousser une branche, donc le rôle Developer est suffisant.
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 n'interagit qu'avec les fichiers qu'il gère pour la traduction et n'apporte aucune modification à d'autres parties de votre dépôt.
Les webhooks maintiennent les traductions synchronisées automatiquement
Les webhooks sont le moyen par lequel PTC est notifié lorsque vous poussez des modifications vers votre dépôt, afin qu'il puisse retraduire automatiquement les chaînes affectées. Sans accès aux webhooks, 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.
Passez en revue la Merge Request avec les traductions
PTC traduit en quelques minutes et envoie une merge request avec les traductions directement sur 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, gardant votre logiciel entièrement localisé au fil du temps.
Générez 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. À partir de là, vous pouvez passer en revue 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 que vous avez 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.
- Allez dans Paramètres → Monitored Files et cliquez sur Rescan your repository. PTC analysera votre dépôt et affichera tout fichier nouvellement découvert 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 trouve, sans vous obliger à 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 des 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 le moindre script.
Moins de travail manuel
PTC fait gagner du temps de développement et accélère les livraisons 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 logiciel et mobile
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 renvoie les traductions 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 Pay-As-You-Go simple : 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és et les mêmes fonctionnalités pour chaque plateforme.