Localisation GitHub
Automatisez la localisation GitHub en l'intégrant à PTC. Obtenez 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 pendant que vous travaillez. 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 Pay-As-You-Go.
Connectez votre dépôt
Commencer avec l'intégration GitHub est simple :
- Si vous avez déjà un compte PTC et que vous créez un nouveau projet, sélectionnez Intégration Git dans l'assistant de configuration.
- Si vous avez commencé par un téléversement manuel de fichiers, vous pouvez passer à tout moment à un flux de travail continu basé sur Git. Allez dans 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 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 avec OAuth. Si vous vous connectez à l'aide d'un jeton d'accès, assurez-vous qu'il inclut les bons scopes et l'accès au dépôt.
| Où le créer | Propriétaire de la ressource | Autorisations requises | Accès au dépôt | |
|---|---|---|---|---|
| Jeton fine-grained personnel | Personal access tokens dans Developer Settings | Votre compte utilisateur GitHub | Commit statuses → Read-only Contents → Read and write Pull requests → Read and write Webhooks → Read and write |
Choisissez « Only select repositories » (recommandé) ou « All repositories » |
| Jeton fine-grained d'organisation | Personal access tokens dans Developer Settings Important : La création d'un jeton d'accès fine-grained peut être restreinte par les politiques d'accès de votre organisation. Si vous ne pouvez pas créer le jeton, demandez à un administrateur de l'organisation d'examiner les paramètres de la politique des jetons d'accès personnels dans GitHub. |
L'organisation GitHub | Commit statuses → Read-only Contents → Read and write Pull requests → Read and write Webhooks → Read and write |
Choisissez « Only select repositories » (recommandé) ou « All repositories » |
Stockez 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 fonctionner avec les fichiers de traduction existants dans votre dépôt, la traduction de 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 que vous avez sélectionnée. Une fois terminé, PTC vous enverra un e-mail avec un lien vers la pull request.
Révisez et approuvez la pull request lorsque vous êtes prêt. Les traductions de PTC sont de qualité production et peuvent être fusionnées sans révision manuelle.
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 chaque fois que des modifications sont détectées.
Comment générer de nouvelles pull requests manuellement
Allez dans l'onglet Translations dans PTC pour voir les traductions dans chaque langue que vous avez sélectionnée, organisées dans un tableau. Depuis cette page, vous pouvez apporter 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.
Ajouter de nouveaux fichiers de ressources pour la traduction
Si vous ajoutez de nouveaux fichiers de ressources à votre dépôt après la connexion avec PTC, 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 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 pour 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éversements et téléchargements manuels de fichiers, ainsi que la nécessité d'exécuter des scripts de traduction.
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 dont il a besoin
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 pull 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.
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 à la recherche de chaînes nouvelles ou mises à jour et renvoie automatiquement les traductions via une pull request, afin 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 de logiciels et d'applications mobiles, y compris les fichiers PO et les fichiers JSON. 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.
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és pour chaque plateforme.
Inclus sans frais supplémentaires
L'intégration GitHub est incluse sans frais supplémentaires. PTC n'a aucun frais d'abonnement ni de facturation par fonctionnalité. Vous ne payez que pour les mots que vous traduisez, et les 500 premiers mots de chaque mois sont gratuits. Pour obtenir tous les détails sur les tarifs, consultez la page de tarification.