Localisation GitHub

Comment intégrer GitHub avec PTC

PTC se connecte à votre dépôt GitHub et assure la traduction de vos fichiers de ressources pendant que vous travaillez. Lorsque vous poussez des modifications à votre code, PTC les détectera automatiquement, traduira les chaînes mises à jour et ouvrira une demande de tirage — le tout sans aucune intervention manuelle de votre part.

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échargement manuel de fichiers, vous pouvez passer à un flux de travail continu basé sur Git à tout moment. Allez dans Paramètres → Demandes de fusion et cliquez sur Ajouter une intégration Git.

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.

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 étendues et l’accès au dépôt corrects.

Stockez le jeton en toute sécurité et ajoutez-le à PTC. Il vérifiera vos autorisations et vous invitera à choisir les branches à surveiller.

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.

PTC ne prend 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 avec un lien vers la demande de tirage.

Examinez et approuvez la demande de tirage 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 demandes de tirage avec des traductions mises à jour chaque fois que des modifications sont détectées.

Comment générer manuellement de nouvelles pull requests

Allez dans l’onglet Traductions de PTC pour voir les traductions dans toutes les langues que vous avez sélectionnées, organisées dans un tableau. À partir de 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 Générer une demande de fusion pour envoyer une nouvelle demande de tirage avec les traductions mises à jour.

Si vous ajoutez de nouveaux fichiers de ressources à votre dépôt après vous être connecté à PTC, vous pouvez demander à PTC de les vérifier.

1. Allez dans Paramètres → Fichiers surveillés et cliquez sur Rescanner votre dépôt. PTC scannera votre dépôt et affichera tous les fichiers nouvellement découverts comme des brouillons.
2. Cliquez sur l’icône + à côté d’un fichier découvert pour l’inclure dans la traduction, puis cliquez sur Enregistrer avec traduction pour confirmer.

Cochez la case Inclure automatiquement les nouveaux fichiers de traduction 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