<chapter id="translators">
<title
>Vertaalgids voor &kturtle;</title>
<para
>As you probably already know, the unique feature of the &logo; programming language is that the &logo; commands are often translated to language of the programmer. This takes away a barrier for some learners to understand the basics of programming. When translating &kturtle; to a new language some more files have to be translated in addition to the usual strings and documentation. Yet most it is autogenerated by Rafael Beccar's scripts. These scripts can be found in <userinput
>kdeedu/kturtle/scripts</userinput
>, the files that needs translation can be found in <userinput
>kdeedu/kturtle/data</userinput
>, in those directories you also find README files which contains instructions for using/translating them. </para>
 
<sect1 id="make_directory">
<title
>Een map aanmaken voor de vertaalde bestanden</title>
<para
>Eerst maakt u een map aan waarin de vertaalde bestanden zullen worden opgeslagen. Maak de map <filename class="directory"
>kde-i18n<replaceable
>code</replaceable
>/data/kdeedu/kturtle/</filename
> in uw KDE-CVS-map, waarbij u <replaceable
>code</replaceable
> vervangt door uw landcode (de 2- of 4-letterige <acronym
>ISO</acronym
>-code). </para>
<para
>Kopieer het bestand <filename
>Makefile.AM</filename
> vanuit <filename class="directory"
>kdeedu/kturtle/data</filename
> naar deze map. Open het met uw favoriete tekst-editor en vervang alle <quote
>en-US</quote
> in het bestand door uw taalcode (die u ook hierboven hebt gebruikt) en sla het bestand op. </para>
</sect1>
<sect1 id="commands_trans">
<title
>Hoe u de &logo;-sleutelwoorden (commando's) kunt vertalen</title>
<para>
<itemizedlist>
<listitem
><para
>Kopieer het bestand <filename
>logokeywords.en_US.xml</filename
> vanuit de map <filename class="directory"
>kdeedu/kturtle/data/</filename
> naar de map die u net hebt aangemaakt, en hernoem het bestand naar <filename
>logokeywords.<replaceable
>code</replaceable
>.xml</filename
>, waarbij <replaceable
>code</replaceable
> uw taalcode is. </para>
</listitem>
<listitem
><para
>Vertaal de inhoud van de tag <sgmltag class="starttag"
>keyword</sgmltag
> (dus de tekst tussen <sgmltag class="starttag"
>keyword</sgmltag
> en <sgmltag class="endtag"
>keyword</sgmltag
>) in uw eigen taal, voor zover dat mogelijk is. Vertaal ook de inhoud van de tag <sgmltag class="starttag"
>alias</sgmltag
> (dus de tekst tussen <sgmltag class="starttag"
>alias</sgmltag
> en <sgmltag class="endtag"
>alias</sgmltag
>). Beide zijn namelijk verwant aan elkaar omdat de alias een snelkoppeling is voor het sleutelwoord.</para>
<para
>Bijvoorbeeld voor een Nederlandse vertaling: vertaal de term <quote
>while</quote
> in <sgmltag class="starttag"
>keyword</sgmltag
>while<sgmltag class="endtag"
>keyword</sgmltag
> naar <quote
>terwijl</quote
> </para>
<para
>Vertaal a.u.b. de rest niet, en vertaal ook niet de Engelse woorden in <sgmltag class="starttag"
>command name="Engels woord"</sgmltag
>. Deze dienen in het Engels te blijven. </para>
<para
>Last bit: dont change the order of this file, this is needed for Rafael Beccar's automatic translation generation scripts. </para>
</listitem>
<listitem
><para
>Sla uw bestanden op met de tekenset <acronym
>UTF-8</acronym
> (in &kate;, gebruik menuoptie <guimenuitem
>Opslaan als...</guimenuitem
> en verander het spinveld rechtsboven in <guilabel
>utf-8</guilabel
>. </para>
</listitem>
<listitem
><para
>Commit uw bestand in &kde;'s cvs (vergeet niet om uw bestandsnaam toe te voegen aan het bestand <filename
>Makefile.am</filename
>), of stuur het naar Anne-Marie. </para>
</listitem>
<listitem
><para
>Mocht u twijfelen, neem contact op met Anne-Marie Mahfouf <email
>annemarie.mahfouf@free.fr</email
> voor meer informatie.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="examples_syntax">
<title
>Hoe u de bestanden met syntaxisaccentuering kunt vertalen</title>
<para
>Translating the <filename
>logohighlightstyle.en_US.xml</filename
> is a breeze when using Rafael Beccar's script in <filename class="directory"
>kdeedu/kturtle/data/</filename
>. Please make sure to read the README file in that directory. </para>
<para
>For backward compatibility with all people who dont want to the perl scripted blessing mentioned in the previous paragraph, here the old fashioned way of doing it: <itemizedlist>
<listitem
><para
>Kopieer het bestand <filename
>logohighlightstyle.en_US.xml</filename
> vanuit de map <filename class="directory"
>kdeedu/kturtle/data/</filename
> naar de map die u eerder hebt aangemaakt en hernoem het naar <filename
>logohighlightstyle.<replaceable
>code</replaceable
>.xml</filename
> waarbij u <replaceable
>code</replaceable
> vervangt door uw taalcode ( de 2- of 4-letterige <acronym
>ISO</acronym
>-code). </para>
</listitem>
<listitem
><para
>Op regel 4 in het bestand vindt u de tekst <sgmltag class="starttag"
>Language name="en_US"</sgmltag
>...: verander hier de term <quote
>en_US</quote
> naar de <acronym
>ISO</acronym
>-code van uw taal. </para
></listitem>
<listitem
><para
>Vertaal vervolgens de inhoud van de tags <sgmltag class="starttag"
>item</sgmltag
> (dus de tekst tussen <sgmltag class="starttag"
>item</sgmltag
> en <sgmltag class="endtag"
>item</sgmltag
>). Deze inhoud dient overeen te komen met het bestand <filename
>logokeyword</filename
>. Bijvoorbeeld, voor de Nederlandse vertaling vertaalt u <quote
>while</quote
> in <sgmltag class="starttag"
>item</sgmltag
> while <sgmltag class="endtag"
>item</sgmltag
> in <quote
>terwijl</quote
> en laat de spaties zoals ze zijn (een aan het begin en een aan het einde). Vertaal verder niets. </para
></listitem>
<listitem
><para
>Sla uw bestanden op met de tekenset <acronym
>UTF-8</acronym
> (in &kate;, gebruik menuoptie <guimenuitem
>Opslaan als...</guimenuitem
> en verander het spinveld rechtsboven in <guilabel
>utf-8</guilabel
>. </para
></listitem>
<listitem
><para
>Commit uw bestand in &kde;'s cvs (vergeet niet om uw bestandsnaam toe te voegen aan het bestand <filename
>Makefile.am</filename
>), of stuur het naar Anne-Marie. </para
></listitem>
<listitem
><para
>Mocht u twijfelen, neem contact op met Anne-Marie Mahfouf <email
>annemarie.mahfouf@free.fr</email
> voor meer informatie. </para
></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="examples_trans">
<title
>Hoe u de voorbeelden kunt vertalen</title>
<para
>Again this task is simplified a lot by Rafael Beccar's script in <filename class="directory"
>kdeedu/kturtle/data/</filename
>. Please make sure to read the README file in that directory, since some work still has to be done after the example logo files are autotranslated. </para>
<para
>When you followed the intrusctions, given in the README file that you found in the scripts directory, you should now be almost ready. Please do not forget to test the translated example logo code you created, since it is very common that an error sneaks in. Also make sure the <userinput
>Makefile.am</userinput
> in <filename class="directory"
>kde-i18n/<replaceable
>code</replaceable
>/data/kdeedu/kturtle/</filename
> is updated according to the new files. For the Dutch the <userinput
>Makefile.am</userinput
> should look like this: <screen
>txt_DATA = advertentie.logo driehoeken.logo krullen.logo tafels.logo \
bloem.logo driehoek.logo logohighlightstyle.nl.xml pijl.logo vierkanten.logo \
kleuren.logo logokeywords.nl.xml randomnaam.logo vierkant.logo
txtdir = $(kde_datadir)/kturtle/examples/nl

xml_DATA = logohighlightstyle.nl.xml
xmldir = $(kde_datadir)/katepart/syntax

keywords_DATA = logokeywords.nl.xml
keywordsdir = $(kde_datadir)/kturtle/data
EXTRA_DIST = $(txt_DATA) $(xml_DATA) $(keywords_DATA)
</screen
> 
</para>
<para
>Here a desciprtion of how to do the translation WITHOUT the use of Rafael's perl scripts: <itemizedlist>
<listitem
><para
>Kopieer de Engelse voorbeelden vanuit <filename class="directory"
>kdeedu/kturtle/data</filename
> naar deze map en vertaal de bestandsnamen in uw eigen taal. Zo kunnen de gebruikers beter zien waar het voorbeeld over gaat.</para>
</listitem>
<listitem
><para
>Vertaal de sleutelwoorden in de voorbeelden, waarbij u gebruik maakt van de vertalingen uit het bestand <filename
>logokeywords.xml</filename
> dat bij uw taal hoort. Voordat u de voorbeelden gaat vertalen dient dit bestand al vertaald te zijn.</para>
</listitem>
<listitem
><para
>Sla uw bestand op met tekenset <acronym
>UTF-8</acronym
> (in &kate; gebruik <guimenuitem
>Opslaan als...</guimenuitem
> en verander het spinveld rechts boven in <guilabel
>utf-8</guilabel
>).</para>
</listitem>
<listitem
><para
>Commit uw map in &kde;'s cvs (vergeet niet uw bestandsnaam toe te voegen aan het bestand <filename
>Makefile.am</filename
>, of stuur het aan Anne-Marie.</para>
</listitem>
<listitem
><para
>Bij twijfel, neem contact op met Anne-Marie Mahfouf, <email
>annemarie.mahfouf@free.fr</email
> voor meer informatie.</para>
</listitem>
<listitem
><para
>Tot slot kunt u uw eigen voorbeelden toevoegen aan deze map.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

</chapter>
