<chapter id="translators">
<title
>Översättningsguide för &kturtle;</title>
<para
>Som du vet är en unik egenskap hos programspråket &logo; att &logo;-kommandon kan översättas till ditt eget språk. Det gör det enklare för ett barn att förstå kommandona. Det finns tre filer att översätta för ett nytt språk: först filen med nyckelord (eller kommandon), därefter filen logo-highlight-style och till sist exemplen. </para>
<sect1 id="commands_trans">
<title
>Hur &logo;-nyckelord (kommandon) ska översättas</title>
<para
>Kommandofilerna finns i <filename class="directory"
>kdeedu/kturtle/src/data/keywords/</filename
>. Varje fil heter <filename
>logokeywords.<replaceable
>kod</replaceable
>.xml</filename
>, där <replaceable
>kod</replaceable
> är ISO-koden för ditt land (observera att detta måste vara en giltig <replaceable
>ISO</replaceable
>-kod).</para>
<para>
<itemizedlist>
<listitem
><para
>Kopiera filen <filename
>logokeywords.en_US.xml</filename
> genom att byta namn på den till <filename
>logokeywords.<replaceable
>kod</replaceable
>.xml</filename
>, där <replaceable
>kod</replaceable
> är din landskod (2 eller 4 bokstävers <acronym
>ISO</acronym
>-kod). </para>
</listitem>
<listitem
><para
>Översätt innehållet i taggen <sgmltag class="starttag"
>keyword</sgmltag
> till ditt eget språk, dvs. informationen mellan <sgmltag class="starttag"
>keyword</sgmltag
> och <sgmltag class="endtag"
>keyword</sgmltag
> när det är möjligt, och innehållet i taggen <sgmltag class="starttag"
>alias</sgmltag
>, dvs. informationen mellan <sgmltag class="starttag"
>alias</sgmltag
> och <sgmltag class="endtag"
>alias</sgmltag
>. Deras innehåll hör ihop på så sätt att alias är en förkortning av keyword.</para>
<para
>Översätt till exempel <quote
>while</quote
> i <sgmltag class="starttag"
>keyword</sgmltag
>while<sgmltag class="endtag"
>keyword</sgmltag
> </para>
<para
>Var snäll översätt inte något annat och översätt inte engelska ord i <sgmltag class="starttag"
>command name="engelskt_ord"</sgmltag
>. De måste förbli på engelska. </para>
</listitem>
<listitem
><para
>Spara filen som <acronym
>UTF-8</acronym
> (använd <guimenuitem
>Spara som...</guimenuitem
> i &kate; och byt till <guilabel
>utf8</guilabel
> i rutan till höger om filnamnet). </para>
</listitem>
<listitem
><para
>Arkivera filen (lägg till ditt filnamn i <filename
>Makefile.am</filename
>) eller skicka den till Anne-Marie. </para>
</listitem>
<listitem
><para
>Om det finns några tveksamheter, kontakta gärna Anne-Marie Mahfouf <email
>annemarie.mahfouf@free.fr</email
> för mer information.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="examples_syntax">
<title
>Hur filerna för syntaxfärgläggning ska översättas</title>
<para
>Filerna för syntaxfärgläggning finns i <filename class="directory"
>kdeedu/kturtle/src/data/highlightstyles/</filename
>. Varje fil heter <filename
>logohighlightstyle.<replaceable
>kod</replaceable
>.xml</filename
>, där <replaceable
>kod</replaceable
> är <acronym
>ISO</acronym
>-koden för ditt land (observera att detta måste vara en giltig <acronym
>ISO</acronym
>-kod). Observera att landskoden här måste vara samma som i filen <filename
>logokeywords</filename
> och i exempelkatalogen. </para>
<para>
<itemizedlist>
<listitem
><para
>Kopiera filen <filename
>logohighlightstyle.en_US.xml</filename
> genom att byta namn på den till <filename
>logohighlightstyle.<replaceable
>kod</replaceable
>.xml</filename
>, där <replaceable
>kod</replaceable
> är din landskod (2 eller 4 bokstävers <acronym
>ISO</acronym
>-kod). </para
></listitem>
<listitem
><para
>På rad 4 i filen finns <sgmltag class="starttag"
>language name="en_US"</sgmltag
>..., här ändrar du <quote
>en_US</quote
> till <acronym
>ISO</acronym
>-koden för ditt språk (2 eller 4 bokstäver). </para
></listitem>
<listitem
><para
>Översätt innehållet i taggen <sgmltag class="starttag"
>item</sgmltag
> till ditt eget språk (dvs. informationen mellan <sgmltag class="starttag"
>item</sgmltag
> och <sgmltag class="endtag"
>item</sgmltag
>). Innehållet måste stämma med filen <filename
>logokeyword</filename
>. Översätt till exempel <quote
>while</quote
> i <sgmltag class="starttag"
>item</sgmltag
> while <sgmltag class="endtag"
>item</sgmltag
> och lämna mellanslagen som de är (ett i början och ett i slutet). Var snäll och översätt ingenting annat. </para
></listitem>
<listitem
><para
>Spara filen som <acronym
>UTF-8</acronym
> (använd <guimenuitem
>Spara som...</guimenuitem
> i &kate; och byt till <guilabel
>utf8</guilabel
> i rutan till höger om filnamnet). </para
></listitem>
<listitem
><para
>Arkivera filen (lägg till ditt filnamn i <filename
>Makefile.am</filename
>) eller skicka den till Anne-Marie. </para
></listitem>
<listitem
><para
>Om det finns några tveksamheter, kontakta gärna Anne-Marie Mahfouf <email
>annemarie.mahfouf@free.fr</email
> för mer information. </para
></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="examples_trans">
<title
>Hur exemplen ska översättas</title>
<para
>Exemplen finns i &kturtle;s källkod under katalogen <filename class="directory"
>kdeedu/kturtle/examples</filename
>. </para>
<para>
<itemizedlist>
<listitem
><para
>Skapa en katalog med <acronym
>ISO</acronym
>-koden för ditt språk som namn.</para>
</listitem>
<listitem
><para
>Kopiera de engelska exemplen i katalogen och byt namn på filerna med översättningen till ditt språk. Det gör det möjligt för användare att enkelt och snabbt förstå vad exemplen handlar om.</para>
</listitem>
<listitem
><para
>Titta i <filename class="directory"
>kturtle/src/data/keywords/</filename
> efter filen som motsvarar ditt språk. Filen måste vara klar innan exemplen översätts. Ersätt alla engelska kommandon i filen med de översatta kommandona.</para>
</listitem>
<listitem
><para
>Spara filen som <acronym
>UTF-8</acronym
> (använd <guimenuitem
>Spara som...</guimenuitem
> i &kate; och byt till <guilabel
>utf8</guilabel
> i rutan till höger om filnamnet).</para>
</listitem>
<listitem
><para
>Arkivera katalogen (lägg till en <filename
>Makefile.am</filename
> i den) eller skicka den till Anne-Marie.</para>
</listitem>
<listitem
><para
>Om det finns några tveksamheter, kontakta gärna Anne-Marie Mahfouf, <email
>annemarie.mahfouf@free.fr</email
> för mer information.</para>
</listitem>
<listitem
><para
>Till sist, om du vill, kan du lägga till egna exempel i katalogen.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

</chapter>