Integrazione di GitLab con PTC
Colleghi GitLab a PTC per una localizzazione continua. Riceva le traduzioni tramite merge request automatiche ogni volta che il suo codice cambia.
Come integrare GitLab con PTC
PTC si collega al suo repository GitLab e mantiene tradotti i suoi file di risorse mentre lavora. Esegua il push delle modifiche al suo 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 attiva Pay-As-You-Go.
Colleghi il suo repository GitLab
PTC supporta sia GitLab.com sia i repository GitLab self-hosted. A seconda del punto in cui si trova nel suo flusso di lavoro, ci sono due modi per iniziare:
- Quando crea un nuovo progetto in PTC, selezioni 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, vada in Settings → Merge Requests e faccia clic su Add Git Integration.
In entrambi i casi, vedrà una schermata in cui può inserire l'URL del suo progetto all'interno del repository. PTC rileverà automaticamente che sta usando GitLab.
Si autentichi con GitLab
Per collegare il suo repository, può usare un access token (consigliato) oppure accedere con OAuth. PTC supporta sia i project access token sia i group access token.
PTC richiede l'accesso ai webhook per rilevare le modifiche nel suo repository. Quando usa un access token, il ruolo e gli scope necessari dipendono da come desidera configurare il webhook:
| Configurazione automatica del webhook | Configurazione manuale del webhook | |
|---|---|---|
| Come funziona | PTC crea e configura il webhook in GitLab per suo conto durante il flusso di integrazione. | PTC le fornisce una Callback URL e un Secret Token. Lei crea un webhook nelle impostazioni di GitLab usando questi dati, con Push events e Merge request events come trigger. |
| Creazione del token | Nel suo progetto, vada in Settings → Access Tokens. Assegni al token un nome, una descrizione facoltativa e imposti una data di scadenza (consigliata per sicurezza). | Nel suo gruppo, vada in Settings → Access Tokens. Assegni al token un nome, una descrizione facoltativa e imposti una data di scadenza (consigliata per sicurezza). |
| Ruolo richiesto | Maintainer | Developer (o equivalente) |
| Scope | api → Consente a PTC di leggere dal repository ed eseguire il push verso di esso |
read_repository + write_repository |
Conservi il token in modo sicuro e lo aggiunga a PTC. Verificherà i suoi permessi e le consentirà di scegliere quali branch e file di risorse monitorare.
L'accesso resta limitato ai file che PTC traduce
PTC usa l'accesso in lettura per rilevare le modifiche nei suoi file di risorse e l'accesso in scrittura per consegnare le traduzioni tramite pull request. PTC interagisce solo con i file che gestisce per la traduzione e non apporta modifiche ad altre parti del suo repository.
I webhook mantengono le traduzioni sincronizzate automaticamente
I webhook sono il modo in cui PTC viene avvisato quando esegue il push di modifiche al suo repository, così da poter ritradurre automaticamente le stringhe interessate. Senza l'accesso ai webhook, PTC non può monitorare gli aggiornamenti dei suoi branch.
Traduca il suo progetto con PTC
Una volta collegato il suo repository GitLab, prosegua con i passaggi di configurazione per fornire un po' di contesto sulla sua app o sul suo software e scegliere le lingue di destinazione.
PTC tradurrà quindi i file di risorse nel suo branch GitLab collegato. Se il suo repository contiene già file di traduzione, PTC può rilevarli e riutilizzarli.
Riveda la merge request con le traduzioni
PTC traduce in pochi minuti e invia una merge request con le traduzioni direttamente al suo repo GitLab. Quando è pronto, basta eseguirne il merge - non serve nessun'altra azione.
Da quel momento in poi, man mano che esegue il push di modifiche al suo codice, PTC le rileva e invia nuove merge request con traduzioni aggiornate, mantenendo il suo software completamente localizzato nel tempo.
Generi nuove merge request manualmente
Oltre agli aggiornamenti automatici, può generare una nuova merge request in qualsiasi momento per sincronizzare le traduzioni che ha modificato o ritradotto.
Per farlo, vada alla scheda Translations. Da qui può rivedere il testo tradotto che supera il limite di lunghezza e modificarlo manualmente oppure lasciare che PTC generi una versione più breve. Al termine, faccia clic su Generate MR per eseguire il push delle traduzioni aggiornate verso il suo repository.
Dia a PTC l'accesso ai nuovi file di risorse man mano che li aggiunge
Se aggiunge nuovi file di risorse al suo repository dopo l'integrazione iniziale, può chiedere a PTC di cercarli.
- Vada in Settings → Monitored Files e faccia clic su Rescan your repository. PTC analizzerà il suo repository e mostrerà come bozze tutti i file appena rilevati.
- Faccia clic sull'icona + accanto a un file per includerlo nella traduzione, quindi faccia clic su Save with translation per confermare.
Per saltare completamente la revisione manuale, selezioni la casella Automatically include new translation files. Da quel momento in poi, PTC includerà e monitorerà automaticamente qualsiasi nuovo file di risorse che trova, senza richiederne la conferma.
Per regolare altre impostazioni come i branch monitorati e le lingue, navighi 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 suoi file di risorse, consegnando le traduzioni tramite merge request. Lei mantiene il controllo usando il flusso di lavoro GitLab che già conosce e di cui si fida - e senza dover creare alcuno script.
Meno lavoro manuale
PTC fa risparmiare tempo di sviluppo e accelera i rilasci monitorando il suo repository e aggiornando i file di traduzione man mano che esegue il push delle modifiche.
Maggiore precisione delle traduzioni
PTC elimina il rischio di errori umani come chiavi fuori posto o traduzioni obsolete. Ottiene traduzioni estremamente precise e in linea con il suo brand.
La localizzazione tiene il passo con lo sviluppo software e mobile
PTC è progettato per i team che creano prodotti software e app mobili e che vogliono che la localizzazione tenga il passo con lo sviluppo. Una volta collegato il suo repository GitLab, PTC rileva automaticamente le stringhe nuove e aggiornate e restituisce le traduzioni tramite una merge request, senza alcun passaggio manuale.
I formati comuni nei progetti software e mobili - 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, consulti le nostre pagine sulla localizzazione del software e sulla localizzazione delle app mobili.
Colleghi GitLab senza costi aggiuntivi
Non c'è alcun costo aggiuntivo per collegare GitLab. Anziché un modello in abbonamento, PTC usa una semplice tariffazione Pay-As-You-Go: paga solo per le parole che traduce 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 e le stesse funzionalità di localizzazione automatizzata per ciascuna piattaforma.