Help:Extensão:Translate/Exemplo de tradução de página
Documentação para a extensão Extensão:Translate
Tradutores (página de ajuda principal)
- Como traduzir
- Melhores práticas
- Estatísticas e relatórios
- Garantia de qualidade
- Estados de grupo de mensagens
- Tradução off-line
- Glossário
Administradores de tradução
- Como preparar uma página para tradução
- Administração de tradução de páginas
- Tradução de elementos não estruturados
- Gerenciamento de grupo
- Move translatable page
Administradores e desenvolvedores
Bem-vindo! Depois de concluir este tutorial, você vai saber como criar e gerenciar páginas traduzíveis usando a extensão Translate. Nosso objetivo é manter este tutorial o mais curto possível, ao introduzir todos os conceitos básicos e tarefas. Depois de concluir este tutorial, você pode usar a documentação detalhada sobre o recurso de tradução de páginas.
Passo 1: Antes de começar
Este tutorial pressupõe que a extensão Translate já está instalada e configurada. Talvez você já tenha uma página em mente que precisa de tradução, ou você pode usar a página de exemplo fornecido a seguir para experimentar os passos deste tutorial em seu próprio wiki.
Esta é uma página que descreve o município imaginário de Fréttinga.
Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. == Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.
- 1. Vá para a página [[Fréttinga]] na sua wiki (ou uma página de rascunho) e clique em criar.
- 2. Cole o conteúdo acima e guarde-o.
Passo 2: Preparação
Agora temos uma página com algum texto. Se a página ainda esta em construção e tera constante alteração, talvez seja melhor esperar até que as edições cheguem a um nível normal antes de adicionar a página no sistema de tradução. Isso serve para evitar que os tradutores tenham muito trabalho, pois terão de acompanhar todas as mudanças.
- 3. Edite [[Fréttinga]]
- 4. Envolva todo o conteúdo nas etiquetas
<translate>...</translate>como mostrado abaixo - 5. Salve a página
<translate> Fréttinga is a small municipality in MungoLand, located on the BaMungo island. It hosts a population of about 400 people. It has some agriculture and fishing. Tourists like to visit it in the summertime. == Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day. </translate>
Você não precisa adicionar etiquetas <translate> a todos os elementos ou adicione marcadores como <!--T:1-->; a extensão faz isso por você.
Passo 3: Habilitando as traduções
Após salvar a página, você verá um link na parte superior da página dizendo "Marcar esta página para tradução" - ou "Esta página contém alterações que não estão marcadas para tradução." se você não é um administrador de tradução. Se você é um administrador de tradução, clique no link "Marcar esta página para tradução". A página foi automaticamente dividida em quatro unidades de tradução. A primeira unidade é o título da página, a segunda é o primeiro parágrafo, a terceira é o cabeçalho do segundo parágrafo e a quarta é o texto do segundo parágrafo. Estes são os itens básicos das páginas traduzíveis: cada unidade é independente; pode e deve ser traduzido na totalidade; as alterações no conteúdo da página são rastreadas no nível da unidade. As unidades podem ser reorganizadas ou excluídas.
Há também uma visualização da página da predefinição de tradução de páginas, o que será abordado em etapas posteriores. Você pode dar nomes às unidades de tradução, mas neste exemplo, podemos optar por ficar com os padrões.
- 6. Clique no link "Marque esta página para tradução"
- 7. Certifique-se de que o corpo da página é dividido em três unidades corretamente
- 8. Clique no botão "Marque esta versão para tradução"
- 9. Retorne à página
Agora você vai ver um novo link no topo, "Traduzir esta página", que permite que os tradutores traduzam a página. Talvez você tenha que dar uma olhada no tutorial de tradução que usa essa página como um exemplo e experimentar algumas traduções agora. Depois, volte aqui para a próxima etapa.
Passo 4: Fazendo alterações
O rastreamento de mudanças é uma característica muito importante, por isso vamos fazer algumas mudanças e ver como ele funciona. Quando você abre a página para edição você vai ver que ela foi modificada com marcadores como <!--T:1-->.
Eles são adicionados pela extensão e ajudam você a identificar qual unidade é, qual. Isso permite que você reorganize e edite essas unidades. Ao editar a página, os marcadores devem ser deixados sozinhos e sua posição em relação à unidade a que pertencem não deve ser alterado. Ao mover uma unidade, mova também o marcador de unidade.
Ao excluir uma unidade, exclua também o marcador. Ao adicionar novos parágrafos, novos marcadores serão adicionados pelo software. Não tente fazer isso manualmente, isso pode confundir o software. Os marcadores que você excluiu também serão excluídos automaticamente pelo ‘bot’ nas traduções existentes.
Se você fizer pequenas alterações em uma unidade de tradução existente (adicionando algumas palavras ou um link a um parágrafo), mantenha o marcador. Se você alterar um parágrafo inteiro (exclua e reconstrua), exclua o marcador. Dessa forma, os tradutores terão tarefas diferentes, entre revisar uma tradução difusa ou criar uma nova tradução.
<languages />
<translate>
<!--T:1-->
Fréttinga is a small municipality in MungoLand, located on the BaMungo island.
It hosts a population of about 400 people. It has some agriculture and fishing.
Tourists like to visit it in the summertime.
It has marvelous beaches with a lot of seagulls.
== Services == <!--T:2-->
<!--T:3-->
It doesn't have many services. There is a shop, and a car ferry visits the island
from the mainland once a day.
In 2009 January the roof of the church in the island fell down. It was rebuilt
collaboratively the following summer.
</translate>
- 10. Faça algumas adições como destacado acima
- 11. Clique no link "marcado para tradução" no topo
- 12. Observe as mudanças
- 13. Clique no botão "Marcar para tradução"
- 14. Retorne à página original
Se você fez traduções, como sugerido na etapa anterior, agora você pode ver essas traduções ligadas no topo da página. Você também verá que a tradução não está 100% atualizada. Se você observar a versão traduzida, você verá o novo parágrafo em Inglês, e os parágrafos alterados são substituídos pelo texto em Inglês. Se você for para a visualização da tradução, você verá que a unidade está marcada com necessidade de atualização.
Traduções desatualizadas são substituídas por texto em Inglês, o usuário é informado de que a tradução está incompleta
A visualização da predefinição de tradução ajuda você a ver quais partes da página são constantes em todas as versões linguísticas (a "predefinição de tradução de páginas", ou seja, as partes fora das tags de tradução) e também mostra se as unidades foram movidas ao redor ou excluídas.
Pode haver um pequeno atraso antes de todas as versões traduzidas serem atualizadas, porque podem haver muitas páginas a serem atualizadas.
Agora você já sabe o básico, mas este tutorial vai prosseguir com outras coisas que você provavelmente vai encontrar.
Passo 5: Adicionar outros elementos do wiki
Agora você possui uma página básica traduzível, mas ela é muito desinteressante. Vamos adicionar uma imagem e algumas outras coisas para fazê-la parecer-se mais com uma página wiki normal e ver como estes elementos interagem com a tradução.
Nós também removemos um parágrafo, incluindo seu marcador de unidade, e o substituímos com uma lista, para que você possa ver o que acontece.
- 15. Adicione uma imagem, uma categoria e uma lista na página como mostrado abaixo
- 16. Salve a página
- 17. Clique no link "marked for translation" no topo da página
- 18. Verifique se as alterações estão como pretendido.
- 19. Clique no botão "Marque esta versão para tradução"
- 20. Retorne à página traduzível
<languages />
[[File:Torsö.jpg|thumb|<translate>A typical view of Fréttinga</translate>]]
<translate>
<!--T:1-->
Fréttinga is a small municipality in MungoLand, located on the BaMungo island.
It hosts a population of about 400 people. It has some agriculture and fishing and
tourists like to visit it in the summertime.
It has marvelous beaches with a lot of [[Special:MyLanguage/Seagull|seagulls]].
== Services == <!--T:2-->
<!--T:3-->
It doesn't have many services. There is a shop, and a car ferry visits the island
from the mainland once a day.
Main events:
* The roof of the church fell down in 2009
* New church was built in 1877
[[Category:Municipalities]]
</translate>
Documentar uma tradução
Aqui você pode ver que nós deixamos a maior parte da marcação da imagem fora de uma unidade de tradução e a colocamos na predefinição de tradução de página em vez disso. Isso geralmente é bom, mas às vezes tradutores pode querer mudar a imagem, especialmente se ela contiver conteúdo lingüístico (texto). Nesses casos, geralmente é mais fácil incluir toda a marcação em uma unidade (como fizemos para a categoria). Quando a tradução de uma unidade envolve ou interage com a marcação, é uma boa ideia escrever uma pequena dica para os tradutores sobre o assunto. Você pode fazer isso com os seguintes passos.
- 21. Clique o link "Translate this page" no topo
- 22. Selecione a linguagem "qqq - Documentação da página"
- 23. Clique no nome da mensagem que contém a mensagem "Uma visão típica de Fréttinga"
- 24. Escreva "Descrição de uma imagem" e clique "Salvar"
Sobre as categorias
Neste exemplo, a atribuição de toda a categoria é uma unidade de tradução. Isso permite que tradutores a alterem para [[Category:Municipalities/de]] ou qualquer que seja a convenção de nomenclatura que pretende utilizar para as categorias. Se fosse fora da predefinição de tradução, você teria todas as páginas Foo, Foo/de, Foo/ru, Foo/ta e assim por diante na mesma categoria. Às vezes, isso é bom, mas geralmente distrai os usuários. Verifique se seus tradutores sabem qual é a convenção local.
Sobre as hiperligações
Da mesma forma, para as ligações, há muitas maneiras de fazê-lo. Usamos "[[Special:MyLanguage/Seagull]]", que redireciona automaticamente para a versão traduzida da página conforme o idioma da ‘interface’ do usuário (se essa tradução existe). Esta não é uma solução definitiva, porque os usuários serão sempre redirecionados para o idioma da ‘interface’ que estão usando, não o idioma que está sendo lido no momento. A página especial Special:MyLanguage também interfere na página especial Special:WhatLinksHere e faz com que não funcione. A coisa boa sobre Special:MyLanguage é que você sempre terá alguma versão da página, mesmo que a tradução solicitada não exista.
Sobre os títulos
Para que os títulos sejam considerados elementos separados em vez do texto, não se esqueça de adicionar uma linha em branco (se ainda não houver) entre o título e o parágrafo a seguir.
O exemplo a seguir criará apenas uma unidade de tradução:
== Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.
O próximo criará duas unidades de tradução, incluindo uma para o título.
== Services == It doesn't have many services. There is a shop, and a car ferry visits the island from the mainland once a day.
Adicionar uma linha em branco permite que os tradutores saibam quando podem fazer uma pausa. Além disso, evita problemas com o wikitexto.
Palavras finais
Também é possível mover páginas traduzíveis, incluindo todas as suas traduções para um novo nome. Porque muitas páginas podem precisar ser movidas, esta operação não é instantânea. Você pode excluir a página inteira, incluindo todas as traduções, ou apenas uma versão traduzida de uma página. Você pode acessar essas funções a partir do mesmo lugar em que estão em todas as outras páginas.
A página especial Special:PageTranslation lista todas as páginas do sistema. Além de dar uma visão geral de todas as páginas traduzíveis, também é possível desencorajar páginas de tradução. Ela esconde a página da maioria das listas. Isso não impede fazer outras traduções.
Você já criou uma página traduzível e tentou de todas as ações comuns que podem ser executadas em páginas traduzíveis. Para mais informações, ou se você quiser entender a característica mais profundamente, por favor, continue lendo a documentação aprofundada do recurso de tradução de página. Ela também contém a discussão sobre as diferentes formas de relações de manipulação, categorias e modelos ou prós e contras do uso de unidades de tradução maiores ou menores.
A página especial tradução de página
Movendo uma página
Excluindo uma página
