Domande tecniche frequenti

Da dove ottiene le traduzioni <T>? Quali traduzioni utilizza?

<T> può tecnicamente caricare le traduzioni da qualsiasi fonte, a seconda di come hai configurato la libreria. Se disponi di un project ID, la libreria può usare un CDN gratuito. Può anche salvare le traduzioni in locale o fare un mix delle due cose. Consulta la documentazione di load-translations per ulteriori dettagli.

Durante lo sviluppo, per permetterti di vedere l’hot reload delle traduzioni quando modifichi i contenuti, il componente <T> chiama un’API che usa un piccolo modello di AI per creare traduzioni temporanee. Queste traduzioni non vengono salvate da nessuna parte: vengono semplicemente restituite all’app.

In produzione, <T> non lo fa per evitare di esporre le tue API key.

Perché devo installare la CLI?

La CLI esegue il parsing del contenuto all'interno di tutti i componenti <T> e genera in anticipo le relative traduzioni, così che siano già pronte quando l’app viene messa in produzione. In fase di sviluppo non è necessaria, perché puoi usare le chiavi API di sviluppo per tradurre on demand.

Esiste un fallback automatico per le traduzioni mancanti in produzione?

Sì. In produzione, se manca la traduzione di un contenuto, la libreria esegue automaticamente il fallback al testo sorgente originale.

La traduzione con AI funziona anche con contenuti dinamici e variabili?

Il componente <T> non supporta la traduzione di contenuti dinamici e variabili, perché questo potrebbe far sì che le traduzioni cambino a ogni re-render. Tuttavia, puoi comunque includere contenuti dinamici e variabili all'interno di <T> racchiudendoli con i componenti <Var>, <Datetime>, <Currency>. Questo è simile al modo in cui altre librerie gestiscono l'interpolazione delle stringhe.

Per gt-next è disponibile anche un componente server-side, <Tx>, che esegue le traduzioni al volo in produzione e supporta qualsiasi forma di contenuto dinamico, ma richiede una chiave API.

Come funziona il sistema offline? Posso distribuire un’applicazione con GT senza dipendere dai vostri server?

Sì, è possibile, ma dovrai occuparti tu delle traduzioni, poi caricarle dal tuo bundle o dal tuo CDN. Consulta la nostra documentazione in merito: qui.

Domande frequenti per le aziende

Sono proprietario delle mie traduzioni?

Sì.

Lei, in qualità di cliente, conserva la piena proprietà e tutti i diritti su qualsiasi contenuto tradotto prodotto tramite i Servizi. Non rivendichiamo alcun diritto sul suo output.

Per ulteriori informazioni, consulti i nostri Termini di utilizzo.

Domande frequenti

Cosa sono i token?

Quando il testo viene inviato alle API di GT, viene suddiviso in blocchi chiamati token. Pensa ai token come a piccole porzioni del testo in input, come parole o parti di parola, che un modello di IA usa per comprendere e tradurre i tuoi contenuti.

Una regola pratica utile è che in genere un token corrisponde a ~4 caratteri di testo per l’inglese comune. Questo equivale a circa ¾ di parola (quindi 100 token ~= 75 parole).

Per esempio, la stringa Hello, world! ha 13 caratteri e 4 token: Hello, ,, world e !.

Se superi il limite di token del tuo piano, inizieremo ad addebitare in base all’utilizzo dei token. Addebitiamo sempre e solo in base alla lunghezza dell’input, mai alla lunghezza della traduzione. Scopri di più sui piani disponibili qui.

Per esempio, immagina di avere la stringa "Hello, world!" e che le lingue del tuo progetto siano "fr" (francese), "es" (spagnolo) e "de" (tedesco). L’utilizzo dei token sarà calcolato come 4 * 3 = 12, ossia i 4 token di "Hello, world!" tradotti 3 volte.

Al momento effettuiamo la tokenizzazione con tiktoken di OpenAI, lo stesso tokenizer utilizzato da GPT-4. Puoi esplorare questo tokenizer qui.

Locali? Lingue? Regioni? Qual è la differenza?

In tutta questa documentazione useremo i termini locale e lingua in modo in parte intercambiabile. Per lo più indicano la stessa cosa, ma esistono differenze sottili che chiariremo quando necessario.

Lingua indica una forma di comunicazione parlata o scritta utilizzata dagli esseri umani.

Regione indica l’area in cui una lingua è parlata o scritta. Naturalmente la lingua può restare la stessa, ma variare tra regioni. Ad esempio, il francese canadese rispetto al francese parlato in Francia.

Locale è una combinazione di una lingua e una regione, e viene usato per specificare una determinata lingua in una determinata regione. Ad esempio, en-US è l’inglese così come è parlato negli Stati Uniti.