Sprachauflösung

Erfahre, welche gespeicherte Konfiguration für eine angeforderte Sprache, Region oder Schrift gilt und wie Anweisungen, Markenstimme, Modelle und Terminologie sie nutzen.

Eine Anfrage nutzt die Konfiguration, die für ihre eigene Sprache, für eine übergeordnete Sprache, die sie einschließt, und für * gespeichert ist. Konfigurationen für eine spezifischere Sprache oder eine andere Region derselben Sprache gelten nicht. Wie die geltende Konfiguration zum Einsatz kommt, hängt von der Ressource ab: Anweisungen werden zusammengeführt, eine Markenstimmenvariante setzt sich durch, Modelle werden in einer festgelegten Reihenfolge ausprobiert, und eine benutzerdefinierte Übersetzung muss außerdem die Schrift der Anfrage verwenden.

Wie du Sprach-Tags auswählst, erfährst du unter Sprachen. Diese Referenz erklärt, was passiert, nachdem die Tags die Lokalisierungs-Engine erreicht haben.

Welche Konfiguration gilt #

Bei der Verarbeitung von Sprachen werden anhand von CLDR-Daten gleichwertige Schreibweisen als dieselbe Sprache behandelt: zh, zh-CN, zh-Hans und zh-Hans-CN bezeichnen alle vereinfachtes Chinesisch, wie es in China verwendet wird. Eine Sprache ohne Regionsangabe steht für ihre Standardregion. Eine Anfrage für es ist eine Anfrage für Spanisch, wie es in Spanien verwendet wird (es-ES), pt steht für pt-BR und de steht für de-DE.

Eine Konfiguration gilt für eine Anfrage, wenn sie für eine der folgenden Sprachen gespeichert ist:

  • *, das für jede Sprache gilt.
  • Die angeforderte Sprache in einer beliebigen gleichwertigen Schreibweise.
  • Eine übergeordnete Sprache, die die angeforderte Sprache einschließt. de gilt für de-CH und zh-Hant gilt für zh-TW.

Alle anderen Sprachen bleiben unberücksichtigt. Dazu gehören eine spezifischere Region, etwa de-CH bei einer Anfrage für de, und eine andere Region derselben Sprache, etwa de-DE bei einer Anfrage für de-CH.

AnfrageGiltGilt nicht
es*, es, es-ESes-MX, es-419
es-MX*, es, es-MXes-ES, es-419
de-CH*, de, de-CHde-DE, de-AT
zh-TW*, zh, zh-Hant, zh-TWzh-Hans, zh-CN
sr*, sr, sr-Cyrlsr-Latn

Eine Regionsgruppe wie es-419 zählt als eigenständige Sprache. Sie gilt nur für Anfragen für es-419. Anfragen für es-MX oder es-AR erhalten diese Konfiguration daher nicht.

Dieselbe Regel gilt für die Ausgangssprache bei Ressourcen, die eine solche haben: Modellkonfigurationen und Glossarbegriffe. Ein für die Ausgangssprache en-GB gespeicherter Begriff gilt nicht für Inhalte mit der Ausgangssprache en, da en für en-US steht.

Damit Vorgaben für alle Regionen einer Sprache gelten, speichere sie für die Sprache ohne Regionsangabe, etwa es. Speichere sie nur dann für eine bestimmte Region, wenn sie sich an deren Zielgruppe richten.

Übereinstimmungsstufen bestimmen die Reihenfolge der geltenden Konfiguration #

Die Lokalisierungs-Engine ordnet die geltende Konfiguration nach Übereinstimmungsstufen: zuerst die angeforderte Sprache, dann eine übergeordnete Sprache und schließlich *. Innerhalb einer Stufe steht die spezifischere Schreibweise an erster Stelle. Bei einer Anfrage für de hat eine Variante für de-DE daher Vorrang vor einer Variante für de.

Gib die Sprache ausdrücklich mit Region an, wenn die Region Teil der Anforderung ist. Unterscheide außerdem zwischen verschiedenen Sprachkennungen: no und nb sind unterschiedliche Codes. Eine Konfiguration, die für den einen Code gespeichert ist, gilt nicht für den anderen.

Jede Ressource nutzt die geltende Konfiguration anders #

RessourceErgebnis
RegelnGeltende vordefinierte und benutzerdefinierte Anweisungen werden in der Reihenfolge ihrer Sprachrelevanz zusammengeführt. Spezifische Regeln heben allgemeine Regeln nicht auf.
MarkenstimmeDie am besten passende Variante setzt sich durch. Besteht weiterhin Gleichstand, sorgen zuerst der Erstellungszeitpunkt und dann die ID für eine eindeutige Reihenfolge.
ModelleDie Übereinstimmungsstufe der Zielsprache, die Übereinstimmungsstufe der Ausgangssprache, die Spezifität der Zielsprache, die Spezifität der Ausgangssprache und der konfigurierte Rang bestimmen, in welcher Reihenfolge die Modelle ausprobiert werden.
GlossarBenutzerdefinierte Übersetzungen in einer anderen Schrift bleiben unberücksichtigt. Nachdem die verbleibenden Kandidaten nach Sprache geordnet wurden, werden Duplikate anhand des Ausgangstexts entfernt. Beim anschließenden Abruf wird der passende Kontext ausgewählt.
Menschliche PrüfungFür eine Anfrage wird eine Prüfung durchgeführt, wenn eine der Sprachen aus der Prüfungsrichtlinie für sie gilt oder die Richtlinie keine Sprachen angibt.

Der Modellrang kann einer Konfiguration mit Platzhalter keinen Vorrang vor einer genauer passenden Sprachkonfiguration geben. Die Reihenfolge, in der Glossare verknüpft werden, legt keinen Vorrang fest. Behalte diese Unterschiede im Blick, wenn die gespeicherte Konfiguration die erwarteten Inhalte enthält, eine Anfrage aber etwas anderes auswählt.

Abweichungen bei Region oder Schrift erkennen #

Für eine Region gespeicherte Vorgaben fehlen in einer anderen #

Angenommen, die spanischen Begriffe eines Glossars sind für es-419 gespeichert und die Anfragen haben es oder es-MX als Ziel. Keine der beiden Anfragen erhält die Begriffe: es steht für Spanien, und es-419 gilt nur für Anfragen für es-419. Speichere Begriffe, die für alle spanischsprachigen Zielgruppen gelten, für es oder für jede Region, die du anforderst. Für Portugiesisch gilt dasselbe: pt steht für Brasilien. Begriffe, die für pt-PT gespeichert sind, werden daher nur bei Anfragen für pt-PT berücksichtigt.

Die Markenstimme ist regional, die Anfrage enthält aber keine Regionsangabe #

Angenommen, eine Markenstimme hat Varianten für de-DE und de-CH, und die Anfrage hat de als Ziel. Die Anfrage erhält die Variante für de-DE, weil de für Deutsch steht, wie es in Deutschland verwendet wird. Die Variante für de-CH gilt nur für Anfragen für de-CH. Fordere für Inhalte, die für die Schweiz bestimmt sind, de-CH an, statt zu erwarten, dass die Lokalisierungs-Engine die Zielgruppe aus dem Ausgangstext ableitet.

Eine regionale Regel widerspricht einer allgemeinen Regel #

Eine Regel mit Platzhalter, die eine formelle Anrede verlangt, und eine geltende regionale Regel, die eine informelle Anrede fordert, können beide in den Prompt einfließen. Eine spezifischere Regel hebt die allgemeine Anforderung nicht auf. Beseitige den Widerspruch oder grenze seinen Geltungsbereich ein, damit die ausgewählten Anweisungen ein einheitliches, beabsichtigtes Verhalten vorgeben.

Der bevorzugte Begriff verwendet eine andere Schrift #

Eine benutzerdefinierte Übersetzung gilt nur, wenn sich aus ihren Sprachen sowohl für den Ausgangs- als auch für den Zieltext dieselben Schriften ergeben wie bei der Anfrage. Die CLDR-Standardwerte legen für jede Sprache eine Schrift fest: zh, zh-CN und zh-SG stehen für vereinfachte chinesische Schrift, zh-TW und zh-HK für traditionelle chinesische Schrift, sr für kyrillische Schrift und sr-ME für lateinische Schrift.

Ein für zh gespeicherter Begriff wird daher bei Anfragen für zh, zh-CN und zh-SG berücksichtigt, aber nie bei einer Anfrage für zh-TW – obwohl die für zh gespeicherten Regeln und die Markenstimme für zh-TW gelten. Ein für zh-Hans gespeicherter Begriff wird bei einer Anfrage für zh berücksichtigt, ein für zh-TW gespeicherter Begriff bei einer Anfrage für zh-Hant. Speichere einen Begriff in traditioneller chinesischer Schrift, der für Taiwan und Hongkong gilt, für zh-Hant. Ein nicht übersetzbarer Name ist davon ausgenommen, weil er unverändert bleibt.

Die benutzerdefinierte Übersetzung gilt für jede Zielsprache #

Eine benutzerdefinierte Übersetzung mit der Zielsprache * darf keinen Zieltext enthalten, der vom Ausgangstext abweicht. Verwende für eine bevorzugte Übersetzung eine konkrete Zielsprache. Für Text, der überall gleich bleiben muss, verwende einen nicht übersetzbaren Eintrag.

Beim Hinzufügen einer Sprache alle Bestandteile kontrollieren #

Die Sprachkonfiguration sorgt weder für ein Rechts-nach-links-Layout noch für eine sprachabhängige Formatierung in der Anwendung. Kontrolliere neben der Übersetzung auch die gerenderte Benutzeroberfläche. Ein aussagekräftiges Beispiel belegt das Verhalten im jeweiligen Fall, nicht die allgemeine Qualität in der neuen Sprache.