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.

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 summer time. == Services == It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day.
 * 1. Vá até a página Fréttinga no seu wiki e clique em Criar.
 * 2. Cole o conteúdo acima e salve-o.

Passo 2: Preparação
Agora temos uma página com algum texto. Se a página ainda vai ser sujeita a muitas mudanças, 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 muito trabalho para os tradutores, pois terão de acompanhar todas as mudanças.

&lt;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 summer time. == Services == It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day. &lt;/translate>
 * 3. Edite Fréttinga
 * 4. Envolva todo o conteúdo dentro das tags &lt;translate>...&lt;/translate> como mostrado abaixo
 * 5. Salve a página

Passo 3: Habilitando as traduções
Depois de salvar a página, você verá um link no topo da página dizendo "Marque 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 for um administrador de tradução). Clique nesse link. 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 princípios itens de páginas traduzíveis: cada unidade é independente, que pode e deve ser traduzida como um todo; 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. Eles são adicionados pela extensão e ajudam você 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. Quando mover uma unidade, mova o marcador da unidade, também. Ao excluir uma unidade, excluir o marcador também. Ao adicionar novos parágrafos, novos marcadores serão adicionados pelo software. Não tente fazer isso manualmente, pode confundir o software. &lt;languages /> &lt;translate> &lt;!--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 summer time. It has marvelous beaches with a lot of seagulls. == Services == &lt;!--T:2--> &lt;!--T:3--> It doesn't have many services. There is a shop and car ferry visits the island from mainland once a day. In 2009 January the roof of the church in the island fell down. It was rebuilt collaboratively in the following summer. &lt;/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

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 look at the translated version, you will see the new paragraph in English, and the changed paragraphs are replaced with the English text. If you go to the translation view, you see that the unit is marked as in need of updating.

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.

&lt;languages /> &lt;translate> &lt;!--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 summer time. It has marvelous beaches with a lot of seagulls. == Services == &lt;!--T:2--> &lt;!--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 &lt;/translate>
 * 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

Here you can see that we left most of the image markup outside of a translation unit and have it in the translation page template instead. This is usually okay, but sometimes translators may want to change the image, especially if it contains linguistic content (text). In those cases it's usually easiest to include the whole markup in a unit (as we did for the category). When the translation of a unit involves or interacts with markup it's a good idea to write a small tip to the translators about it. You can do this with the following steps.


 * 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"

In this example, the whole category assignment is a translation unit. This lets translators change it to or whatever naming convention you want to use for categories. If it were outside the translation template, you would have all the pages Foo, Foo/de, Foo/ru, Foo/ta and so on in the same category. Sometimes this is okay, but usually it distracts the users. Make sure your translators know what the local convention is.

Similarly, for links there are many ways to do it. We used " Special:MyLanguage/Seagull ", which automatically redirects to the translated version of the page depending on the users' interface language (if that translation exists). This isn't an ultimate solution, because users will always be redirected to the interface language they're using, not to the language they are currently reading. Special:MyLanguage also interferes with Special:WhatLinksHere and makes it not work. The good thing about Special:MyLanguage is that you always get some version of the page, even if the requested translation doesn't exist.

Palavras finais
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.

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.

You have now created a translatable page and tried all of the common actions that can be performed on translatable pages. For more information, or if you want to understand the feature more deeply, please continue reading on the in-depth documentation of page translation feature. It also contains discussion about different ways of handling links, categories and templates, or pros and cons of using larger or smaller translation units.