# Guide pour la traduction des fichiers de &kturtle;

Comme vous le savez probablement déjà, la caractéristique unique du langage de programmation &logo; est que les commandes &logo; sont souvent traduites dans la langue du programmeur. Ceci casse une barrière pour certains apprenants pour comprendre les bases de la programmation. Lorsque &kturtle; est traduit dans une autre langue, quelques fichiers doivent être traduits en plus des chaînes traditionnelles de l'interface graphique et de la documentation. Ces fichiers sont générés automatiquement par les scripts de Rafael Beccar. Ces scripts se trouvent dans `kdeedu/kturtle/scripts`, et les fichiers à traduire se trouvent dans`kdeedu/kturtle/data`. Vous trouverez également dans ces dossiers des fichiers README qui contiennent des instructions pour les utiliser et les traduire.

## Création d'un dossier pour accueillir les fichiers traduits

Vous devez d'abord créer un dossier afin de stocker les fichiers traduits. Créez un dossier nommé `kde-i18n/code/data/kdeedu/kturtle/` dans votre dossier CVS de KDE, ou code est le code de votre pays (le code ISO à deux ou quatre lettres).

Copiez le fichier `Makefile.am` depuis `kdeedu/kturtle/data/` dans ce dossier. Ouvrez-le avec votre éditeur de texte favori, remplacez toutes les instances de en_US dans le fichier par le code de votre pays (celui utilisé plus haut) et enregistrez le fichier.

## Comment traduire les mots-clés &logo;(commandes)

- Copiez le fichier `logokeywords.en_US.xml` depuis `kdeedu/kturtle/data/` dans le dossier que vous venez juste de créer, en le renommant `logokeywords.code.xml` où code est le code ISO de votre pays (le code ISO de 2 ou 4 lettres).

- Traduisez le contenu de la balise `keyword` (par exemple l'information entre `keyword` et `keyword`) dans votre langue chaque fois que c'est possible. Traduisez aussi le contenu de la balise `alias`, (par exemple l'information entre `alias` et `alias`) : ils sont utilisés comme raccourcis pour le mot clé.

  Traduisez par exemple while dans : `keyword`while`keyword`

  Merci de ne rien traduire d'autre et veuillez ne pas traduire les mots anglais dans `command name="mot_anglais"`. Ceux-ci doivent rester en anglais.

  Dernière chose : ne modifiez pas l'ordre dans ce fichier, ceci est nécessaire pour le script de génération automatique de traduction de Rafael Beccar.

- Enregistrez votre fichier avec l'encodage UTF-8 (dans &kate;, utilisez Enregistrer sous... et assurez-vous d'avoir utf8 dans la boîte déroulante à droite du nom de fichier).

- Faites un commit de votre fichier (ajouter le nom de fichier dans le fichier `Makefile.am`) ou envoyez-le à Anne-Marie.

- En cas de doute, merci de contacter Anne-Marie Mahfouf annemarie.mahfouf@free.fr pour plus d'information.

## Comment traduire les fichiers de coloration syntaxique

Traduire le fichier `logohighlightstyle.en_US.xml` est simple comme bonjour en utilisant le script de Rafael Beccar dans `kdeedu/kturtle/data/`. Nous vous recommandons de lire le fichier README qui se trouve dans ce dossier.

Pour des raisons de compatibilité descendante avec toutes les personnes qui ne souhaitent pas utiliser les bienfaits du scripts perl mentionné au paragraphe précédent, voici la vieille méthode pour y parvenir :

- Copiez le fichier `logohighlightstyle.en_US.xml` depuis `kdeedu/kturtle/data/` dans le dossier que vous avez créé pour accueillir les fichiers de mots clés traduits, et renommez-le `logohighlightstyle.code.xml` où code est le code de votre pays (le code ISO de 2 ou 4 lettres).

- À la ligne 4 du fichier, se trouvent les mots suivants : `language name="en_US"`... : vous changez ici en_US pour mettre le code ISO de votre pays (2 ou 4 lettres).

- Traduisez ensuite dans votre langue le contenu des balises `item` (par exemple l'information contenue entre `item` et `item`). Cette traduction doit correspondre à celle du fichier `logokeyword`. Par exemple traduisez while dans : `item` while `item` 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.

- Enregistrez votre fichier avec l'encodage UTF-8 (dans &kate;, utilisez Enregistrer sous... et assurez-vous d'avoir utf8 dans la boîte déroulante à droite du nom de fichier).

- Faites un commit de votre fichier (ajouter le nom de fichier dans le fichier `Makefile.am`) ou envoyez-le à Anne-Marie.

- En cas de doute, merci de contacter Anne-Marie Mahfouf annemarie.mahfouf@free.fr pour plus d'information.

## Comment traduire les exemples

Encore une fois cette tâche est grandement simplifiée par le script de Rafael Beccar dans `kdeedu/kturtle/data/`. Lisez le fichier README dans ce dossier, puisqu'il reste des choses à faire après la traduction automatique des fichiers d'exemple logo.

Une fois que vous avez suivi les isntructions, données dans le fichier README que vous avez trouvé dans le dossier des scripts, vous devriez être prêt maintenant. N'oubliez pas de tester le code logo de l'exemple traduit, il arrive souvent qu'une erreur s'y soit glissée. Assurez-vous également que le fichier `Makefile.am` dans `kde-i18n/code/data/kdeedu/kturtle/` est bien mis à jour par rapport aux nouveaux fichiers. Pour le français, le fichier `Makefile.am` devrait ressembler à ceci :

    txt_DATA = triangle.logo carre.logo enroule.logo exemple1.logotxtdir = $(kde_datadir)/kturtle/examples/fr_FRxml_DATA = logohighlightstyle.fr_FR.xmlxmldir = $(kde_datadir)/katepart/syntaxkeywords_DATA = logokeywords.fr_FR.xmlkeywordsdir = $(kde_datadir)/kturtle/dataEXTRA_DIST = $(txt_DATA) $(xml_DATA) $(keywords_DATA)

Voici une description sur la façon de traduire SANS utiliser les scripts perl de Rafael :

- Copiez les exemples anglais dans depuis `kdeedu/kturtle/data/` dans le dossier que vous avez utilisé pour stocker les fichiers de mots clés et de coloration syntaxique traduits. Traduisez les noms de fichiers dans votre dossier : Cela va permettre aux utilisateurs de comprendre facilement et rapidement ce qu'est l'exemple.

- Traduisez les mots clés dans les exemples, en utilisant ceux de `logokeywords.xml` pour votre langue. Les fichiers de mots clés doit être traduit avant les exemples.

- Enregistrez votre fichier avec l'encodage UTF-8 (dans &kate;, utilisez Enregistrer sous... et choisissez utf8 dans le menu déroulant à droite du nom de fichier)

- Faites un commit de votre dossier (ajoutez un fichier `Makefile.am` dedans) ou envoyez-le à Anne-Marie.

- En cas de doute, merci de contacter Anne-Marie Mahfouf, annemarie.mahfouf@free.fr pour plus d'information.

- Enfin, si vous le voulez, vous pouvez ajouter vos propres exemples dans ce dossier.