Help:Extension:Translate/pt-br



A Extensão para Tradução melhora todos os wiki da MediaWiki onde está sendo utilizada através de ferramentas essenciais que são necessárias para o trabalho de tradução. Pode ser utilizada para traduzir as páginas com conteúdo, a interface do wiki e outros produtos do software, como no translatewiki.net. A Extensão para Tradução tem uma interface fácil de utilizar e permite que a estrutura do conteúdo seja separada do idioma de conteúdo para a tradução, mostrando apenas o texto que pode ser traduzido através da separação do conteúdo em unidades controladas. Cada unidade é automaticamente rastreada para mudanças, e os tradutores veem imediatamente o que deve ser atualizado numa página específica ou através do wiki.

A Extensão para Tradução é usada para traduzir a interface do usuário do MediaWiki e outros produtos de software no translatewiki.net por centenas de tradutores todos os meses. No userbase.kde.org, a extensão é utilizada para traduzir cerca de mil páginas de conteúdo com documentação de usuário. É fácil começar a utilizar a Extensão para Tradução, que ao mesmo tempo expandi e fornece recursos de relatórios avançados, revisões e fluxos de trabalho.

Características


Interface: A principal função da Extensão para Tradução é uma simples e funcional interface de tradução. Além das informações essenciais como definição da mensagem e documentação, você também pode ver traduções em outros idiomas. Se uma definição for modificada, você verá as mudanças. A extensão vem com alguns controles embutidos, que podem ajudar com erros comuns como falta de colchetes e variáveis não utilizadas. Dependendo da configuração, também aparecerão sugestões da memória de traduções e traduções de máquinas como o Google Tradutor, o tradutor Bing da Microsoft e o Apertium.

A usabilidade da página de tradução é melhor com o JavaScript e AJAX, mas editar as mensagens em uma janela de página de edição normal também é suportada. Todos os assistentes são suportados nas duas visualizações. A tradução não é apenas restrita à essas interfaces! Também é possível exportar mensagens para traduzir em ferramentas off-line e on-line que aceitem o formato Gettext po. Há ainda um Web API que pode ser utilizado para desenvolver interfaces customizadas.

Grupos de mensagens e tarefas: Muitas das funcionalidades são desenvolvidas a partir de dois conceitos básicos: grupos de mensagens e tarefas.

Um grupo de mensagens representa uma coletânea de mensagens. Uma página de conteúdo é um grupo de mensagens, onde, de maneira simples, cada parágrafo é uma mensagem nesse grupo. Mensagens utilizadas nas extensões do MediaWiki formam um grupo de mensagens no translatewiki.net - algumas extensões maiores tem múltiplos grupos. Você também pode fazer um grupo de grupos, como Todos os boletins informativos ou Todas as mensagens da extensão de tradução. Muitas das estatísticas e tarefas funcionam na base de mensagens de grupo.

As tarefas, ou as diferentes mensagens em um grupo de mensagens, facilitam diferentes casos. Normalmente o tradutor vê uma lista de mensagens não traduzidas no grupo de mensagens escolhido, mas há tarefas onde você pode revisar mensagens ou obter uma lista de todas as mensagens, traduzidas ou não.



Relatos e estatísticas: A extensão tem diversas funções de relato, desde uma visualização de mensagens não traduzidas em todos os grupos de mensagens em um idioma específico, até listas de tradutores por idioma, incluindo seu nível de atividade.

Tradução de conteúdo: Se você já tentou traduzir conteúdo no MediaWiki sem qualquer ferramenta, você sabe que essa não será escalada. As versões traduzidas ficam desatualizadas e não há uma maneira de rastrear as mudanças na página mestre, então há diversas traduções feitas pela metade ou desatualizadas sem uma visão do estado geral. Os tradutores são desmotivados quando não conseguem trabalhar com pequenos pedaços de texto. Eles também não acham trabalho para fazer ou que precise de atualização. Os usuários também ficam confusos com informações desatualizadas.

Isto tudo é resolvido com a Extensão de Tradução e sua página com a ferramenta de tradução. Isso adiciona um pouco de peso às páginas que precisam de tradução, mas os benefícios são muito maiores. Essencialmente, você só precisa marcar as partes da página que precisam de tradução. A extensão irá separar as partes em parágrafos e criar um grupo de mensagens para eles. Depois disso os tradutores podem utilizar todas as funções descritas acima. Você também pode adicionar uma barra de idiomas com a tag ou ter links que direcionam automaticamente para a versão no idioma de preferência do usuário quando este existe, isso pode ser feito utilizando a forma Special:MyLanguage/Pagename.

Para mais informações veja o tutorial Como enviar uma página de conteúdo para tradução e a documentação da função de tradução.

Desenvolvedores: A extensão tem suporte para muitos formatos de arquivos de tradução comum, como propriedades de Java e arquivos Gettext po. Tem um extensivo conjunto de ferramentas, tanto in-wiki como na linha de comando, para importar e exportar traduções eficientemente.

Utilização
Você pode traduzir quase tudo com a Extensão de Tradução. Naturalmente, há ferramentas especializadas para tradução de certos tipos de textos como legendas de vídeos, que são melhores com estas ferramentas, mas geralmente o Tradutor é muito bom para qualquer tipo de texto que possa ser dividido em mensagens com tamanhos de uma palavra até um parágrafo. Mensagens longas se tornam difíceis de traduzir e são mais difíceis ainda de trabalhar.

Os três casos básicos que a Extensão de Tradução suporta são tradução de conteúdo, tradução de interface local e tradução de software. Todos esses são explicados nas seções posteriores, com links para tutoriais e documentações de referência ou tópicos de ajuda aprofundados, quando disponíveis. Dos três casos, a tradução de interface tem sido a menos utilizada.

Tradução de conteúdo


Most wikis have content they would like to be available in multiple languages. Whether just a few or hundreds of pages, it doesn't matter. In order to prevent wasting translator's time, pages should be marked for translation only when they are reasonably stable. Each change that is made afterwards can affect tens or hundreds of old translations, and the time needed to update them adds up. Especially with volunteer translators, you should be aware of this aspect, and respect the time they spend making translations and updates, avoiding unnecessary work. If you use the Translate extension to translate pages, you are already well on your way to using the translator time available in the most effective and efficient way.

The way the Translate extension splits up a page into paragraph sized units does not leave too much freedom for translators to change the content. This is usually a good thing and is ideal where continuity and consistency of content across languages is desired. It can be worked around, but in principle this way of doing translations is not generally suitable, for example, for Wikipedia articles, which usually are totally independent of each other. Even if they originally start as a translation from a different language, they usually begin living their own independent life from the original version. With Translate, the original page is always the main version, and new content cannot be developed in translated versions.

With these limitations in mind there are still plenty of cases where this feature is a perfect match. Most, if not all, user documentation falls into this category as well as news-like content that does not change once written. If you have the Translate extension already installed and access rights configured, try creating a page and wrapping the whole text inside  and follow the links, or follow the tutorial How to prepare a page for translation.

Local interface translation in multilingual wikis
One thing almost every wiki has customized is the sidebar. It is possible to create a message group for the custom sidebar messages and also for other local interface customisations.

One interesting expansion is the multilingual pages or templates built with the magic word. The translatewiki.net main page and some Wikimedia Commons templates are good examples of this. The magic word is an alternative to the content translation feature and it is more suitable to mark-up heavy pages just like the translatewiki.net main page. Another nice feature is that the language of the page automatically follows the user interface language, so there is no need for a language bar, although you might want to have an interface language selector instead.

Setting this up is currently a bit more complicated than content translation and needs software configuration, but it is all covered in the tutorial How to make an interface message group.

Software translation
The Translate extension is a good fit for translating software interface messages. At translatewiki.net, it is used to translate tens of software products from games to web applications. The Translate extension supports reading and updating translations from and to common formats used in web development including Java properties, Gettext and Yaml files.

Change tracking is also available for externally tracked files, because internally the extension uses a cached derivative version of the localisation files where the source text and its translations are stored, instead of using them directly in their original format. Translation administrators can either use the web interface or a command line interface to check new message definitions and "fuzzy" (request update of) translations when they need updating. This works regardless of the underlying file format or version control system (if any).

With simple command line tools, translation administrators can easily import even a large set of existing translations and with just one command they can export all translations in the correct format and in the correct directory structure. You can export directly to your VCS repository checkout, where you can easily commit changes and new files.

For translators and translation administrators

 * How to translate [Tutorial]
 * Translation best practices
 * Statistics and reporting
 * Quality assurance
 * Message group states
 * Off-line translation
 * [In progress] Glossary

For translation administrators

 * How to prepare a page for translation [Tutorial]
 * Page translation administration
 * Interface message groups (localised sidebar, main page and templates) [Tutorial]
 * [In progress] Message group management
 * [Needs updating] YAML configuration format
 * How to write YAML configuration for file based message groups [Tutorial]

Reference documents for developers

 * Installation
 * Configuration
 * [In progress] Translate explained for developers
 * Hooks
 * [In progress] Message groups
 * [In progress] File format support
 * [Unwritten] Web API
 * Translation memories

Related

 * Translation notifications
 * Localisation/Tutorial: General localisation tutorial for developers, for use at hackathons & trainings
 * Extension:TranslateSvg: Adds support for translating SVG files
 * Universal Language Selector: Provides webfonts and input methods

Todo

 * Implementation on Meta: m:Meta:Translate extension.
 * See translate-doc for specific tasks.