# Guia do Tradutor do &kturtle;

Como você sabe, a grande especificidade da linguagem &logo; é que os comandos de &logo; podem ser traduzidos para a sua própria língua. Isto facilita a uma criança perceber os comandos. Para uma língua nova, existem três ficheiros a traduzir: em primeiro lugar, o ficheiro de palavras-chave (ou comandos), depois o ficheiro 'logo-highlight-style' e finalmente os exemplos.

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

Os ficheiros de comandos estão localizados em `kdeedu/kturtle/src/data/keywords/` Cada ficheiro chama-se `logokeywords.codigo.xml` em que o codigo é o código ISO para o seu país (lembre-se que este tem de ser um código ISO válido).

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

- Traduza para a sua própria língua o conteúdo da marca `keyword` i.e a informação entre o `keyword` e o `keyword` sempre que possível e o conteúdo da marca `alias`, i.e a informação entre o `alias` e o `alias`. Este conteúdo está relacionado, dado 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 de permanecer em Inglês.

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

- Envie o seu ficheiro por CVS (adicione o nome do seu ficheiro 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 ficheiros de realce de sintaxe

Os ficheiros de realce de sintaxe estão localizados em `kdeedu/kturtle/src/data/highlightstyles/`. Cada ficheiro chama-se `logohighlightstyle.codigo.xml` em que o codigo é o código ISO do seu país (lembre-se que tem de ser um código ISO válido). Para além disso, o código do país tem de ser o mesmo aqui e no ficheiro `logokeywords`, assim como também na pasta de exemplos.

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

- A linha 4 do ficheiro, tem um `language name="en_US"` ..., o qual você deverá alterar para o código ISO da sua língua (pt, no caso do Português).

- Traduza para a sua própria língua 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 ficheiro `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.

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

- Envie o seu ficheiro por CVS (adicione o nome do seu ficheiro 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

Os exemplos localizam-se no código do &kturtle; na pasta `kdeedu/kturtle/examples`.

- Crie uma pasta com o código ISO da sua língua como nome.

- Copie os exemplos em Inglês desta pasta e mude os nomes dos ficheiros de acordo com a tradução para a sua língua. Isto permitirá aos utilizadores perceberem rápida e facilmente o objectivo do exemplo.

- Veja em `kturtle/src/data/keywords/` o ficheiro que corresponde à sua língua. O ficheiro terá de estar pronto antes de traduzir os exemplos. Substitua nos ficheiros de exemplo todas as palavras-chave em Inglês para as suas palavras-chave traduzidas.

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

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