Integra la localizzazione nella tua pipeline CI/CD con l'API PTC

Scopri come integrare l'API PTC nella tua pipeline CI/CD per fornire traduzioni con IA di qualità umana come parte del tuo processo di build.

• Sicuro by design: non è richiesto alcun accesso in lettura o scrittura al repository.
• Compatibile con qualsiasi sistema CI/CD, con configurazioni pronte all'uso incluse.
• Accesso controllato tramite token API specifici per progetto.
• Traduzioni di qualità umana consegnate in pochi minuti, direttamente nella tua build.

Come funziona l'integrazione CI/CD

Prima di configurare PTC con il tuo sistema CI, ecco i tre principi alla base dell'API e della CLI di PTC:

1. I file di risorse sono legati a un branch

Ogni file che invii a PTC è collegato a un nome di branch (ad es. main, feature/new-checkout). Questo mantiene le traduzioni separate, in modo che le traduzioni di funzionalità diverse non si sovrascrivano a vicenda. Quando utilizzi le configurazioni CI/CD pronte all'uso, questa mappatura viene già gestita automaticamente.

2. Le traduzioni vengono elaborate in modo asincrono

PTC non restituisce le traduzioni immediatamente. Invece:

• Carica i file aggiornati
• Identifica solo le stringhe nuove o modificate
• Traduce le stringhe
• Prepara i file tradotti per il download

3. Un solo script CLI funziona ovunque

Invece di chiamare l'API tu stesso, usa la CLI di PTC:

Un unico script gestisce l'intero flusso (caricamento → polling → download). La CLI viene eseguita su Linux e macOS e funziona con GitHub Actions, GitLab, Bitbucket o qualsiasi altra piattaforma CI/CD.

Flusso ad alto livello: configura l'API PTC nella tua pipeline CI/CD

1Iscriviti per una prova.

Ottieni pieno accesso a tutte le funzionalità e traduci fino a 20.000 parole in due lingue a tua scelta.

2Crea un nuovo progetto.

Quando scegli come usare PTC, seleziona API integration. Durante la configurazione, fornirai un po' di contesto sul tuo progetto (cosa fa, a chi è rivolto) e selezionerai le lingue in cui desideri tradurre.

3Ottieni il tuo token API.

Alla fine della configurazione, riceverai un token API specifico per il progetto. Copialo e conservalo in modo sicuro: ti servirà per autenticare tutte le richieste. Puoi sempre ritrovare lo stesso token nel pannello di controllo del tuo progetto in Impostazioni → Token API PTC.

4Aggiungi il token API PTC al tuo repository nella posizione corretta.

5Copia la configurazione CI/CD pronta all'uso.

Su GitHub Actions, aggiungi la PTC Translate action al tuo workflow. Il tuo token API è l'unico input che devi passare. L'action porta con sé una versione fissa della CLI al suo interno, in modo che la tua build non scarichi mai uno script in fase di esecuzione, e quando un'esecuzione produce nuove traduzioni apre un pull request per te.

Su GitLab CI, Bitbucket Pipelines o qualsiasi altra piattaforma, copia il job per la tua piattaforma dai template CI/CD della CLI di PTC. Ogni template blocca la CLI a una release specifica e pubblica il checksum con cui verificarla, in modo che una release successiva della CLI non possa modificare ciò che esegue la tua build.

6Esegui il workflow.

Puoi attivare il workflow manualmente, sui commit che aggiornano i file di risorse o in base a una pianificazione. Vedi i trigger per GitHub, GitLab e Bitbucket. Un pull request ha bisogno di un branch su cui aprirsi, quindi su GitHub Actions la PTC Translate action ne apre uno su un push, su una pianificazione e su un'esecuzione manuale da un branch. Su un evento pull_request, pull_request_target o merge_group, oppure su un tag o una release, si ferma invece con una spiegazione: traduci su un push al tuo branch di origine, oppure imposta create-pr: false per quell'esecuzione.

Quando viene eseguita, la CLI carica i tuoi file, attende che le traduzioni finiscano e riscrive le traduzioni aggiornate nel tuo repository. Se stai usando le configurazioni pronte all'uso e l'esecuzione ha prodotto nuove traduzioni, il workflow provvederà anche a create a merge request con le modifiche, in modo che tu possa revisionarle e fare il merge come per qualsiasi altro aggiornamento del codice. Un'esecuzione che non trova nulla da tradurre non scrive nulla e non apre alcun merge request. Da questo momento in poi, le tue traduzioni restano sincronizzate automaticamente.

Esempi CI/CD

WordPress

• GitHub Actions
• GitLab CI

Ruby on Rails

• GitHub Actions

File JSON (app React)

• GitHub Actions
• GitLab CI

Ulteriori letture

• Input della PTC Translate action
• Template CI/CD per GitHub e GitLab
• File di configurazione
• Workflow di elaborazione
• Risoluzione dei problemi

Perché usare PTC per le traduzioni di software?

PTC è un sistema di traduzione completo per sviluppatori e team di prodotto, creato per mantenere il tuo codice, il tuo brand e il tuo pubblico sincronizzati.

Traduzioni contestualizzate che proteggono il tuo brand

Prima di tradurre, PTC impara a conoscere il tuo prodotto, il tuo pubblico e la tua terminologia. Ecco perché il 99,5% delle frasi va in produzione senza modifiche e l'85% dei progetti non viene modificato affatto.

Come le traduzioni con IA di PTC proteggono il tuo brand →

Ampio supporto per piattaforme e formati di file

PTC funziona con le piattaforme e i formati di file di risorse più diffusi, tra cui: Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify e WordPress.

Maggiori informazioni sui formati di file supportati →

Traduci non solo i file di risorse

Devi tradurre note di rilascio, email o documentazione? PTC include anche una veloce funzionalità «Paste to translate» che ti offre le stesse traduzioni contestualizzate per il testo al di fuori del codice.

Come tradurre il testo al di fuori dei file di risorse →

Automatizza le traduzioni nella tua CI/CD

Configura PTC una volta sola e i tuoi file di risorse e le traduzioni resteranno aggiornati automaticamente nella tua pipeline CI/CD.