Questa guida ti illustra come creare un progetto in PTC, aggiungere i tuoi file di risorse e ottenere le tue prime traduzioni AI.
Passaggio 1
Iscriviti a PTC
Inizia creando il tuo account PTC:
- Iscriviti per una prova gratuita.
- Controlla la tua email per i dettagli di accesso.
- Accedi alla tua dashboard PTC.
Dopo aver effettuato l’accesso, fai clic su Nuovo progetto per avviare il wizard di configurazione.
Passaggio 2
Scegli come vuoi usare PTC
Scegli tra tre metodi di traduzione per il tuo progetto:
Caricamento manuale dei file
Come funziona:
Carica i tuoi file di risorse dal tuo dispositivo. PTC li traduce e restituisce un file ZIP con i tuoi file tradotti nello stesso formato.
Ideale per:
Prova subito PTC senza impostare un flusso di lavoro automatizzato.
Cosa serve:
Un file di risorse con stringhe traducibili in un formato di file supportato.
Integrazione Git
Come funziona:
Collega PTC direttamente al tuo repository GitHub, GitLab o Bitbucket. PTC monitora il tuo repository per gli aggiornamenti, traduce le stringhe nuove o modificate e fornisce le traduzioni tramite richieste di merge.
Ideale per:
Team di sviluppo che utilizzano Git e preferiscono una localizzazione continua senza aggiungere passaggi CI.
Cosa serve:
Concedi a PTC l’accesso in lettura e scrittura al tuo repository e aggiungi il tuo token di accesso nel wizard di configurazione di PTC. PTC scrive solo file di traduzione e non modifica mai il tuo codice.
Maggiori dettagli:
Consulta le guide di integrazione per i passaggi di configurazione completi: GitHub • GitLab • Bitbucket
Integrazione API
Come funziona:
Utilizza la REST API di PTC per aggiungere e aggiornare i file di origine, recuperare le informazioni sul progetto, gestire le traduzioni e integrare la localizzazione nella tua pipeline CI/CD.
Ideale per:
Progetti che necessitano di attività di traduzione attivate e gestite programmaticamente come parte del flusso di lavoro di sviluppo.
Cosa serve:
Riceverai il tuo token API nel wizard di configurazione. Includi questo token nell’intestazione Authorization di ogni richiesta.
Maggiori dettagli:
Consulta il Riferimento API di PTC per i dettagli completi sull’autenticazione e sugli endpoint.
Passaggio 2.1
Collega il tuo sito WPML (opzionale)
Se il tuo prodotto ha anche un sito web multilingue realizzato con WPML, puoi connetterlo a PTC durante la configurazione. PTC:
- Importa e sincronizza con il tuo glossario WPML
- Condividi la memoria di traduzione con l’Advanced Translation Editor di WPML
- Allinea la terminologia tra il tuo sito web e il software
- Condividi i crediti di traduzione tra WPML e PTC
Passaggio 3
Parla a PTC del tuo progetto
Fornisci a PTC il contesto del tuo software in modo che possa produrre traduzioni accurate e dal suono naturale. Questo include:
- Il nome del prodotto e una breve descrizione
- Il tuo pubblico di destinazione
- Come gestire i termini comuni (ad esempio, se tradurre “email”)
Le informazioni che fornisci qui influenzano la terminologia, il tono e la formalità delle tue traduzioni.
Passaggio 3.1
Aggiungi i tuoi file di risorse
Aggiungi i file di risorse che contengono il testo che vuoi che PTC traduca. Quindi conferma come devono essere generati i tuoi file tradotti, inclusi i nomi dei file di output e dove devono essere salvati i file tradotti.
A seconda del tuo progetto, potresti archiviare le stringhe in uno o più formati di file. PTC può tradurre un’ampia gamma di formati di file di risorse, tra cui:
Gettext.po
JSON
YAML
Adobe Commerce / Magento .csv
Android
Apple .strings
Apple .stringsdict
Apple .xcstrings
Proprietà Java
Array JSON
Visualizza tutti i formati di file supportati →
Se scegli l’integrazione API, non vedrai questo passaggio. Riceverai la tua chiave API alla fine del wizard di configurazione e caricherai i tuoi file di risorse programmaticamente.
Passaggio 3.2
Seleziona le tue lingue di destinazione
Scegli le lingue in cui vuoi che PTC traduca il tuo progetto. PTC supporta attualmente più di 33 lingue.
- Durante la prova gratuita, puoi selezionare fino a 2 lingue.
- Con un abbonamento a pagamento, puoi selezionare un numero illimitato di lingue.
Puoi aggiungere o rimuovere lingue in seguito in Impostazioni → Lingue.
Visualizza tutte le lingue supportate →
Passaggio 4
Carica le traduzioni esistenti (opzionale)
PTC offre i migliori risultati quando può tradurre il tuo progetto da zero utilizzando la sua AI e il contesto del tuo progetto.
Tuttavia, se hai già delle traduzioni esistenti, puoi caricarle durante la configurazione. PTC utilizzerà le traduzioni che fornisci e, per tutte le stringhe che non hanno traduzioni, genererà traduzioni AI.
Come caricare file con traduzioni esistenti →
Passaggio 5
Crea un glossario
PTC utilizza il contesto del tuo progetto per creare traduzioni che corrispondano al tono e al pubblico del tuo prodotto, quindi non hai bisogno di un glossario di grandi dimensioni. Aggiunge anche automaticamente il nome del tuo prodotto al glossario.
Se hai nomi di prodotti o termini di marca che richiedono traduzioni specifiche, puoi aggiungerli per garantire la coerenza.
Puoi aggiungere e gestire i termini del glossario in qualsiasi momento dopo la configurazione aprendo la scheda Glossario nella tua dashboard PTC.
Maggiori informazioni sul glossario in PTC →
Passaggio 6
Ottieni le tue traduzioni AI
Una volta terminata la configurazione del progetto, PTC tradurrà i tuoi file di risorse. Il modo in cui ricevi le tue traduzioni dipende dal metodo che hai selezionato:
Caricamento manuale dei file:
Scarica un file ZIP con le tue traduzioni dalla scheda Risorsa nella tua dashboard.
Inoltre, puoi visualizzare e modificare le traduzioni dalla scheda Traduzioni nella tua dashboard PTC.
Integrazione Git:
PTC fornisce le traduzioni al tuo repository tramite una richiesta di merge.
Da lì, puoi rivedere e unire le modifiche quando sei pronto.
Integrazione API:
Dopo aver ricevuto la tua chiave API, usa gli endpoint API per caricare i tuoi file sorgente, richiedere traduzioni e scaricarli.
Quando le tue traduzioni sono pronte, PTC invia una notifica di callback. Dopodiché, puoi recuperare i file tradotti tramite l’API.
