Integrazione di GitLab con PTC
Collega GitLab con PTC per una traduzione continua. Ricevi le traduzioni tramite merge request automatiche ogni volta che il tuo codice cambia.
Come integrare GitLab con PTC
PTC si connette al tuo repository GitLab e mantiene tradotti i tuoi file di risorse mentre lavori. Invia le modifiche al tuo codice e PTC le rileverà automaticamente, tradurrà le stringhe aggiornate e aprirà una merge request.
L’integrazione con GitLab è una funzionalità Pro. Diventa disponibile quando attivi il piano Pay-As-You-Go.
Collega il tuo repository GitLab
PTC supporta sia i repository su GitLab.com che quelli GitLab self-hosted. A seconda della fase del tuo flusso di lavoro, ci sono due modi per iniziare:
- Quando crei un nuovo progetto in PTC, seleziona Git Integration nella procedura guidata di configurazione.
- Per passare un progetto esistente dal caricamento manuale dei file a un flusso di lavoro continuo basato su Git, vai su Settings → Merge Requests e clicca su Add Git Integration.
In entrambi i casi, vedrai una schermata in cui potrai inserire l’URL del tuo progetto all’interno del repository. PTC rileverà automaticamente che stai usando GitLab.
Autenticazione con GitLab
Per collegare il tuo repository, puoi usare un token di accesso (scelta consigliata) o accedere tramite OAuth. PTC supporta sia i token di accesso al progetto che quelli di gruppo.
PTC richiede l’accesso ai webhook per rilevare le modifiche nel tuo repository. Quando usi un token di accesso, il ruolo e gli ambiti (scope) necessari dipendono da come desideri configurare il webhook:
| Configurazione automatica del webhook | Configurazione manuale del webhook | |
|---|---|---|
| Come funziona | PTC crea e configura il webhook in GitLab per tuo conto durante il flusso di integrazione. | PTC ti fornisce un Callback URL e un Secret Token. Crei un webhook nelle impostazioni di GitLab usando questi dettagli, con eventi Push e Merge request come trigger. |
| Creazione del token | Nel tuo progetto, vai su Settings → Access Tokens. Dai un nome al token, una descrizione opzionale e imposta una expiry date (consigliato per sicurezza). | Nel tuo gruppo, vai su Settings → Access Tokens. Dai un nome al token, una descrizione opzionale e imposta una expiry date (consigliato per sicurezza). |
| Ruolo richiesto | Maintainer | Developer (o equivalente) |
| Ambiti (Scopes) | api → Permette a PTC di leggere dal repository e inviare modifiche |
read_repository + write_repository |
Conserva il token in modo sicuro e aggiungilo a PTC. Il sistema verificherà i tuoi permessi e ti permetterà di scegliere quali branch e file di risorse monitorare.
L’accesso rimane limitato ai file tradotti da PTC
PTC utilizza l’accesso in lettura per rilevare le modifiche nei tuoi file di risorse e l’accesso in scrittura per consegnare le traduzioni tramite merge request. PTC interagisce solo con i file che gestisce per la traduzione e non apporta modifiche a nessun’altra parte del tuo repository.
I webhook mantengono le traduzioni sincronizzate automaticamente
I webhook sono il modo in cui PTC riceve una notifica quando invii modifiche al tuo repository, così può ritradurre automaticamente le stringhe interessate. Senza l’accesso ai webhook, PTC non può monitorare i tuoi branch per gli aggiornamenti.
Traduci il tuo progetto con PTC
Una volta collegato il tuo repository GitLab, prosegui con i passaggi di configurazione per fornire un po’ di contesto sulla tua app o software e scegli le tue lingue di destinazione.
PTC tradurrà quindi i file di risorse nel branch GitLab collegato. Se il tuo repository contiene già dei file di traduzione, PTC può rilevarli e riutilizzarli.
Revisiona la merge request con le traduzioni
PTC traduce in pochi minuti e invia una merge request con le traduzioni direttamente al tuo repository GitLab. Quando sei pronto, ti basta approvarla: non è necessaria nessun’altra azione.
Da quel momento in poi, man mano che invii modifiche al tuo codice, PTC le rileverà e invierà nuove merge request con le traduzioni aggiornate, mantenendo il tuo software completamente localizzato nel tempo.
Genera nuove merge request manualmente
Oltre agli aggiornamenti automatici, puoi generare una nuova merge request in qualsiasi momento per sincronizzare le traduzioni che hai modificato o ritradotto.
Per farlo, vai alla scheda Translations. Da qui, puoi revisionare il testo tradotto che supera il limite di lunghezza e modificarlo manualmente o lasciare che PTC generi una versione più breve. Una volta terminato, clicca su Generate MR per inviare le traduzioni aggiornate al tuo repository.
Dai a PTC l’accesso ai nuovi file di risorse man mano che li aggiungi
Se aggiungi nuovi file di risorse al tuo repository dopo l’integrazione iniziale, puoi chiedere a PTC di cercarli.
- Vai su Settings → Monitored Files e clicca su Rescan your repository. PTC eseguirà la scansione del tuo repository e mostrerà tutti i file appena scoperti come bozze.
- Clicca sull’icona + accanto a un file per includerlo nella traduzione, quindi clicca su Save with translation per confermare.
Per saltare completamente la revisione manuale, seleziona la casella Automatically include new translation files. Da quel momento in poi, PTC rileverà e monitorerà automaticamente tutti i nuovi file di risorse che trova, senza richiedere la tua conferma.
Per regolare altre impostazioni come i branch monitorati e le lingue, naviga tra le schede Branch Management, Monitored Files e Languages.
Perché localizzare i progetti GitLab con PTC
Traduzione automatizzata dei file
PTC rileva e traduce automaticamente i tuoi file di risorse, consegnando le traduzioni tramite merge request. Mantieni il controllo utilizzando il flusso di lavoro di GitLab che già conosci e di cui ti fidi — e senza la necessità di creare alcuno script.
Meno lavoro manuale
PTC fa risparmiare tempo di sviluppo e accelera i rilasci monitorando il tuo repository e aggiornando i file di traduzione man mano che invii le modifiche.
Maggiore accuratezza della traduzione
PTC elimina il rischio di errori umani come chiavi fuori posto o traduzioni non aggiornate. Ottieni traduzioni altamente accurate e in linea con la voce del tuo brand.
La localizzazione tiene il passo con lo sviluppo software e mobile
PTC è progettato per i team che creano prodotti software e app mobile e che desiderano che la localizzazione tenga il passo con lo sviluppo. Una volta collegato il tuo repository GitLab, PTC rileva automaticamente le stringhe nuove e aggiornate e restituisce le traduzioni tramite una merge request, senza bisogno di passaggi manuali.
I formati comuni nei progetti software e mobile — come i file PO e i file JSON — sono pienamente supportati. Per saperne di più su come PTC si inserisce in questi flussi di lavoro, consulta le nostre pagine sulla localizzazione software e sulla localizzazione di app mobile.
Collega GitLab senza costi aggiuntivi
Non ci sono costi aggiuntivi per il collegamento di GitLab. Invece di un modello in abbonamento, PTC utilizza un semplice prezzo Pay-As-You-Go: paghi solo per le parole che traduci e le prime 500 parole ogni mese sono gratuite. Tutti i dettagli sono sulla pagina dei prezzi di PTC.
Funziona anche con GitHub e Bitbucket
Oltre a GitLab, PTC si integra con GitHub e Bitbucket, offrendo gli stessi flussi di lavoro di localizzazione automatizzati e le stesse funzionalità per ogni piattaforma.