Die Übersetzungszuordnung der ID
attribute::LocaleMap
definiert die vom Server verwendeten Regeln, um die ID der lokalisierten Inhalte zu bestimmen, die als Eingaben von der generischen Objekt-ID und dem locale=
-Wert gegeben ist.
attribute::LocaleMap
besteht aus einer Liste von Gebietsschemata (die mit den mit locale=
angegebenen Werten übereinstimmen), von denen jedes keine oder mehrere Suffixe für das Ausgabelokal ( *
locSuffixes*
) aufweist.
attribute::LocaleMap
könnte beispielsweise wie folgt aussehen:
en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,|,_E,
Die Anfrage /is/image/myCat/myImg?locale=de_de
gibt das Bild zurück, das mit dem Katalogeintrag verknüpft ist myCat/myImg_D
(unter der Annahme, dass ein solcher Katalogeintrag vorhanden ist).
Weitere Informationen finden Sie in der Beschreibung von attribute::LocaleMap
.
Der Übersetzungsprozess
In diesem Beispiel sucht der Server zunächst in der ID-Übersetzungszuordnung nach dem locale
"de_de
". Anschließend wird der mit diesem Eintrag verknüpfte locSuffixes
durchlaufen, in diesem Fall "_D
" und "" (leeres Suffix). Bei jeder Iteration wird das Suffix an die Bild-ID angehängt und die resultierende ID wird auf ihre Existenz im Katalog getestet. Wenn gefunden, wird dieser Katalogeintrag verwendet, andernfalls wird der nächste getestet. In diesem Beispiel werden diese Einträge überprüft: myCat/myImg_D
und myCat/myImg
. Wenn keine Übereinstimmung gefunden wird, gibt der Server einen Fehler oder ein Standardbild zurück (falls so konfiguriert).
Unbekannte Gebietsschemata
Im obigen Beispiel enthält attribute::LocaleMap
einen leeren locale
, der die standardmäßige Übersetzungsregel definiert, die für unbekannte locale=
verwendet wird (d. h. für solche, die nicht explizit in der Übersetzungszuordnung aufgeführt sind). Wenn diese Übersetzungszuordnung auf die Anfrage-/is/image/myCat/myImg?locale=ja
angewendet würde, würde sie, sofern vorhanden, in myCat/myImg_E
aufgelöst oder anderweitig myCat/myImg
.
Wenn eine Übersetzungszuordnung keine standardmäßige Übersetzungsregel angibt, wird für alle Anfragen mit unbekannten locale=
ein Fehler zurückgegeben.
Beispiele
Mehrstufige Suche
Es ist oft wünschenswert, Gebietsschemata (z. B. Europa, Naher Osten, Nordamerika) zu gruppieren, um regionale Standards zu berücksichtigen. Dies kann mit einer mehrstufigen Suche erreicht werden.
Für dieses Beispiel möchten wir Sammlungen für die Verwendung im Westen und Nahen Osten unterstützen. Beide Sammlungen basieren auf der generischen Bildsammlung und in beiden werden einige Bilder hinzugefügt oder angepasst. Beide Sammlungen werden dann für bestimmte Gebietsschemata weiter verfeinert ( m1
, m2
für zwei Varianten des Mittleren Ostens und w1
, w2
und w3
für drei westliche Gebietsschemata), mit der Ausnahme, dass Bilder für w1
und w3
freigegeben werden. Unbekannte Gebietsschemata werden nur der generischen Sammlung zugeordnet und haben keinen Zugriff auf gebietsschemaspezifische Bilder.
attribute::LocaleMap: w1,-W,|w2,-W2,-W,|w3,-W,|m1,-M1,-M,|m2,-M2,-M,|,
Die folgende Tabelle zeigt, welche Katalogeinträge berücksichtigt werden und in welcher Reihenfolge sie für die generische Eingabe-ID myImg
berücksichtigt werden:
locale | Zu durchsuchende Katalog-IDs |
---|---|
W1, W3 | myImg-W, myImg |
W2- | myImg-W2, myImg-W, myImg |
M1 | myImg-M1, myImg-M, myImg- |
m2 | myImg-M2, myImg-M, myImg- |
Alle anderen | myImg- |
Suchen nach bestimmten IDs
Einige Bildnamenskonventionen unterstützen möglicherweise keine generischen Bild-IDs intern. Die generischen IDs aus der Anfrage müssen immer einer bestimmten ID im Katalog zugeordnet sein. Häufig ist die genaue spezifische ID nicht bekannt.
In diesem Beispiel können Bilder für alle Sprachen das Suffix _1
, _2
oder _3
aufweisen. Bilder, die für französische Gebietsschemata spezifisch sind, können _22
oder _23
Suffix aufweisen, und Bilder, die für deutsche Gebietsschemata spezifisch sind, können _470
oder _480
Suffix aufweisen.
attribute::LocaleMap: ,_1,_2,_3|fr,_22,_23,_1,_2,_3|de,_470,_480,_1,_2,_3| de_at,_470,_480,_1,_2,_3| de_de,_470,_480,_1,_2,_3
Die folgende Tabelle zeigt, welche Katalogeinträge berücksichtigt werden und in welcher Reihenfolge sie für die generische Eingabe-ID myImg
berücksichtigt werden:
locale | Zu suchende Ausgabe-IDs |
---|---|
FR | myImg_22, myImg_23, myImg_1, myImg_2, myImg_3 |
de , de_at , de_de | myImg_470, myImg_480, myImg_1, myImg_2, myImg_3 |
Alle anderen | myImg_1, myImg_2, myImg_3 |