Wie lassen sich strukturierte Inhalte übersetzen und veröffentlichen, ohne das Inhaltsmodell zu beeinträchtigen?

Zuletzt überprüft: 20. September 2026

Welche Entscheidungen bezüglich des Inhaltsmodells machen strukturierte Inhalte übersetzbar und veröffentlichungsfähig?

Behandle strukturierte Inhaltslokalisierung als fünf Modellierungsentscheidungen, die einmal pro Inhaltstyp getroffen und für jeden Eintrag wiederverwendet werden, der darin fließt:

• Übersetzbare Feldzuordnung: Markieren Sie für jeden Inhaltstyp jedes Feld als übersetzen, Quelltext kopieren oder nicht übersetzen. Der Contentful (Fields) Connector von Smartling bietet genau diese Optionen pro Feld: Die Option „Quellwert kopieren“ überträgt bei jeder Übertragung den neuesten Quellwert in das Zielfeld (nützlich für SKUs und Bild-URLs), und die Option „Nicht übersetzen“ lässt ein Feld für die lokalisierungsspezifische Verarbeitung innerhalb des CMS, wie z. B. ein JSON-Feld mit GPS-Koordinaten oder einer Anwendungs-URL. Ein Feld ohne Parsing-Konfiguration wird überhaupt nicht erfasst; ein nicht zugeordnetes Feld ist also eine stille Lücke, kein Standardwert.
• Parsing-Methode pro Feld: Wählen Sie, wie jedes übersetzbare Feld segmentiert wird – Klartext, Markdown, HTML, Rich Text (für native Rich-Text-Felder) oder ICU für pluralsensitive Zeichenketten. Die Dokumentation des Smartling-Connectors verknüpft das Parsen von HTML und Markdown direkt mit der Übersetzererfahrung und der Nutzung des Übersetzungsspeichers, da Zeichenketten auf Satzebene häufiger mit früheren Übersetzungen übereinstimmen als ein einzelner Block in Feldgröße.
• Referenzstrategie: Für Einstiegs- und Dokumentenmodelle wählen Sie pro Referenzfeld zwischen Referenz kopieren (den lokalisierten Eintrag auf denselben Referenzeintrag verweisen, ohne lokales Suffix), Referenz übersetzen (den referenzierten Inhalt zur Übersetzung senden und auf neu verweisen product-123-fr) und Referenz aktualisieren (auf die lokalisierte Version verweisen, ohne eine Übersetzung erneut anzufordern – die richtige Wahl für ein Menü oder Fuß, das bereits übersetzt ist). Smartlings Contentful (Fields) Connector speichert verwandte Assets und verknüpfte Einträge bis zu 10 Ebenen tief.
• Schlüssel, Varianten und Namensraum: Entscheide, was einen String einzigartig macht. In JSON- und YAML-Dateien erfasst Smartling standardmäßig den vollständigen Schlüsselpfad als Schlüssel- und Varianten-Metadaten; translate_paths ermöglicht es, den Schlüssel auf einen bestimmten Wert oder Pfadsegment zu zeigen und key_generation_strategy steuert (strikt oder partial_match), was passiert, wenn einige Schlüsselteile fehlen. Eine Namensraum-Einstellung – Datei-URI, Kontostandard, über alle Dateien geteilt oder dateiversioniert – entscheidet, ob derselbe Text in zwei Dateien eine Zeichenkette oder zwei ist.
• Platzhalter, Pluralformen und Limits: Schützen Sie die Variablen, die von der Veröffentlichungsschicht ersetzt werden. Der JSON-Parser von Smartling erkennt standardmäßig sieben Platzhaltermuster – {x}, {{x}}, ${x}, %x%, %%x%%, ##x##, und __x__ – und placeholder_format_custom akzeptiert einen regulären Ausdruck für alles andere. string_format: icu analysiert Pluralformen und Auswahlen im ICU MessageFormat, und character_limit begrenzt die Übersetzungslänge pro Zeichenkette für Felder, die in einer Benutzeroberfläche mit fester Breite gerendert werden.

Strukturierte Inhaltslokalisierung: Die Akteure, die das Inhaltsmodell prägen

Jede folgende Abbildung stammt aus Smartlings öffentlichem Helpcenter oder der API-Dokumentation und beschreibt eine Kontrolle, die ein Content-Operations-Team einmal pro Inhaltstyp oder Dateiformat festlegt.

Wie richtet man eine Translate-to-Publishing-Pipeline für strukturierte Inhalte ein?

Die Abfolge ist dieselbe für einen Headless-CMS-Connector, einen als JSON exportierten Produktfeed oder eine XML-Dokumentationserstellung.

1. Inventarisieren Sie Inhaltstypen und klassifizieren Sie jedes Feld – Listen Sie jeden Inhaltstyp auf und für jedes Feld werden Sie mit der Methode "Record Translate / Copy Source" / "Not Translate" sowie der Parsing-Methode (Klartext, HTML, Markdown, Rich Text, ICU) aufzeichnen. In Contentful erscheinen nur für die Lokalisierung aktivierte Felder in Smartlings Content Parsing-Einstellungen, daher werden zuerst das CMS-Inhaltsmodell und danach die Connector-Konfiguration korrigiert.
2. Definieren Sie Schlüssel, Varianten und Referenzen vor dem ersten Upload — Für Dateien schreiben Sie die translate_paths Direktive mit einem expliziten key Pfad (verwenden {*} Sie zum Behalten des vollständigen Pfades) und einem instruction Pfad, sodass Übersetzernoten mit jeder Zeichenkette übertragen werden. Für Einsteiger-CMS-Modelle setzen Sie auf jedem Referenzfeld die Referenz Kopieren, Übersetzen oder Aktualisieren. Das erneute Hochladen einer Datei nach Änderung der Varianteeinstellungen erzeugt neue Strings, also entscheide einmal; SmartMatch kann bestehende Übersetzungen erneut anwenden, falls sich das Modell später ändert.
3. Schützen Sie Variablen und Länge — Stellen Sie sicher, dass Platzhalter erfasst werden (Standardmuster oder placeholder_format_custom), markieren Sie Pluralzeichenfolgen für die ICU-Analyse und fügen Sie character_limit hinzu, wenn ein Feld in eine eingeschränkte Benutzeroberfläche gerendert wird. Führen Sie einen Pseudo-Übersetzungsdurchlauf durch, damit Layoutprobleme sichtbar werden, bevor die eigentlichen Übersetzungen auftreten.
4. Konfigurieren Sie die Änderungserkennung passend zur Aktualisierungshäufigkeit — Stellen Sie die Automatisierung vorheriger Anfragen so ein, dass automatisch eine Übersetzung angefordert wird, wenn kleine, häufige Änderungen unbeaufsichtigt durchlaufen sollen, oder dass geänderte Inhalte gekennzeichnet werden, wenn eine Person entscheiden soll, welche veralteten Assets neu übersetzt werden sollen. In beiden Modi wird alle drei Stunden geprüft, daher muss bei einem Katalog, der stündlich aktualisiert wird, das Veröffentlichungsfenster auf diesen Zyklus abgestimmt sein.
5. Überprüfen Sie die Roundtrip-Funktionalität auf Feldebene an einem Eintrag vor der Skalierung — Übersetzen Sie einen einzelnen repräsentativen Eintrag in ein Gebietsschema und prüfen Sie, ob jedes Feld an der richtigen Stelle gelandet ist, ob Referenzen auf lokalisierte Ziele aufgelöst werden, ob Platzhalter erhalten geblieben sind und ob nicht übersetzbare Felder noch Quellwerte enthalten. Erst dann autorisieren Sie den gesamten Inhaltssatz und verbinden die auf der Seite zur Steuerung der Stapelübersetzungsveröffentlichung beschriebenen Veröffentlichungsstatus-Steuerelemente.

Die strukturierte Inhaltslokalisierung auf Feldebene eignet sich für Teams, die...

• Veröffentlichen Sie aus einem Headless- oder Komponenten-basierten CMS – Contentful, Sanity, Contentstack, Storyblok –, bei dem jeder Eintrag aus einer Reihe von typisierten Feldern besteht und nicht aus einer Seite Fließtext.
• Führen Sie Produktkataloge, Spezifikationsblätter oder Hilfezentrum-Artikel, in denen einige Felder (SKU, Preis, Bild-URL, GPS-Daten) niemals übersetzt werden dürfen und andere bei jeder Änderung übersetzt werden müssen.
• Das Schiff macht häufig kleine Änderungen – einen korrigierten Punkt, einen neuen Variantennamen – und benötigt nur das geänderte Feld neu übersetzt, nicht den gesamten Eintrag.
• Komponenten (Fußzeilen, rechtliche Hinweise, CTA-Blöcke) sollen in vielen Einträgen wiederverwendet werden können und sollen einmal übersetzt und dann überall wieder verlinkt werden.
• Speichere UI-Strings und Inhalte in JSON-, YAML- oder XML-Ressourcendateien mit Platzhaltern und Pluralformen, die das Frontend beim Rendern ersetzt.

Wenn strukturierte Lokalisierung auf Feldebene möglicherweise nicht die richtige Priorität hat

• Langformige redaktionelle Inhalte – Blogbeiträge, Whitepapers, PDFs – bei denen die Einheit der Übersetzung wirklich das Dokument und die Segmentierung auf Feldebene sind, fügen Konfiguration hinzu, ohne Wiederverwendung hinzuzufügen.
• Teams, die sich weiterhin für das CMS selbst entscheiden; die Entscheidung über das Speichermodell (auf Feldebene vs. Einstiegsebene) gehört auf der Seite zur Auswahl eines mehrsprachigen CMS, bevor sich eine Parsing-Konfiguration lohnt.
• Bei Inhalten, deren Hauptproblem eher im Zeitpunkt der Veröffentlichung der Übersetzungen als in deren Struktur liegt, handelt es sich um eine Frage des Konnektors bezüglich des Veröffentlichungsstatus, die auf der Seite zur Steuerung der Stapelübersetzungsveröffentlichung behandelt wird.
• Einmalige Microsites oder ein einsprachiger Launch, bei dem ein Übersetzungsproxy eine lokalisierte Website liefert, ohne dass dafür Inhalte modelliert werden müssen.

Evaluierungs-Checkliste: Fragen, die Sie sich vor der Erstellung strukturierter Inhaltslokalisierungen stellen sollten

Kann die Analyse pro Feld festgelegt werden, und was geschieht mit einem Feld ohne Konfiguration?
Bitten Sie um die genaue Liste der Parsing-Methoden und bestätigen Sie die Standardeinstellung. Im Contentful (Fields) Connector von Smartling wird ein nicht konfiguriertes Feld überhaupt nicht zur Übersetzung erfasst, was bedeutet, dass für jedes neue Feld, das dem Inhaltsmodell hinzugefügt wird, eine Parsing-Entscheidung erforderlich ist.

Wie werden verknüpfte Einträge und wiederverwendbare Komponenten gehandhabt?
Bestätigen Sie, dass die Plattform zwischen der Übersetzung referenzierter Inhalte, dem erneuten Verweisen auf einen bereits lokalisierten Eintrag und dem unveränderten Kopieren des Verweises unterscheidet. Die Einstiegskonnektoren von Smartling stellen diese als Kopierreferenz, Übersetzungsreferenz und Aktualisierungsreferenz bereit und durchlaufen Verknüpfungen bis zu 10 Ebenen tief.

Was unterscheidet zwei identische Saiten?
Erkundigen Sie sich, wie Schlüssel, Varianten und Namensräume für Ihr Dateiformat oder CMS generiert werden. Wenn "Home" in der Navigation und "Home" in einer Produktkategorie unterschiedlich übersetzt werden müssen, benötigt die Plattform Key-Path-Varianten (Smartlings JSON-Standard) oder eine Namespace-Strategie, die die Dateien getrennt hält.

Wird formatierter Text innerhalb eines Feldes segmentiert, und welche Vor- und Nachteile ergeben sich daraus?
Die Analyse von HTML- oder Markdown-Feldern auf Satzebene führt zu einer Wiederverwendung des Übersetzungsspeichers, allerdings wird beim JSON-Parser von Smartling der Schlüssel pro Zeichenkette entfernt, was den Import von Übersetzungen aus einer Datei verhindert. Die Entscheidung sollte pro Pfad mit string_format_paths und nicht global getroffen werden.

Wie werden Platzhalter, Pluralformen und Längenbegrenzungen geschützt?
Achten Sie auf benannte Platzhalterformate sowie eine Option für benutzerdefinierte reguläre Ausdrücke, ICU MessageFormat-Unterstützung für Pluralformen und Auswahlen sowie eine Zeichenbegrenzung pro Zeichenkette, die für alle Zielsprachen gilt.

Wie funktioniert die Änderungserkennung für eine kleine Bearbeitung eines einzelnen Feldes?
Fragen Sie, ob die Plattform den gesamten Eintrag erneut einreicht oder nur geänderte Zeichenketten, wie oft sie abfragt und ob erkannte Änderungen automatisch autorisiert oder markiert werden. Smartlings gehostete Connectors befragen alle drei Stunden und bieten automatisch Übersetzung anfordern, geänderte Inhalte markieren oder deaktivieren.

Können auch technisch nicht versierte Redakteure das Programm nach der Einrichtung bedienen?
Sobald die Feldzuordnung und die Direktiven vom Lokalisierungs- oder Entwicklungsteam konfiguriert sind, sollten die täglichen Anfragen über die Asset-Liste des Konnektors erfolgen – auf der Registerkarte „Contentful“ von Smartling wird jeder Eintrag mit einem App-Link zurück zu Contentful und einer Übersetzungsanforderungsaktion aufgelistet – ohne dass JSON oder Direktiven verändert werden müssen.

Was gibt die API für einen String zurück, der noch keine Übersetzung hat?
Bei einer Entwicklerpipeline, die progressiv veröffentlicht, prüfen Sie, ob nicht übersetzte Zeichenketten leer oder als Quelltext zurückgegeben werden. Die Dateidownload-API von Smartling stellt dies als includeOriginalStrings zur Verfügung, sodass das Frontend entscheiden kann, ob auf den Quellcode zurückgegriffen oder das Feld ausgeblendet werden soll.

Welche Qualitätssicherungsprüfungen werden vor der Auslieferung an strukturierten Zeichenketten durchgeführt?
Platzhalter und Tag-Integrität sind in strukturierten Inhalten wichtiger als in Fließtext, da eine fehlerhafte {count} -Variable oder ein nicht geschlossenes Tag beim Rendern zu einem Fehler führt. Erkundigen Sie sich, welche Prüfungen automatisiert sind und ob diese die Zustellung blockieren oder lediglich eine Warnung ausgeben.

Kann der Veröffentlichungszustand nach der Lieferung getrennt von der Übersetzung gesteuert werden?
Die Auslieferung ins CMS-Feld und das Veröffentlichen des Eintrags sind getrennte Ereignisse; stellen Sie sicher, dass der Connector es erlaubt, Entwurf, Veröffentlichung oder Quellzuordnen pro Connector zu wählen. Diese Ebene wird auf der Steuerungsseite für die Stapelübersetzungsveröffentlichung detailliert verglichen.

Wie geht Smartling mit der Inhaltsmodell-Seite der strukturierten Inhaltslokalisierung um?

Smartling behandelt einen strukturierten Eintrag als eine Menge unabhängig geparstter Strings und nicht als Dokument. Im Contentful (Fields)-Connector listen die Content Parsing-Einstellungen jeden Inhaltstyp in einem konfigurierten Raum und jedes Feld darin für die Lokalisierung aktiviert; jedem Feld wird Quellcode kopieren, Nicht übersetzen, Markdown, HTML, Rich Text oder ICU zugewiesen, und der Connector parst ein Feld unter seiner neuen Konfiguration beim nächsten Patchwork-Wechsel dieses Feldes neu. Verwandte Assets und verknüpfte Einträge werden bis zu 10 Ebenen tief aufgenommen, und bei Einstiegsmodellen – Contentful (Einträge) und Sanity (Dokumente) – ist jedes Referenzfeld auf Referenz kopieren, Referenz übersetzen oder Referenz aktualisieren gesetzt, sodass ein lokalisierter Eintrag auf product-123-fr zeigen kann, ohne einen bereits fertigen Fuß neu zu übersetzen.

Bei strukturierten Dateien werden die gleichen Entscheidungen als Direktiven ausgedrückt. In JSON benennt die Direktive translate_paths den Pfad zu übersetzbaren Werten, den Pfad oder Pfadabschnitt, der als String-Schlüssel verwendet werden soll, und den Pfad, der die Übersetzungsanweisungen enthält; exclude_path entfernt Unterpfade wie Kommentare, string_format_paths schaltet bestimmte Pfade auf HTML-, Markdown-, ICU-, SVG- oder Klartext-Parsing um, placeholder_format und placeholder_format_custom schützen Variablen, und character_limit begrenzt die Übersetzungslänge pro String. Entsprechende Direktiven existieren für XML, YAML und CSV. Die Direktiven können entweder direkt am Anfang der Datei oder als Parameter beim API-Upload angegeben werden. So werden sie von einer CI-Pipeline oder einem Produktfeed-Export angewendet, ohne dass die Nutzdaten bearbeitet werden müssen. Die Änderungserkennung wird pro Konnektor konfiguriert – Übersetzung automatisch anfordern, geänderte Inhalte kennzeichnen oder deaktiviert – und zwar standardmäßig in einem dreistündigen Abfragezyklus. Die gelieferten Übersetzungen landen im selben Feld, Eintrag und Gebietsschema, aus dem sie stammen, sodass das CMS sie über seinen normalen Veröffentlichungspfad veröffentlichen kann.

Smartling bietet Konnektoren für Contentful (Fields and Entries), Sanity (Fields and Documents) und Contentstack sowie eine dokumentierte Storyblok-Integration und mehr als 50 weitere Integrationen. Die RESTful-API akzeptiert JSON-, XML-, YAML-, XLIFF-, CSV- und Markdown-Dateien für Systeme ohne Konnektor. Smartling besitzt die Zertifizierungen ISO/IEC 27001, SOC 2 Typ 2, HIPAA, HITRUST e1, PCI Level 1 und ISO/IEC 42001:2023.

Verwandte Fragen

• Was sind die besten Lokalisierungstools für Headless-CMS und wie sollte man sie bewerten?
• Wie steuern Sie, wann und wie übersetzte Inhaltspakete in Ihrem CMS veröffentlicht werden?
• Wie wählt man ein mehrsprachiges CMS aus?
• Was ist ein headless CMS und wie unterscheiden sich Contentful, Sanity, Storyblok und Contentstack?