文本字符串本地化

翻译图

attribute::LocaleStrMap定义服务器用于确定哪个​ localizedStrings ​返回到客户端的规则。 它包含输入​ locales ​的列表（与使用locale=指定的值匹配），每个列表均不含一个或多个内部区域设置ID ( locId)。 例如：

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

空​ locId ​值表示应返回​ defaultString（如果可用）。

有关详细信息，请参阅attribute::LocaleStrMap的说明。

翻译过程

给定上面的示例翻译映射和请求/is/image/myCat/myItem?req=&locale=nl，服务器首先在区域设置映射中查找“nl”。 匹配的条目nl,N指示对于每个​ stringElement，应返回标记为​ localizedString ​的^loc=N^。 如果​ localizationToken ​中不存在此​ stringElement，则返回空值。

假设catalog::UserData的myCat/myItem包含以下内容（为清楚起见，插入了换行符）：

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

服务器将返回以下内容以响应示例请求：

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

未知区域设置

在上例中，attribute::LocaleStrMap有一个包含空​ locale ​值的条目。 服务器使用此条目处理翻译映射中未明确指定的所有locale=值。

示例翻译映射指定在这种情况下，应返回​ defaultString（如果可用）。 因此，如果将此翻译映射应用于请求/is/image/myCat/myItem?req=&locale=ja，则会返回以下内容：

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

示例

语言系列

多个​ locId ​值可以与翻译映射中的每个​ locale ​关联。 原因在于，它允许为所选​ stringElements ​支持特定于国家或地区的变体（例如，美国英语与英国英语），同时处理大多数具有通用基本区域设置的内容（例如，国际英语）。

例如，添加了对特定于美国的英语(*locId* EUS)和特定于英国的英语(*locId* EUK)的支持，以支持偶尔的替代拼写。 如果EUK或EUS不存在，则它回退到E。同样，奥地利特定的德语变体(DAT)可以在大多数情况下返回通用德语​ localizedStrings（用D标记）时根据需要提供。

attribute::LocaleStrMap将如下所示：

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

下表描述了某些代表​ stringElement ​和​ locale ​组合的输出：