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 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 intervention 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
Démarrer avec l'intégration GitHub est facile :
- 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 | |
|---|---|---|---|---|
| Personal Fine-Grained Token | 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 » |
| Organization Fine-Grained Token | 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 de vérifier les Personal Access Token Policy settings 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'ensemble de votre projet avec PTC garantit la cohérence dans toutes les langues.
Vérifiez les pull requests
PTC ne met généralement que quelques minutes pour traduire les fichiers de la branche GitHub sélectionnée. Une fois terminé, PTC vous enverra un e-mail contenant 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 seront détectées.
Comment générer de nouvelles pull requests manuellement
Allez dans l'onglet Translations de 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.
Ajoutez 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 à l'état de brouillon.
- 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 ainsi les téléversements et téléchargements manuels de fichiers, ou le besoin 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 des 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 fournir des 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 à 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 de localisation automatisés et les mêmes fonctionnalités 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 obtenir tous les détails sur les tarifs, consultez la page de tarification.