====== Теги и фильтры пакета I18N. ======
Для удобства вся информация по тегам и фильрам наиболее распространенных пакетов собрана в одном месте:

  * [[limb3:ru:packages:macro:tags|Все теги]]
  * [[limb3:ru:packages:macro:filters|Все фильтры]]

Здесь мы лишь опишем, какие теги и фильтры используются для решения различных задач, связанных с пакетом I18N.


Итак, есть различные задачи:

  * связанные с созданием мультиязыковых шаблонов, некоторые строки которых должны быть переведены при помощи системы словарей
  * связанные с форматированием дат и чисел в соответствие с той или иной локалью
  * связанные с работой со строками, представленными в мультибайтовой кодировке



===== Перевод строк в шаблонах =====

Для задач, связанных с работой с переводом строк в шаблонах, есть специальный тег %%{{i18n}}%%, который берёт на себя заботу о переводе фразы в соответствии с утановленной в lmbI18nTools локалью. 

Пример:
<code php>{{i18n text="Организовать многоязычность в проекте это легко!" [domain="domain_name"]}}</code>

Помимо тэга вы можете использовать фильтр i18n. Например:

<code php>
{$my_var|i18n[:domain_name]}
</code>

В случае, когда нет возможностью пользоваться макротегом, используйте функцию ''lmb_i18n()''



===== Форматирование дат  =====

Для задач, связанных с форматированием дат, в MACRO есть фильтр [[limb3:ru:packages:macro:filters#i18n_date|i18n_date]]. 

Обратите внимание, что в качестве первого параметра фильтра используется название локали, в соответствие со свойствами которой, нужно форматировать то или иное значение. Если этот параметр не указан (пустая строка вместо реального значения), тогда в качестве локали будет использована текущая локаль, установленная в lmbI18NTools.



===== Работа с мультибайтовыми строками =====

Для задач, связанных с работой с мультибайтовыми строками, есть фильтры:   

  * [[limb3:ru:packages:macro:filters#i18n_capitalize|i18n_capitalize]], 
  * [[limb3:ru:packages:macro:filters#i18n_clip|i18n_clip]]

Многие фильтры для работы с мультибайтовыми строками еще не реализованы, однако знакомым с шаблонной системой, эта задача не должна показаться сложной.