# Guia do Tradutor do &kturtle;

Como você sabe, um dos grandes recursos da linguagem &logo; é que os comandos de &logo; podem ser traduzidos para o seu próprio idioma. Isto facilita a uma criança entender os comandos. Para habilitar um idioma novo, existem três arquivos a traduzir: em primeiro lugar, o arquivo de palavras-chave (ou comandos), depois o arquivo 'logo-highlight-style' e finalmente os exemplos.

## Criando um Dicionário para Guardar os Arquivos Traduzidos

Primeiro, você precisa criar uma pasta para guardar os arquivos traduzidos. Crie uma pasta chamada `kde-i18n/código/data/kdeedu/kturtle/` na sua pasta de CVS do KDE, onde o código é o código do seu país (o código ISO de 2 ou 4 letras).

Copie o arquivo `Makefile.am` de `kdeedu/kturtle/data/` para esta pasta. Abra-o com o seu editor de texto favorito, substitua todas as instâncias de en_US no arquivo pelo seu código de país (o que é usado acima) e grave o arquivo.

## Como Traduzir as Palavras-Chave (Comandos) do &logo;

- Copie o arquivo `logokeywords.en_US.xml`, mudando o seu nome para `logokeywords.codigo.xml` em que o codigo é o código do seu país (para o Brasil, é o br).

- Traduza para o seu próprio idioma o conteúdo da marca `keyword`, &ie; a informação entre o `keyword` e o `keyword` sempre que possível e o conteúdo da marca `alias`, &ie; a informação entre o `alias` e o `alias`. Estas informações estão relacionadas, uma vez que o conteúdo do 'alias' é um nome alternativo ou atalho para a palavra-chave.

  Por exemplo, o while traduz-se em português para: `keyword`enquanto`keyword`.

  Por favor não traduza mais nada e não traduza as palavras em inglês no `command name="palavra_em_ingles"`. Estas terão que permanecer em Inglês.

- Salve o seu arquivo como UTF-8 (no &kate;, use o Salvar Como... e mude para UTF-8 na lista à direita do nome do arquivo).

- Envie o seu arquivo por CVS (adicione o nome do seu arquivo ao `Makefile.am`) ou envie-o para a Anne-Marie.

- Em caso de qualquer dúvida, por favor contacte a Anne-Marie Mahfouf annemarie.mahfouf@free.fr para mais informações.

## Como Traduzir os Arquivos de Realce de Sintaxe

- Copie o arquivo `logohighlightstyle.en_US.xml`, mudando o nome dele para `logohighlightstyle.codigo.xml` em que o codigo é o código de 2 ou 4 letras ISO do seu país (no caso do Brasil, é o 'br').

- A linha 4 do arquivo, tem um `language name="en_US"` ..., o qual você deverá alterar para o código ISO do seu idioma (pt_BR, para o Português do Brasil).

- Traduza para o seu próprio idioma o conteúdo da marca `item` i.e a informação entre o `item` e o `item`. Este conteúdo deverá ter uma correspondência ao arquivo `logokeyword`. Por exemplo, traduza o while para: `item` enquanto `item` e deixe os espaços tal como estão (um no início e um no fim). Por favor não traduza mais nada.

- Salve o seu arquivo como UTF-8 (no &kate;, use o Salvar Como... e mude para UTF-8 na lista à direita do nome do arquivo).

- Envie o seu arquivo por CVS (adicione o nome do seu arquivo ao `Makefile.am`) ou envie-o para a Anne-Marie.

- Em caso de qualquer dúvida, por favor contacte a Anne-Marie Mahfouf annemarie.mahfouf@free.fr para mais informações.

## Como Traduzir os Exemplos

- Copie os exemplos em Inglês da pasta `kdeedu/kturtle/data/` e mude os nomes dos arquivos de acordo com a tradução para o seu idioma: isto permitirá aos usuários perceberem rápida e facilmente o objetivo do exemplo.

- Traduza as palavras-chave nos exemplos, usando as do `logokeywords.xml` para o seu idioma. O arquivo de palavras-chave deverá estar terminado, em primeiro lugar, antes de traduzir os exemplos.

- Salve o seu arquivo como utf-8 (no &kate;, use o Salvar Como... e mude para UTF-8 na lista à direita do nome do arquivo)

- Envie a sua pasta (adicione um `Makefile.am` dentro dela) ou envie-a para a Anne-Marie.

- Em caso de alguma dúvida, por favor contacte a Anne-Marie Mahfouf, annemarie.mahfouf@free.fr para mais informações.

- Finalmente, se você quiser, poderá adicionar os seus próprios exemplos nesta pasta.