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

Découvrez comment intégrer l'API PTC dans 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 (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, 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, 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 :

• 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 processus (envoi → interrogation → 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.

Processus 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 deux langues de votre choix.

2Créez un nouveau projet.

Au moment de choisir comment utiliser PTC, sélectionnez API integration. 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 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 stockez-le en toute sécurité — 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 Settings → PTC API tokens.

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

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

Sur GitHub Actions, ajoutez l'action PTC Translate à votre workflow. 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 elle ouvre la pull request de traduction pour vous.

Sur GitLab CI, Bitbucket Pipelines ou toute autre plateforme, copiez le job 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 puisse pas modifier ce que votre build exécute.

6Exécutez le workflow.

Vous pouvez déclencher le workflow manuellement, lors de commits qui mettent à jour les fichiers de ressources, ou selon une planification. Consultez les déclencheurs pour GitHub, GitLab et Bitbucket.

Lorsqu'il s'exécute, 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, le workflow 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. À partir de là, vos traductions restent synchronisées automatiquement.

Exemples CI/CD

WordPress

• GitHub Actions

Ruby on Rails

• GitHub Actions

Fichiers JSON (Applications React)

• GitHub Actions

Lectures complémentaires

• Entrées de l'action PTC Translate
• Modèles CI/CD pour GitHub et GitLab
• Fichier de configuration
• Workflow de traitement
• Dépannage

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 intègre é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.