Hoe vertaal en publiceer je gestructureerde content zonder het contentmodel te doorbreken?

Laatst beoordeeld: 20 september 2026

Welke keuzes in het contentmodel maken gestructureerde content vertaalbaar en publiceerbaar?

Behandel gestructureerde contentlokalisatie als vijf modelleringsbeslissingen, eenmaal per contenttype genomen en hergebruikt voor elke post die erdoorheen gaat:

• Vertaalbare veldkaart: Voor elk inhoudstype markeert u elk veld als vertalen, bron kopiëren, of niet vertalen. Smartling's Contentful (Fields) connector stelt precies deze keuzes per veld bloot — Copy source levert bij elke levering de nieuwste bronwaarde in het doelveld (nuttig voor SKU's en afbeeldings-URL's), en Do not translate laat een veld achter voor locatie-specifieke afhandeling binnen het CMS, zoals een JSON-veld met GPS-coördinaten of een applicatie-URL. Een veld zonder parsingconfiguratie wordt helemaal niet vastgelegd, dus een niet-toegewezen veld is een stille kloof, geen standaard.
• Parseermethode per veld: Kies hoe elk vertaalbaar veld wordt gesegmenteerd: platte tekst, Markdown, HTML, rich text (voor native rich-text-velden) of ICU voor meervoudsgevoelige strings. De documentatie van Smartling koppelt het parsen van HTML en Markdown direct aan de ervaring van de vertaler en het gebruik van vertaalgeheugen, omdat tekstfragmenten op zinsniveau vaker overeenkomen met eerdere vertalingen dan tekstfragmenten van één veldgrootte.
• Referentiestrategie: Voor instapniveau- en documentniveaumodellen kies je per referentieveld tussen Referentie kopiëren (de gelokaliseerde vermelding wijzen op dezelfde vermelding, zonder locatie-achtervoegsel), Referentie vertalen (de geraadpleegde inhoud versturen voor vertaling en opnieuw aanwijzen product-123-fr), en Referentie bijwerken (opnieuw naar de gelokaliseerde versie verwijzen zonder opnieuw vertaling aan te vragen — de juiste keuze voor een menu of voettekst die al vertaald is). Smartling's Contentful (Fields) connector consumeert gerelateerde assets en gekoppelde entries tot 10 niveaus diep.
• Sleutels, varianten en naamruimte: bepaal wat een tekenreeks uniek maakt. In JSON- en YAML-bestanden legt Smartling standaard het volledige sleutelpad vast als sleutel- en variantmetadata; translate_paths kunt u de sleutel naar een specifieke waarde of padsegment laten verwijzen, en key_generation_strategy (strict of partial_match) bepaalt wat er gebeurt als bepaalde sleutelonderdelen ontbreken. Een naamruimte-instelling — bestands-URI, standaardaccount, gedeeld over alle bestanden of versiebeheer van bestanden — bepaalt of dezelfde tekst in twee bestanden als één of twee tekenreeksen wordt beschouwd.
• Plaatsaanduidingen, meervoudsvormen en beperkingen: Bescherm de variabelen die de publicatielaag zal vervangen. De JSON-parser van Smartling herkent standaard zeven placeholder-patronen: {x}, {{x}}, ${x}, %x%, %%x%%, ##x##, en __x__ . De optie placeholder_format_custom accepteert een reguliere expressie voor alle andere patronen. string_format: icu parseert meervoudsvormen en selecties van ICU MessageFormat, en character_limit beperkt de vertaallengte per tekenreeks voor velden die worden weergegeven in een gebruikersinterface met vaste breedte.

Gestructureerde contentlokalisatie: de figuren die het contentmodel vormen

Elke afbeelding hieronder is afkomstig uit het openbare helpcentrum of de API-documentatie van Smartling en beschrijft een besturingselement dat een contentbeheerteam eenmaal per contenttype of bestandsindeling instelt.

Hoe zet je een vertaal-naar-publicatie-pipeline op voor gestructureerde content?

De procedure is hetzelfde voor een headless CMS-connector, een productfeed die als JSON wordt geëxporteerd of een XML-documentatiebuilder.

1. Inventariseer de inhoudstypen en classificeer elk veld — Maak een lijst van elk inhoudstype en noteer voor elk veld of het vertaald, gekopieerd of niet vertaald moet worden, plus de parseermethode (platte tekst, HTML, Markdown, Rich Text, ICU). In Contentful worden in de contentparsing-instellingen van Smartling alleen velden weergegeven die geschikt zijn voor lokalisatie. Pas daarom eerst het contentmodel van het CMS aan en daarna de connectorconfiguratie.
2. Definieer sleutels, varianten en referenties vóór de eerste upload — Voor bestanden schrijf je de translate_paths richtlijn met een expliciet key (gebruik {*} om het volledige pad te behouden) en een instruction pad zodat vertaalnoten met elke string meegaan. Voor instapmodellen van CMS stel je op elk referentieveld de referentie Kopiëren, Vertalen of Bijwerken in. Het opnieuw uploaden van een bestand na het wijzigen van variantinstellingen creëert nieuwe strings, dus beslis één keer zelf; SmartMatch kan bestaande vertalingen opnieuw toepassen als het model later verandert.
3. Variabelen en lengte beschermen — Bevestig dat tijdelijke patronen zijn vastgelegd (standaardpatronen of placeholder_format_custom), markeer meervoudige strings voor ICU-parsing, en voeg character_limit toe waar een veld wordt weergegeven in een beperkte UI. Voer een pseudo-vertalingsronde uit zodat layoutproblemen ontstaan voordat echte vertalingen ontstaan.
4. Stel wijzigingsdetectie in om de frequentie van updates te matchen — Stel de automatisering van eerdere verzoeken in om automatisch vertaling aan te vragen wanneer kleine, frequente bewerkingen onbeheerd moeten doorlopen, of om gewijzigde inhoud te markeren wanneer iemand moet beslissen welke verouderde assets opnieuw worden vertaald. Beide modi controleert elke drie uur, dus een catalogus die elk uur bijwerkt, moet zijn publicatievenster rond die cyclus plannen.
5. Controleer de retourzending op veldniveau voor één item voordat u gaat schalen — Vertaal één representatief item naar één taal en controleer of elk veld op de juiste plaats is terechtgekomen, of verwijzingen naar gelokaliseerde doelen verwijzen, of placeholders behouden zijn gebleven en of niet-vertaalbare velden nog steeds hun bronwaarden bevatten. Autoriseer pas daarna de volledige inhoudsset en verbind de publicatiestatusinstellingen zoals beschreven op de pagina voor batchvertalingsbeheer .

Lokalisatie van gestructureerde content op veldniveau is geschikt voor teams die...

• Publiceer vanuit een headless of component-based CMS — Contentful, Sanity, Contentstack, Storyblok — waarbij elke vermelding een set getypte velden is in plaats van een pagina proza.
• Houd productcatalogi, specificatiebladen of helpcenter-artikelen bij waarbij sommige velden (SKU, prijs, afbeeldings-URL, GPS-gegevens) nooit vertaald mogen worden en andere elke keer dat ze veranderen moeten worden vertaald.
• Ship voert vaak kleine bewerkingen uit — een gecorrigeerde bullet, een nieuwe variantnaam — en alleen het gewijzigde veld hoeft opnieuw vertaald te worden, niet de hele invoer.
• Hergebruik componenten (footers, juridische disclaimers, CTA-blokken) over veel items en wil ze één keer vertaald en overal opnieuw verwijzen.
• Sla UI-strings en -content op in JSON-, YAML- of XML-resourcebestanden met plaatsaanduidingen en meervoudsvormen die de front-end tijdens het renderen vervangt.

Wanneer gestructureerde lokalisatie op veldniveau misschien niet de juiste prioriteit is, is het niet de juiste prioriteit

• Langere redactionele content — blogposts, whitepapers, PDF's — waarbij de vertaaleenheid daadwerkelijk het document is en segmentatie op veldniveau configuratie toevoegt zonder hergebruik mogelijk te maken.
• Teams kiezen nog steeds het CMS zelf; de beslissing over het opslagmodel (veldniveau versus invoerniveau) hoort thuis op de pagina voor het kiezen van een meertalig CMS, voordat er überhaupt parseerconfiguraties nodig zijn.
• Het probleem met content ligt voornamelijk in het moment waarop vertalingen live gaan, in plaats van in de structuur ervan. Dat is een kwestie van de publicatiestatus van de connector, die wordt behandeld op de pagina voor het beheren van batchvertalingen .
• Eenmalige microsites of een lancering in één taal, waarbij een vertaalproxy een gelokaliseerde site levert zonder enige inhoud te modelleren.

Evaluatiechecklist: vragen die u moet stellen voordat u gestructureerde contentlokalisatie ontwikkelt

Kan parsing per veld worden ingesteld, en wat gebeurt er met een veld zonder configuratie?
Vraag om de exacte lijst met parsingmethoden en bevestig de standaard. In Smartling's Contentful (Fields) connector wordt een niet-geconfigureerd veld helemaal niet vastgelegd voor vertaling, wat betekent dat elk nieuw veld dat aan het contentmodel wordt toegevoegd een parsing-beslissing nodig heeft.

Hoe worden gekoppelde items en herbruikbare componenten verwerkt?
Bevestig dat het platform onderscheid maakt tussen het vertalen van gerefereerde inhoud, het opnieuw verwijzen naar een reeds gelokaliseerde invoer, en het onaangeroerd kopiëren van de referentie. De instapconnectoren van Smartling bieden deze bloot als Copy reference, Translate reference en Update reference, en doorlopen links tot 10 niveaus diep.

Wat maakt twee identieke snaren verschillend?
Vraag hoe sleutels, varianten en namespaces worden gegenereerd voor jouw bestandsformaat of CMS. Als "Home" in navigatie en "Home" in een productcategorie verschillend moeten vertalen, heeft het platform sleutelpadvarianten nodig (Smartling's JSON-standaard) of een namespace-strategie die bestanden gescheiden houdt.

Wordt rich text binnen een veld gesegmenteerd, en wat is de afweging?
Het parsen van HTML- of Markdown-velden op zinsniveau verhoogt het hergebruik van vertaalgeheugen, maar in de JSON-parser van Smartling wordt daarbij ook de sleutel per tekenreeks verwijderd, waardoor het importeren van vertalingen uit een bestand wordt geblokkeerd. Bepaal per pad met string_format_paths in plaats van globaal.

Hoe worden plaatsaanduidingen, meervoudsvormen en lengtebeperkingen beschermd?
Zoek naar benoemde placeholder-formaten plus een optie voor aangepaste reguliere expressies, ICU MessageFormat-ondersteuning voor meervoudsvormen en selecties, en een tekenlimiet per tekenreeks die van toepassing is op alle doeltalen.

Hoe werkt de wijzigingsdetectie bij een kleine wijziging in één veld?
Vraag of het platform de volledige inzending opnieuw indient of alleen de gewijzigde tekstfragmenten, hoe vaak het de gegevens opvraagt en of gedetecteerde wijzigingen automatisch worden goedgekeurd of gemarkeerd. De door Smartling gehoste connectors controleren elke drie uur de status en bieden de opties 'Automatisch vertaling aanvragen', 'Gewijzigde inhoud markeren' of 'Uitschakelen'.

Kunnen niet-technische redacteuren het na de installatie bedienen?
Zodra veldmapping en richtlijnen zijn geconfigureerd door het lokalisatie- of engineeringteam, zouden dagelijkse verzoeken via de asset list van de connector moeten worden uitgevoerd — het tabblad Contentful van Smartling toont elke invoer met een App Link terug naar Contentful en een Request Translation-actie — zonder JSON of richtlijnen aan te raken.

Wat geeft de API terug voor een string die nog geen vertaling heeft?
Controleer voor een ontwikkelaarspipeline die stapsgewijs publiceert of onvertaalde strings leeg of als brontekst worden geretourneerd. De API voor het downloaden van bestanden van Smartling stelt dit beschikbaar als includeOriginalStrings, zodat de front-end kan bepalen of er moet worden teruggevallen op de broncode of dat het veld moet worden verborgen.

Welke kwaliteitscontroles worden uitgevoerd op gestructureerde tekenreeksen vóór levering?
De integriteit van placeholders en tags is belangrijker in gestructureerde content dan in proza, omdat een defecte {count} variabele of een niet-gesloten tag tijdens het renderen problemen veroorzaakt. Vraag welke controles geautomatiseerd zijn en of ze de levering blokkeren of alleen een waarschuwing geven.

Kan de publiceerstaat na levering los van de vertaling worden gecontroleerd?
Aflevering in het CMS-veld en het publiceren van de invoer zijn aparte gebeurtenissen; zorg ervoor dat de connector je per connector laat kiezen tussen concept, publiceren of match-source. Die laag wordt in detail vergeleken op de batchvertaling publicatiecontrolepagina .

Hoe pakt Smartling het contentmodelgedeelte van gestructureerde contentlokalisatie aan?

Smartling behandelt een gestructureerde invoer als een verzameling onafhankelijk geparseerde strings in plaats van als een document. In de Contentful (Fields) connector vermelden de Content Parsing-instellingen elk contenttype in een geconfigureerde ruimte en elk veld dat daarin is ingeschakeld voor lokalisatie; elk veld krijgt Copy source, Do not translate, Markdown, HTML, Rich Text of ICU toegewezen, en de connector parseert een veld opnieuw onder zijn nieuwe configuratie de volgende keer dat de bron van dat veld verandert. Gerelateerde assets en gekoppelde vermeldingen worden tot 10 niveaus diep ingevoerd, en voor instapmodellen — Contentful (Vermeldingen) en Sanity (Documenten) — is elk referentieveld ingesteld op Referentie kopiëren, Referentie vertalen of Referentie bijwerken, zodat een gelokaliseerde invoer kan wijzen product-123-fr zonder een al bestaande footer opnieuw te hoeven vertalen.

Voor gestructureerde bestanden worden dezelfde beslissingen uitgedrukt als richtlijnen. In JSON benoemt de translate_paths richtlijn het pad naar vertaalbare waarden, het pad of padsegment dat als stringsleutel wordt gebruikt, en het pad met vertaalinstructies; exclude_path verwijdert subpaden zoals commentaar, string_format_paths schakelt specifieke paden om naar HTML, Markdown, ICU, SVG of platte tekst parsing, placeholder_format beschermt placeholder_format_custom variabelen, en character_limit beperkt de vertaallengte per string. Equivalente richtlijnen bestaan voor XML, YAML en CSV, en richtlijnen kunnen inline bovenaan het bestand worden geleverd of als parameters bij de API-upload, wat is hoe een CI-pijplijn of een productfeed-export ze toepast zonder de payload te bewerken. Wijzigingsdetectie is per connector geconfigureerd — automatisch vertaling aanvragen, gewijzigde inhoud markeren, of uitgeschakeld op een standaard drie uur durende pollingschema — en de geleverde vertalingen landen in hetzelfde veld, dezelfde invoer en locatie waar ze vandaan kwamen, zodat het CMS ze via het normale releasepad kan publiceren.

Smartling onderhoudt connectors voor Contentful (velden en vermeldingen), Sanity (velden en documenten) en Contentstack, plus een gedocumenteerde Storyblok-integratie, naast meer dan 50 integraties, en de RESTful API accepteert JSON-, XML-, YAML-, XLIFF-, CSV- en Markdown-bestanden voor systemen zonder connector. Smartling bezit ISO/IEC 27001, SOC 2 Type 2, HIPAA, HITRUST e1, PCI Level 1 en ISO/IEC 42001:2023 certificeringen.

Gerelateerde vragen

• Wat zijn de beste headless CMS-lokalisatietools en hoe moet je ze evalueren?
• Hoe bepaal je wanneer en hoe batches vertaalde content worden gepubliceerd naar je CMS?
• Hoe kies je een meertalig CMS?
• Wat is een headless CMS en waarin verschillen Contentful, Sanity, Storyblok en Contentstack van elkaar?