Découvrez comment intégrer l’API PTC dans votre pipeline CI/CD afin de fournir des traductions d’IA de qualité humaine dans le cadre de votre processus de build.
Sécurité dès la conception : aucun accès en lecture ou en écriture au dépôt n’est requis.
Compatible avec n’importe quel système CI/CD, avec des configurations prêtes à l’emploi incluses.
Accès contrôlé via des jetons d’API spécifiques au projet.
Des traductions de qualité humaine livrées en quelques minutes, directement dans votre build.
Sur cette page
Comment fonctionne l’intégration CI/CD
Avant de configurer PTC avec votre système CI, voici les trois principes qui sous-tendent l’API et la CLI PTC :
1
Les fichiers de ressources sont liés à une branche
Chaque fichier que vous envoyez à PTC est lié à un nom de branche (par exemple, main, feature/new-checkout). Cela permet de séparer les traductions, de sorte que le travail provenant de différentes fonctionnalités ne s’écrase pas mutuellement.
Lorsque vous utilisez les configurations CI/CD prêtes à l’emploi, ce mappage est déjà géré automatiquement.
2
Les traductions sont traitées de manière asynchrone
PTC ne renvoie pas les traductions immédiatement. Au lieu de cela, il :
- Prépare les fichiers traduits pour le téléchargement
- Télécharge les fichiers mis à jour
- Identifie uniquement les chaînes nouvelles ou modifiées
- Traduit les chaînes
3
Un script CLI fonctionne partout
Au lieu d’appeler l’API vous-même, utilisez la CLI PTC :
Un script gère l’ensemble du flux (téléchargement → interrogation → téléchargement). La CLI est hébergée sur GitHub, mais fonctionne sous Linux, macOS, GitHub Actions, GitLab, Bitbucket ou toute autre plateforme CI/CD.
Flux de haut niveau : configurez l’API PTC dans votre pipeline CI/CD
Accédez à toutes les fonctionnalités et traduisez jusqu’à 2 500 mots dans les deux langues de votre choix.
Étape 2
Créer un nouveau projet.
Lorsque vous choisissez comment utiliser PTC, sélectionnez Intégration de l’API. Lors de la configuration, vous fournirez un peu de contexte sur votre projet (ce qu’il fait, à qui il s’adresse) et sélectionnerez les langues dans lesquelles vous souhaitez traduire.
Étape 3
Obtenez votre jeton d’API.
À la fin de la configuration, vous recevrez un jeton API spécifique au projet. Copiez-le et conservez-le en lieu sûr — vous en aurez besoin pour authentifier toutes les requêtes. Vous pouvez toujours retrouver ce même jeton dans le tableau de bord de votre projet sous Paramètres → Jetons API PTC.
Étape 4
Ajoutez le jeton d’API PTC à votre dépôt au bon endroit.
| Fournisseur | Où ajouter le jeton |
|---|---|
| Actions GitHub | Accédez à Paramètres → Secrets et variables → Actions et ajoutez PTC_API_TOKEN. Ensuite, accédez à Paramètres → Actions → Général et activez Autorisations de workflow afin que le workflow puisse créer des demandes d’extraction. |
| GitLab CI/CD | Accédez à Paramètres → CI/CD → Variables et ajoutez PTC_API_TOKEN. |
| Pipelines Bitbucket | Accédez à Paramètres du dépôt → Pipelines → Variables du dépôt et ajoutez PTC_API_TOKEN. |
Étape 5
Copiez la configuration CI/CD prête à l’emploi.
You can get the ready-made CI/CD configuration for your platform from the PTC CLI wiki. These templates already include the steps to download and run the CLI.
Étape 6
Exécutez le workflow.
Vous pouvez déclencher le workflow manuellement, sur les commits qui mettent à jour les fichiers de ressources ou selon un calendrier. Voir les déclencheurs pour GitHub, GitLab et Bitbucket.
Lorsqu’il s’exécute, la CLI télécharge vos fichiers, attend que les traductions soient terminées et réécrit les traductions mises à jour dans votre dépôt. Si vous utilisez les configurations prêtes à l’emploi, le workflow créera également une demande d’extraction/de fusion avec les modifications, afin que vous puissiez les examiner et les fusionner comme toute autre mise à jour de code. À partir de là, vos traductions restent synchronisées automatiquement.
Exemples de CI/CD
WordPress
Ruby on rails
Fichiers JSON (applications React)
Pour en savoir plus
Pourquoi utiliser PTC pour les traductions de logiciels ?
PTC est un système de traduction complet pour les développeurs et les équipes de produits, conçu pour maintenir votre code, votre marque et votre public synchronisés.
Des traductions tenant compte du contexte qui protègent votre marque
Avant de traduire, PTC s’informe sur votre produit, votre public et votre terminologie. C’est pourquoi 99,5 % des phrases sont mises en ligne sans modifications et 85 % des projets ne sont pas modifiés du tout.
Comment les traductions d’IA de PTC protègent votre marque →
Prise en charge étendue des plateformes et des formats de fichiers
PTC fonctionne avec les formats de fichiers de ressources et les plateformes les plus populaires, notamment :
Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify et WordPress.
Traduire plus que des fichiers de ressources
Besoin de traduire des notes de version, des e-mails ou de la documentation ? PTC comprend également une fonctionnalité « Coller pour traduire » rapide qui vous offre les mêmes traductions tenant compte du contexte pour le texte en dehors du code.
Comment traduire du texte en dehors des fichiers de ressources →
Automatisez les traductions dans votre CI/CD
Configurez PTC une seule fois, et vos fichiers de ressources et vos traductions restent automatiquement mis à jour dans votre pipeline CI/CD.
