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

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.

There is also a set of video tutorials that parallel part of this tutorial that you can use to help learn how to use the Translate extension:

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.

Here is the wikicode associated to it :

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. Go to the page  in your wiki (or a draft page) and click create.
 * 2. Paste the above content and save it.

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.

The page is ready for translation ? So let's see how to request translation :


 * 3. Edit
 * 4. Wrap the whole content inside  tags as shown below
 * 5. Save the page

 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. 

Você não precisa adicionar etiquetas a todos os elementos ou adicione marcadores como  ; 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.

There is also a view of the page translation page template; this will be covered in later steps. You can give names to the translation units, but in this example, we choose to stick with the defaults.


 * 6. Click the "Mark this page for translation" link
 * 7. Ensure that the page body is split into three units correctly
 * 8. Click the "Mark this version for translation" button (reminder: you have to be a Translation administrator for this)
 * 9. Return to the page

Now you will see a new link at the top, "Translate this page", that lets translators translate the page. You might have a look at the translation tutorial which uses this page as an example and try out few translations now. Then return here for the next step.

Understanding how changes are impacting translations and translations units
Tracking changes is a very important feature, so let's make some changes and see how it works. When you open the page for editing you will see that it has been modified with markers like. These are added by the extension and help it identify which unit is which. This allows you to rearrange and edit those units. When editing the page, the markers should be left alone and their position in relation to the unit they belong to should not be changed. When moving a unit, move the unit marker, too.

When deleting a unit, delete the marker too. When adding new paragraphs, new markers will be added by the software. Do not try to do this manually, it may confuse the software. Markers you have deleted will also be automatically deleted by the bot in the existing translations.

If you do minor changes to an existing translation unit (adding a few words or a link to a paragraph), keep the marker. If you change a whole paragraph (delete and rebuilt it), delete the marker. This way, translators will have different tasks, between reviewing a fuzzy translation or create a new translation.

let's modify something !
Here is what you will do :


 * 10. Make some additions as highlighted above
 * 11. Click the "marked for translation" link at the top
 * 12. Observe the changes
 * 13. Click the "Mark for translation" button (reminder: you have to be a Translation administrator for this)
 * 14. Return to the original page

If you made translations as suggested in the previous step, you can now see those translations linked at the top of the page. You will also see that the translation is not 100 % up to date. If you go to the translation view, you see that the unit is marked as in need of updating.

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.

Adding an image, a category and a list with translation markers
You have a basic translatable page now, but it is very dull. Let's add an image and some other stuff to make it look more like a normal wiki page and see how those elements interact with translation.

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. Add an image, a category and a list to the page as shown below
 * 16. Save the page
 * 17. Click the link "marked for translation" at the top of the page
 * 18. Verify that the changes look as intended
 * 19. Click the "Mark this version for translation" button
 * 20. Return to the translatable page

Documentar uma tradução
Allowing to translate only the picture title:

Or allowing to change the image file in the translated page (for localized version for exemple) and the title:

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. (reminder: the translation page template doesn't change between the different translated pages) 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. Click "Translate this page" link at the top
 * 22. Select "qqq - Page documentation" language
 * 23. Click the message name which contains the message "A typical view of Fréttinga"
 * 24. Write "Description of an image" and click "Save"

Now, the documentation "Description of an image" is shown next to the to-be-translated-title of the image.

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 as categorias
Neste exemplo, a atribuição de toda a categoria é uma unidade de tradução. Isso permite que tradutores a alterem para 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 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.

Operating on the whole page and its translations
It is also possible to move translatable pages including all their translations to a new name. Because many pages may need to be moved, this operation is not instant. You can delete either the whole page including all translations, or just one translated version of a page. You can access these functions from the same place they are on all other pages.

Managing all wiki's pages translations with Special pages
Special:PageTranslation lists all the pages in the system. Besides giving you an overview of all translatable pages, it is also possible to discourage pages from translation. This hides the page from most lists. It does not prevent further translations.

Now, you know !
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.

Going deeper ?
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.

Veja também

 * Help:Extension:Translate/Page translation administration