Help:Extension:Translate/Page translation administration/pt-br

O que. O recurso tradução de página permite a tradução controlada de páginas wiki para outras línguas. Isso significa que o conteúdo de cada tradução será, geralmente, igual a página de origem. Isto é o oposto de, por exemplo, a versão em idioma diferente de artigos em diferentes Wikipedias, que são totalmente independentes umas das outras. Supõe-se que apenas as páginas são traduzidas de uma língua principal para outros idiomas, mas os tradutores podem tirar proveito de traduções em outras línguas também, se elas existirem.

Por que. Sem qualquer ajuda, traduzir mais do que algumas páginas para outros idiomas torna-se uma perda de tempo na melhor das hipóteses, uma bagunça insustentável, na pior. Com o recurso de tradução de páginas você pode evitar a confusão e trazer estrutura para o processo de tradução. A idéia central é que o texto de origem seja segmentado em unidades menores, cada um dos quais vai ser traduzidos individualmente. Quando o texto de origem é segmentado em unidades, todas as alterações podem ser isolados e tradutores só precisa atualizar as traduções de unidades que tiveram alterações no texto-fonte. Isso também permite que tradutores trabalhem em unidades de tamanho gerenciável e compartilhem o trabalho entre vários tradutores ou continuem a tradução em sessões posteriores, porque não precisam fazer tudo de uma vez.

Quem. Esta página desenvolve o tutorial de tradução de páginas proporcionando uma análise mais profunda sobre a forma como o sistema funciona, e sugere que as melhores práticas para uma ampla variedade de casos. Esta página destina-se a administradores de tradução de páginas e, em geral para todos que editam o texto de origem de páginas traduzíveis, mesmo que eles não tenham o acesso aos recursos administrativos de aprovação de mudanças para a tradução.

Vida de uma página traduzível
Papéis. Várias pessoas estão envolvidas no processo de escrita e tradução de uma página wiki: o escritor cria uma página inicial, alguém corrige erros de ortografia, um administrador de página de tradução marca a página para a tradução, os tradutores traduzem, alguém faz alterações na página, um administrador de tradução marca essas alterações para tradução e tradutores atualizam as traduções. Esses papéis podem se sobrepor mais ou menos, mas a responsabilidade final de uma tradução livre de problemas é deixado para o administrador de tradução. O administrador decide quando a página está pronta para a tradução pela primeira vez, garante que a segmentação sirva a um propósito e aprova (ou corrige) as mudanças.

Preparação. Para ter algo traduzido você tem que escrever primeiro. Se você já fez a tradução sem a extensão Translate, veja abaixo a seção sobre migração de traduções. Se você quer um monte de tradução e rapidamente, é fundamental para o texto de origem estar em boa forma. Antes de marcar a página para tradução, peça a alguém para corrigi-la e se possível peça a um especialista em linguagem para tornar o texto mais claro e conciso. Vocabulário complicado e frases de difícil compreensão são um empecilho para muitas traduções voluntárias. Marcações demais podem causar problemas para os tradutores, mas como administrador de tradução, você pode evitar esses problemas, veja abaixo a seção sobre manipulação de marcação. Naturalmente as alterações feitas no texto fonte de tradução forçam a atualização de todas as traduções existentes, por isso é melhor esperar até que o conteúdo da página tenha se estabilizado. Por outro lado, as mudanças acontecem, e o sistema as processa da melhor maneira, então confira a seção sobre como lidar com as mudanças abaixo.

Marcação. Quando o texto está, de outra forma, pronto para a tradução, qualquer um pode marcar as partes traduzíveis envolvendo-as entre as tags &lt;translate> e adicionando a barra &lt;languages /> no topo da página. Esta última acrescenta uma lista de todas as traduções da página, com as porcentagens de sua conclusão e atualização. Não há nenhuma outra indicação de que as traduções existem. Veja abaixo como fazer esta marcação. O sistema irá detectar quando as tags são colocadas na página traduzível, e a página terá um link para marcá-la para tradução. Ele também irá notificar e evitar o salvamento se você, por exemplo, esqueceu de adicionar uma tag de fechamento. A página traduzida também será listada na página especial PageTranslation como "pronto para marcar".

Marcação para tradução. Após a marcação, um administrador de tradução marca a página para tradução. A interface é explicada neste exemplo de tradução de página. A responsabilidade do administrador de tradução é certificar-se que a segmentação faz sentido e que a marcação foi correta. A página pode ser marcada de novo se ela foi alterada nesse meio tempo. Veja abaixo como fazer alterações que causam o mínimo de interrupções. A marcação da página começa um processo de fundo que usa a fila de tarefas do MediaWiki. Este processo passa por cada página de tradução e regenera-a: mudanças na predefinição de tradução de página será refletida e traduções desatualizadas será substituído temporariamente com o texto original. Pelo contrário, a interface de tradução é atualizada imediatamente.

Alterações. Os usuários podem continuar a fazer alterações no código fonte da página traduzível. As mudanças serão visíveis para usuários que estão visualizando a página no idioma de origem, mas traduções são feitas contra as unidades de tradução extraídas da última versão da página traduzível que foi marcada para tradução: as páginas de tradução são relatadas como 100% atualizadas, se todas as unidades de tradução foram traduzidas, mesmo que a página de origem tenha novas alterações. Você pode facilmente ver se há alterações não marcadas ao visualizar a página traduzida no idioma de origem: há um aviso na parte superior que diz que você pode traduzir esta página e também links para as alterações, se houver algum.

Idioma de origem. Há também uma página de tradução com o código de idioma do idioma de origem: ele não contém as tags extras e outras marcações relacionadas à tradução da página que são utilizadas no código fonte da página traduzível. Esta página não está ligada a partir da interface, mas é útil, por exemplo, quando você quer transcluir a página (normalmente para predefinições traduzíveis) ou exportá-la.

Pedidos de tradução fechados. Algumas páginas traduzíveis têm um conteúdo que só é interessante por um determinado período de tempo. Por exemplo, os anúncios e atualizações de status regulares, como os Wikimedia destaques mensais. Você pode manter as páginas em torno de traduções, mas escondê-las a partir da interface de tradução. Isso não impede outras traduções para as páginas, mas reduz muito a chance de que um usuário inicie acidentalmente a tradução da página. O desencorajamento e sua reversão são feitas a partir da página especial PageTranslation.

Priorizando idiomas. Você também pode definir uma lista de idiomas que você especificamente quer traduções incluídas; deixar a lista de idiomas vazia é interpretado como todos os idiomas permitidos. A página irá se comportar como uma página desencorajadora (ver parágrafo anterior) para os idiomas que não estão na lista de prioridades e, ao traduzir para eles, tradutores receberão um aviso prévio. Você também pode evitar a tradução em outros idiomas, dizer se as traduções são realmente utilizadas em outros lugares e você não será capaz de usá-las, mas em alguns idiomas.

Agrupamento. É possível agrupar páginas relacionadas. Esses grupos funcionam como todos os outros grupos de mensagens. Eles têm as suas próprias estatísticas e contêm todas as mensagens dos subgrupos: neste caso, páginas traduzíveis. Esta funcionalidade está atualmente na página especial Special:AggregateGroups. Grupos de mensagens agregados estão recolhidos por padrão em Special:LanguageStats no seletor de grupo de Special:Translate.

Movimentação. Você pode mover páginas traduzíveis como faria com qualquer outra página. Ao mover, você pode escolher se você deseja mover qualquer subpáginas não traduzíveis também. O movimento utiliza uma tarefa de fundo para mover as muitas páginas relacionadas. Enquanto o movimento está em andamento, não é possível traduzir a página. A conclusão é anotada no registro da página de tradução.

Exclusão. Como a movimentação, a exclusão é acessada a partir do local normal. Você pode excluir toda a página traduzível, ou apenas uma tradução da mesma. Para excluir uma tradução, vá para a página de tradução e, em seguida, acesse excluir. Como na movimentação, um processo em segundo plano vai apagar as páginas ao longo do tempo. A exclusão também vai apagar as páginas de unidades de tradução relacionadas. A conclusão é anotada no registro da página de tradução. A exclusão exige as permissões "delete" e "pagetranslation", mas as páginas de unidades de tradução indivíduais podem sempre ser apagadas com a opção padrão "delete".

Reversão. Da mesma forma, reverter edições incorretas funciona como de costume (incluisive o botão de reversão): você só tem que editar a unidade de tradução afetada e a página de tradução será atualizada. Para encontrar a edição para a unidade de tradução a partir da edição da página de tradução, basta clicar no link "" para o editor e procurar por uma edição em um momento similar.

Proteção. É possível proteger a página traduzível. Páginas de tradução não podem ser protegidas, nem a proteção da página traduzível se estender a elas. Para evitar mais alterações em traduções, você deve adicionar o idioma de origem como apenas idioma prioritário e desabilitar as traduções para outros idiomas, consulte priorizando idiomas acima. Juntas, essas duas ações efetivamente previnem alterações, tanto a página de origem quanto as páginas de tradução com suas páginas de unidades de tradução. É possível proteger unidades de páginas de tradução individuais, embora não seja aconselhável.

Remoção de tradução. Também é possível desmarcar uma página para tradução. Primeiro você precisa remover todas as tags traduzir a partir da página. Então você pode usar a página especial PageTranslation ou seguir o link no topo da página traduzível para removê-la da tradução. Isto irá remover qualquer estrutura relacionada com a página de tradução, mas deixa todas as páginas existentes no lugar, livremente editáveis. Esta ação não é recomendada.

Anatomia de uma página traduzível
A tradução de uma página traduzível irá produzir muitas páginas, que em conjunto compõem a página traduzível no sentido mais amplo: o título é determinado pelo título da  traduzível:


 * (a página de origem)
 * (as páginas de tradução, além de uma cópia da página de origem, sem marcação)
 * (todas as páginas de unidades de tradução)

Além disso, há a predefinição da página de tradução e as fontes de unidades de tradução, extraídas da página de origem e armazenadas no banco de dados. O sistema mantém o controle de quais versões da página de origem contêm tags de tradução e de qual versão delas foi marcada para tradução.

Sempre que uma página de unidade de tradução é atualizada, o sistema também gerará a página de tradução correspondente. Isto resultará em duas edições. A edição da página de unidade de tradução está oculta por padrão nas mudanças recentes e pode ser mostrada ao escolher Mostrar traduções do filtro de tradução. Qualquer ação que não seja a edição (como a exclusão e a movimentação) das páginas de unidade de tradução não acionará a regeneração da página de tradução correspondente.

Segmentação
Princípios gerais:


 * 1) Todo o texto destinado à tradução deve ser acondicionado dentro das tags &lt;translate>. Pode haver vários pares de tags em uma página.
 * 2) Tudo que estiver fora dessas tags não será alterado em qualquer página de tradução. Este texto estático, juntamente com os espaços reservados que marcam o lugar onde a tradução de cada unidade de tradução será substituída, é chamado de modelo de página de tradução.
 * 3) Muita marcação no texto tornará mais difícil o trabalho dos tradutores. Use uma colocação mais criteriosa das tags &lt;translate> quando há muita marcação.
 * 4) O texto dentro das tags &lt;translate> é dividida em unidades de tradução em que há uma ou mais linhas em branco entre elas (duas ou mais novas linhas).

Restrições. O recurso de página de tradução coloca algumas restrições sobre o texto. Não deve haver qualquer marcação que se estenda por mais de duas ou mais unidades de tradução. Em outras palavras, cada parágrafo deve ser auto-suficiente. Atualmente, isso não é aplicado no software, mas a violação invalidará a renderização da página, a gravidade, dependendo se o próprio MediaWiki é capaz de corrigir a saída HTML resultante ou não.

Ordem de análise. Cuidado, as tags translate funcionam de forma diferente de outras tags, porque elas não passam pelo analisador. Isso não deve causar problemas, geralmente, mas pode ocorrer, se você está tentando algo extravagante. Em mais detalhes, eles são analisados ​​antes de quaisquer outras tags ou como &lt;pre> &lt;source>, com a excepção de &lt;nowiki> que é reconhecida pela extensão Translate em algumas circunstâncias (por exemplo, na renderização de uma página), mas não em outras (como na geração de listas em Special: PageTranslation de páginas que contêm &lt;translate>). Se você quer ter a expressão literal "&lt;translate>" no texto de origem, você deve fazer algo como "&amp;&lt;translate>".

Colocação de tags. Se possível, tente colocar as tags em suas próprias linhas, sem linhas vazias entre o conteúdo e as tags. Às vezes isso não é possível, por exemplo, se você quiser traduzir algum conteúdo cercado pela marcação, mas não a própria marcação. Isso é bom também, por exemplo:

Para fazer este trabalho, a extensão tem um manuseio simples de espaços em branco: o espaço em branco é preservado, exceto se uma tag translate de abertura ou fechamento é a única coisa em uma linha. Nesse caso, a nova linha após a tag de abertura ou antes da tag de fechamento é suprimida. Isso significa que elas não causam espaço extra na versão processada da página.

Variáveis. É possível usar variáveis semelhantes às variáveis da predefinição. A sintaxe para isso é. Para os tradutores, estes irão aparecer apenas como, e em páginas de tradução serão automaticamente substituídos pelo valor definido na página traduzível (assim elas são "constantes" globais em todas as suas páginas de tradução). As variáveis podem ser utilizadas para ocultar o conteúdo intraduzível no meio de uma unidade de tradução. Ele também funciona para coisas como números que precisam ser atualizados com freqüência. Você pode atualizar o número em todas as traduções, alterando o número no código fonte da página traduzível e re-marcação da página. Você não precisa invalidar traduções, porque o número não é parte das páginas de unidades de tradução.

Exemplos de marcação
Abaixo estão listadas algumas alternativas e maneiras sugeridas de lidar com diferentes tipos de marcação wiki.

{| class=wikitable Sem tradução: Category:Cars
 * Categorias
 * Categorias podem ser adicionadas de duas maneiras: no modelo da página de tradução ou em uma das unidades de tradução. Se você tem as categorias no modelo da página de tradução, todas as traduções acabarão na mesma categoria. Se você tiver as categorias em unidades de tradução, você deve mostrar aos usuários um esquema de nomenclatura. À direita, mostramos dois esquemas possíveis que são independentes dos meios técnicos para adotá-las.


 * Todas as traduções na mesma categoria (bom, se for em apenas alguns idiomas, e ruim se for em muitos).
 * Nome da categoria não traduzido (pode ser colocado como está no modelo de tradução).

Tradução, adicionando o sufixo do idioma: Category:Cars/fi (recomendado, mas não suportado)

There are some such templates available on the wikis which use the Translate extension, but they won't be dealt with here. Additionally, categories' description pages will have to be created manually and translated with a non-Translate system, because the extension is not able to deal with them.
 * Category page name not translated (just like the page names).
 * Uma categoria para cada linguagem.
 * A tradução da página podia ser utilizada para a própria categoria: as categorias seriam ligadas entre si e os cabeçalhos seriam traduzidos (mas não o nome da categoria em links e afins).
 * This option is not yet supported out of the box by the Translate extension. You need to either instruct your translators to add the language code suffix to the category markup in the translation, or leave the category out of translation and write your own templates which add the language code automatically.

Errado: == &lt;translate>Culture&lt;/translate> ==
 * Cabeçalhos
 * Os cabeçalhos podem, em princípio, ser vinculados ao parágrafo seguinte, mas é melhor deixa-los separados. Desta forma, alguém pode traduzir rapidamente o índice antes de ir para o conteúdo. Ao codificar os cabeçalhos, é importante incluir a marcação de cabeçalho dentro das tags, ou o MediaWiki deixará de identificá-los corretamente, por exemplo, ao tentar editar uma seção específica da página de origem. A marcação também dá imediatamente ao tradutor um contexto: ele/ela está traduzindo um cabeçalho.
 * Os cabeçalhos podem, em princípio, ser vinculados ao parágrafo seguinte, mas é melhor deixa-los separados. Desta forma, alguém pode traduzir rapidamente o índice antes de ir para o conteúdo. Ao codificar os cabeçalhos, é importante incluir a marcação de cabeçalho dentro das tags, ou o MediaWiki deixará de identificá-los corretamente, por exemplo, ao tentar editar uma seção específica da página de origem. A marcação também dá imediatamente ao tradutor um contexto: ele/ela está traduzindo um cabeçalho.

Certo: &lt;translate>== Culture ==&lt;/translate> Segmentação sugerida: &lt;translate>

Culture
Lorem ipsum dolor. &lt;/translate>

&lt;translate> &lt;/translate>
 * Imagens
 * Imagens que contenham conteúdo específico do idioma como texto deve incluir a sintaxe de imagem completa em uma unidade. Outras imagens só podem marcar a descrição com sugestão opcional na documentação de mensagens da página depois de terem sido marcadas.
 * Imagens que contenham conteúdo específico do idioma como texto deve incluir a sintaxe de imagem completa em uma unidade. Outras imagens só podem marcar a descrição com sugestão opcional na documentação de mensagens da página depois de terem sido marcadas.


 * Links
 * Os links podem ser incluídos no parágrafo em que eles estão inseridos. Isto permite alterar o rótulo do link, mas também alteram o destino do link para uma versão localizada, se houver.
 * Os links podem ser incluídos no parágrafo em que eles estão inseridos. Isto permite alterar o rótulo do link, mas também alteram o destino do link para uma versão localizada, se houver.

Se a página de destino é (ou deveria ser) também traduzível, você deve ligar para ele, antecedendo  ao seu título. Apenas o rótulo do link terá de ser traduzido, porque este redireciona automaticamente os usuários para a página de tradução em seu próprio idioma da interface, como selecionado por exemplo através da página especial UniversalLanguageSelector. No entanto, para conseguir um comportamento constante a sintaxe deve ser utilizada para todas os links.

Como os cabeçalhos são traduzidos, você não pode contar com os IDs gerados automaticamente para cabeçalhos. Você pode adicionar suas próprias âncoras. Para tê-los fora do modelo de tradução, você precisa quebrar a página em vários pares de tags &lt;translate> em torno de cada cabeçalho para o qual você queira ter uma âncora. Links internos &lt;translate> Helsinki is capital of Finland. &lt;/translate>

Links para páginas traduzíveis: &lt;translate> It has marvelous beaches with a lot of seagulls. &lt;/translate> Links externos &lt;translate> PHP (website) is a programming language. &lt;/translate> Links dentro de uma página: &lt;translate>

Culture
Lorem ipsum dolor.

...

For more about food, see section about culture. &lt;/translate>

&lt;translate> &lt;translate> &lt;/translate>
 * Listas
 * As listas podem ficar muito grandes, então você pode querer dividi-las em várias partes com, por exemplo, cinco itens ou menos em cada um, como se segue. Faça isso apenas se os itens são suficientemente independentes para serem traduzidos separadamente em todos os idiomas, não crie "mensagens de lego": por exemplo, você deve evitar dividir uma única frase em várias unidades, ou para separar partes dependentes logicamente que podem afetar entre si (em relação à pontuação ou ao estilo da lista, por exemplo). Para dividir uma lista, use as tags . Não insira novas linhas ou isso vai quebrar a saída HTML.
 * As listas podem ficar muito grandes, então você pode querer dividi-las em várias partes com, por exemplo, cinco itens ou menos em cada um, como se segue. Faça isso apenas se os itens são suficientemente independentes para serem traduzidos separadamente em todos os idiomas, não crie "mensagens de lego": por exemplo, você deve evitar dividir uma única frase em várias unidades, ou para separar partes dependentes logicamente que podem afetar entre si (em relação à pontuação ou ao estilo da lista, por exemplo). Para dividir uma lista, use as tags . Não insira novas linhas ou isso vai quebrar a saída HTML.
 * General principles
 * Headings
 * Images
 * Tables
 * Categories&lt;/translate>
 * Links
 * Templates


 * Números
 * Com os números e outros elementos não linguísticos você pode querer remover o número da tradução e torná-lo uma variável. Isto traz vários benefícios:
 * Com os números e outros elementos não linguísticos você pode querer remover o número da tradução e torná-lo uma variável. Isto traz vários benefícios:

&lt;translate> Income this month  EUR &lt;translate> Note that this prevents the translators from localising the number by doing currency conversion. The  call makes sure the number is formatted correctly in the target language.
 * You can update the number without invalidating translations.
 * Translation memory can work better when the changing number is ignored.


 * Predefinições
 * Templates have varying functions and purposes, so the best solution depends on what the template is for. If the template is not a part of longer paragraph, it should be left out, unless it has parameters that need to be translated. If the template has no linguistic content itself, you don't need to do anything for the template itself.
 * For an example of templates translated with page translation, see Template:Extension-Translate. To use this template, you need to have another template similar to Template:Translatable navigation template, because you cannot include the template by anymore. This is not yet provided by the Translate extension itself, but that is in the plans.
 * For an example of templates translated with page translation, see Template:Extension-Translate. To use this template, you need to have another template similar to Template:Translatable navigation template, because you cannot include the template by anymore. This is not yet provided by the Translate extension itself, but that is in the plans.

Another way is to use the unstructured element translation to translate the template, but then the language of the template will follow the user's interface language, not the language of the page he is viewing.
 * }

Mudando o texto fonte
Princípios gerais:


 * Avoid changes
 * Make the changes as isolated as possible
 * Do not add translation unit markers yourself

Unit markers. When page is marked for translation, the system will update the translatable page source and add unique identifiers for each translation unit. See example below. These markers are crucial for the system, which uses them to track changes to each translation unit. You should never add unit markers yourself. The markers are always on the line before the unit; or, if it starts with a header, after the first header on the same line. The different placement for headers is needed to keep section editing working as expected.

&lt;translate>

Birds
&lt;!--T:1--> Birds are animals which....

&lt;!--T:2--> Birds can fly and... &lt;/translate> Changing unit text. Changing is the most common operation for translation units. You can fix spelling mistakes, correct grammar or do other changes to the unit. When re-marking the page for translation, you will see the difference in the unit text. The same difference is also shown to translators when they update their translations. For simple spelling fixes and other cases where you don't want the existing translations to be removed from translation pages, you can avoid invalidating them: translators will still see the difference if they ever update the translation for any reason.

Adding new text. You can freely add new text inside translate tags. Make sure that there is one empty line between adjacent units, so that the system will see it as a new unit. You can also add translate tags around the new text, if it is not inside existing translate tags. Again, do not add unit markers yourself, the system will do it.

Deleting text. You can delete whole units. If you do so, also remove the unit marker.

Splitting units. You can split existing units by adding an empty line in the middle of a unit, or by placing translate tags so that they split the unit. You can either keep the unit marker with the first unit or remove it altogether. In the first case, translators see the old text when updating the old translation. If you removed the unit marker, both units will behave as if no translation ever existed, after the page is re-marked for translation.

Merging units. If you merge units, you have to remove at least all but one unit marker.

Moving units. You can move units around without invalidating translations: just move the unit marker together with the rest of the unit.

Before marking the new version of the page for translation, ensure that the best practices are followed, especially that translators get a new translation unit if the content has changed. Also make sure that there are no unnecessary changes to prevent wasting translators time. If the source page is getting many changes, it may be worthwhile to wait for it to stabilize, and push the work for translators only after that.

Unidades de tradução não utilizadas não são excluídas automaticamente, mas isso não deve causar problemas.

Migrando para a tradução de páginas
Se você tem traduzido páginas antes de utilizar o sistema de tradução da página, você pode querer migrar as páginas para o novo sistema, pelo menos as que você espera ter novas traduções e quer estatísticas. Você provavelmente vai ter predefinições existentes para a mudança de idioma e talvez diferentes convenções de nomenclatura de páginas.

Você pode iniciar a migração pela limpeza, etiquetagem e marcação da página fonte. Você pode manter as predefinições de mudança de idioma existentes, enquanto você migra as traduções antigas. Se as suas páginas seguem as convenções de nomenclatura de subpáginas de código de idioma, elas serão substituídas pelo texto de origem depois de marcar a página de origem para a tradução, mas você ainda será capaz de acessar traduções a partir do histórico.

Este é um trabalho manual, onde você tem que abrir a página de tradução antiga e copiar e colar traduções de lá para corrigir unidades de tradução no novo sistema usando a interface de tradução. Para isso, você precisa saber mais ou menos qual a parte das correspondências de tradução que partem do texto antigo (e espero que elas combinem). Você pode querer considerar marcar todas as traduções migradas que estiverem necessitando de atualização, antecedendo a string  às traduções e ter um olhar tradutor para eles. Uma vez migradas, você pode excluir as páginas de tradução antigas, se elas não estiverem usando a mesma convenção de nomenclatura (ou você poderia ter mudado-as para isso antes da migração). Uma vez que todas as páginas forem migradas, você também pode remover as predefinições de navegação de idioma antigas.