Help:Extension:Translate/Unstructured element translation/ru

This page explains how to make translation of customised wiki interfaces messages a bit more manageable, with the Translate extension. It applies to any part of the wiki which you want to automatically provide in the user's interface language. The most typical example is the sidebar, because there can be only one, but the same method can be used for the main page, if you want to have all translations of it under the same title, or even for templates.

This method is applicable also to wiki content where full page translation just doesn't fit, like pages heavy in markup or templates, whose markup you don't want to expose to translators. This all revolves around interface messages, or the magic word, that allows you to include interface messages anywhere where you can write wikitext. This magic word allows to automatically substitute the interface message, whether standard, customised or new, in the user interface language.

You can use it to bring the power of the automatic localisation of the wiki's interface to the wiki's content, but it doesn't solve the problem for anonymous users, who cannot change the interface language by default. See the note about the Universal Language Selector extension below.

Compared to page translation, this method has some drawbacks:


 * 1) MediaWiki developers usually discourage the usage of  because it fragments the cache. Instead of storing one cached rendered version of a page, when  is used it needs to be cached potentially in hundreds of different languages.
 * 2) It is harder to setup, requiring access to wiki configuration.
 * 3) There is no automatic tracking of outdated translations and completion statistics might be off when new messages are added or deleted.
 * 4) Only wiki administrators can add messages to the message groups and translate them. This means that the system is suitable only for pages which don't change often, or administrators will have a lot of work.

The good thing is that it works most of the time and you can still get the job done. There are two tutorials that provide examples of the common use cases. Before that there is section which details how to set up a message group, something which is always needed when using this method.

Установка
Для правильной работы администратор сервера должен добавить строки в wiki configuration: Идентификатор группы сообщений  должен быть уникальными, нельзя использовать этот же самый id для нескольких групп. Второй параметр конструктора, относится к странице Mediawiki:Sidebar-messages. Метка указывает на выпадающие меню и другие места, где вы можете выбрать группу сообщений. Описание на Special:Translate. Это значения, которые надо изменить на то, что подходит вашей вики при добавлении новой пользовательской группы сообщений.

Инструкция по созданию локализуемой навигационной панели
Предполагается, что настройки из предыдущего шага уже сделаны. Далее вы тщательно должны следовать руководству по настройке боковой навигационной панели. Предположим, что была создана следующая простая боковая панель: И MediaWiki:Sidebar-commonpages содержит, а MediaWiki:Sidebar-faq содержит.
 * sidebar-commonpages
 * FAQ|sidebar-faq

Теперь всё, что нам остаётся сделать, это перейти в MediaWiki:Sidebar-messages (или другой раздел, определенный на предыдущем шаге) и записать в него: sidebar-commonpages sidebar-faq То есть, имена системных сообщений, без префиксов пространства имен "Обсуждение:", разделенных пробелами.

Затем перейдите к Special:Translate/wiki-sidebar (или другому раздел, определенному на предыдущем шаге, см. Special:Translate для получения списка определенных групп). Теперь можно переводить сообщения на другие языки. Поскольку все сообщения находятся в пространстве имен MediaWiki, только администратор вики может редактировать список сообщений и перевести их на самом деле.

Инструкция по созданию локализуемой заглавной страницы
Another use case is a page with lots of markup or templates. See the main page of translatewiki.net for example. The advantage of this method is that the language automatically appears in the user's interface language. The drawback is that to change the language in which the page is displayed, the interface language must be changed.

The implementation is the same as in the previous tutorial:


 * 1) Setup a new message group.
 * 2) Take a wiki page.
 * 3) Replace each translatable part with  and move the content to MediaWiki:Mainpage-messagename.
 * 4) Go to MediaWiki:Mainpage-messages (or what was defined in the setup) and add the message names there separated by whitespace.
 * 5) You are done. Go to Special:Translate to translate the main page.

Here is an example. Let's say Main Page contains:  is a community for chefs and bakers that love chocolate. We currently have full of chocolate. Then change it to: 

Создайте сообщение MediaWiki:Mainpage-slogan, содержащее текст: is a community for chefs and bakers that love chocolate. Создайте сообщение MediaWiki:Mainpage-pagecount, содержащее текст: We currently have full of chocolate. Создайте сообщение MediaWiki:Mainpage-messages, содержащее текст: mainpage-slogan mainpage-pagecount Всё готово! Вы можете добавлять и удалять новые элементы, когда захотите.

Переключатель языков
Not only the user can't choose what localised version of the page to read unless changing their preferences, but anonymous users can't set their user interface language and always use the wiki's default language. A page translated with this system will be in the default content language, if you don't provide anonymous users a way to select their language.

Luckily, there is a solution. With the UniversalLanguageSelector extension it is possible to guess the user's preferred language and also to let the user manually select another language and store the choice in a cookie, with no need of tricks such as the  parameter, which is suitable mostly only for debugging.