Help:Extension:Translate/Unstructured element translation/pt-br

Esta página explica como tornar a tradução de mensagens personalizadas de interfaces wiki um pouco mais fácil de gerenciar, com a extensão Translate. Aplica-se a qualquer parte do wiki que você desejar fornecer automaticamente no idioma da interface do usuário. O exemplo mais típico é a barra lateral, porque só pode haver uma, mas o mesmo método pode ser usado para a página principal, se você quer ter todas as suas traduções sob o mesmo título, ou mesmo para predefinições.

Este método é aplicável também ao conteúdo wiki onde a tradução da página completa simplesmente não se encaixa, como páginas pesadas na marcação ou predefinições, cuja marcação você não deseja expor para tradutores. Isso tudo gira em torno das mensagens de interface, ou a palavra mágica, que permite incluir mensagens de interface em qualquer lugar onde você pode escrever wikitexto. Esta palavra mágica permite substituir automaticamente a mensagem de interface, se for padrão, personalizado ou novo, no idioma da interface de usuário.

Você pode usá-lo para trazer o poder da localização automática da interface do wiki para o conteúdo do wiki, mas não resolve o problema para usuários anônimos, que não podem alterar o idioma da interface, por padrão. Consulte a nota sobre a extensão Universal Language Selector abaixo.

Comparado à tradução de páginas, este método tem algumas desvantagens:


 * 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.

Configuração
A server administrator must complete this step. The following snippet needs to be added to LocalSettings.php: The message group id,, must be unique, so don't reuse the same id for multiple groups. The second parameter to the, refers to the Mediawiki:Sidebar-messages page. The label is shown in dropdowns and other places where you can select a message group. The description is shown in Special:Translate. Those are the values you can and should change to what suits your wiki when adding a new custom message group.

Localised sidebar tutorial
We assume that the setup step has already been done. Then you should follow the sidebar customization guide carefully. Let's assume the following simple sidebar was created: And MediaWiki:Sidebar-commonpages contains, while MediaWiki:Sidebar-faq contains.
 * sidebar-commonpages
 * FAQ|sidebar-faq

Then all we need to do is to go to MediaWiki:Sidebar-messages (or whatever was defined in the previous step) and write there: sidebar-commonpages sidebar-faq That is, the names of the system messages, without the "MediaWiki:" namespace prefix, separated by whitespace.

Then go to Special:Translate/wiki-sidebar (or whatever was defined in the previous step; see Special:Translate for the list of defined groups). Now it is possible to translate the messages into other languages. Since all the messages are in the MediaWiki namespace, only a wiki administrator can edit the list of messages and actually translate them.

Localised main page tutorial
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.

A implementação é a mesma vista no tutorial anterior:


 * 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. Então mude para: 

Create MediaWiki:Mainpage-slogan with the content: is a community for chefs and bakers that love chocolate. Create MediaWiki:Mainpage-pagecount with the content: We currently have full of chocolate. Create MediaWiki:Mainpage-messages with the content: mainpage-slogan mainpage-pagecount E está pronto! Você pode adicionar ou remover novas mensagens na hora que quiser.

Seletor de idioma
Não é só o usuário que não pode escolher que versão localizada da página ler, a não ser que se mude as suas preferências, os usuários anônimos também não podem definir seu idioma da interface do usuário e usar sempre o idioma padrão do wiki. A página traduzida com este sistema vai estar no idioma do conteúdo padrão, se você não fornecer aos usuários anônimos uma maneira de selecionar sua língua.

Felizmente, existe uma solução. Com a extensão Universal Language Selector, é possível adivinhar o idioma preferido do usuário e também permitir que o usuário selecione manualmente outro idioma e armazene a escolha em um cookie, sem a necessidade de truques, como o parâmetro, que é adequado na maior parte das vezes apenas para depuração.