Tekstreeks lokaliseren text-string-localization

Bij de lokalisatie van teksttekenreeksen kunnen afbeeldingscatalogi meerdere landspecifieke representaties voor dezelfde tekenreekswaarde bevatten.

De server geeft de representatie die overeenkomt met de landinstelling die met locale= is opgegeven, terug aan de client, waarbij lokalisatie op de client wordt vermeden en toepassingen naar een andere landinstelling kunnen overschakelen door gewoon de juiste locale= -waarde te verzenden met de IS-tekstaanvragen.

Toepassingsgebied section-a03f48e3bc0e4ab281909a2bd441a3c2

De het koordlocalisatie van de tekst wordt toegepast op alle koordelementen die het lokalisatietoken ^loc= * locId *^ op de volgende catalogusgebieden omvatten:

het gebied van de Catalogus
element van het Koord op gebied
catalog::ImageSet

Elk subelement met een vertaalbare tekenreeks (gescheiden door een combinatie van scheidingstekens ',' ';' ':' en/of het begin/einde van het veld).

Een 0xrrggbb -kleurwaarde aan het begin van een lokaliseerbaar veld wordt uitgesloten van lokalisatie en ongewijzigd doorgegeven.

catalog::Map
Een willekeurige kenmerkwaarde die een of twee letters bevat, behalve de waarden van de kenmerken coördins= en shape= .
catalog::Target
De waarde van een willekeurig target.*.label en target.*.userdata eigenschap.
catalog::UserData
De waarde van een eigenschap.

Tekenreekssyntaxis section-d12320edf300409f8e17565b143acafc

Localisatie-ingeschakelde string elementen in de afbeeldingscatalogus bestaan uit een of meer gelokaliseerde tekenreeksen, die elk worden voorafgegaan door een lokalisatietoken.

stringElement
[ defaultString ]*{ localizationToken localizedString
localizationToken
^loc= locStr ^
locId
Interne landinstellings-id voor de localizedString die volgt op deze localizationToken .
localizedString
Gelokaliseerde tekenreeks
defaultString
Tekenreeks die moet worden gebruikt voor onbekende landinstellingen.

De instructie locId moet ASCII zijn en mag geen '^' bevatten.

'^' kan overal in substrings met of zonder HTTP-codering voorkomen. De server past het volledige patroon localizationToken ^loc=locId^ aan afzonderlijke subtekenreeksen aan.

stringElements , die niet minstens één localizationToken bevat, wordt niet in aanmerking genomen voor lokalisatie.

De vertaalkaart section-f7ce3df91b724adf95cee44eac4915d4

attribute::LocaleStrMap definieert de regels die door de server worden gebruikt om te bepalen welke localizedStrings moet worden geretourneerd naar de client. Deze bestaat uit een lijst met invoer locales (die overeenkomt met de waarden die zijn opgegeven met locale= ), elk met geen of meer interne id's voor landinstellingen ( locId ). Bijvoorbeeld:

attribute::LocaleStrMap= en,E|nl,N|de,D|,

Lege locId -waarden geven aan dat de defaultString moet worden geretourneerd, indien beschikbaar.

Zie de beschrijving van attribute::LocaleStrMap voor meer informatie.

Het vertaalproces section-a2a8a3e5850f4f7c9d2318267afe98a2

Op basis van de bovenstaande voorbeeld-vertaalkaart en de aanvraag /is/image/myCat/myItem?req=&locale=nl zoekt de server eerst naar " nl" in de landinstellingskaart. De overeenkomende vermelding nl,N geeft aan dat voor elke stringElement de tekst localizedString gemarkeerd met ^loc=N^ moet worden geretourneerd. Als localizationToken niet aanwezig is in stringElement , wordt een lege waarde geretourneerd.

catalog::UserData for myCat/myItem bevat bijvoorbeeld het volgende (voor de duidelijkheid worden regeleinden ingevoegd):

val1=111?? str1=Default1^loc=N^Dutch1^loc=D^German1?? val2=value2?? str2=^loc=E^English2^loc=N^Dutch2^loc=D^German2?? str3=Default3^loc=N^Dutch3^loc=D^German3

De server retourneert het volgende in reactie op de voorbeeldaanvraag:

val1=111 str1=Dutch1 val2=value2 str2=Dutch2 str3=Dutch3

Onbekende landinstellingen section-26dfeefbd60345de94bbfeaaf7741223

In het bovenstaande voorbeeld heeft attribute::LocaleStrMap een item met een lege locale -waarde. De server gebruikt deze vermelding om alle locale= -waarden af te handelen die niet expliciet anders in de vertaalkaart zijn opgegeven.

In het voorbeeld van de vertaalkaart wordt aangegeven dat in een dergelijk geval de defaultString moet worden geretourneerd, indien beschikbaar. Daarom wordt het volgende geretourneerd als deze vertaalkaart wordt toegepast op de aanvraag /is/image/myCat/myItem?req=&locale=ja :

val1=111 str1=Default1 val2=value2 str2= str3=Default3

Voorbeelden section-ae6ff7fb90754b839f04ed08aadffa3f

families van de Taal

Meerdere locId waarden kunnen aan elke locale in de vertaalkaart worden gekoppeld. De reden hiervoor is dat het ondersteuning mogelijk maakt voor landspecifieke of regiospecifieke variaties (bijvoorbeeld Engels in de VS versus Engels in het Verenigd Koninkrijk) voor het selecteren van stringElements terwijl de meeste inhoud wordt afgehandeld met algemene basislandinstellingen (bijvoorbeeld Internationaal Engels).

Bijvoorbeeld, wordt de steun toegevoegd voor V.S.-Specifiek Engels ( * locId * EUS) en VK-Specifiek Engels ( * locId * EUK), om de occasionele alternatieve spelling te steunen. Als EUK of EUS niet bestaat, valt deze terug op E. Ook Oostenrijkse specifieke Duitse varianten ( DAT) kunnen zo nodig beschikbaar worden gesteld bij het terugsturen van het Duits localizedStrings (gemarkeerd met D ).

De attribute::LocaleStrMap zou er als volgt uitzien:

en,E|en_us,EUS,E|en_uk,EUK,E|de,D|de_at,DAT,D|de_de,D

In de volgende tabel wordt de uitvoer voor een aantal representatieve stringElement - en locale -combinaties beschreven:

stringElement
scène
Uitvoertekenreeks
^loc=E^English^loc=D^German

en, en_us, en_uk

de, de_at, de_de

alle andere

Engels

Duits

-

^loc=E^English^loc=UKE^UK-English^loc=D^German^loc=DAT^Austrian

en, en_us

en_uk

de, de

de_at

alle andere

Engels

Engels (GB)

Duits

Oostenrijks

-

^ loc=en^English^loc=USE^US-English^loc=D^German^loc=DDE^Deutsch

In dit voorbeeld bestaat het attribuut locId DDE niet in ::LocaleStrMap en wordt dus de subtekenreeks die aan deze locId is gekoppeld, nooit geretourneerd.

en, en_uk

nl_NL

de, de_at, de_de

alle andere

Engels

US-English

Duits

-

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49