Localizzazione GitHub
Automatizza la localizzazione di GitHub integrandolo con PTC. Ricevi pull request automatiche contenenti traduzioni di qualità umana.
Come integrare GitHub con PTC
PTC si connette al tuo repository GitHub e mantiene i tuoi file di risorse tradotti mentre lavori. Invia le modifiche al tuo codice e PTC le rileverà automaticamente, tradurrà le stringhe aggiornate e aprirà una pull request — il tutto senza alcun passaggio manuale da parte tua.
L’integrazione Git è una funzionalità Pro. Diventa disponibile quando attivi il piano Pay-As-You-Go.
Connetti il tuo repository
Iniziare con l’integrazione GitHub è semplice:
- Se hai già un account PTC e stai creando un nuovo progetto, seleziona Git Integration nella procedura guidata di configurazione.
- Se hai iniziato con un caricamento manuale dei file, puoi passare a un flusso di lavoro continuo basato su Git in qualsiasi momento. 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 il servizio che stai utilizzando.
Autenticati in GitHub
Per consentire a PTC l’accesso al tuo repository, puoi utilizzare un token di accesso (scelta consigliata) o accedere tramite OAuth. Se ti connetti utilizzando un token di accesso, assicurati che includa gli scope corretti e l’accesso al repository.
| Dove crearlo | Proprietario della risorsa | Permessi richiesti | Accesso al repository | |
|---|---|---|---|---|
| Personal Fine-Grained Token | Personal access tokens in Developer Settings | Il tuo account utente GitHub | Commit statuses → Read-only Contents → Read and write Pull requests → Read and write Webhooks → Read and write |
Scegli “Only select repositories” (consigliato) o “All repositories” |
| Organization Fine-Grained Token | Personal access tokens in Developer Settings Importante: la creazione di un fine-grained access token potrebbe essere limitata dalle policy di accesso della tua organizzazione. Se non riesci a creare il token, chiedi a un amministratore dell’organizzazione di controllare le impostazioni della Personal Access Token Policy in GitHub. |
L’organizzazione GitHub | Commit statuses → Read-only Contents → Read and write Pull requests → Read and write Webhooks → Read and write |
Scegli “Only select repositories” (consigliato) o “All repositories” |
Conserva il token in modo sicuro e aggiungilo a PTC. Il sistema verificherà i tuoi permessi e ti chiederà di scegliere quali branch monitorare.
Traduci i file nel tuo repository con PTC
Una volta collegato il tuo repository GitHub a PTC, prosegui con la configurazione per aggiungere le lingue e i dettagli del progetto.
Sebbene PTC possa lavorare con i file di traduzione esistenti nel tuo repository, tradurre l’intero progetto con PTC garantisce coerenza in tutte le lingue.
Controlla le pull request
PTC impiega solitamente solo pochi minuti per tradurre i file nel branch GitHub selezionato. Una volta completata l’operazione, PTC ti invierà un’e-mail con un link alla pull request.
Controlla e approva la pull request quando sei pronto. Le traduzioni di PTC sono pronte per la produzione e possono essere unite senza revisione manuale.
Dopo aver unito le prime traduzioni, PTC continuerà a monitorare i tuoi file di risorse e invierà nuove pull request con le traduzioni aggiornate ogni volta che verranno rilevate modifiche.
Come generare manualmente nuove pull request
Vai alla scheda Translations in PTC per vedere le traduzioni in ogni lingua selezionata, organizzate in una tabella. Da questa pagina puoi apportare modifiche o chiedere a PTC di tradurre nuovamente — ad esempio, quando le traduzioni superano un limite di lunghezza.
Clicca su Create a pull request per inviare una nuova pull request con le traduzioni aggiornate.
Aggiungi nuovi file di risorse per la traduzione
Se aggiungi nuovi file di risorse al tuo repository dopo la connessione con PTC, puoi chiedere a PTC di cercarli.
- Vai su Settings → Monitored Files e clicca su Rescan your repository. PTC eseguirà la scansione del repository e mostrerà tutti i file appena scoperti come bozze.
- Clicca sull’icona + accanto a un file scoperto per includerlo nella traduzione, quindi clicca su Save with translation per confermare.
Seleziona la casella di controllo Automatically include new translation files per fare in modo che PTC monitori e includa i nuovi file di risorse scoperti senza chiedere conferma ogni volta.
Perché localizzare i tuoi progetti GitHub con PTC
Connessione semplice al tuo repository
PTC si integra direttamente con il tuo repository GitHub, eliminando i caricamenti e i download manuali dei file o la necessità di eseguire script di traduzione fai-da-te.
Sincronizzazione in tempo reale
PTC monitora il tuo repository GitHub per rilevare modifiche nei file di risorse, genera automaticamente le traduzioni e le invia indietro tramite pull request.
Localizzazione più rapida per i mercati globali
PTC accelera il processo di localizzazione fornendo traduzioni di alta qualità automaticamente tramite pull request. Adatta rapidamente il tuo software per i mercati globali e riduci il time-to-market.
Solo l’accesso al repository necessario
PTC utilizza l’accesso in lettura per rilevare le modifiche nei 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 repository.
Localizzazione al passo con il tuo ciclo di rilascio
PTC è progettato per i team di sviluppo che desiderano che la localizzazione proceda allo stesso ritmo del codice. PTC monitora il tuo repository per individuare stringhe nuove o aggiornate e restituisce automaticamente le traduzioni tramite pull request, in modo che la localizzazione non diventi mai un collo di bottiglia nel tuo ciclo di rilascio.
Funziona con i formati di file comuni nello sviluppo software e mobile, inclusi i file PO e i file JSON. 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.
Funziona con GitHub, GitLab e Bitbucket
Oltre a GitHub, PTC si integra con GitLab e Bitbucket, offrendo gli stessi flussi di lavoro e funzionalità di localizzazione automatizzata per ogni piattaforma.
Incluso senza costi aggiuntivi
L’integrazione con GitHub è inclusa senza costi aggiuntivi. PTC non prevede canoni di abbonamento o costi per singola funzionalità. Paghi solo per le parole che traduci e le prime 500 parole ogni mese sono gratuite. Per i dettagli completi sui prezzi, consulta la pagina dei prezzi.