<chapter id="translators">
<title
>Guia do Tradutor do &kturtle;</title>
<para
>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. </para>
<sect1 id="commands_trans">
<title
>Como Traduzir as Palavras-Chave (Comandos) do &logo;</title>
<para
>Os ficheiros de comandos estão localizados em <filename class="directory"
>kdeedu/kturtle/src/data/keywords/</filename
> Cada ficheiro chama-se <filename
> logokeywords.<replaceable
>codigo</replaceable
>.xml</filename
> em que o <replaceable
>codigo</replaceable
> é o código <acronym
>ISO</acronym
> para o seu país (lembre-se que este tem de ser um código <acronym
>ISO</acronym
> válido).</para>
<para>
<itemizedlist>
<listitem
><para
>Copie o ficheiro <filename
>logokeywords.en_US.xml</filename
>, mudando o seu nome para <filename
>logokeywords.<replaceable
>codigo</replaceable
>.xml</filename
> em que o <replaceable
>codigo</replaceable
> é o código do seu país (para Portugal, é o <emphasis
>pt</emphasis
>). </para>
</listitem>
<listitem
><para
>Traduza para a sua própria língua o conteúdo da marca <sgmltag class="starttag"
>keyword</sgmltag
> i.e a informação entre o <sgmltag class="starttag"
>keyword</sgmltag
> e o <sgmltag class="endtag"
>keyword</sgmltag
> sempre que possível e o conteúdo da marca <sgmltag class="starttag"
>alias</sgmltag
>, i.e a informação entre o <sgmltag class="starttag"
>alias</sgmltag
> e o <sgmltag class="endtag"
>alias</sgmltag
>. Este conteúdo está relacionado, dado que o conteúdo do 'alias' é um nome alternativo ou atalho para a palavra-chave.</para>
<para
>Por exemplo, o <quote
>while</quote
> traduz-se em português para: <sgmltag class="starttag"
>keyword</sgmltag
>enquanto<sgmltag class="endtag"
>keyword</sgmltag
>. </para>
<para
>Por favor não traduza mais nada e não traduza as palavras em inglês no <sgmltag class="starttag"
>command name="palavra_em_ingles"</sgmltag
>. Estas terão de permanecer em Inglês. </para>
</listitem>
<listitem
><para
>Grave o seu ficheiro como <emphasis role="bold"
>UTF-8</emphasis
> (no &kate;, use o <guimenuitem
>Gravar Como...</guimenuitem
> e mude para <guilabel
>UTF-8</guilabel
> na lista à direita do nome do ficheiro). </para>
</listitem>
<listitem
><para
>Envie o seu ficheiro por CVS (adicione o nome do seu ficheiro ao <filename
>Makefile.am</filename
>) ou envie-o para a Anne-Marie. </para>
</listitem>
<listitem
><para
>Em caso de qualquer dúvida, por favor contacte a Anne-Marie Mahfouf <email
>annemarie.mahfouf@free.fr</email
> para mais informações.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="examples_syntax">
<title
>Como traduzir os ficheiros de realce de sintaxe</title>
<para
>Os ficheiros de realce de sintaxe estão localizados em <filename class="directory"
>kdeedu/kturtle/src/data/highlightstyles/</filename
>. Cada ficheiro chama-se <filename
>logohighlightstyle.<replaceable
>codigo</replaceable
>.xml</filename
> em que o <replaceable
>codigo</replaceable
> é o código <acronym
>ISO</acronym
> do seu país (lembre-se que tem de ser um código <acronym
>ISO</acronym
> válido). Para além disso, o código do país tem de ser o mesmo aqui e no ficheiro <filename
>logokeywords</filename
>, assim como também na pasta de exemplos. </para>
<para>
<itemizedlist>
<listitem
><para
>Copie o ficheiro <filename
>logohighlightstyle.en_US.xml</filename
>, mudando o nome dele para <filename
>logohighlightstyle.<replaceable
>codigo</replaceable
>.xml</filename
> em que o <replaceable
>codigo</replaceable
> é o código de 2 ou 4 letra <acronym
>ISO</acronym
> do seu país (no caso de Portugal, é o 'pt') </para
></listitem>
<listitem
><para
>A linha 4 do ficheiro, tem um <sgmltag class="starttag"
>language name="en_US"</sgmltag
> ..., o qual você deverá alterar para o código <acronym
>ISO</acronym
> da sua língua (<quote
>pt</quote
>, no caso do Português). </para
></listitem>
<listitem
><para
>Traduza para a sua própria língua o conteúdo da marca <sgmltag class="starttag"
>item&gt; i.e a informação entre o &lt;item</sgmltag
> e o <sgmltag class="endtag"
>item</sgmltag
>. Este conteúdo deverá ter uma correspondência ao ficheiro <filename
>logokeyword</filename
>. Por exemplo, traduza o <quote
>while</quote
> para: <sgmltag class="starttag"
>item</sgmltag
> enquanto <sgmltag class="endtag"
>item</sgmltag
> e deixe os espaços tal como estão (um no início e um no fim). Por favor não traduza mais nada. </para
></listitem>
<listitem
><para
>Grave o seu ficheiro como <emphasis role="bold"
>UTF-8</emphasis
> (no &kate;, use o <guimenuitem
>Gravar Como...</guimenuitem
> e mude para <guilabel
>UTF-8</guilabel
> na lista à direita do nome do ficheiro). </para
></listitem>
<listitem
><para
>Envie o seu ficheiro por CVS (adicione o nome do seu ficheiro ao <filename
>Makefile.am</filename
>) ou envie-o para a Anne-Marie. </para
></listitem>
<listitem
><para
>Em caso de qualquer dúvida, por favor contacte a Anne-Marie Mahfouf <email
>annemarie.mahfouf@free.fr</email
> para mais informações. </para
></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="examples_trans">
<title
>Como traduzir os exemplos</title>
<para
>Os exemplos localizam-se no código do &kturtle; na pasta <filename class="directory"
>kdeedu/kturtle/examples</filename
>. </para>
<para>
<itemizedlist>
<listitem
><para
>Crie uma pasta com o código <acronym
>ISO</acronym
> da sua língua como nome.</para>
</listitem>
<listitem
><para
>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.</para>
</listitem>
<listitem
><para
>Veja em <filename class="directory"
>kturtle/src/data/keywords/</filename
> 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.</para>
</listitem>
<listitem
><para
>Grave o seu ficheiro como <acronym
>utf-8</acronym
> (no &kate;, use o <guimenuitem
>Gravar Como...</guimenuitem
> e mude para <guilabel
>UTF-8</guilabel
> na lista à direita do nome do ficheiro)</para>
</listitem>
<listitem
><para
>Envie a sua pasta (adicione um <filename
>Makefile.am</filename
> dentro dela) ou envie-a para a Anne-Marie.</para>
</listitem>
<listitem
><para
>Em caso de alguma dúvida, por favor contacte a Anne-Marie Mahfouf, <email
>annemarie.mahfouf@free.fr</email
> para mais informações.</para>
</listitem>
<listitem
><para
>Finalmente, se você quiser, poderá adicionar os seus próprios exemplos nesta pasta.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

</chapter>