Яндекс.Виджеты. Руководство разработчика: Отображение XHTML-виджетов на разных языках

Главная страница Яндекса может отбражаться на разных языках, в соответствии с личными настройками пользователей. Вы также можете перевести содержимое вашего виджета на языки, поддерживаемые Яндексом, и настроить виджет так, чтобы он по возможности отображался на родном языке пользователя.

Для этого потребуется самостоятельно выполнить перевод текстового содержимого виджетов на языки, поддерживаемые Яндексом, и указать какой из языков будет использоваться по умолчанию.

Формат мультиязычного виджета

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

<meta name="language_default" 
      content="ru"/>
<meta name="title"  
      content_ru="Заголовок на русском"
      content_uk="Заголовок на украинском" 
      content_be="Заголовок на белорусском" 
      content_kk="Заголовок на казахском" 
      content_tt="Заголовок на татарском" 
      content_tr="Заголовок на турецком"/>
<meta name="description" 
      content_ru="Описание на русском" 
      content_uk="Описание на украинском" 
      content_be="Описание на белорусском" 
      content_kk="Описание на казахском" 
      content_tt="Описание на татарском" 
      content_tr="Описание на турецком"/>
<widget:preferences>
      <preference name="preference1"
              type="list" 
              defaultValue_ru="Значение по умолчанию для русского языка"
              defaultValue_uk="Значение по умолчанию для украинского языка"
              defaultValue_be="Значение по умолчанию для белорусского языка"
              defaultValue_kk="Значение по умолчанию для казахского языка"
              defaultValue_tt="Значение по умолчанию для татарского языка"
              defaultValue_tr="Значение по умолчанию для турецкого языка"
              label_ru="Настройка на русском" 
              label_uk="Настройка на украинском" 
              label_be="Настройка на белорусском" 
              label_kk="Настройка на казахском" 
              label_tt="Настройка на татарском" 
              label_tr="Настройка на турецком"/>
</widget:preferences>

Виджет должен всегда отображаться на языке главной страницы Яндекса. Для определения языка главной страницы используйте метод widget.getLocale.

У виджета также должен быть задан язык по умолчанию и для этого языка должен существовать перевод. Язык по умолчанию используется в случаях, когда интерфейс виджета не переведен на язык пользователя (виджет не переведен на все языки главной страницы Яндекса).

Список поддерживаемых языков (в соответствии с ISO 639-1):

be - белорусский;
en - английский;
kk - казахский;
ru - русский;
tt - татарский;
tr - турецкий;
uk - украинский.

Если какой-либо из элементов виджета не требует перевода, например, заголовок виджета на английском языке, то его содержимое следует скопировать в соответсвующие элементы на других языках.

Быстрый старт

Руководство разработчика

Справочник по API

Отображение XHTML-виджетов на разных языках

Формат мультиязычного виджета