# Guide pour la traduction des fichiers de &kturtle;

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 : d'abord le fichier des mots-clés (ou commandes) puis le fichier de surbrillance syntaxique puis enfin les exemples.

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

Les fichiers de commandes sont situés dans `kdeedu/kturtle/src/data/keywords/` Chaque fichier est nommé `logokeywords.code.xml` où code est le code ISO de votre pays (veuillez noter que ce code ISO doit être un code valide).

- Copiez le fichier `logokeywords.en_US.xml` 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`). Ces deux balises sont reliées car l'alias est la contraction du 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"`. Ceci doivent rester en anglais.

- 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 surbrillance syntaxique

Les fichiers de surbrillance syntaxique se trouve dans le répertoire `kdeedu/kturtle/src/data/highlightstyles/`. Chaque fichier est nommé `logohighlightstyle.code.xml` où code est le code ISO de votre pays (veuillez noter que ce code ISO doit être un code valide). Veuillez aussi noter que le code de votre pays doit aussi être le même que pour le fichier `logokeywords` et pour le répertoire des exemples.

- Copiez le fichier `logohighlightstyle.en_US.xml` en le renommant

  `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 comme... et choisissez utf8 dans le menu déroulant à 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

Les exemples se trouvent dans la source de &kturtle; dans le répertoire `kdeedu/kturtle/examples`.

- Créez un répertoire ayant pour nom le code ISO de votre pays.

- 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.

- Référez vous aux fichier `kturtle/src/data/keywords/` 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.

- 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 répertoire (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 répertoire.