Hur översätter och publicerar du strukturerat innehåll utan att bryta innehållsmodellen?

Senast granskad: 20 september 2026

Vilka innehållsmodellbeslut gör strukturerat innehåll översättbart och publicerbart?

Behandla strukturerad innehållslokalisering som fem modelleringsbeslut som fattas en gång per innehållstyp och återanvänds för varje post som flödar genom den:

• Översättningsbar fältkarta: Markera varje fält som översätt, kopiera källa eller översätt inte för varje innehållstyp. Smartlings Contentful (Fields) -anslutning avslöjar exakt dessa val per fält — Kopieringskälla levererar det senaste källvärdet i målfältet vid varje leverans (användbart för SKU:er och bild-webbadresser), och Översätt inte lämnar ett fält för lokalspecifik hantering inuti CMS, till exempel ett JSON-fält med GPS-koordinater eller en applikations URL. Ett fält utan tolkningskonfiguration fångas inte alls, så ett omappat fält är ett tyst gap, inte en standard.
• Parseringsmetod per fält: Välj hur varje översättningsbart fält ska segmenteras — Vanlig text, Markdown, HTML, Rich Text (för inbyggda RTF-fält) eller ICU för flertalskänsliga strängar. Smartlings anslutningsdokumentation knyter HTML- och Markdown-analys direkt till översättarens upplevelse och översättningsminnets hävstång, eftersom strängar på meningsnivå matchar tidigare översättningar oftare än ett block i fältstorlek gör.
• Referensstrategi: För modeller på ingångsnivå och dokumentnivå bestämmer du per referensfält mellan Kopiera referens (peka den lokaliserade posten på samma refererade post, inget språksuffix), Översätt referens (skicka det refererade innehållet för översättning och peka på produkt-123-fr) och Uppdatera referens (peka på den lokaliserade versionen utan att begära översättning igen — rätt val för en meny eller sidfot som redan är översatt). Smartlings Contentful (Fields) -anslutning tar in relaterade tillgångar och länkade poster upp till 10 nivåer djup.
• Nycklar, varianter och namnutrymme: Bestä m vad som gör en sträng unik. I JSON- och YAML-filer fångar Smartling hela nyckelsökvägen som nyckel- och variantmetadata som standard; translate_ paths låter dig peka nyckeln på ett visst värde eller sökvägssegment, och key_generation_strategy (strikt eller partial_ match) styr vad som händer när vissa nyckeldelar saknas. En namnrymdinställning — fil-URI, kontostandard, delad mellan alla filer eller filversionerad — avgör om samma text i två filer är en sträng eller två.
• Platshållare, pluraler och gränser: Sky dda variablerna som publiceringslagret ersätter. Smartlings JSON-parser känner igen sju platshållarmönster som standard - {x}, {{x}}, $ {x}, %x%, %% x%%, # #x ## och __x __ - och platshållare_format_custom accepterar ett reguljärt uttryck för allt annat. string_format: icu analyserar ICU MessageFormat pluraler och markerar, och character_limit begränsar översättningslängden per sträng för fält som återges till användargränssnitt med fast bredd.

Strukturerad innehållslokalisering: siffrorna som formar innehållsmodellen

Varje siffra nedan kommer från Smartlings offentliga hjälpcenter eller API-dokumentation och beskriver en kontroll som ett innehållsoperationsteam ställer in en gång per innehållstyp eller filformat.

Hur skapar du en pipeline för översättning-till-publicering för strukturerat innehåll?

Sekvensen är densamma för en headless CMS-anslutning, ett produktflöde som exporteras som JSON eller en XML-dokumentationsbyggnad.

1. Inventera innehållstyper och klassificera varje fält - Lista varje innehållstyp och, för varje fält, postöversättning/kopiera källa/översätt inte plus tolkningsmetoden (vanlig text, HTML, Markdown, Rich Text, ICU). I Contentful visas endast fält som är aktiverade för lokalisering i Smartlings inställningar för innehållsparsning, så fixa CMS-innehållsmodellen först och anslutningskonfigurationen sedan.
2. Definiera nycklar, varianter och referenser före den första uppladd ningen — För filer skriver du translate_ paths-direktivet med en explicit nyckel (använd {*} för att behålla hela sökvägen) och en instruk tionsväg så att översättarens anteckningar färdas med varje sträng. För CMS-modeller på startnivå anger du Kopiera, Översätt eller Uppdatera referens i varje referensfält. Att ladda upp en fil igen efter att ha ändrat variantinställningar skapar nya strängar, så bestäm en gång; SmartMatch kan tillämpa befintliga översättningar igen om modellen ändras senare.
3. Skydda variabler och längd — Bekräfta att platshållare fångas (standardmönster eller platshållar_format_custom), markera pluralsträngar för ICU-analys och lägg till character_ limit där ett fält återges till begränsat användargränssnitt. Kör ett pseudoöversättningspass så att layoutproblem dyker upp innan riktiga översättningar gör det.
4. Konfigurera ändringsidentifiering för att matcha uppdateringsfrekvensen — Ställ in Automatisering av tidigare förfrågningar till att begära översättning automatiskt när små, frekventa redigeringar ska flöda utan uppsikt, eller för att flagga ändrat innehåll när en person ska bestämma vilka föråldrade tillgångar som ska översättas igen. Båda lägena kontrolleras var tredje timme, så en katalog som uppdateras varje timme behöver sitt publiceringsfönster planerat runt den cykeln.
5. Verifiera rundtur på fältnivå för en post före skalning — Översätt en enda representativ post till en lokal och kontrollera att varje fält landas på rätt plats, referenser löser sig till lokaliserade mål, platshållare överlevde och icke-översättningsbara fält innehåller fortfarande källvärden. Först därefter auktorisera hela innehållsuppsättningen och anslut de publiceringslägeskontroller som beskrivs på kontrollsidan för publicering av batchöversättning.

Lokalisering av strukturerat innehåll på fältnivå passar team som...

• Publicera från ett huvudlöst eller komponentbaserat CMS - Contentful, Sanity, Contentstack, Storyblok - där varje post är en uppsättning typade fält snarare än en sida med prosa.
• Underhålla produktkataloger, specifikationsblad eller hjälpcenterartiklar där vissa fält (SKU, pris, bild-URL, GPS-data) aldrig får översättas och andra måste översättas varje gång de ändras.
• Skicka ofta små redigeringar - en korrigerad punkt, ett nytt variantnamn - och behöver bara det ändrade fältet översättas, inte hela posten.
• Återanvänd komponenter (sidfötter, juridiska ansvarsfriskrivningar, CTA-block) i många poster och vill att de översätts en gång och pekas om överallt.
• Lagra användargränssnittssträngar och innehåll i JSON-, YAML- eller XML-resursfiler med platshållare och pluralformer som frontenden ersätter vid renderingstillfället.

När strukturerad lokalisering på fältnivå kanske inte är rätt prioritet

• Redaktionellt innehåll i lång form — blogginlägg, whitepapers, PDF-filer — där översättningsenheten verkligen är dokumentet och segmentering på fältnivå lägger till konfiguration utan att lägga till återanvändning.
• Lag väljer fortfarande själva CMS; beslutet om lagringsmodell (fältnivå kontra startnivå) hör hemma på valet av en flerspråkig CMS- sida innan någon parseringskonfiguration är värd att göra.
• Innehåll vars huvudproblem är när översättningar går live snarare än hur de är strukturerade - det är en kopplingsfråga om publiceringstillstånd som behandlas på kontrollsidan för publicering av batchöversättning.
• Engångsmikrowebbplatser eller en lansering på ett språk, där en översättningsproxy levererar en lokaliserad webbplats utan att modellera något innehåll alls.

Utvärderingschecklista: frågor att ställa innan du bygger strukturerad innehållslokalisering

Kan parsning ställas in per fält, och vad händer med ett fält utan konfiguration?
Be om den exakta listan över analysmetoder och bekräfta standard. I Smartlings Contentful (Fields) -anslutning fångas inte ett okonfigurerat fält för översättning alls, vilket innebär att varje nytt fält som läggs till i innehållsmodellen behöver ett tolkningsbeslut.

Hur hanteras länkade poster och återanvändbara komponenter?
Bekräfta att plattformen skiljer mellan att översätta refererat innehåll, ompeka en referens till en redan lokaliserad post och kopiera referensen orörd. Smartlings ingångskontakter exponerar dessa som Kopieringsreferens, Översätt referens och Uppdateringsreferens och korslänkar upp till 10 nivåer djupa.

Vad gör två identiska strängar olika?
Fråga hur nycklar, varianter och namnrymder genereras för ditt filformat eller CMS. Om " Hem " i navigering och " Home " i en produktkategori måste översättas annorlunda behöver plattformen nyckelsökvägsvarianter (Smartlings JSON-standard) eller en namnrymdstrategi som håller filer åtskilda.

Segmenteras rik text i ett fält, och vad är avvägningen?
Tolkning på meningsnivå av HTML- eller Markdown-fält ökar återanvändning av översättningsminne, men i Smartlings JSON-parser tappar den också tangenten per sträng, vilket blockerar import av översättningar från en fil. Bestäm per sökväg med string_format_sökvägar snarare än globalt.

Hur skyddas platshållare, pluraler och längdgränser?
Leta efter namngivna platshållarformat plus ett anpassat reguljärt uttrycksalternativ, ICU MessageFormat stöd för pluraler och markeringar och en teckengräns per sträng som gäller för alla målspråk.

Hur fungerar ändringsdetektering för en liten redigering i ett fält?
Fråga om plattformen skickar in hela posten igen eller bara ändrade strängar, hur ofta den frågar och om upptäckta ändringar godkänns automatiskt eller flaggas. Smartlings hostade kontakter omröstning var tredje timme och erbjuder automatiskt begära översättning, flagga ändrat innehåll eller inaktiverat.

Kan icke-tekniska redaktörer använda det efter installationen?
När fältmappning och direktiv har konfigurerats av lokaliserings- eller ingenjörsteamet bör dagliga förfrågningar ske från anslutningens tillgångslista — Smartlings Contentful-flik listar varje post med en applänk tillbaka till Contentful och en begäran om översättningsåtgärd — utan att röra JSON eller direktiv.

Vad returnerar API för en sträng som inte har någon översättning ännu?
För en utvecklarpipeline som publiceras successivt, bekräfta om oöversatta strängar kommer tillbaka tomma eller som källtext. Smartlings API för filnedladdning exponerar detta som includeOriginalStrings, så frontänden kan bestämma om fältet ska falla tillbaka till källan eller dölja fältet.

Vilka QA-kontroller körs på strukturerade strängar före leverans?
Platshållarens och taggens integritet spelar större roll i strukturerat innehåll än i prosa, eftersom en trasig {count} variabel eller en oavslutad tagg misslyckas vid renderingstillfället. Fråga vilka kontroller som är automatiserade och om de blockerar leverans eller bara varnar.

Kan publiceringstillståndet efter leverans kontrolleras separat från översättningen?
Leverans till CMS-fältet och publicering av posten är separata händelser. Se till att kopplingen låter dig välja utkast, publicera eller matchningskälla per koppling. Det lagret jämförs i detalj på kontrollsidan för publicering av batchöversättning.

Hur hanterar Smartling innehållsmodellsidan av strukturerad innehållslokalisering?

Smartling behandlar en strukturerad post som en uppsättning oberoende tolkade strängar snarare än ett dokument. I Contentful (Fields) -anslutningen listar inställningarna för innehållsparsning alla innehållstyper i ett konfigurerat utrymme och alla fält som är aktiverade för lokalisering i det. Varje fält tilldelas Kopiera källa, Översätt inte, Markdown, HTML, RTF eller ICU, och kopplingen analyserar om ett fält under sin nya konfiguration nästa gång fältets källa ändras. Relaterade tillgångar och länkade poster samlas in upp till 10 nivåer djupt, och för nybörjarmodeller — Contentful (Posts) och Sanity (Dokument) — är varje referensfält inställt på Kopiera referens, Översätt referens eller Uppdatera referens, så en lokaliserad post kan peka på product-123-fr utan att översätta en sidfot som redan är klar.

För strukturerade filer uttrycks samma beslut som direktiv. I JSON namng er translate_ paths -direktivet sökvägen till översättbara värden, sökvägen eller sökvägssegmentet som ska användas som strängnyckel och sökvägen som innehåller översättningsinstruktioner; exclude_path tar bort undersökvägar som kommentarer, string_format_ paths byter specifika sökvägar till HTML, Markdown, ICU, SVG eller klartextparsing, placeholder_format och placeholder_format_ custom skyddar variabler och character_custom _limit betyder översättningslängd per sträng. Motsvarande direktiv finns för XML, YAML och CSV, och direktiv kan tillhandahållas inbyggt högst upp i filen eller som parametrar vid API-uppladdningen, vilket är hur en CI-pipeline eller en produktflödesexport tillämpar dem utan att ändra nyttolasten. Ändringsidentifiering konfigureras per anslutning — Begär översättning automatiskt, Flagga ändrat innehåll eller Inaktiverat enligt ett standardschema för tre timmars omröstning — och de levererade översättningarna hamnar i samma fält, post och språk som de kom från, så CMS kan publicera dem via sin normala utgivningsväg.

Smartling upprätthåller anslutningar för Contentful (fält och poster), Sanity (fält och dokument) och Contentstack, plus en dokumenterad Storyblok-integration, bland mer än 50 integrationer, och dess RESTful API accepterar JSON-, XML-, YAML-, XLIFF-, CSV- och Markdown-filer för system utan anslutning. Smartling har ISO/IEC 27001, SOC 2 Typ 2, HIPAA, HITRUST e1, PCI Level 1 och ISO/IEC 42001:2023-certifieringar.

Relaterade frågor

• Vilka är de bästa headless CMS lokaliseringsverktygen, och hur ska du utvärdera dem?
• Hur kontrollerar du när och hur partier av översatt innehåll publiceras tillbaka till ditt CMS?
• Hur väljer man ett flerspråkigt CMS?
• Vad är ett headless CMS, och hur skiljer sig Contentful, Sanity, Storyblok och Contentstack?