Intégrez la localisation à votre pipeline CI/CD avec l'API PTC

Découvrez comment intégrer l'API PTC à votre pipeline CI/CD pour fournir des traductions par IA de qualité humaine dans le cadre de votre processus de build.

Sécurisé par conception — aucun accès en lecture ou en écriture au dépôt n'est requis.
Compatible avec tout 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.

Comment fonctionne l'intégration CI/CD

Avant de configurer PTC avec votre système d'intégration continue, voici les trois principes qui sous-tendent l'API PTC et la CLI :

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, afin que les traductions de différentes fonctionnalités ne s'écrasent pas mutuellement. Lorsque vous utilisez les configurations CI/CD prêtes à l'emploi, cette association est déjà gérée automatiquement.

2. Les traductions sont traitées de manière asynchrone

PTC ne renvoie pas les traductions immédiatement. À la place, il :

Envoie les fichiers mis à jour
Identifie uniquement les chaînes nouvelles ou modifiées
Traduit les chaînes
Prépare les fichiers traduits pour le téléchargement

3. Un seul script CLI fonctionne partout

Au lieu d'appeler l'API vous-même, utilisez la CLI PTC :

Un seul script gère l'ensemble du flux de travail (envoi → interrogation périodique → téléchargement). La CLI s'exécute sur Linux et macOS, et fonctionne avec GitHub Actions, GitLab, Bitbucket ou toute autre plateforme CI/CD.

Flux de travail global : configurer l'API PTC dans votre pipeline CI/CD

1Inscrivez-vous pour un essai.

Obtenez un accès complet à toutes les fonctionnalités et traduisez jusqu'à 20 000 mots dans les deux langues de votre choix.

2Créez un nouveau projet.

Lors du choix de la méthode d'utilisation de PTC, sélectionnez Intégration API. Pendant la configuration, vous fournirez un peu de contexte sur votre projet (ce qu'il fait, à qui il s'adresse) et sélectionnerez les langues vers lesquelles vous souhaitez traduire.

3Obtenez votre jeton d'API.

À la fin de la configuration, vous recevrez un jeton d'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 pourrez toujours retrouver ce même jeton dans le tableau de bord de votre projet sous Paramètres → Jetons API PTC.

Obtention du jeton d'API PTC lors de la configuration du projet — Obtention du jeton d'API lors de la configuration du projet

Obtention du jeton d'API PTC depuis le tableau de bord — Obtention du jeton d'API depuis le tableau de bord PTC

4Ajoutez le jeton d'API PTC à votre dépôt au bon emplacement.

Fournisseur	Où ajouter le jeton
GitHub Actions	Allez dans Settings → Secrets and variables → Actions et ajoutez `PTC_API_TOKEN`. Ensuite, allez dans Settings → Actions → General → Workflow permissions et activez Allow GitHub Actions to create and approve pull requests. Le fichier du flux de travail demande déjà l'accès en écriture dont il a besoin ; cette case à cocher est la seule chose qu'il ne peut pas s'accorder lui-même.
GitLab CI/CD	Allez dans Settings → CI/CD → Variables et ajoutez `PTC_API_TOKEN`.
Bitbucket Pipelines	Allez dans Repository settings → Pipelines → Repository variables et ajoutez `PTC_API_TOKEN`.

5Copiez la configuration CI/CD prête à l'emploi.

Sur GitHub Actions, ajoutez l'action PTC Translate à votre flux de travail. Votre jeton d'API est la seule entrée que vous devez transmettre. L'action intègre une version fixe de la CLI, de sorte que votre build ne télécharge jamais de script au moment de l'exécution, et lorsqu'une exécution produit de nouvelles traductions, elle ouvre la pull request pour vous.

Sur GitLab CI, Bitbucket Pipelines ou toute autre plateforme, copiez la tâche correspondant à votre plateforme à partir des modèles CI/CD de la CLI PTC. Chaque modèle épingle la CLI à une version spécifique et publie la somme de contrôle pour la vérifier, de sorte qu'une version ultérieure de la CLI ne peut pas modifier ce que votre build exécute.

6Exécutez le flux de travail.

Vous pouvez déclencher le flux de travail manuellement, lors de commits qui mettent à jour des fichiers de ressources, ou de manière planifiée. Consultez les déclencheurs pour GitHub, GitLab et Bitbucket. Une pull request a besoin d'une branche cible pour s'ouvrir ; ainsi, sur GitHub Actions, l'action PTC Translate en ouvre une lors d'un push, d'une exécution planifiée et d'une exécution manuelle depuis une branche. Lors d'un événement pull_request, pull_request_target ou merge_group, ou lors de la création d'une étiquette ou d'une version, elle s'arrête avec une explication à la place : traduisez lors d'un push vers votre branche source, ou définissez create-pr: false pour cette exécution.

Lors de son exécution, la CLI envoie vos fichiers, attend la fin des traductions et réinscrit les traductions mises à jour dans votre dépôt. Si vous utilisez les configurations prêtes à l'emploi et que l'exécution a produit de nouvelles traductions, le flux de travail va également create a merge request avec les modifications, afin que vous puissiez les réviser et les fusionner comme n'importe quelle autre mise à jour de code. Une exécution qui ne trouve rien à traduire n'écrit rien et n'ouvre aucune merge request. À partir de là, vos traductions restent synchronisées automatiquement.

Exemples CI/CD

WordPress

Ruby on Rails

GitHub Actions

Fichiers JSON (Applications React)

Pour aller plus loin

Pourquoi utiliser PTC pour les traductions de logiciels ?

PTC est un système de traduction complet pour les développeurs et les équipes produit, conçu pour maintenir votre code, votre marque et votre public en parfaite synchronisation.

Des traductions contextuelles 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 passent en production sans modification, et 85 % des projets ne sont pas modifiés du tout.

Comment les traductions par IA de PTC protègent votre marque →

Vaste prise en charge des plateformes et 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.

En savoir plus sur les formats de fichiers pris en charge →

Traduisez plus que des fichiers de ressources

Besoin de traduire des notes de version, des e-mails ou de la documentation ? PTC inclut également une fonctionnalité rapide « Paste to translate » qui vous offre les mêmes traductions contextuelles 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 traductions restent mis à jour automatiquement dans votre pipeline CI/CD.