Orientações de Tradução¶

Primeira tradução¶

Para criar documentação primeiro é necessário criar os documentos rst. Um programa de pré-compilação cria os arquivos de tradução chamados de arquivos .po para o idioma inglês na pasta /QGIS-Documentation/i18n/en.

Estes “originais” são copiados pelo programa para as pastas i18n para os outros idiomas.

As instruções nos arquivos .po necessitam de ser traduzidos a partir do inglês para o idioma com uma ferramenta de edição de tradução. Existe uma ferramenta de tradução web chamada de pootle que queremos usar, mas ainda não está ativa. Contudo existe uma ferramenta excelente fornecida com as ferramentas de programação do Qt chamado de Qt Linguist.

Quando quiser contribuir, primeiro obtenha o arquivo .po e adicione as traduções para as instruções no arquivo .po.

Quando acabar o arquivo .po é posto no sítio certo e durante a próxima compilação o programa de compilação irá criar arquivos .mo perto dos arquivos .po.

Estes arquivos .mo são atualmente usados pelo programa para criar arquivos de saída traduzidos.

Atualizar traduções¶

Posteriormente o documento rst é atualizado e um novo arquivo .po é criado na parte inglesa. Os conteúdos deste novo arquivo serão juntos com os arquivos .po que já existem para cada idioma. Isto significa que quando um nova linha é adicionada a um documento rst que já está traduzida, apenas instruções novas/atualizadas são adicionadas ao arquivo .po traduzido e necessitam de ser traduzidas. A quantidade de trabalho para atualizar as traduções para as próximas versões do QGIS devem ser relativamente pequenas.

Traduções no Qt Linguist¶

Quando abre um arquivo .po no Qt Linguist pela primeira vez irá ver a seguinte janela:

Figure Translation 1:

Selecione o idioma para a tradução no menu linguist

O idioma Destino deverá ser preenchido corretamente. O idioma de Origem pode ser deixado como o idioma POSIX e País/Região em Qualquer País.

Quando carrega no botão [OK] o Qt Linguist é preenchido com as instruções e poderá começar a tradução, veja a Figure translation 2.

Figure Translation 2:

Tradução usando o menu linguist

No menu poderá ver os seguintes botões que devem ser usados.

• O Botão Tradução Concluída, é o botão mais importante. Se o item necessita de tradução, você introduz a tradução no campo de texto, e de seguida prima este botão. Se o item não for traduzido apenas deixe o campo de texto para uma tradução vazia e prima também este botão que indica que o item está concluído e pode continuar para o próxima item.

• O Botão Anterior, pode ser usado para ir para um anterior item de tradução.

• O Botão Seguinte, pode ser usado para ir para o próximo item de tradução.

• O Botão Seguinte A Fazer, salta a o primeiro item de tradução que necessita de tradução. É útil quando o documento original foi mudado e apenas algumas instruções novas/alteradas necessitam de ser traduzidas.

• O Botão Anterior A Fazer, faz uma procura para trás e salta para o primeiro item de tradução e vê se necessita de tradução.

Traduzir o manual¶

Agora iremos começar a traduzir o manual do plugin_heatmap !

Os primeiros dois itens não necessitam de ser traduzidos, apenas puxe o botão da barra de ferramentas que considera a tradução completa e salte para o próximo item.

Quando chegamos ao terceiro item nós veremos uma instrução interessante para traduzir:

The |heatmap| :sup:`Heatmap` plugin allows to create a heatmap from a point vector map. A heatmap is a raster map showing the density or magnitude of point related information. From the result "hotspots" can easily be identified.

Esta instrução contem duas instruções rst:

1. |heatmap| as palavras entre | são substituições e estas nunca devem ser traduzidas! Isto será substituido pelo o ícone do módulo de densidade!

2. A instrução :sup:`Mapa de Densidade` `` e ``:sup: são instruções de super posição e exibe o seguinte texto elevado. Iso é usado para mostrar janelas de textos explicativos que aparecem quando passa por cima do item da barra de ferramentas e isto pode ser diferente quando está atualmente a traduzir a aplicação QGIS. Neste caso não é!

Todos os outros textos nesta instrução podem ser traduzidos!

O quinto item de tradução contem um instrução rst :ref: que é comum ser usado para referir outra seção em outro lugar do manual! O texto seguido de uma instrução :ref: nunca deverá ser alterado porque é um identificador único!

First this core plugin needs to be activated using the Plugin Manager (see Section :ref:`load_core_plugin`). After activation the heatmap icon |heatmap| can be found in the Raster Toolbar.

Neste caso “load_core_plugin” é um identificador de referência único posicionado antes de um item rst que tem a legenda. A instrução ref será substítuida com o texto do cabeçalho e transformado numa hiperligação. Quando o cabeçalho desta referência fizer referência à sua tradução, todas as referências deste cabeçalho serão automaticamente traduzidas.

O próximo item contem a etiqueta rst :menuselection: seguida de texto que atualmente exibida num menu da aplicação QGIS, isto deve ser traduzido na aplicação e portando deverá ser alterado quando for o caso.

Select from menu :menuselection:`View -->` :menuselection:`Toolbars -->` :menuselection:`Raster` to activate the Raster Toolbar when it is not yet activated.

O item “Ver –>” acima está atualmente traduzido para “Beeld –>” porque esta é a tradução usada para Holandês localizada na aplicação QGIS.

Um pouco mais à frente nós encontramos um item de tradução um pouco mais díficil:

The |heatmap| :sup:`Heatmap` toolbutton starts the Dialog of the Heatmap plugin (see figure_heatmap_2_).

Possui uma referência para a figura figure_heatmap_2_, e como a referência para uma seção esta referência não deve ser alterada!! A definição em si da referência do documento rst não está incluída no arquivo .po e portanto não pode ser alterada. Isto significa que a referência para as figuras não podem ser traduzidas. Quando o HTML é criado irá ver figure_heatmap_2. Quando o documento PDF é criado a figure_heatmap_2_ será substítuida pelo número da figura.

O próximo item de tradução com atributos rst é o seguinte item:

**Input Point dialog**: Provides a selection of loaded point vector maps.

Não remova as estrelas na linha acima. Irá fazer com que o texto seja exibido em negrito. O texto em si é muitas vezes incluído na própria janela e pode ser traduzido na aplicação.

O seguinte item de tradução contém a etiqueta :guilabel: rst.

When the |checkbox| :guilabel:`Advanced` checkbox is checked it will give acces to additional advanced options.

O texto Avançado da etiqueta guilabel pode ser traduzido na aplicação QGIS e provavelmente necessita de ser alterado!

O seguinte item de tradução contém ``airports``. Os apóstrofes são usados desta forma para dar ao texto outro tipo de fonte de texto. Neste caso é um valor literal e não necessita de tradução.

For the following example, we will use the ``airports`` vector point layer from the QGIS sample dataset (see :ref:`label_sampledata`). Another exellent QGIS tutorial on making heatmaps can be found on `http://qgis.spatialthoughts.com <http://qgis.spatialthoughts.com/2012/07/tutorial-making-heatmaps-using-qgis-and.html>`_.

Este item também inclui uma hiperligação com um url e uma apresentação externa. O url deverá ser deixado intativo, poderá alterar o texto externo “http://qgis.spatialthoughts.com” que é visível no leitor. Nunca remova o underline no fim da hiperligação pois é a parte essencial!!

Sumário das Regras para a tradução¶

1. Não altera subsituições como |nix|

2. Não altere as referências que começam com um etiqueta :ref:

3. Não altere as referências que acabam com um underline como figure_1_

4. Não altere o url das hiperligações, mas pode mudar a descrição externa. Deixe o underline no fim da hiperligação

5. Altere os conteúdos de :sup:, :guilabel: e :menuselection:, Verifique se/como é traduzido na Aplicação QGIS.

6. O texto entre duas estrelas e apóstrofes duplos muitas vez indicam valores ou nomes de campos, umas vez precisam de ser traduzidos outras vezes não.

7. Tenha atenção no uso exato dos mesmos apóstrofes do texto fonte.

8. Não acabe as cadeias de texto traduzidas com um novo parágrafo, senão o texto não irá ficar traduzido durante a conversão para html.

Agarra-se às regras apresentadas em cima e o documento traduzido irá ficar muito bom!