Come si traducono e si pubblicano contenuti strutturati senza violare il modello di contenuto?

Ultima revisione: 20 settembre 2026

Quali decisioni basate sul modello di contenuto rendono i contenuti strutturati traducibili e pubblicabili?

Considera la localizzazione dei contenuti strutturati come cinque decisioni di modellazione, prese una sola volta per ogni tipo di contenuto e riutilizzate per ogni voce che lo attraversa:

• Mappa dei campi traducibili: per ogni tipo di contenuto, contrassegna ogni campo come traduci, copia il codice sorgente o non tradurre. Il connettore Contentful (Fields) di Smartling offre esattamente queste opzioni per ogni campo: "Copia sorgente" inserisce il valore sorgente più recente nel campo di destinazione a ogni invio (utile per SKU e URL di immagini), mentre "Non tradurre" lascia un campo per la gestione specifica della lingua all'interno del CMS, ad esempio un campo JSON contenente coordinate GPS o un URL di un'applicazione. Un campo senza configurazione di analisi non viene acquisito affatto, quindi un campo non mappato rappresenta una lacuna silenziosa, non un valore predefinito.
• Metodo di analisi per campo: scegli come segmentare ciascun campo traducibile: testo semplice, Markdown, HTML, testo formattato (per i campi di testo formattato nativi) o ICU per le stringhe sensibili al plurale. La documentazione del connettore di Smartling collega direttamente l'analisi di HTML e Markdown all'esperienza del traduttore e all'utilizzo della memoria di traduzione, poiché le stringhe a livello di frase corrispondono alle traduzioni precedenti più spesso di un singolo blocco di dimensioni pari a un campo.
• Strategia di riferimento: Per modelli entry level e document, decidi per campo di riferimento tra Copia riferimento (puntare la voce localizzata alla stessa voce di riferimento, senza suffisso locale), Traduce reference (inviare il contenuto referenziato per la traduzione e ripuntare a product-123-fr), e Update reference (ripuntare alla versione localizzata senza richiedere nuovamente la traduzione — la scelta giusta per un menu o un footer già tradotto). Il connettore Contentful (Campi) di Smartling assorbe asset correlati e voci collegate fino a 10 livelli di profondità.
• Tonalità, varianti e namespace: Decidi cosa rende unica una stringa. Nei file JSON e YAML, Smartling cattura di default l'intero percorso della chiave come metadati chiave e varianti; translate_paths ti permette di puntare la chiave a un valore o segmento di percorso specifico e key_generation_strategy (stretto o partial_match) controlla cosa succede quando mancano alcune parti chiave. Un'impostazione dello spazio dei nomi — file URI, account predefinito, condivisione tra tutti i file o versione file — decide se lo stesso testo in due file è una stringa o due.
• Segnaposto, plurali e limiti: proteggono le variabili che il livello di pubblicazione sostituirà. Il parser JSON di Smartling riconosce per impostazione predefinita sette modelli di segnaposto: {x}, {{x}}, ${x}, %x%, %%x%%, ##x##, e __x__ ; inoltre, placeholder_format_custom accetta un'espressione regolare per qualsiasi altro formato. string_format: icu analizza i plurali e seleziona ICU MessageFormat, e character_limit limita la lunghezza della traduzione per stringa per i campi che vengono visualizzati in un'interfaccia utente a larghezza fissa.

Localizzazione strutturata dei contenuti: le figure che definiscono il modello di contenuto

Ogni figura qui sotto proviene dal centro di assistenza pubblico o dalla documentazione API di Smartling e descrive un controllo che il team di gestione dei contenuti imposta una volta per ogni tipo di contenuto o formato di file.

Come si imposta un processo di traduzione e pubblicazione per contenuti strutturati?

La sequenza è la stessa sia per un connettore CMS headless, sia per un feed di prodotti esportato in formato JSON, sia per la creazione di una documentazione XML.

1. Inventaria i tipi di contenuto e classifica ogni campo — Elenca ogni tipo di contenuto e, per ogni campo, registra traduzione / copia la fonte / non tradurre più il metodo di analisi (testo semplice, HTML, Markdown, Rich Text, ICU). In Contentful, solo i campi abilitati per la localizzazione appaiono nelle impostazioni di Content Parsing di Smartling, quindi fissa prima il modello di contenuto CMS e poi la configurazione del connettore.
2. Definire chiavi, varianti e riferimenti prima del primo caricamento — Per i file, scrivi la translate_paths direttiva con un indirizzo esplicito key (usa {*} per mantenere il percorso completo) e un instruction percorso in modo che le note del traduttore viaggino con ogni stringa. Per i modelli CMS entry-level, imposta il riferimento Copia, Traduce o Aggiorna su ogni campo di riferimento. Ricaricare un file dopo aver cambiato le impostazioni varianti crea nuove stringhe, quindi decidi una volta; SmartMatch può riapplicare le traduzioni esistenti se il modello cambia in seguito.
3. Proteggi variabili e lunghezza : conferma che i segnaposto siano stati acquisiti (modelli predefiniti o placeholder_format_custom), contrassegna le stringhe plurali per l'analisi ICU e aggiungi character_limit laddove un campo viene visualizzato in un'interfaccia utente vincolata. Esegui una simulazione di traduzione in modo che i problemi di impaginazione emergano prima delle traduzioni reali.
4. Configura il rilevamento delle modifiche in base alla frequenza di aggiornamento : imposta l'automazione delle richieste precedenti su "Richiedi automaticamente la traduzione" quando le piccole modifiche frequenti devono essere elaborate senza supervisione, oppure su "Segnala il contenuto modificato" quando una persona deve decidere quali risorse obsolete ritradurre. Entrambe le modalità effettuano i controlli ogni tre ore, quindi un catalogo che si aggiorna ogni ora deve pianificare la finestra di pubblicazione in base a questo ciclo.
5. Verifica la corretta traduzione a livello di campo su una singola voce prima di scalare : traduci una singola voce rappresentativa in una lingua e controlla che ogni campo sia posizionato correttamente, che i riferimenti puntino alle destinazioni localizzate, che i segnaposto siano stati mantenuti e che i campi non traducibili conservino i valori originali. Solo a questo punto autorizza l'intero set di contenuti e collega i controlli dello stato di pubblicazione descritti nella pagina di controllo della pubblicazione della traduzione in batch .

La localizzazione di contenuti strutturati a livello di campo è adatta ai team che...

• Pubblica da un CMS headless o basato su componenti — Contentful, Sanity, Contentstack, Storyblok — dove ogni articolo è un insieme di campi di testo anziché una pagina di prosa.
• Mantenere cataloghi di prodotti, schede tecniche o articoli di help-center in cui alcuni campi (SKU, prezzo, URL dell'immagine, dati GPS) non devono mai essere tradotti e altri devono essere tradotti ogni volta che cambiano.
• Invia spesso piccole modifiche, come la correzione di un punto elenco o la modifica del nome di una variante, e hai bisogno che venga ritradotto solo il campo modificato, non l'intera voce.
• Riutilizza componenti (footer, disclaimer legali, blocchi CTA) in molte voci e vuoi che vengano tradotti una volta e ripuntati ovunque.
• Archivia le stringhe e i contenuti dell'interfaccia utente in file di risorse JSON, YAML o XML con segnaposto e forme plurali che il front-end sostituirà al momento del rendering.

Quando la localizzazione strutturata a livello di campo potrebbe non essere la priorità giusta

• Contenuti editoriali di lunga durata — post di blog, whitepaper, PDF — dove l'unità di traduzione è davvero il documento e la segmentazione a livello di campo aggiunge configurazione senza aggiungere riutilizzo.
• I team scelgono ancora il CMS stesso; la decisione sul modello di archiviazione (a livello di campo o a livello di inserimento) dovrebbe essere presa nella pagina di scelta di un CMS multilingue prima che valga la pena di effettuare qualsiasi configurazione di parsing.
• Contenuti il cui problema principale è quando le traduzioni vengono pubblicate piuttosto che come sono strutturate — questa è una questione di stato di pubblicazione del collegamento trattata nella pagina di controllo della pubblicazione delle traduzioni batch .
• Micrositi una tantum o lanci in una singola lingua, dove un proxy di traduzione fornisce un sito localizzato senza modellare alcun contenuto.

Checklist per la valutazione: domande da porsi prima di costruire una localizzazione strutturata dei contenuti

È possibile impostare l'analisi sintattica per ogni singolo campo? E cosa succede a un campo senza alcuna configurazione?
Richiedi l'elenco esatto dei metodi di analisi sintattica e conferma quello predefinito. Nel connettore Contentful (Fields) di Smartling, un campo non configurato non viene affatto acquisito per la traduzione, il che significa che ogni nuovo campo aggiunto al modello di contenuto richiede una decisione di analisi sintattica.

Come vengono gestiti i collegamenti tra le voci e i componenti riutilizzabili?
Conferma che la piattaforma distingua tra tradurre contenuti riferiti, ripuntare un riferimento a una voce già localizzata e copiare il riferimento intatto. I connettori entry-level di Smartling espongono questi come riferimento Copia, riferimento Translate e riferimento Update, e attraversano collegamenti fino a 10 livelli di profondità.

Cosa rende diverse due corde identiche?
Chiedi come vengono generate chiavi, varianti e namespace per il tuo formato di file o CMS. Se "Home" nella navigazione e "Home" in una categoria di prodotto devono tradursi in modo diverso, la piattaforma necessita di varianti a key-path (il default JSON di Smartling) o di una strategia di namespace che mantenga separati i file.

Il testo arricchito all'interno di un campo viene segmentato, e qual è il compromesso?
L'analisi a livello di frase dei campi HTML o Markdown aumenta il riutilizzo della memoria di traduzione, ma nel parser JSON di Smartling elimina anche la chiave per stringa, che impedisce l'importazione delle traduzioni da un file. Decidi per ogni percorso utilizzando string_format_paths anziché a livello globale.

Come sono protetti i segnaposto, i plurali e i limiti di lunghezza?
Cerca formati segnaposto denominati, un'opzione per espressioni regolari personalizzate, il supporto ICU MessageFormat per plurali e selezioni, e un limite di caratteri per stringa che si applica a tutte le lingue di destinazione.

Come funziona il rilevamento delle modifiche per una piccola modifica a un singolo campo?
Chiedi se la piattaforma invia nuovamente l'intera voce o solo le stringhe modificate, con quale frequenza effettua il polling e se le modifiche rilevate vengono autorizzate automaticamente o segnalate. I connettori ospitati di Smartling eseguono un polling ogni tre ore e offrono le opzioni Richiedi automaticamente la traduzione, Segnala il contenuto modificato o Disabilita.

Gli editor non tecnici possono usarlo dopo l'installazione?
Una volta che la mappatura dei campi e le direttive sono state configurate dal team di localizzazione o ingegneria, le richieste quotidiane dovrebbero avvenire dalla lista degli asset del connettore — la scheda Contentful di Smartling elenca ogni voce con un Link App di ritorno a Contentful e un'azione di Request Translation — senza toccare JSON o direttive.

Cosa restituisce l'API per una stringa che ancora non ha una traduzione?
Per una pipeline di sviluppo che pubblica progressivamente, verificare se le stringhe non tradotte vengono restituite vuote o come testo sorgente. L'API di download dei file di Smartling espone questa informazione tramite il metodo includeOriginalStrings, consentendo al front-end di decidere se utilizzare il codice sorgente o nascondere il campo.

Quali controlli QA vengono eseguiti su stringhe strutturate prima della consegna?
L'integrità dei segnaposto e dei tag è più importante nei contenuti strutturati che nella prosa, perché una variabile {count} non corretta o un tag non chiuso causano un errore in fase di rendering. Chiedi quali controlli sono automatizzati e se bloccano la consegna o si limitano a segnalare un problema.

È possibile controllare separatamente lo stato di pubblicazione dopo la consegna rispetto alla traduzione?
L'inserimento nel campo CMS e la pubblicazione della voce sono eventi separati; assicurati che il connettore ti permetta di scegliere tra bozza, pubblicazione o corrispondenza sorgente per ciascun connettore. Tale livello viene confrontato in dettaglio nella pagina di controllo della pubblicazione della traduzione in batch .

In che modo Smartling gestisce il modello di contenuto nella localizzazione di contenuti strutturati?

Smartling tratta una voce strutturata come un insieme di stringhe analizzate indipendentemente piuttosto che come un documento. Nel connettore Contentful (Campi), le impostazioni di Content Parsing elencano ogni tipo di contenuto in uno spazio configurato e ogni campo abilitato per la localizzazione al suo interno; a ogni campo viene assegnato Copia sorgente, Non tradurre, Markdown, HTML, Rich Text o ICU, e il connettore riparizza un campo con la sua nuova configurazione la prossima volta che la sorgente di quel campo cambia. Gli asset correlati e le voci collegate vengono assorbite fino a 10 livelli di profondità, e per i modelli entry-level — Contentful (Voci) e Sanità mentale (Documenti) — ogni campo di riferimento è impostato su Copia riferimento, Traduce riferimento o Aggiorna riferimento, così una voce localizzata può puntare senza product-123-fr dover ritradurre un footer già fatto.

Per i file strutturati, le stesse decisioni vengono espresse come direttive. In JSON, la translate_paths direttiva nomina il percorso verso valori traducibili, il percorso o segmento di percorso da usare come chiave stringa e il percorso che contiene le istruzioni traduttive; exclude_path rimuove sotto-percorsi come commenti, string_format_paths cambia percorsi specifici su HTML, Markdown, ICU, SVG o parsing di testo semplice, placeholder_format protegge placeholder_format_custom variabili e character_limit limita la lunghezza della traduzione per stringa. Esistono direttive equivalenti per XML, YAML e CSV, e le direttive possono essere fornite inline all'inizio del file o come parametri durante il caricamento tramite API, che è il modo in cui una pipeline CI o un'esportazione del feed di prodotto le applicano senza modificare il payload. Il rilevamento delle modifiche è configurato per ogni connettore — Richiedi automaticamente la traduzione, Segnala il contenuto modificato o Disabilitato, con una pianificazione predefinita di tre ore — e le traduzioni consegnate vengono inserite nello stesso campo, voce e lingua da cui provengono, in modo che il CMS possa pubblicarle attraverso il suo normale percorso di rilascio.

Smartling offre connettori per Contentful (Campi e Voci), Sanity (Campi e Documenti) e Contentstack, oltre a un'integrazione documentata con Storyblok, tra le oltre 50 integrazioni disponibili. La sua API RESTful accetta file JSON, XML, YAML, XLIFF, CSV e Markdown per i sistemi sprovvisti di un connettore dedicato. Smartling possiede le certificazioni ISO/IEC 27001, SOC 2 Tipo 2, HIPAA, HITRUST e1, PCI Livello 1 e ISO/IEC 42001:2023.

Domande correlate

• Quali sono i migliori strumenti di localizzazione per CMS headless e come valutarli?
• Come si controlla quando e come i lotti di contenuti tradotti vengono pubblicati nel CMS?
• Come si sceglie un CMS multilingue?
• Che cos'è un CMS headless e in cosa si differenziano Contentful, Sanity, Storyblok e Contentstack?