Localização da cadeia de caracteres de texto

A localização da sequência de caracteres de texto permite que os catálogos de imagem contenham várias representações específicas do local para o mesmo valor da sequência de caracteres.

O servidor retorna ao cliente a representação correspondente ao local especificado com locale=, evitando a localização no lado do cliente e permitindo que os aplicativos alternem as localidades simplesmente enviando o arquivo apropriado locale= com as solicitações de texto IS.

Escopo

A localização da cadeia de texto é aplicada a todos os elementos de cadeia de caracteres que incluem o token de localização ^loc= *locId*^ nos seguintes campos de catálogo:

Sintaxe de string

Habilitado para localização string os elementos no catálogo de imagens consistem em uma ou mais strings localizadas, cada uma precedida por um token de localização.

A variável locId deve ser ASCII e não pode incluir '^'.

O '^' pode ocorrer em qualquer lugar em substrings com ou sem codificação HTTP. O servidor corresponde a todo localizationToken ^loc=locId^ padrão para separar subsequências.

A variável stringElements, que não incluem pelo menos um localizationToken, não são considerados para localização.

O mapa de tradução

attribute::LocaleStrMap define as regras usadas pelo servidor para determinar quais localizedStrings para retornar ao cliente. Ele consiste em uma lista de entradas locales (correspondendo aos valores especificados com locale=), cada um com nenhuma ou mais ids de localidade internas ( locId). Por exemplo:

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

Empty locId os valores indicam que a variável defaultString deve ser retornado, se disponível.

Consulte a descrição de attribute::LocaleStrMap para obter detalhes.

O processo de tradução

Dado o exemplo de mapa de tradução acima e a solicitação /is/image/myCat/myItem?req=&locale=nl, o servidor procura primeiro por " nl" no mapa do local. A entrada correspondente nl,N indica que, para cada stringElement, o localizedString marcado com ^loc=N^ deve ser devolvido. Se isso localizationToken não está presente no stringElement, um valor vazio é retornado.

Digamos que catalog::UserData para myCat/myItem contém o seguinte (quebras de linha inseridas para maior clareza):

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

O servidor retornaria o seguinte em resposta à solicitação do exemplo:

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

Localidades desconhecidas

No exemplo acima, attribute::LocaleStrMap tem uma entrada com um vazio locale valor. O servidor usa essa entrada para lidar com todas as locale= valores que não estão explicitamente especificados de outra forma no mapa de tradução.

O exemplo de mapa de tradução especifica que, nesse caso, o defaultString deve ser retornado, se disponível. Portanto, o seguinte será retornado se este mapa de tradução for aplicado à solicitação /is/image/myCat/myItem?req=&locale=ja:

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

Exemplos

Famílias de idiomas

Múltiplo locId podem ser associados a cada locale no mapa de tradução. O motivo é que ela permite o suporte de variações específicas de país ou região (por exemplo, inglês dos EUA versus inglês do Reino Unido) para seleção stringElements ao manipular a maioria dos conteúdos com localidades de base comuns (por exemplo, inglês internacional).

Por exemplo, há suporte para inglês específico dos EUA ( *locId* EUS) e inglês específico do Reino Unido ( *locId* EUK), para dar suporte à ortografia alternativa ocasional. Se o EUK ou o EUS não existirem, recorrerá a E. Do mesmo modo, as variantes alemãs específicas da Áustria ( DAT) poderia ser disponibilizado, se necessário, durante o regresso do alemão comum localizedStrings (marcado com Dna maioria das vezes.

A variável attribute::LocaleStrMap seria semelhante a:

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

A tabela a seguir descreve a saída de alguns stringElement e locale combinações: