Help:Extension:Translate/pt-br



The Translate extension enhances MediaWiki with essential features needed to do translation work. It can be used to translate the content pages, the interface of the wiki and even other software products, as it is used at translatewiki.net. The Translate extension comes with an easy to use translation interface and allows to separate the content structure from the content language to be translated, showing only the translatable text to translators by splitting the content into manageable units. Each unit is automatically tracked for changes, and translators immediately see what needs updating on a specific page or throughout the 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.

The usability of the translation interface is enhanced with JavaScript and AJAX. The backend provides WebAPIs than can be used in mobile interfaces or interfaces tailored to specific kind of content. It is also possible to export messages for translation in other off-line and on-line tools that accept the Gettext po file format.

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
You can translate almost anything with the Translate extension. Naturally there are specialized tools for translation of certain kind of content like video subtitles, that are better done with those tools, but in general Translate performs very well with any kind of text that can be split into messages with length ranging from one word up to one large paragraph. Longer messages become unwieldy to translate and are just harder to work with.

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


A maioria dos wikis tem conteúdo que gostariam de disponibilizar em vários idiomas. Seja um pouco ou centenas de páginas, não importa. Para poupar tempo dos tradutores, páginas devem ser marcadas para tradução apenas quando elas estão razoavelmente estáveis. Cada mudança feita posteriormente pode afetar dezenas ou centenas de traduções antigas, e o tempo necessário para atualizá-las aumenta. Especialmente com tradutores voluntários, você deve estar atento à esse aspecto, e respeitar o tempo que eles dedicam à fazer as traduções e atualizações, evitando trabalho desnecessário. Se você utiliza a Extensão para Tradução para traduzir páginas, você está no caminho para utilizar o tempo disponível dos tradutores o mais efetiva e eficientemente.

A maneira como a Extensão para Tradução divide a página em parágrafos como unidades não deixa muita liberdade para o tradutor mudar o conteúdo. Isso é normalmente bom e ideal quando se deseja que a continuidade e consistência do conteúdo seja a mesma entre os idiomas. Pode ser modificada, mas, a princípio, essa maneira de traduzir não é geralmente adequada, por exemplo, para artigos da Wikipédia, que são normalmente totalmente independentes entre si. Mesmo que eles sejam criados como traduções de artigos de outros idiomas, eles normalmente começam a ter vida própria. com o Tradutor, a página original é sempre a versão principal, e o conteúdo novo não pode ser desenvolvido nas versões traduzidas.

Com essas limitações em mente, há ainda muitos casos onde essa função é muito adequada. A maioria, se não todas, as documentações de usuário entram nessa categoria assim como o conteúdo de notícia que não se modifica depois de escrito. Se você já tem a Extensão para Tradução instalada e as permissões de acesso configuradas, tente criar uma página e envolver o texto inteiro dentro de  e seguir os links, ou o tutorial Como preparar uma página para tradução.

Tradução de interface local em wikis multilinguísticos
Uma coisa que quase todos os wikis tem customizado é a barra lateral. É possível criar um grupo de mensagens para as mensagens da barra lateral customizada e também para outras customizações da interface local.

Uma expansão interessante são as páginas multilinguísticas ou modelos criados com a palavra mágica. A página principal do translatewiki.net e alguns modelos do Wikimedia Commons são bons exemplos. A palavra mágica é uma alternativa para a ferramenta de tradução de conteúdo e é mais adequada para páginas pesadas como a página principal do translatewiki.net. Outro fato interessante é que o idioma da página automaticamente segue aquele da interface do usuário, então não há a necessidade de uma barra de idiomas, embora você possa ter uma interface de seleção de idioma.

Criar isso é um pouco mais complicado do que a tradução do conteúdo e é necessário uma configuração do software, mas está tudo explicado no tutorial Como criar uma interface de grupo de mensagens.

Tradução de software
A Extensão para Tradução é uma boa ferramenta para tradução de mensagens de interface de software. No translatewiki.net, ela é utilizada para traduzir dezenas de produtos como jogos para aplicativos online. A Extensão para Tradução suporta a leitura e atualização de traduções de ou para formatos comuns utilizados no desenvolvimento de web, incluindo propriedades de Java, Gettext e arquivos Yaml.

Rastreamento de mudanças também está disponível para arquivos rastreados externamente, pois internamente a extensão utiliza uma versão derivada do cache da localização dos arquivos onde o texto original e suas traduções são armazenadas, ao invés de utilizá-los diretamente no formato original. Os administradores de tradução podem usar tanto a interface da web ou uma interface de linha de comando, para verificar novas definições de mensagens e requisições de tradução "fuzzy" quando precisam de atualização. Esse trabalho não tem ligação com o formato básico do arquivo ou sistema de controle de versão.

Com ferramentas simples de comando de linha, os administradores de tradução podem facilmente importar um conjunto grande de traduções existentes e com apenas um comando exportá-las no formato e estrutura de diretório corretos. Você pode exportar diretamente para o seu depósito de verificação do sistema de controle de versão, onde pode fazer mudanças e novos arquivos.

Para tradutores e administradores de tradução

 * How to translate [Tutorial]
 * Melhores práticas de tradução
 * Estatísticas e relatório
 * Garantia de qualidade
 * Estados de grupo de mensagens
 * Off-line translation
 * [Em andamento] Glossário

Para administradores de tradução

 * Como preparar uma página para tradução [Tutorial]
 * Administração da tradução da página
 * Interface message groups (localised sidebar, main page and templates) [Tutorial]
 * [Em andamento] Message group management
 * YAML configuration format
 * How to write YAML configuration for file based message groups [Tutorial]

Documentos de referência para desenvolvedores

 * Instalação
 * Configuração
 * [Em andamento] Tradução explicada para desenvolvedores
 * Hooks
 * [Em andamento] Grupos de mensagem
 * [Em andamento] Suporte de formato de arquivo
 * Ajudas de tradução
 * [Unwritten] API da Web
 * Memórias da tradução

Relacionados

 * 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

A ser feito

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