Torna al blog

Contentful · 13 mag 2026

Il rich text è il vero test del flusso di lavoro di traduzione

Il testo semplice è facile. Un flusso di lavoro di localizzazione dimostra il suo valore quando riesce a preservare link, elenchi, embed e struttura all'interno del rich text di Contentful.

Il rich text è il vero test del flusso di lavoro di traduzione

Un titolo e una breve descrizione possono far sembrare competente quasi qualsiasi flusso di lavoro di traduzione. Il vero test inizia quando la voce di origine contiene elenchi nidificati, link inline, voci incorporate e formattazione che porta significato.

È lì che la traduzione smette di essere un problema di testo e diventa un problema di struttura del contenuto.

Il rich text è un documento, non una stringa

Il rich text di Contentful è memorizzato come un albero. I paragrafi contengono nodi di testo. Gli elenchi contengono elementi di elenco. I link e le voci incorporate puntano ad altri contenuti. I mark trasmettono grassetto, corsivo, codice e altra formattazione.

Se si appiattisce quell'albero in testo semplice, le parole possono anche sopravvivere, ma la voce no.

Un flusso di lavoro affidabile deve tradurre la lingua preservando il documento:

  • le intestazioni restano intestazioni
  • gli elementi dell'elenco rimangono nell'ordine corretto
  • i link mantengono le loro destinazioni
  • le voci inline restano nella frase in cui gli editor le hanno collocate
  • i blocchi incorporati mantengono la loro relazione con il testo circostante

Al modello di traduzione non si dovrebbe mai chiedere di ricostruire una struttura che il flusso di lavoro avrebbe potuto proteggere esplicitamente.

I guasti pericolosi sembrano plausibili

I danni al rich text non sono sempre evidenti durante una revisione della traduzione. Un embed mancante può lasciare un paragrafo che continua comunque a suonare naturale. Un elenco spezzato può sembrare composto da diversi paragrafi validi. Una voce inline può scomparire mentre la frase si richiude attorno al vuoto.

Questo rende gli errori strutturali più pericolosi di un'eccezione visibile. La richiesta può essere contrassegnata come riuscita anche se la voce localizzata non rappresenta più l'origine.

Un buon strumento di revisione rende visibile la struttura protetta. Gli editor dovrebbero poter vedere dove si trovano embed, link e formattazione senza leggere JSON grezzo o confidare che ogni token sia sopravvissuto.

Prima proteggere, poi tradurre

Una solida pipeline di rich text separa il contenuto traducibile dal contenuto strutturale.

Prima che un modello riceva il documento, il flusso di lavoro può sostituire i nodi protetti con placeholder stabili. Il modello traduce il linguaggio circostante. Il flusso di lavoro poi ripristina i nodi originali e convalida che ogni placeholder sia stato restituito esattamente una volta.

Questo crea responsabilità chiare:

  • il modello gestisce la lingua
  • l'applicazione gestisce la struttura
  • la convalida intercetta contenuti protetti mancanti o duplicati

Questo confine è molto più affidabile che chiedere a una singola risposta probabilistica di preservare per convenzione un intero documento CMS.

Rivedere la gerarchia, non solo la prosa

La revisione umana dovrebbe confrontare più che le sole frasi. Dovrebbe anche rispondere a queste domande:

  1. Tutte le sezioni di origine sono rappresentate?
  2. La nidificazione degli elenchi è rimasta intatta?
  3. Link e voci incorporate sono ancora associati al contesto giusto?
  4. I blocchi vuoti della fonte sono rimasti fuori dal risultato tradotto?
  5. L'anteprima renderizzata corrisponde alla gerarchia dei contenuti della pagina di origine?

L'ultima domanda è importante perché un documento strutturalmente valido può comunque produrre una pagina poco armoniosa. L'anteprima rivela se un titolo tradotto va a capo male, una CTA rompe il layout o un embed finisce in una posizione visiva inattesa.

Conclusione

Il rich text è il punto in cui un flusso di lavoro di traduzione si guadagna fiducia. Preservare le parole è solo il primo requisito. Il sistema deve anche preservare il documento che gli editor hanno costruito attorno a quelle parole.

Trattare la struttura come dati protetti, convalidarla prima del salvataggio e rivedere il risultato nell'anteprima del CMS. Quando il rich text sopravvive a questo intero percorso, i campi più semplici diventano il caso facile che dovrebbero essere.