Översättning av objekt-ID object-id-translation
Image Serving är en mekanism som översätter externa objekt-ID:n till språkområdesspecifika objekt-ID:n (katalog). Det primära programmet är att tillhandahålla språkområdesspecifikt innehåll och innehåll som delas mellan flera språkområden utan att klientprogrammet behöver känna till de språkområdesspecifika objekt-ID:n.
Programmet kan bara skrivas med globala objekt-ID:n, och med Image Serving ersätts automatiskt språkområdesspecifika bilder och annat innehåll där det finns tillgängligt.
locale
har angetts i Image Serving-begäranden med kommandot locale=
.
Omfång section-66fcd5bd467c4eeaa1574583cbe9756d
Alla referenser till poster i bildkataloger, SVG och statiska innehållskataloger beaktas för översättningsteckensnitt och ICC-profilreferenser översätts inte. Förutom object
i sökvägen för /is/image och /is/static requests är dessa kommandon och katalogattribut föremål för ID-översättning: src=
, mask=
, template=
, defaultImage=
, attribute::DefaultImage
och attribute::Watermark
.
Översättningskarta för ID section-9e417b352c314dfe94e831fdd62cddc8
attribute::LocaleMap
definierar reglerna som används av servern för att fastställa ID:t för det lokaliserade innehållet, givet som indata för det generiska objekt-ID:t och locale=
-värdet.
attribute::LocaleMap
består av en lista med språkområden (som matchar de värden som anges med locale=
), där vart och ett saknar eller har inga utdatastypssuffix ( *
locSuffixes*
).
attribute::LocaleMap
kan till exempel se ut så här:
en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,|,_E,
Begäran /is/image/myCat/myImg?locale=de_de
returnerar bilden som är associerad med katalogposten myCat/myImg_D
(förutsatt att det finns en sådan katalogpost).
Mer information finns i beskrivningen av attribute::LocaleMap
.
Översättningsprocessen section-1f64db17e9f644d88e09853670e14a16
Med hjälp av exemplet ovan söker servern först efter locale
de_de
i ID-översättningskartan. Sedan itereras den över locSuffixes
som är associerad med den här posten, i det här fallet _D
och (tomt suffix). För varje upprepning läggs suffixet till i bild-ID:t och det resulterande ID:t som testas finns i katalogen. Om det hittas används katalogposten, annars testas nästa. I det här exemplet kontrolleras följande poster: myCat/myImg_D
och myCat/myImg
. Om ingen matchning hittas returnerar servern ett fel eller en standardbild (om den är konfigurerad).
Okända språk section-b2f3c83f2dc845d69b5908107b775537
I ovanstående exempel innehåller attribute::LocaleMap
en tom locale
som definierar standardöversättningsregeln, som används för okända locale=
-värden (det vill säga de som inte uttryckligen anges i översättningsschemat). Om den här översättningskartan tillämpades på begäran /is/image/myCat/myImg?locale=ja
skulle den matcha myCat/myImg_E
, om den fanns, eller i annat fall myCat/myImg
.
Om en översättningskarta inte anger någon standardöversättningsregel returneras ett fel för alla begäranden med okända locale=
-värden.
Exempel section-cc40bb00ee9248bb8cb23e17d7a5984c
Uppslag på flera nivåer
Det är ofta önskvärt att gruppera språkområden (till exempel europeiska, Mellanöstern och Nordamerika) för att ta hänsyn till regionala standarder. Detta kan uppnås med en sökning på flera nivåer.
I det här exemplet vill vi stödja samlingar för väst- och Mellanöstern-användning. Båda samlingarna är baserade på den generiska bildsamlingen, och båda lägger till eller ändrar vissa bilder. Båda samlingarna har sedan förfinats ytterligare för specifika språkområden ( m1
, m2
för två mellanöstra varianter och w1
, w2
och w3
för tre västerländska språkområden), förutom att bilder delas för w1
och w3
. Okända språk mappas endast till den generiska samlingen och har inte tillgång till språkspecifika bilder.
attribute::LocaleMap: w1,-W,|w2,-W2,-W,|w3,-W,|m1,-M1,-M,|m2,-M2,-M,|,
Följande tabell visar vilka katalogposter som beaktas och i vilken ordning de beaktas för det generiska indata-ID:t myImg
:
Sök efter specifika ID:n
Vissa namngivningskonventioner kanske inte stöder generiska bild-ID internt. De generiska ID:n från begäran måste alltid mappas till ett specifikt ID i katalogen. Ofta är det inte säkert att det exakta specifika ID:t är känt.
I det här exemplet kan bilder för alla språk ha suffixet _1
, _2
eller _3
. Bilder som är specifika för franska språkområden kan ha suffixet _22
eller _23
, och bilder som är specifika för tyska språkområden kan ha suffixet _470
eller _480
.
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
Följande tabell visar vilka katalogposter som beaktas och i vilken ordning de beaktas för det generiska indata-ID:t myImg
:
Se även section-05893816c66a406d89f9bfd6ace8d47a
attribute::LocaleMap , attribute::DefaultLocale, locale=, req=xlate