<chapter id="translators">
<title>Guide pour la traduction des fichiers de &kturtle;</title>
<para>Comme vous le savez, l'unique particularité du langage &logo; est que les commandes &logo; peuvent être traduites dans votre propre langue. Ceci est plus facile pour qu'un enfant comprenne les commandes.
Pour une nouvelle langue, il y a trois fichiers à traduire&nbsp;: d'abord le fichier des mots-clés (ou commandes) puis le fichier de surbrillance syntaxique puis enfin les exemples.
</para>
<sect1 id="commands_trans">
<title>Comment traduite les mots-clés &logo; (commandes)</title>
<para>
Les fichiers de commandes sont situés dans <filename class="directory">kdeedu/kturtle/src/data/keywords/</filename>
Chaque fichier est nommé <filename>logokeywords.<replaceable>code</replaceable>.xml</filename>
où <replaceable>code</replaceable> est le code ISO de votre pays (veuillez noter que ce code <acronym>ISO</acronym> doit être un code valide).</para>
<para>
<itemizedlist>
<listitem><para>
Copiez le fichier <filename>logokeywords.en_US.xml</filename> en le renommant <filename>logokeywords.<replaceable>code</replaceable>.xml</filename>
où <replaceable>code</replaceable> est le code ISO de votre pays (le code <acronym>ISO</acronym> de 2 ou 4 lettres).
</para>
</listitem>
<listitem><para>Traduisez le contenu de la balise <sgmltag class="starttag">keyword</sgmltag> (par exemple l'information entre <sgmltag class="starttag">keyword</sgmltag>
et <sgmltag class="endtag">keyword</sgmltag>) dans votre langue chaque fois que c'est possible. Traduisez aussi le contenu de la balise <sgmltag class="starttag">alias</sgmltag>, (par exemple l'information entre <sgmltag class="starttag">alias</sgmltag> et <sgmltag class="endtag">alias</sgmltag>). Ces deux balises sont reliées car l'alias est la contraction du mot-clé.</para>
<para>
Traduisez par exemple <quote>while</quote> dans&nbsp;: <sgmltag class="starttag">keyword</sgmltag>while<sgmltag class="endtag">keyword</sgmltag>
</para>
<para>
Merci de ne rien traduire d'autre et veuillez ne pas traduire les mots anglais dans <sgmltag class="starttag">command name="mot_anglais"</sgmltag>. Ceci doivent rester en anglais.
</para>
</listitem>
<listitem><para>Enregistrez votre fichier avec l'encodage <acronym>UTF-8</acronym> (dans &kate;, utilisez <guimenuitem>Enregistrer sous...</guimenuitem> et assurez-vous d'avoir <guilabel>utf8</guilabel> dans la boîte déroulante à droite du nom de fichier).
</para>
</listitem>
<listitem><para>Faites un commit de votre fichier (ajouter le nom de fichier dans le fichier <filename>Makefile.am</filename>) ou envoyez-le à Anne-Marie.
</para>
</listitem>
<listitem><para>En cas de doute, merci de contacter Anne-Marie Mahfouf <email>annemarie.mahfouf@free.fr</email> pour plus d'information.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="examples_syntax">
<title>Comment traduire les fichiers de surbrillance syntaxique</title>
<para>Les fichiers de surbrillance syntaxique se trouve dans le répertoire <filename class="directory">kdeedu/kturtle/src/data/highlightstyles/</filename>.
Chaque fichier est nommé <filename>logohighlightstyle.<replaceable>code</replaceable>.xml</filename>
où <replaceable>code</replaceable> est le code <acronym>ISO</acronym> de votre pays (veuillez noter que ce code <acronym>ISO</acronym> doit être un code valide).
Veuillez aussi noter que le code de votre pays doit aussi être le même que pour le fichier <filename>logokeywords</filename> et pour le répertoire des exemples.
</para>
<para>
<itemizedlist>
<listitem><para>Copiez le fichier
<filename>logohighlightstyle.en_US.xml</filename> en le renommant

<filename>logohighlightstyle.<replaceable>code</replaceable>.xml</filename>
où <replaceable>code</replaceable> est le code de votre pays ( le code <acronym>ISO</acronym> de 2 ou 4 lettres)
</para></listitem>
<listitem><para>À la ligne 4 du fichier, se trouvent les mots suivants&nbsp;:
<sgmltag class="starttag">language name="en_US"</sgmltag>...: vous changez ici <quote>en_US</quote> pour mettre le code <acronym>ISO</acronym> de votre pays (2 ou 4 lettres).
</para></listitem>
<listitem><para>Traduisez ensuite dans votre langue le contenu des balises <sgmltag class="starttag">item</sgmltag> (par exemple l'information contenue entre <sgmltag class="starttag">item</sgmltag> et <sgmltag class="endtag">item</sgmltag>). Cette traduction doit correspondre à celle du fichier <filename>logokeyword</filename>.
Par exemple traduisez <quote>while</quote> dans&nbsp;: <sgmltag class="starttag">item</sgmltag> while <sgmltag class="endtag">item</sgmltag> et laissez les espaces blancs tels qu'ils sont à l'origine (un au début, un à la fin).
Merci de ne rien traduire d'autre.
</para></listitem>
<listitem><para>Enregistrez votre fichier avec l'encodage <acronym>UTF-8</acronym> (dans &kate;, utilisez <guimenuitem>Enregistrer comme...</guimenuitem> et choisissez <guilabel>utf8</guilabel> dans le menu déroulant à droite du nom de fichier).
</para></listitem>
<listitem><para>Faites un commit de votre fichier (ajouter le nom de fichier dans le fichier <filename>Makefile.am</filename>) ou envoyez-le à Anne-Marie.
</para></listitem>
<listitem><para>En cas de doute, merci de contacter Anne-Marie Mahfouf <email>annemarie.mahfouf@free.fr</email> pour plus d'information.
</para></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="examples_trans">
<title>Comment traduire les exemples</title>
<para>
Les exemples se trouvent dans la source de &kturtle; dans le répertoire <filename class="directory">kdeedu/kturtle/examples</filename>.
</para>
<para>
<itemizedlist>
<listitem><para>Créez un répertoire ayant pour nom le code <acronym>ISO</acronym> de votre pays.</para>
</listitem>
<listitem><para>Copiez les exemples anglais dans ce répertoire et renommez les fichiers en les traduisant. Cela va permettre aux utilisateurs de comprendre facilement et rapidement ce qu'est l'exemple.</para>
</listitem>
<listitem><para>Référez vous aux fichier <filename class="directory">kturtle/src/data/keywords/</filename> qui correspond à votre langue. Ce fichier doit être traduit avant de traduire les exemples. 
Remplacez dans les fichiers des exemples toutes les commandes en anglais par la traduction dans votre langue.</para>
</listitem>
<listitem><para>Enregistrez votre fichier avec l'encodage <acronym>UTF-8</acronym> (dans &kate;, utilisez <guimenuitem>Enregistrer sous...</guimenuitem> et choisissez <guilabel>utf8</guilabel> dans le menu déroulant à droite du nom de fichier)</para>
</listitem>
<listitem><para>Faites un commit de votre répertoire (ajoutez un fichier <filename>Makefile.am</filename> dedans) ou envoyez-le à Anne-Marie.</para>
</listitem>
<listitem><para>En cas de doute, merci de contacter Anne-Marie Mahfouf, <email>annemarie.mahfouf@free.fr</email> pour plus d'information.</para>
</listitem>
<listitem><para>Enfin, si vous le voulez, vous pouvez ajouter vos propres exemples dans ce répertoire.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

</chapter>