Поиск сообщества

Когда вы завершили создание своего языкового пакета, вы можете экспортировать его и поделиться им с другими людьми (например на официальном сайте или в нашем разделе Загрузки) или просто сделать его резервную копию. Для этого перейдите на страницу Кастомизация > Локализация > Языки в вашем админцентре и нажмите кнопку выпадающего меню справа от названия языка, который вы хотите экспортировать. Выберите пункт "Скачать" и ваш браузер загрузит ваш файл языка: Скачивание языкового пакета Файл языка будет с расширением .xml и это единственный файл, которым нужно поделиться с другими, если вы хотите поделиться собственным переводом.

Некоторые фразы имеют значения, передаваемые в них системой, вы должны знать их и использовать в своём переводе в неизменном виде. Вот несколько типов замен, которые вы увидите: %s Простая строковая замена. {internal.app=core&module=system&controller=register} Замена URL адреса {# [1:reply][?:replies]} Плюрализационная замена. Мы рассмотри плюрализационную замену более подробно в данной статье - . Строковая замена Простые строковые замены используют формат, определяемый PHP функцией sprintf. В этом формате специальный маркер %s заменяется значением, передаваемым во фразу: Меня зовут %s При отображении будет: Меня зовут Кирилл В некоторые фразы передаётся несколько значений, которые заменяются в порядке свей очерёдности. Например, если значения "Кирилл" и "синий" передаются во фразу, они будут расположены в таком порядке в языковой фразе: Меня зовут %s и мой любимый цвет %s Станет таким при отображении: Меня зовут Кирилл и мой любимый цвет синий Однако, поскольку порядок переданных значений определяется PHP кодом и не может быть изменён автором перевода, существует специальный синтаксис, позволяющий изменить порядок любого из значений (это может быть необходимо для других языков, у которых структура предложения отличается от структуры в английском языке). Для изменения порядка замен, маркер %s должен быть изменён на %2$s - по сути вставка 2$ в середину обычного маркера, где 2 - это позиция параметра, который вы хотите использовать для замены. Для понимая описанного мы изменим порядок: Мой любимый цвет %2$s и меня зовут %1$s который будет выглядеть так: Мой любимый цвет синий и меня зовут Кирилл Для получения дополнительной информации обратитесь к документации PHP.net sprintf (имейте ввиду, что этот документ носит технический характер и предназначен только для разработчиков). Замена URL адреса В некоторых случаях в языковых фразах должны быть построены ссылки. Языковая система Invision Community поддерживает эту возможность с помощью специальных тегов, например: {internal.app=core&module=system&controller=register} В этом примере internal. подразумевает собой ссылку на внутреннюю страницу (то есть страницу IPS4), с URL адресом на определённую страницу. Соответственно могут быть определены внешние ссылки, например: {external.ad-custom-location} В этом случае ad-custom-location это предустановленный внешний URL адрес в IPS4. При выполнении перевода не забудьте включить эти ссылки, найденные в оригинальном языке, т.к. они часто несёт за собой полезную информацию.

Если вам необходимо создать собственный языковой пакет для вашего сообщества, Invision Community включает инструменты для реализации этого. Invision Community имеет множество фраз, которые нуждаются в переводе для создания полноценного языкового пакета, это может занять довольно продолжительное время, будьте к этому готовы. Если для вашего языка существует готовый языковой пакет, вы можете взять его за основу при создании собственного, это сэкономит большое количество времени. Существует два доступных инструмента: Стандартный перевод Вы должны указать перевод для каждой существующей фразы. Визуальный редактор языка Пользуйтесь сообществом в обычном режиме и нажимайте на фразы, которые видите, для их перевода. Мы рассмотрим оба варианта подробнее в других инструкциях. Для создания собственного языкового пакета, перейдите на страницу Кастомизация > Локализация > Языки, и нажмите на кнопку Создать. Во всплывающем окне укажите название вашего пакета и выберите другие соответствующие параметры. Нажмите Сохранить для создания языкового пакета. Язык теперь доступен для пользователей, однако, все фразы по-прежжнему на английском языке, пока вы их не переведёте. Вы можете отключить язык, пока вы не закончили перевод. Для этого щёлкните на бейдж Включено, расположенный справа от названия языка:

Invision Community поставляется с единственным английским языковым пакетом, который также установлен языком по умолчанию. Тем не менее, вы можете установить другой язык как язык по умолчанию, если хотите. Invision Community пытается определить корректный для пользователя язык на основании предоставленной его браузером информации. Если это может быть определено и у вас установлен соответствующий языковой пакет, и пользователь специально для себя не выбрал определённый язык, этот язык будет отображён пользователю, независимо от настроек стандартного языка в вашем сообществе. Для установки языка по умолчанию, перейдите на страницу Кастомизация > Локализация > Языки и нажмите иконку Изменить рядом с названием языка: Настройка темы по умолчанию Во всплывающем окне активируйте настройку Язык по умолчанию? и сохраните форму.

Самый простой способ добавить новый язык на ваше сообщество, это установить готовый языковой пакет. Многие из них доступны в категории Translations на официальном сайте разработчика. Скачать русский языковой пакет для IPS4 можно в нашем специальном разделе на сайте. Языковой пакет состоит из одного файла с расширением .xml. Если языковой пакет, который вы устанавливаете, содержит другие файлы, следуйте инструкциям локализатора. Для установки пакета, перейдите на страницу Кастомизация > Локализация > Языки в вашем админцентре. Нажмите на кнопку "Создать" и во всплывающем окне выберите вкладку "Загрузить". Укажите файл языкового пакета. Установка нового языка в IPS4 Локаль определяет, как будут форматироваться числа и даты в программном обеспечении. Один и тот же язык может использоваться в разных локалях; например, английский язык используется в США и Великобритании, хотя эти страны имеют разные локали и разное форматирование чисел и дат. Выберите локаль, которая наилучшим образом соответствует вашему сообществу (вы можете установить один языковой пакет несколько раз с несколькими локалями, если хотите). Нажмите кнопку Сохранить для установки языкового пакета. Теперь вы увидите новый язык в списке языков; он включён и готов к использованию вашими пользователями!

Invision Community полностью переводим и может поддерживать любые языки. По умолчанию встроен только один язык - English (US), но другие языки также могут быть добавлены путём: Загрузки готового языкового пакета. Создания своего собственного языкового пакета. Что охватывают языковые пакеты? Языковой пакет управляет: Языком, на котором отображается интерфейс. Форматирование чисел и дат (локале-зависимо). Направление текста (слева направо или справа налево). Позволяет вам переводить определённый контент, созданный администратором, например названия форумов, названия групп пользователей и т.д. Локали Локаль вашего языка в первую очередь определяет форматирование числе и дат. Хотя каждый язык, установленный на вашем сообществе, имеет собственную локаль, локаль можно выбирать. Это происходит потому, что язык часто может использовать больше одной локали, например, Английский язык используется как в США, так и Великобритании, хотя это разные локали с разным форматирование дат. Если это необходимо, вы можете установить один и тот же языковой пакет несколько раз и выбрать при установке разные локали для каждого, позволяя пользователям выбирать различное форматирование дат. Несколько языков Invision Community позволяет установить сразу несколько языковых пакетов, тем самым позволяя пользователям переключаться между языками. Языковые пакеты не переводят созданный пользователями контент, например сообщения форумов; они будут отображаться только на набранном пользователем языке. Если у вас пользователи будут общаться на разных языках, имеет смысл для каждого языка создать отдельный контейнер (например форум).

Invision Community поддерживает множество языков и инструментов перевода таких как визуальный редактор языков. Весь текст который используется вашим плагином должен быть приведен к языковой строке. Языковые строки определяются key/value парами. Чтобы добавить строку языка, просто откройте файл /plugins/<ваш_плагин>/dev/lang.php и добавьте элемент в массив. Затем чтобы использовать языковые строки, используйте их в контроллере: \IPS\Member::loggedIn()->language()->get( 'KEY' ); Или вот так в шаблоне: {lang="KEY"}

В Invision Community существуют языковые строки, имеющие такой вид: {# [1:comment][?:comments]}Данная конструкция подразумевает собой изменение формы числа существительного в зависимости от количественного значения. Эта фраза будет отображать в единственно числе (если будет передан параметр - 1): 1 comment, если любой другой параметр (количество комментариев): 2 comments, 3 commnets и так далее. Так как в английском языке множественное число существительных образуется в большинстве случаем с помощью добавления к существительному окончания "-s", то такая конструкция слова (указана выше) для английского языка будет исчерпывающей. Для чего тогда это сделано? Данная возможность была реализована разработчиками для придания Invision Community интернациональности, то есть, чтобы любой клиент, не зависимо от страны проживания, имел возможность максимально гибко перевести продукт на родной язык. Такая языковая фраза на русском языке примет вид: {# [1:отзыв][2:отзыва][3:отзыва][4:отзыва][21:отзыв][22:отзыва][23:отзыва][24:отзыва][31:отзыв][32:отзыва][33:отзыва][34:отзыва][41:отзыв][42:отзыва][43:отзыва][44:отзыва][51:отзыв][52:отзыва][53:отзыва][54:отзыва][61:отзыв][62:отзыва][63:отзыва][64:отзыва][71:отзыв][72:отзыва][73:отзыва][74:отзыва][81:отзыв][82:отзыва][83:отзыва][84:отзыва][91:отзыв][92:отзыва][93:отзыва][94:отзыва][?:отзывов]}То есть, для русского языка придётся перечислить в фразе практически все числа (в строке выше получится - 24532 отзывов), что нереально, а значит, придётся воспользоваться шаблонами (см ниже.) Формат фразы Формат фразы выглядит так: {#[x:значение]}1. Фигурные скобки обозначают границы слов. Знак решётки '#' обозначает расположение цифры, указывающей количество. 2. Каждое значение в квадратных скобках представляет собой возможное значение. Оно содержит в себе цифру, а через двоеточие указано слово, которое будет применено с указанной цифрой. Вместо цифры может быть знак вопроса '?', предназначенный для всех неуказанных цифр. Скрытие и перемещение цифр Если вы не хотите отображать цифру в фразе, вы можете добавить восклицательный знак '!' перед решёткой '#', например: %s {!#[1:likes][?:like]} thisВ данном случает будет отображено '%s likes this', если передаваемое значение будет 1, и '%s like this' для любых других значений. Кроме того, вы можете расположить цифру где угодно, указав '#' в любое другое место, например: {!#[1:week][?:# weeks]}В данном случае, если передаваемый параметр будет 1, то будет отображено слово 'week', соответственно, при любом другом параметре будет отображено 'x weeks' (x - цифра). Дополнительный контент В такие языковые строки вы можете включать дополнительный контент, но по правилам синтаксиса, например {# anonymous [1:member][?:members]}Будет отображено '1 anonymous member' при параметре 1 и 'X anonymous members' при любых других параметрах. Для русского языка такая конструкция будет такой: {# [1:анонимный пользователь][?:анонимных пользователей]}Шаблоны Вместо указания определённых значений или '?' для всех остальных значений, вы можете использовать шаблоны. Так знак звёздочки '*' будет соответствовать всем значениям, которые заканчиваются цифрой, указанной после этого знака. Знак '%' будет соответствовать всем значения, которые начинаются цифрой, указанной после него. Например: {# [*1:отзыв][*2:отзыва][*3:отзыва][*4:отзыва][11:отзывов][12:отзывов][13:отзывов][14:отзывов][?:отзывов]}Таким образом, воспользовавшись шаблонами, вы подкорректировали наш пример, указанный в начале статьи. В этом случае все значения, оканчивающиеся на цифру 1 будут указываться со словом 'отзыв', кроме цифры '11', так как для неё мы указали отдельно значение. (1,21,31,41,61,18751 отзыв) или (2,22,52,82,164872 отзыва). Несколько цифр Вы можете создавать строки с указанием нескольких цифр, например: {0# [1:post][*2:posts]} and {1# [1:view][*2:views]}Этак конструкция отобразит два значения, например, если будет передано два параметра 1 и 2, получится '1 post and 2 views'