Localisation GitHub
Automatisez la localisation GitHub en l’intégrant à PTC. Recevez des pull requests automatiques contenant des traductions de qualité humaine.
Comment intégrer GitHub à PTC
PTC se connecte à votre dépôt GitHub 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 pull request — le tout sans aucune étape manuelle de votre part.
L’intégration Git est une fonctionnalité Pro. Elle devient disponible lorsque vous activez le Pay-As-You-Go.
Connectez votre dépôt
La mise en route de l’intégration GitHub est simple :
- Si vous avez déjà un compte PTC et que vous créez un nouveau projet, sélectionnez Git Integration dans l’assistant de configuration.
- Si vous avez commencé par un téléchargement manuel de fichiers, vous pouvez passer à tout moment à un flux de travail continu basé sur Git. Allez dans Settings → 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 au sein du dépôt. PTC détectera automatiquement le service que vous utilisez.
Authentifiez-vous dans GitHub
Pour donner à PTC l’accès à votre dépôt, vous pouvez utiliser un jeton d’accès (recommandé) ou vous connecter via OAuth. Si vous vous connectez à l’aide d’un jeton d’accès, assurez-vous qu’il inclut les portées et l’accès au dépôt appropriés.
| Où le créer | Propriétaire de la ressource | Autorisations requises | Accès au dépôt | |
|---|---|---|---|---|
| Personal Fine-Grained Token | Personal access tokens dans les Developer Settings | Votre compte utilisateur GitHub | Commit statuses → Lecture seule Contents → Lecture et écriture Pull requests → Lecture et écriture Webhooks → Lecture et écriture |
Choisissez « Only select repositories » (recommandé) ou « All repositories » |
| Organization Fine-Grained Token | Personal access tokens dans les Developer Settings Important : La création d’un jeton d’accès précis peut être restreinte par les politiques d’accès de votre organisation. Si vous ne pouvez pas créer le jeton, demandez à un administrateur d’organisation de consulter les paramètres de la Personal Access Token Policy dans GitHub. |
L’organisation GitHub | Commit statuses → Lecture seule Contents → Lecture et écriture Pull requests → Lecture et écriture Webhooks → Lecture et écriture |
Choisissez « Only select repositories » (recommandé) ou « All repositories » |
Conservez le jeton en toute sécurité et ajoutez-le à PTC. Il vérifiera vos autorisations et vous invitera à choisir les branches à surveiller.
Traduisez les fichiers de votre dépôt avec PTC
Une fois votre dépôt GitHub connecté à PTC, poursuivez la configuration pour ajouter des langues et les détails du projet.
Bien que PTC puisse travailler avec les fichiers de traduction existants dans votre dépôt, traduire l’intégralité de votre projet avec PTC garantit la cohérence dans toutes les langues.
Vérifiez les pull requests
PTC ne prend généralement que quelques minutes pour traduire les fichiers de la branche GitHub sélectionnée. Une fois l’opération terminée, PTC vous enverra un e-mail contenant un lien vers la pull request.
Examinez et approuvez la pull request lorsque vous êtes prêt. Les traductions de PTC sont prêtes pour la production et peuvent être fusionnées sans révision humaine.
Après avoir fusionné les premières traductions, PTC continue de surveiller vos fichiers de ressources et enverra de nouvelles pull requests avec les traductions mises à jour dès que des changements seront détectés.
Comment générer de nouvelles pull requests manuellement
Allez dans l’onglet Translations de PTC pour voir les traductions dans chaque langue sélectionnée, organisées dans un tableau. Depuis cette page, vous pouvez effectuer des modifications ou demander à PTC de retraduire — par exemple, lorsque les traductions dépassent une limite de longueur.
Cliquez sur Create a merge request pour envoyer une nouvelle pull request avec les traductions mises à jour.
Ajoutez de nouveaux fichiers de ressources pour la traduction
Si vous ajoutez de nouveaux fichiers de ressources à votre dépôt après l’avoir connecté à PTC, vous pouvez demander à PTC de les rechercher.
- Allez dans Settings → 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 découvert pour l’inclure dans la traduction, puis cliquez sur Save with translation pour confirmer.
Cochez la case Automatically include new translation files pour que PTC surveille et inclue les fichiers de ressources nouvellement découverts sans demander de confirmation à chaque fois.
Pourquoi localiser vos projets GitHub avec PTC
Connexion facile à votre dépôt
PTC s’intègre directement à votre dépôt GitHub, éliminant les téléchargements manuels de fichiers ou la nécessité d’utiliser un script de traduction maison.
Synchronisation en temps réel
PTC surveille votre dépôt GitHub pour détecter les modifications dans les fichiers de ressources, génère automatiquement les traductions et les renvoie via des pull requests.
Localisation plus rapide pour les marchés mondiaux
PTC accélère le processus de localisation en fournissant des traductions de haute qualité automatiquement via des pull requests. Adaptez rapidement votre logiciel aux marchés mondiaux et réduisez votre délai de mise sur le marché.
Uniquement l’accès au dépôt nécessaire
PTC utilise un accès en lecture pour détecter les modifications dans vos fichiers de ressources et un 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.
Une localisation qui suit le rythme de votre cycle de publication
PTC est conçu pour les équipes de développement qui souhaitent que la localisation avance au même rythme que leur code. PTC surveille votre dépôt pour détecter les chaînes nouvelles ou mises à jour et renvoie automatiquement les traductions via pull request, de sorte que la localisation ne devienne jamais un goulot d’étranglement dans votre cycle de publication.
Il fonctionne avec les formats de fichiers courants dans le développement logiciel et mobile, notamment les fichiers PO et les fichiers JSON. Pour en savoir plus sur la manière dont PTC s’intègre dans ces flux de travail, consultez nos pages sur la localisation de logiciels et la localisation d’applications mobiles.
Fonctionne avec GitHub, GitLab et Bitbucket
En plus de GitHub, PTC s’intègre à GitLab et Bitbucket, offrant les mêmes flux de travail et fonctionnalités de localisation automatisée pour chaque plateforme.
Inclus sans frais supplémentaires
L’intégration GitHub est incluse sans frais supplémentaires. PTC n’a pas de frais d’abonnement ni de frais par fonctionnalité. Vous ne payez que pour les mots que vous traduisez, et les 500 premiers mots de chaque mois sont gratuits. Pour plus de détails sur les tarifs, consultez la page des tarifs.