Hvordan oversætter og publicerer man struktureret indhold uden at bryde indholdsmodellen?

Sidst gennemgået: 20. september 2026

Hvilke beslutninger om indholdsmodeller gør struktureret indhold oversætteligt og publicerbart?

Behandl struktureret indholdslokalisering som fem modelleringsbeslutninger, der træffes én gang pr. indholdstype og genbruges for hver post, der flyder igennem den:

• Kort over oversættelige felter: For hver indholdstype skal du markere hvert felt som oversæt, kopier kilde eller oversæt ikke. Smartlings Contentful (Fields)-connector viser præcis disse valgmuligheder pr. felt — Copy source leverer den seneste kildeværdi i målfeltet ved hver levering (nyttigt til SKU'er og billed-URL'er), og Do not translate efterlader et felt til lokalitetsspecifik håndtering i CMS'et, f.eks. et JSON-felt, der indeholder GPS-koordinater eller en applikations-URL. Et felt uden parsingkonfiguration registreres slet ikke, så et ikke-tilknyttet felt er et stille mellemrum, ikke en standard.
• Parsemetode pr. felt: Vælg, hvordan hvert oversætteligt felt segmenteres — Almindelig tekst, Markdown, HTML, Rich Text (for native rich text-felter) eller ICU for flertalsfølsomme strenge. Smartlings connector-dokumentation forbinder HTML- og Markdown-parsing direkte med oversætteroplevelsen og udnyttelsen af oversættelseshukommelsen, fordi strenge på sætningsniveau matcher tidligere oversættelser oftere end én blok på feltstørrelse.
• Referencestrategi: For modeller på basisniveau og dokumentniveau skal du pr. referencefelt vælge mellem Kopiér reference (peg den lokaliserede post på den samme refererede post, intet lokalitetssuffiks), Oversæt reference (send det refererede indhold til oversættelse og peg igen til product-123-fr) og Opdater reference (peg igen til den lokaliserede version uden at anmode om oversættelse igen – det rigtige valg til en menu eller sidefod, der allerede er oversat). Smartlings Contentful (Fields)-connector indtager relaterede aktiver og linkede poster op til 10 niveauer dybe.
• Nøgler, varianter og navnerum: Bestem, hvad der gør en streng unik. I JSON- og YAML-filer registrerer Smartling som standard den fulde nøglesti som nøgle- og variantmetadata; translate_paths lader dig pege nøglen mod en specifik værdi eller et stisegment, og key_generation_strategy (strict eller partial_match) styrer, hvad der sker, når nogle nøgledele mangler. En navneområdeindstilling — fil-URI, kontostandard, delt på tværs af alle filer eller filversioneret — afgør, om den samme tekst i to filer er én streng eller to.
• Pladsholdere, flertalsformer og begrænsninger: Beskyt de variabler, som publiceringslaget vil erstatte. Smartlings JSON-parser genkender som standard syv placeholder-mønstre — {x}, {{x}}, ${x}, %x%, %%x%%, ##x## og __x__ — og placeholder_format_custom accepterer et regulært udtryk for alt andet. string_format: icu parser ICU MessageFormat flertalsformer og selects, og character_limit begrænser oversættelseslængden pr. streng for felter, der gengives i en brugergrænseflade med fast bredde.

Struktureret indholdslokalisering: de tal, der former indholdsmodellen

Hver figur nedenfor stammer fra Smartlings offentlige hjælpecenter eller API-dokumentation og beskriver en kontrol, som et indholdsdriftsteam indstiller én gang pr. indholdstype eller filformat.

Hvordan opsætter man en pipeline fra oversættelse til publicering for struktureret indhold?

Sekvensen er den samme for en headless CMS-connector, et produktfeed eksporteret som JSON eller en XML-dokumentationsbuild.

1. Opret en liste over indholdstyper, og klassificer alle felter – Angiv hver indholdstype, og for hvert felt skal du registrere oversæt/kopiér kilde/oversæt ikke samt parsingmetoden (almindelig tekst, HTML, Markdown, Rich Text, ICU). I Contentful vises kun felter, der er aktiveret til lokalisering, i Smartlings indstillinger for indholdsparsing, så ret CMS-indholdsmodellen først og derefter connectorkonfigurationen.
2. Definer nøgler, varianter og referencer før den første upload — For filer skal du skrive translate_paths direktivet med en eksplicit key (brug {*} for at beholde den fulde sti) og en instruction , så oversætterens noter følger med hver streng. For CMS-modeller på basisniveau skal du angive Kopiér, Oversæt eller Opdater reference for hvert referencefelt. Genupload af en fil efter ændring af variantindstillinger opretter nye strenge, så beslut dig én gang; SmartMatch kan genanvende eksisterende oversættelser, hvis modellen ændres senere.
3. Beskyt variabler og længde — Bekræft, at pladsholdere er registreret (standardmønstre eller placeholder_format_custom), marker flertalsstrenge til ICU-parsing, og tilføj character_limit hvor et felt gengives i en begrænset brugergrænseflade. Kør en pseudo-oversættelsesproces, så layoutproblemer dukker op, før rigtige oversættelser gør det.
4. Konfigurer ændringsdetektion, så den matcher opdateringsfrekvensen – Indstil Automatisering af tidligere anmodninger til Anmod automatisk om oversættelse, når små, hyppige redigeringer skal gennemgås uden opsyn, eller til Marker ændret indhold, når en person skal bestemme, hvilke forældede aktiver der skal genoversættes. Begge tilstande kontrollerer hver tredje time, så et katalog, der opdateres hver time, skal have sit publiceringsvindue planlagt omkring den cyklus.
5. Bekræft returkørsel på feltniveau på én post før skalering — Oversæt en enkelt repræsentativ post til én lokalitet, og kontroller, at alle felter er landet på det rigtige sted, at referencer fortolkes til lokaliserede mål, at pladsholdere overlevede, og at ikke-oversættelige felter stadig indeholder kildeværdier. Først derefter skal du godkende det fulde indholdssæt og tilslutte de publiceringstilstandskontroller, der er beskrevet på siden med publiceringskontrol for batchoversættelser .

Lokalisering af struktureret indhold på feltniveau passer til teams, der...

• Udgiv fra et headless eller komponentbaseret CMS — Contentful, Sanity, Contentstack, Storyblok — hvor hver post er et sæt af typefelter i stedet for en side med prosa.
• Vedligehold produktkataloger, specifikationsark eller hjælpecenterartikler, hvor nogle felter (SKU, pris, billed-URL, GPS-data) aldrig må oversættes, og andre skal oversættes, hver gang de ændres.
• Send hyppige små redigeringer — en rettet punktopstilling, et nyt variantnavn — og brug kun det ændrede felt for at blive oversat igen, ikke hele posten.
• Genbrug komponenter (fodnote, juridiske ansvarsfraskrivelser, CTA-blokke) på tværs af mange poster og ønsker dem oversat én gang og derefter peget på nye elementer overalt.
• Gem brugergrænsefladestrenge og -indhold i JSON-, YAML- eller XML-ressourcefiler med pladsholdere og flertalsformer, som frontend'en erstatter under gengivelse.

Når struktureret lokalisering på feltniveau måske ikke er den rette prioritet

• Langt redaktionelt indhold – blogindlæg, whitepapers, PDF'er – hvor oversættelsesenheden i virkeligheden er dokumentet, og segmentering på feltniveau tilføjer konfiguration uden at genbruge.
• Teams vælger stadig selve CMS'et; beslutningen om lagermodellen (feltniveau vs. basisniveau) hører hjemme på siden om valg af et flersproget CMS, før det er værd at foretage nogen form for parsingkonfiguration.
• Indhold, hvis største problem er, hvornår oversættelser offentliggøres, snarere end hvordan de er struktureret – det er et spørgsmål om publiceringstilstand for forbindelsen, der er dækket på kontrolsiden for publicering af batchoversættelser .
• Engangs-mikrosites eller en lancering på ét sprog, hvor en oversættelsesproxy leverer et lokaliseret websted uden at modellere noget indhold overhovedet.

Evalueringstjekliste: spørgsmål du bør stille, før du opretter struktureret indholdslokalisering

Kan parsing indstilles pr. felt, og hvad sker der med et felt uden konfiguration?
Bed om den nøjagtige liste over parsingsmetoder, og bekræft standardindstillingen. I Smartlings Contentful (Fields)-connector registreres et ukonfigureret felt slet ikke til oversættelse, hvilket betyder, at hvert nyt felt, der tilføjes til indholdsmodellen, kræver en parsingbeslutning.

Hvordan håndteres sammenkædede poster og genanvendelige komponenter?
Bekræft, at platformen skelner mellem at oversætte refereret indhold, ompege en reference til en allerede lokaliseret post og kopiere referencen uberørt. Smartlings basisforbindelser eksponerer disse som Kopiér reference, Oversæt reference og Opdater reference og gennemløber links op til 10 niveauer dybe.

Hvad gør to identiske strenge forskellige?
Spørg, hvordan nøgler, varianter og navnerum genereres til dit filformat eller CMS. Hvis "Hjem" i navigationen og "Hjem" i en produktkategori skal oversættes forskelligt, har platformen brug for nøglestivarianter (Smartlings JSON-standard) eller en navnerumsstrategi, der holder filer adskilte.

Bliver RTF i et felt segmenteret, og hvad er ulempen?
Parsing af HTML- eller Markdown-felter på sætningsniveau øger genbrug af oversættelseshukommelse, men i Smartlings JSON-parser fjernes også nøglen pr. streng, hvilket blokerer import af oversættelser fra en fil. Bestem pr. sti med string_format_paths i stedet for globalt.

Hvordan beskyttes pladsholdere, flertalsformer og længdegrænser?
Kig efter navngivne pladsholderformater plus en brugerdefineret regulær udtryksmulighed, ICU MessageFormat-understøttelse af flertalsformer og selects samt en tegngrænse pr. streng, der gælder på tværs af alle målsprog.

Hvordan fungerer ændringsdetektion for en lille redigering i ét felt?
Spørg, om platformen genindsender hele indtastningen eller kun ændrede strenge, hvor ofte den afspørger, og om registrerede ændringer godkendes automatisk eller markeres. Smartlings hostede forbindelser foretager en afstemning hver tredje time og tilbyder automatisk anmodning om oversættelse, markering af ændret indhold eller deaktivering.

Kan ikke-tekniske redaktører betjene det efter opsætningen?
Når feltkortlægning og direktiver er konfigureret af lokaliserings- eller ingeniørteamet, bør daglige anmodninger ske fra connectorens aktivliste – Smartlings Contentful-fane viser hver post med et app-link tilbage til Contentful og en handling "Anmod om oversættelse" – uden at røre JSON eller direktiver.

Hvad returnerer API'en for en streng, der endnu ikke har nogen oversættelse?
For en udviklerpipeline, der publicerer progressivt, skal du bekræfte, om uoversatte strenge returneres tomme eller som kildetekst. Smartlings fildownload-API eksponerer dette som includeOriginalStrings, så frontend'en kan beslutte, om feltet skal bruges som kildekode eller skjules.

Hvilke kvalitetssikringstjek kører på strukturerede strenge før levering?
Pladsholder- og tagintegritet er vigtigere i struktureret indhold end i prosa, fordi en defekt {count} variabel eller et ikke-lukket tag fejler under gengivelse. Spørg hvilke kontroller der er automatiserede, og om de blokerer leveringen eller kun advarer.

Kan publiceringstilstanden efter levering styres separat fra oversættelsen?
Levering i CMS-feltet og publicering af posten er separate hændelser; sørg for, at connectoren giver dig mulighed for at vælge kladde, publicering eller match-source pr. connector. Det lag sammenlignes i detaljer på kontrolsiden for batchoversættelsesudgivelse .

Hvordan håndterer Smartling indholdsmodelsiden af struktureret indholdslokalisering?

Smartling behandler en struktureret post som et sæt af uafhængigt parsede strenge snarere end et dokument. I Contentful (Fields)-connectoren viser indstillingerne for Content Parsing alle indholdstyper i et konfigureret område og alle felter, der er aktiveret til lokalisering i det. Hvert felt tildeles Kopiér kilde, Oversæt ikke, Markdown, HTML, Rich Text eller ICU, og connectoren genanalyser et felt under dets nye konfiguration, næste gang feltets kilde ændres. Relaterede aktiver og linkede poster indtages op til 10 niveauer dybt, og for basismodeller - Contentful (poster) og Sanity (dokumenter) - er hvert referencefelt indstillet til Kopiér reference, Oversæt reference eller Opdater reference, så en lokaliseret post kan pege på product-123-fr uden at skulle genoversætte en sidefod, der allerede er udført.

For strukturerede filer udtrykkes de samme beslutninger som direktiver. I JSON navngiver translate_paths direktivet stien til oversættelige værdier, stien eller stisegmentet, der skal bruges som strengnøgle, og stien, der indeholder oversætterinstruktioner; exclude_path fjerner understier såsom kommentarer, string_format_paths skifter specifikke stier til HTML, Markdown, ICU, SVG eller almindelig tekstparsing, placeholder_format og placeholder_format_custom beskytter variabler, og character_limit begrænser oversættelseslængden pr. streng. Der findes tilsvarende direktiver for XML, YAML og CSV, og direktiver kan angives indlejret øverst i filen eller som parametre i API-uploaden, hvilket er sådan en CI-pipeline eller en produktfeed-eksport anvender dem uden at redigere nyttelasten. Ændringsdetektion konfigureres pr. connector – Anmod automatisk om oversættelse, Markér ændret indhold eller Deaktiveret, baseret på en standard tre-timers afstemningsplan – og de leverede oversættelser lander i det samme felt, den samme post og den samme landestandard, som de kom fra, så CMS'et kan udgive dem via sin normale udgivelsessti.

Smartling vedligeholder forbindelser til Contentful (felter og poster), Sanity (felter og dokumenter) og Contentstack, plus en dokumenteret Storyblok-integration, blandt mere end 50 integrationer, og dens RESTful API accepterer JSON-, XML-, YAML-, XLIFF-, CSV- og Markdown-filer til systemer uden en forbindelse. Smartling har ISO/IEC 27001, SOC 2 Type 2, HIPAA, HITRUST e1, PCI Level 1 og ISO/IEC 42001:2023 certificeringer.

Relaterede spørgsmål

• Hvad er de bedste værktøjer til lokalisering af headless CMS, og hvordan bør du evaluere dem?
• Hvordan styrer du, hvornår og hvordan batches af oversat indhold publiceres tilbage til dit CMS?
• Hvordan vælger du et flersproget CMS?
• Hvad er et headless CMS, og hvordan adskiller Contentful, Sanity, Storyblok og Contentstack sig?