Refs #1710 Cut all except language from Locale when searching for messages (doc)

This commit is contained in:
Konstantin Krivopustov 2013-01-18 11:10:24 +00:00
parent 2e04bc8761
commit 86207b7bb8
2 changed files with 8482 additions and 8471 deletions

View File

@ -2274,7 +2274,9 @@ Role getAdminRole();</programlisting></para>
<para>Для того, чтобы некоторое сообщение могло быть локализовано, т.е. представлено пользователю на нужном языке, его необходимо поместить в так называемый <firstterm>пакет сообщений</firstterm>. </para>
<section id="message_packs">
<title>Пакеты сообщений</title>
<para>Пакет сообщений представляет собой набор файлов свойств с именами вида <filename>messages{_XX}.properties</filename>, расположенных в одном Java-пакете. Суффикс <literal>XX</literal> определяет язык, для которого в данном файле содержатся сообщения, и соответствует коду языка в <code>Locale.getLanguage()</code>. Один из файлов пакета может быть без суффикса языка - это <firstterm>файл по умолчанию</firstterm>. Именем пакета сообщений считается имя Java-пакета, в котором расположены файлы пакета.</para>
<para>Пакет сообщений представляет собой набор файлов свойств с именами вида <filename>messages{_XX}.properties</filename>, расположенных в одном Java-пакете. Суффикс <literal>XX</literal> определяет язык, для которого в данном файле содержатся сообщения, и соответствует коду языка в <code>Locale.getLanguage()</code> (для поддержки остальных атрибутов локали необходимо установить в <code>false</code> свойство приложения <link linkend="cuba.useLocaleLanguageOnly">
<property>cuba.useLocaleLanguageOnly</property>
</link>). Один из файлов пакета может быть без суффикса языка - это <firstterm>файл по умолчанию</firstterm>. Именем пакета сообщений считается имя Java-пакета, в котором расположены файлы пакета.</para>
<para>Рассмотрим пример:<programlisting>/com/abc/sales/gui/customer/messages.properties
/com/abc/sales/gui/customer/messages_fr.properties
/com/abc/sales/gui/customer/messages_ru.properties</programlisting></para>

View File

@ -1010,6 +1010,15 @@ menu-config.sales$Customer.lookup=Customers</programlisting></para>
<para>Используется в блоках: <structname>Middleware</structname>, <structname>Web Client</structname>, <structname>Web Portal</structname>.</para>
</listitem>
</varlistentry>
<varlistentry id="cuba.useLocaleLanguageOnly">
<term>cuba.useLocaleLanguageOnly</term>
<listitem>
<para>Если данное свойство имеет значение <code>true</code>, то при поиске локализованных сообщений, принимается во внимание только язык текущей или переданной локали. В противном случае принимаются во внимание все параметры локали, т.е. например можно определить файлы сообщений <filename>messages_en_US.properties</filename> и <filename>messages_en_GB.properties</filename>. </para>
<para>Значение по умолчанию: <literal>true</literal></para>
<para>Интерфейс: <code>GlobalConfig</code></para>
<para>Используется во всех стандартных <link linkend="app_tiers">блоках</link>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>cuba.user.fullNamePattern</term>
<listitem>