Localizzazione per GitHub
Automatizza la localizzazione per GitHub integrando PTC. Ottieni pull request automatici contenenti traduzioni di qualità umana.
Come integrare GitHub con PTC
PTC si connette al tuo repository GitHub e mantiene tradotti i tuoi file di risorse mentre lavori. Esegui il push delle modifiche al codice e PTC le rileverà automaticamente, tradurrà le stringhe aggiornate e aprirà un pull request, il tutto senza alcun passaggio manuale da parte tua.
L'integrazione Git è una funzionalità Pro. Diventa disponibile quando attivi il Pay-As-You-Go.
Collega il tuo repository
Iniziare con l'integrazione GitHub è facile:
- Se hai già un account PTC e stai creando un nuovo progetto, seleziona integrazione Git nella configurazione guidata.
- Se hai iniziato con un caricamento manuale dei file, puoi passare a un flusso di lavoro continuo basato su Git in qualsiasi momento. Vai a Impostazioni → 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 dare a PTC l'accesso al tuo repository, puoi usare un access token (consigliato) o accedere con OAuth. Se ti colleghi usando un access token, assicurati che includa gli scope corretti e l'accesso al repository.
| Dove crearlo | Resource owner | Permessi richiesti | Accesso al repository | |
|---|---|---|---|---|
| Fine-grained token personale | 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” |
| Fine-grained token dell'organizzazione | Personal access tokens in Developer Settings Importante: la creazione di un fine-grained access token potrebbe essere limitata dai criteri di accesso della tua organizzazione. Se non riesci a creare il token, chiedi a un amministratore dell'organizzazione di rivedere le impostazioni 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. Verificherà i tuoi permessi e ti chiederà di scegliere quali branch monitorare.
Traduci i file nel tuo repository con PTC
Una volta che il tuo repository GitHub è collegato a PTC, continua con la configurazione per aggiungere le lingue e i dettagli del progetto.
Sebbene PTC possa funzionare con i file di traduzione esistenti nel tuo repository, tradurre l'intero progetto con PTC garantisce coerenza in tutte le lingue.
Controlla i pull request
In genere, PTC impiega solo pochi minuti per tradurre i file nel branch GitHub selezionato. Una volta completato, PTC ti invierà un'e-mail con un link al pull request.
Rivedi e approva il pull request quando sei pronto. Le traduzioni di PTC sono di qualità da produzione e puoi effettuarne il merge senza revisione manuale.
Dopo aver eseguito il merge delle prime traduzioni, PTC continua a monitorare i tuoi file di risorse e invierà nuovi pull request con le traduzioni aggiornate ogni volta che verranno rilevate delle modifiche.
Come generare nuovi pull request manualmente
Vai alla scheda Translations in PTC per vedere le traduzioni in ogni lingua che hai selezionato, organizzate in una tabella. Da questa pagina, puoi apportare modifiche o chiedere a PTC di ritradurre, ad esempio, quando le traduzioni superano un limite di lunghezza.
Clicca su Create a merge request per inviare un nuovo pull request con le traduzioni aggiornate.
Aggiungi nuovi file di risorse per la traduzione
Se aggiungi nuovi file di risorse al tuo repository dopo esserti collegato a PTC, puoi chiedere a PTC di verificarne la presenza.
- Vai su Impostazioni → Monitored Files (file monitorati) e clicca su Rescan your repository. PTC scansionerà il tuo 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 file di risorse appena scoperti senza chiedere conferma ogni volta.
Perché localizzare i tuoi progetti GitHub con PTC
Connessione facile 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.
Sincronizzazione in tempo reale
PTC monitora il tuo repository GitHub alla ricerca di modifiche nei file di risorse, genera automaticamente le traduzioni e le rispedisce 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 ai mercati globali e riduci il time-to-market.
Solo l'accesso al repository di cui ha bisogno
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 tuo repository.
Una localizzazione che tiene il passo con il tuo ciclo di release
PTC è progettato per i team di sviluppo che vogliono che la localizzazione proceda di pari passo con il loro codice. PTC monitora il tuo repository alla ricerca di 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 release.
Funziona con i formati di file comuni nello sviluppo di software e app mobili, 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 del software e sulla localizzazione di app mobili.
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 GitHub è inclusa senza costi aggiuntivi. PTC non ha costi di abbonamento o addebiti 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.