Base di conoscenza

Risposte alle domande più comuni sulla localizzazione di app, documentazione e contenuti con General Translation.

Internazionalizzazione

Configurare l’i18n in una base di codice: librerie, framework e componenti.

Come si traduce un'app Flask o FastAPI?Contrassegna le stringhe visibili agli utenti, determina l'impostazione regionale di ogni richiesta (di solito da Accept-Language) e carica le traduzioni corrispondenti. Le app Flask in genere usano Flask-Babel con cataloghi gettext, mentre le app FastAPI integrano Babel tramite un middleware. La CLI di General Translation popola questi cataloghi, mentre i suoi SDK sperimentali gt-flask e gt-fastapi traducono le stringhe inline di t() senza bisogno di cataloghi.Video52 s
Come si localizza un'app Android con strings.xml?Tieni tutte le stringhe predefinite in res/values/strings.xml, aggiungi un file strings.xml per ciascuna lingua in una cartella qualificata per impostazione regionale, come values-es o values-b+zh+Hant+TW, e leggi il testo con stringResource o getString. Puoi tradurre a mano, in Play Console o con la CLI di General Translation, che genera ogni cartella values e ricostruisce i plurali per ciascuna lingua di destinazione.Video49 s
Come si aggiunge l'i18n a TanStack Start?TanStack Start non offre un supporto i18n integrato, quindi occorre aggiungere una libreria che risolva l'impostazione regionale per ogni richiesta al server, di solito tramite un prefisso nell'URL o un cookie, e carichi i messaggi prima del rendering. Paraglide JS, react-i18next e Lingui renderizzano le traduzioni che fornisci tu; il pacchetto sperimentale gt-tanstack-start di General Translation, invece, le genera anche a partire dai testi scritti inline nel JSX.Video48 s
Come aggiungo l'i18n a un'app Next.js con Pages Router?Aggiungi un blocco i18n con locales e defaultLocale a next.config.js e Next.js servirà /es e /fr, reindirizzerà i visitatori in base alla lingua del browser e passerà l'impostazione regionale a getStaticProps e getServerSideProps. Una libreria renderizza i messaggi; gt-next di General Translation genera anche le traduzioni a partire dai testi scritti inline in JSX.Video55 s
Come si traducono le stringhe al di fuori di JSX?Passa ogni stringa che non è un figlio JSX, come un segnaposto o una costante a livello di modulo, a una funzione di traduzione nel punto in cui viene renderizzata. L'hook useGT di General Translation restituisce questa funzione, mentre msg con useMessages traduce le costanti definite al di fuori di un componente.Video49 s
Come si traduce un'app Vue?Tradurre un'app Vue significa far passare ogni stringa del template attraverso una ricerca nella lingua attiva e tradurla in ogni lingua di destinazione. Il plugin gt-vue di General Translation traduce il contenuto racchiuso nel componente <T> e npx gt translate genera un catalogo per ogni lingua di destinazione.Video48 s
Come si traduce un'app React?Tradurre un'app React significa internazionalizzarne i componenti affinché vengano renderizzati nella lingua dell'utente, quindi tradurre ogni stringa in ciascuna lingua supportata. gt-react di General Translation traduce il JSX in-place nel componente <T>, mentre npx gt translate genera un file per ogni lingua.Video48 s
Come si traduce un'app React Native?Contrassegna il testo nei tuoi componenti, genera un file di traduzione per ogni lingua, aggiungi i Polyfill Intl e carica il file corrispondente alla lingua del dispositivo. Con gt-react-native, la libreria sperimentale di General Translation, racchiudi il testo in <T>, un plugin Babel aggiunge i polyfill e npx gt translate genera i file.Video47 s
Come si traduce un'app Node.js?Rileva la lingua di ogni richiesta, di solito dall'intestazione Accept-Language, e restituisci ogni stringa in quella lingua. gt-node di General Translation associa l'impostazione regionale a ogni richiesta con withGT e traduce le stringhe con getGT, a partire dalle traduzioni che npx gt translate --publish genera prima della distribuzione.Video48 s
Come si internazionalizza un'app con Cursor o Claude Code?Inizia con il prompt Setup for Agents di General Translation in Cursor o Claude Code, scegli una funzionalità e le lingue di destinazione, poi lascia che sia l'agente a implementare e verificare il risultato. L'accesso tramite browser, la documentazione leggibile dalle macchine e gli strumenti MCP collegano la configurazione alla traduzione e alla revisione. Usa Locadex per automatizzare la localizzazione continua tramite pull request.Video46 s
Come si aggiunge l'i18n a un'app Next.js con App Router?Inizia con gt init per configurare General Translation in un progetto App Router supportato, poi contrassegna il contenuto di origine, genera le traduzioni e verifica il cambio di lingua. gt-next mantiene i testi nel JSX insieme al contesto di traduzione; la CLI, l'editor della Dashboard e Locadex si occupano di generazione, revisione e aggiornamenti continui. Questa guida mostra anche la configurazione esplicita con file locali.Video51 s
Internazionalizzazione vs. localizzazione (i18n vs. l10n)L'internazionalizzazione (i18n) è il lavoro di sviluppo e progettazione che permette a un unico prodotto di supportare molte impostazioni regionali, ad esempio formattando le date con Intl e gestendo il testo right-to-left. La localizzazione (l10n) adatta il prodotto a una specifica impostazione regionale e comprende la traduzione, ma anche valute, formati di data, unità di misura, tono e aspetti legali.Video52 s
Come si trovano le stringhe hardcoded non tradotte?Esegui in CI un linter che segnali i letterali stringa visibili all'utente, come la regola no-literal-string di eslint-plugin-i18next per JSX, il controllo HardcodedText di Android Lint o il linter HardCodedString di erb_lint per Rails. Poi naviga nell'app con una pseudo-impostazione regionale per individuare il testo che i controlli statici non riescono a tracciare.Video48 s
Come si rileva la lingua del browser di un utente?Leggi l'elenco ordinato delle lingue del browser (navigator.languages in JavaScript o l'intestazione Accept-Language sul server), ordinato per q-value, e confrontalo con le impostazioni regionali supportate, prevedendo un fallback. Safari e Chrome in incognito restituiscono una sola lingua, mentre la geolocalizzazione tramite IP rivela la posizione, non la lingua.Video47 s
Come si rende multilingue un sito web?Scegli dove gestire le traduzioni (in un proxy, in un plugin del CMS, in un site builder o nel tuo codice), poi assegna a ogni lingua un URL dedicato, come raccomanda Google. Traduci le pagine per intero, compresi titoli e meta description, collega le versioni con hreflang e offri un selettore della lingua anziché reindirizzare automaticamente i visitatori.Video50 s
Come si localizza un'app iOS con gli String Catalog?Aggiungi le lingue in Xcode, scrivi il testo visibile all'utente con API localizzabili come Text di SwiftUI e String(localized:), quindi esegui la build affinché Xcode raccolga queste stringhe in uno String Catalog (.xcstrings). Traduci in Xcode, tramite XLIFF o con la CLI di General Translation se vuoi che i cataloghi si aggiornino a ogni rilascio e condividano la terminologia con il tuo sito web e la tua app Android.Video44 s
Come assegnare i nomi alle chiavi di traduzione i18n?Assegna i nomi alle chiavi in base a dove compare il testo e a cosa significa, ad esempio checkout.summary.title, e non in base alla formulazione inglese. Dai a ogni uso distinto una chiave propria, anche quando il testo inglese è identico: in tedesco il pulsante Open diventa Öffnen, mentre lo stato Open diventa Offen.Video46 s
Che cos'è la pseudo-localizzazione?La pseudo-localizzazione è un test che sostituisce il testo di origine con una versione alterata, con caratteri accentati, allungata di circa il 40% e racchiusa tra parentesi quadre, così che stringhe hardcoded, troncamenti, font che non vengono visualizzati correttamente e frasi concatenate emergano prima ancora che esista una traduzione. Android include a questo scopo le pseudo-impostazioni regionali en-XA e ar-XB.Video48 s
Best practice per il selettore della lingua: UX, SEO e accessibilitàIndica ogni lingua con il suo nome nativo, ad esempio Deutsch o 日本語, ed evita le bandiere, che rappresentano paesi. Collega ogni opzione alla stessa pagina in quella lingua tramite un link scansionabile, memorizza la scelta in un cookie e non reindirizzare mai automaticamente un URL localizzato.Video47 s
General Translation, Babel e Flask-Babel a confronto: quale scegliere?Babel formatta date, numeri e valute per qualsiasi impostazione regionale e gestisce i cataloghi gettext, mentre Flask-Babel lo integra con Flask, ma nessuno dei due traduce le tue stringhe. La CLI di General Translation popola i file PO di Babel per ogni lingua, forme plurali incluse, così puoi continuare a usare Flask-Babel e smettere di tradurre i cataloghi a mano.Video46 s
General Translation vs. vue-i18n: quale scegliere?General Translation consente ai team Vue di scrivere il testo sorgente direttamente nei modelli e di generare le traduzioni con la CLI. Il suo plugin gt-vue renderizza questi contenuti con una formattazione locale-aware di plurali e numeri. Sceglilo per eliminare la manutenzione dei file sorgente basati su chiavi; vue-i18n resta una scelta valida per i team che usano il modulo i18n di Nuxt e un flusso di lavoro consolidato basato su cataloghi.Video42 s
General Translation vs. Rails I18n: servono entrambi?Rails I18n recupera i messaggi e formatta date e numeri. General Translation genera le traduzioni, le mantiene aggiornate man mano che il testo in inglese cambia e offre al tuo team una Dashboard per la revisione. Usali insieme per distribuire cataloghi Rails tradotti a ogni rilascio.Video44 s
General Translation vs. nestjs-i18n: quale scegliere?nestjs-i18n risolve la lingua di ogni richiesta in un'app NestJS e renderizza i messaggi a partire da cataloghi JSON o YAML separati per lingua, ma non traduce nulla. La CLI di General Translation traduce quei cataloghi e la sua libreria gt-node traduce i contenuti che esistono solo a runtime: puoi quindi continuare a usare nestjs-i18n e affiancargli General Translation.Video45 s
General Translation vs. i18next, react-intl e next-intl: quale libreria i18n scegliere?Le librerie open source come i18next, react-intl e next-intl non traducono nulla. Si limitano a visualizzare le traduzioni che fornisci in un file di catalogo per ciascuna lingua, scritte da te, dai tuoi traduttori o da un servizio esterno. Anche le librerie di General Translation sono open source e svolgono lo stesso compito, ma General Translation si occupa anche della traduzione, usando il tuo codice come contesto.Video43 s
General Translation vs. GNU gettext: servono entrambi?Mantieni GNU gettext per l'estrazione e il rendering e aggiungi General Translation per generare e mantenere aggiornati i file PO. General Translation tiene conto delle note per i traduttori e del contesto dei messaggi in fase di generazione, applica una terminologia condivisa e mette a disposizione dei revisori un editor nella Dashboard. Le chiamate gettext esistenti e i cataloghi compilati restano al loro posto.Video46 s
General Translation o Symfony Translation: quale scegliere?Symfony Translation renderizza i messaggi in PHP e Twig. General Translation traduce i suoi cataloghi YAML in CI, li mantiene aggiornati man mano che la sorgente cambia e offre ai revisori una Dashboard per modificarli. Mantieni il rendering di Symfony e aggiungi la traduzione automatica al tuo flusso di lavoro di rilascio.Video44 s
General Translation o Paraglide JS: quale scegliere?Scegli General Translation per mantenere i testi inline e generare traduzioni basate sulla struttura dei tuoi componenti React, su una terminologia condivisa e sulla revisione nella Dashboard. Scegli Paraglide JS per funzioni di messaggio compilate e tipizzate, con tree-shaking per singolo messaggio. Paraglide renderizza i tuoi cataloghi; General Translation collega i testi sorgente alla generazione delle traduzioni e ai successivi aggiornamenti.Video42 s
General Translation o Mobility: quale scegliere?Mobility salva nel tuo database gli attributi tradotti dei modelli. General Translation genera queste traduzioni tramite la sua API, usando il tuo Glossario e i tuoi prompt personalizzati. Usali insieme per tradurre schede prodotto, post e altri contenuti del database senza rinunciare ai tuoi modelli Rails.Video44 s
General Translation o Lingui: quale scegliere?Scegli General Translation per mantenere i testi inline come con Lingui e generare le traduzioni usando la struttura JSX come contesto. Lingui estrae i messaggi inline in cataloghi che i tuoi traduttori o un servizio collegato dovranno tradurre. La CLI di General Translation aggiorna le traduzioni man mano che il codice cambia e il tuo team le revisiona nella Dashboard.Video45 s
General Translation o Intlayer: quale scegliere?Intlayer conserva il contenuto di ogni componente in un file di dichiarazione tipizzato posto accanto al componente stesso, con tutte le lingue scritte una accanto all'altra, e può completare le lingue mancanti con un provider di IA da te configurato. General Translation mantiene i testi inline nei componenti in un'unica lingua e genera le altre lingue sfruttando il contesto del tuo codice.Video42 s
General Translation e il framework di traduzione di Django: servono entrambi?Usa insieme il framework di traduzione di Django e General Translation. Django si occupa dell'estrazione dei messaggi, della selezione della lingua e del rendering. General Translation compila i suoi file PO, forme plurali comprese, con la terminologia del tuo prodotto e la revisione nella Dashboard. I tuoi template e i modelli di URL restano invariati, mentre le traduzioni si aggiornano di pari passo con il codice.Video46 s
Conviene creare un sistema i18n in autonomia o usare General Translation?Un sistema i18n fatto in casa (un dizionario per lingua e un piccolo helper t()) va bene per una o due lingue e pochi testi. Man mano che l'app cresce, ti ritrovi a ricostruire regole del plurale, fallback e sincronizzazione dei file, e le traduzioni vanno comunque prodotte. Le librerie open source di General Translation si occupano del rendering, mentre General Translation genera e aggiorna le traduzioni a partire dal tuo codice.Video43 s
Checklist per il test di localizzazione delle app multilingueVerifica nove aspetti in ogni impostazione regionale supportata su una build di produzione: percorsi completi, inclusi gli stati di errore e le email, cambio di lingua, plurali, valuta e fusi orari, espansione del testo, layout right-to-left, accessibilità, distribuzione delle traduzioni e URL per lingua scansionabili. Assegna a ogni verifica un criterio di superamento esplicito.Video33 s
Alternative a react-intl: General Translation o react-intlGeneral Translation consente ai team React di mantenere la sintassi dei messaggi ICU, aggiungendo la generazione delle traduzioni, una terminologia condivisa e la revisione nella Dashboard. react-intl fornisce la formattazione e gli strumenti di FormatJS per la gestione dei cataloghi; General Translation, invece, produce anche le traduzioni.Video47 s
Alternative a i18next: General Translation vs. i18nextScegli General Translation per mantenere i testi inline nei componenti React e generare le traduzioni sfruttando la struttura JSX e il contesto del prodotto. In alternativa, puoi continuare a usare i18next e affidarti a General Translation per tradurre i cataloghi esistenti. i18next si occupa del rendering dei messaggi e della selezione dei plurali, mentre la generazione delle traduzioni è affidata a un servizio separato.Video47 s
Posso fare i18n senza file di traduzione?Sì. Le librerie gt-react e gt-next di General Translation gestiscono l'i18n in React e Next.js senza chiavi di traduzione e senza dover mantenere un file JSON per ogni lingua. I testi restano inline nel JSX all'interno del componente <T> e il comando gt translate genera le traduzioni per ogni lingua durante la build, sfruttando il contesto del tuo codice. Locadex può mantenerle aggiornate tramite pull request.Video46 s
Come si traduce il testo condizionale in JSX?Mantieni la frase intera e traducine ogni versione, perché un operatore ternario la spezza in frammenti che perdono il loro significato e la loro posizione nell'ordine delle parole di ciascuna lingua. General Translation lo fa con <Branch> all'interno di <T>, che traduce la frase come un'unica unità.Video46 s

Formattazione per impostazione regionale

Plurali, date, numeri, valute e testo right-to-left per ogni impostazione regionale.

Traduzione

Traduzione automatica e basata sull’IA, qualità, contesto e glossari.

SEO multilingue

Routing delle impostazioni regionali, hreflang, sitemap e metadati tradotti per siti multilingue.

Strumenti per il flusso di lavoro

Scegliere gli strumenti di localizzazione e mantenere sincronizzate le traduzioni grazie alla localizzazione continua.

Distribuisci oggi stesso

Unisciti ai migliori team di sviluppatori al mondo su General Translation

Inizia oraRichiedi una demo