Integri la localizzazione nella sua pipeline CI/CD con l'API PTC
Scopra come integrare l'API PTC nella sua pipeline CI/CD per fornire traduzioni con IA di qualità umana come parte del suo processo di build.
Sicuro fin dalla progettazione: 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 il progetto.
- Traduzioni di qualità umana fornite in pochi minuti, direttamente nella sua build.
Come funziona l'integrazione CI/CD
Prima di configurare PTC con il suo sistema CI, ecco i tre principi alla base dell'API e della CLI di PTC:
I file di risorse sono legati a un branch
Ogni file che invia a PTC è collegato a un nome di branch (ad esempio, main, feature/new-checkout). Questo mantiene separate le traduzioni, in modo che il lavoro di funzionalità diverse non si sovrascriva a vicenda.
Quando utilizza le configurazioni CI/CD pronte all'uso, questa mappatura è già gestita automaticamente.
Le traduzioni vengono elaborate in modo asincrono
PTC non restituisce le traduzioni immediatamente. Invece:
- Prepara i file tradotti per il download
- Carica i file aggiornati
- Identifica solo le stringhe nuove o modificate
- Traduce le stringhe
Un unico script CLI funziona ovunque
Invece di chiamare l'API da sé, utilizzi la PTC CLI:
Un unico script gestisce l'intero flusso (caricamento → polling → download). La CLI è ospitata su GitHub ma funziona su Linux, macOS, GitHub Actions, GitLab, Bitbucket o qualsiasi altra piattaforma CI/CD.
Panoramica: configuri l'API PTC nella sua pipeline CI/CD
1Si iscriva per una prova gratuita.
Ottenga l'accesso completo a tutte le funzionalità e traduca fino a 20.000 parole in due lingue a sua scelta.
2Crei un nuovo progetto.
Quando sceglie come utilizzare PTC, selezioni API integration. Durante la configurazione, fornirà un po' di contesto sul suo progetto (cosa fa, a chi è destinato) e selezionerà le lingue in cui desidera tradurre.
3Ottenga il suo token API.
Al termine della configurazione, riceverà un token API specifico per il progetto. Lo copi e lo conservi in modo sicuro: ne avrà bisogno per autenticare tutte le richieste. Può sempre ritrovare lo stesso token nel pannello di controllo del suo progetto sotto Settings → PTC API tokens.
4Aggiunga il token API PTC al suo repository nella posizione corretta.
| Fornitore | Dove aggiungere il token |
|---|---|
| GitHub Actions | Vada su Settings → Secrets and variables → Actions e aggiunga PTC_API_TOKEN. Poi vada su Settings → Actions → General e abiliti Workflow permissions in modo che il workflow possa creare pull request. |
| GitLab CI/CD | Vada su Settings → CI/CD → Variables e aggiunga PTC_API_TOKEN. |
| Bitbucket Pipelines | Vada su Repository settings → Pipelines → Repository variables e aggiunga PTC_API_TOKEN. |
5Copi la configurazione CI/CD pronta all'uso.
Può ottenere la configurazione CI/CD pronta all'uso per la sua piattaforma dalla wiki della PTC CLI. Questi modelli includono già i passaggi per scaricare ed eseguire la CLI.
6Esegua il workflow.
Può attivare il workflow manualmente, sui commit che aggiornano i file di risorse, o secondo una pianificazione. Veda i trigger per GitHub, GitLab e Bitbucket.
Quando viene eseguita, la CLI carica i suoi file, attende il completamento delle traduzioni e riscrive le traduzioni aggiornate nel suo repository. Se utilizza le configurazioni pronte all'uso, il workflow creerà anche una pull/merge request con le modifiche, così può revisionarle e unirle come qualsiasi altro aggiornamento di codice. Da qui in poi, le sue traduzioni rimangono sincronizzate automaticamente.
Esempi CI/CD
WordPress
Ruby on Rails
JSON Files (React Apps)Approfondimenti
Perché usare PTC per le traduzioni di software?
PTC è un sistema di traduzione completo per sviluppatori e team di prodotto, creato per mantenere sincronizzati il suo codice, il suo brand e il suo pubblico.
Traduzioni contestuali che proteggono il suo brand
Prima di tradurre, PTC apprende informazioni sul suo prodotto, sul suo pubblico e sulla sua terminologia. Ecco perché il 99,5% delle frasi viene pubblicato senza modifiche e l'85% dei progetti non viene modificato affatto.
Come le traduzioni con IA di PTC proteggono il suo brand →
Ampio supporto di piattaforme e formati di file
PTC funziona con i formati di file di risorse e le piattaforme più popolari, 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 →
Traduca più dei semplici file di risorse
Ha bisogno di tradurre note di rilascio, e-mail o documentazione? PTC include anche una rapida funzione «Incolla per tradurre» che le offre le stesse traduzioni contestuali per il testo al di fuori del codice.
Come tradurre testo al di fuori dei file di risorse →
Automatizzi le traduzioni nella sua CI/CD
Configuri PTC una sola volta e i suoi file di risorse e le traduzioni rimarranno aggiornati automaticamente nella sua pipeline CI/CD.