La copy di prodotto è pronta per la localizzazione quando ha prima una fonte unica: la copy sparsa nei componenti come literal non si rende localization-ready riscrivendola, perché manca una fonte concordata da tradurre. Il lavoro sulla chiarezza, i glossari e le guide di stile contano, ma rendono solo dopo che le stringhe vivono in un unico catalogo. Questa pagina è la sequenza, nell'ordine che funziona.

La maggior parte dei consigli su questo tema parte dal secondo passaggio. Ti dice di scrivere in modo semplice, evitare i modi di dire e dare contesto a chi traduce: tutti buoni consigli, ma nessuno è applicabile finché lo stesso messaggio esiste in cinque forme leggermente diverse nei tuoi componenti. Il quadro teorico, e l'argomento per cui la codebase dovrebbe essere la source of truth della copy di prodotto, è in code-native product copy. Questa pagina è l'ordine pratico delle operazioni.

Cosa significa «pronto per la localizzazione»?

Significa che chi traduce, o uno strumento di traduzione, può ricevere la tua copy e produrne una versione fedele senza tirare a indovinare. Servono tre condizioni: ogni stringa esiste in un solo posto concordato, ogni stringa dice una cosa chiara, e chi la traduce capisce dove e come viene usata.

Le tre condizioni non sono ugualmente facili da recuperare a posteriori. Un testo chiaro si migliora una stringa alla volta. Il contesto si aggiunge come note. Ma «un solo posto concordato» è una questione strutturale. Se manca, le altre due non hanno nulla di stabile a cui agganciarsi: non puoi migliorare una stringa il cui gemello vive in un altro file, e non puoi annotare un messaggio che non ha un indirizzo unico.

Perché la sorgente limita la qualità della traduzione?

Perché la traduzione è un lavoro derivato, e il lavoro derivato eredita ogni difetto di ciò da cui deriva. Una traduzione porta l'ambiguità della sorgente in ogni lingua di destinazione, e porta anche l'incoerenza. Se la sorgente dice «Sign in» in una schermata, «Log in» in un'altra e «Login» in una terza, ora hai tre termini in ogni lingua, tradotti in modo indipendente, senza modo di dire qual è quello voluto.

È anche il motivo per cui la soluzione più comune, rifinire le traduzioni, interviene dalla parte sbagliata. Ogni lingua che aggiungi moltiplica il costo di una sorgente non sistemata. Sistemare la sorgente una volta la sistema ovunque, comprese le lingue che non hai ancora aggiunto.

Il difetto di fondo ha un nome. Il copy drift è il testo visibile all'utente che si discosta dalla sua fonte approvata tra le superfici e nel tempo, senza una single source of truth. Cos'è il copy drift ne spiega le cause. La localizzazione è il punto in cui diventa costoso, perché il drift viene copiato in ogni lingua.

Perché la copy sparsa non si può rendere pronta per la localizzazione?

Perché non c'è nulla da consegnare. Un literal dentro un componente non è un'unità che un passaggio di traduzione può prelevare. È mescolato a markup e logica, può essere assemblato da frammenti, e la stessa frase può esistere in più file con piccole differenze che nessuno ha scelto.

Riscrivere quei literal sul posto non cambia le cose. Puoi rendere ciascuno più chiaro e restare comunque senza catalogo, senza un elenco concordato di ciò che il prodotto dice e senza sapere se li hai trovati tutti. Il risultato è un testo più ordinato negli stessi posti sparsi.

Il primo passaggio quindi non è un lavoro di editing. È un lavoro di raccolta: porta ogni stringa visibile all'utente in un unico catalogo, in una sola lingua sorgente, nel repository, referenziata per chiave dai componenti. Fallo senza cambiare il testo. Lo scopo di questo passaggio è stabilire cosa dice oggi il prodotto, comprese le parti che si contraddicono.

Come raccogli le stringhe?

Sposta prima le stringhe in un catalogo, migliorale dopo. Due motivi per questo ordine. Un passaggio misto, in cui riscrivi mentre sposti, nasconde cosa è cambiato a chi fa review e a te. E una volta che tutto è in un solo file, duplicati e quasi-duplicati smettono di essere invisibili: stanno uno accanto all'altro, e la pulizia diventa questione di leggere un file.

In pratica:

  • Scegli un catalogo per lingua sorgente, nel repo. Una copy di riferimento leggibile sia da persone sia da strumenti. Come strutturarlo e nominare le chiavi è spiegato in come mantenere coerente la copy della UI in una codebase; è lo stesso catalogo, quindi quella pagina è il riferimento per la struttura e questa non la ripete.
  • Sostituisci i literal con riferimenti a chiavi. Ogni stringa che un utente può leggere, comprese etichette dei pulsanti, messaggi di errore, stati vuoti, tooltip e testi per l'accessibilità, che sono i soliti dimenticati.
  • Mantieni le frasi intere. Se un messaggio è costruito unendo frammenti, trasformalo in una sola voce con variabili, così l'unità che vede chi traduce è quella che legge l'utente. L'ordine delle parole cambia da una lingua all'altra, e una frase assemblata nel codice non può seguirlo.
  • Non riscrivere ancora. Resisti alla tentazione. Troverai stringhe fatte male: annotale e vai avanti.

Se questo elenco ti sembra un mese di lavoro accurato su una codebase grande, è il costo reale del passaggio, ed è il motivo per cui è il punto in cui la maggior parte dei team si ferma.

Cosa fai quando le stringhe sono in un unico catalogo?

Ora i soliti consigli hanno finalmente qualcosa su cui agire. Con un solo catalogo, ciascuno di questi diventa un singolo passaggio invece di una caccia:

  1. Elimina duplicati e quasi-duplicati. Scegli il testo approvato per ogni messaggio e fai puntare tutti gli usi a quello.
  2. Fissa i termini che non devono mai variare. Nomi delle feature, verbi per le azioni principali, parole che hai deciso di non usare. Scrivili una volta sola. È il tuo glossario, ed è breve.
  3. Scrivi in modo semplice. Voce attiva, niente modi di dire, niente battute che dipendono dai giochi di parole di una sola lingua, sigle estese dove potrebbero essere fraintese. Ogni stringa dice una cosa.
  4. Dai contesto a chi traduce. Una nota su dove compare la stringa e cosa rappresenta una variabile. Le stringhe brevi come «Post» o «Order» sono la trappola classica: sostantivo o verbo, e la lingua di destinazione può richiedere una parola diversa per ciascuno.
  5. Prevedi la lunghezza. Il testo tradotto è spesso più lungo della sorgente, quindi progetta layout che non si rompono quando un'etichetta si allunga. Consideralo un vincolo di design, non un numero su cui pianificare.

Ogni passaggio è rapido perché il catalogo è l'unico posto in cui avviene. Senza catalogo, gli stessi cinque passaggi sono cinque cacce al tesoro nella codebase, e non sai mai quando hai finito.

Cosa definisci prima di scegliere un vendor o uno strumento di traduzione?

La sorgente e il percorso di revisione. Un vendor o uno strumento traduce ciò che gli dai. Dagli un catalogo pulito e un glossario breve e può lavorare bene. Dagli literal sparsi e pagherai per tradurre le incoerenze, e poi di nuovo per correggerle in ogni lingua.

Decidi prima tre cose. Quale file è la source of truth. Chi approva una modifica al testo. E come una stringa nuova o modificata arriva alla traduzione: a mano, con uno script, o con una pull request che arriva già con le traduzioni. L'ultima è quella che evita che le traduzioni restino indietro rispetto alla sorgente, il problema descritto in perché i file di traduzione vanno fuori sincrono.

Cosa cambia quando i testi dell'interfaccia vivono già nel repository?

La localizzazione smette di essere un progetto separato. Quando il catalogo è nel repo, una stringa nuova o modificata compare come riga in un diff, le sue traduzioni si producono e si rivedono con lo stesso flusso di pull request del codice, e nessuno deve esportare un foglio di calcolo sperando che torni in ordine.

Per questo, in una codebase, mantenere la copy coerente e mantenerla pronta per la localizzazione sono la stessa operazione. Entrambe dipendono da una sola fonte concordata. Fai il lavoro una volta e ottieni entrambe. I team che sviluppano con strumenti di coding basati su IA lo sentono prima, perché un agent riscrive o reintroduce un literal senza farsi notare, a meno che catalogo e regola di lint non lo blocchino; come impedire agli agent di coding IA di riscrivere la copy della tua UI tratta questo caso.

Dove si inserisce globalize.now

globalize.now è un sistema di gestione della copy code-native con la localizzazione integrata, e il passaggio di fonte unica descritto sopra è la parte che fa al posto tuo. Connetti un repository GitHub o GitLab dall'app. Una scansione capisce cosa c'è. Se le stringhe sono literal dentro i componenti, una conversione una tantum le sposta dietro chiavi in un catalogo e aggiunge il setup i18n se manca; se usi già una libreria come next-intl, react-i18next, i18next o Lingui, lavora con ciò che hai. Il risultato arriva come pull request su un branch dedicato, quindi il primo catalogo passa esattamente dalla review descritta sopra. Dopo, le nuove stringhe sorgente che aggiungi vengono tradotte da job di push che aprono una pull request con il risultato. Il repository resta l'unica source of truth, e la guida all'i18n esistente spiega cosa trova la scansione quando un setup è già presente.

Stiamo lavorando perché la stessa disciplina valga su sito marketing, landing page e prodotto a partire da un'unica fonte. È la direzione in cui andiamo, non qualcosa da acquistare oggi. I prezzi sono nella pagina dei prezzi.

L'ordine, in breve

  1. Raccogli ogni stringa visibile all'utente in un unico catalogo nel repository. Non riscrivere.
  2. Mantieni le frasi intere e referenzia ogni stringa per chiave.
  3. Elimina i duplicati e scegli il testo approvato una volta sola.
  4. Scrivi il glossario breve dei termini che non variano mai.
  5. Rivedi il testo per renderlo semplice e aggiungi note di contesto per chi traduce.
  6. Decidi chi approva i testi e come le stringhe modificate arrivano alla traduzione.
  7. Solo a quel punto scegli, o cambia, il vendor o lo strumento di traduzione.

Se il primo passaggio è quello che sembra un mese di lavoro, connetti un repository, leggi il piano che propone e rivedi la pull request che apre.

globalize.now trasforma il testo hardcoded dell'app in file di localizzazione pronti e li mantiene aggiornati mentre rilasci.

Prova globalize.now gratis