# Translator's Guide to &kturtle;

As you know, the &logo; language great specificity is that the &logo; commands can be translated in your own language. This makes it easier for a child to understand the commands. For a new language, there are 3 files to translate: first the keywords file (or commands) then the logo-highlight-style file and finally the examples.

## How To Translate the &logo; keywords (commands)

The commands files are located in `kdeedu/kturtle/src/data/keywords/` Each file is named `logokeywords.`code`.xml` where `code` is the ISO code for your country (note that this must be a valid ISO code).

- Copy the `logokeywords.en_US.xml` file by renaming it to `logokeywords.`code`.xml` where `code` is your country code (the 2 or 4 letters ISO code).

- Translate the content of the `keyword` tag (&ie; the information between `keyword` and `keyword`) into your own language whenever it's possible. Also translate the content of the `alias` tag, (&ie; the information between the `alias` and `alias`). These contents are related as the alias is a shortcut for the keyword.

  For example translate while in: `keyword`while`keyword`

  Please don't translate anything else and don't translate English words in `command name="english_word"`. These must stay in English.

- Save your file as UTF-8 (in &kate;, use Save As... and change to utf8 in the box on the right of the file name).

- Commit your file (add your filename in the `Makefile.am`) or send it to Anne-Marie.

- In case of any doubt, please contact Anne-Marie Mahfouf annemarie.mahfouf@free.fr for more information.

## How To Translate the syntax highlighting files

The syntax highlighting files are located in `kdeedu/kturtle/src/data/highlightstyles/`. Each file is named `logohighlightstyle.`code`.xml` where `code` is the ISO code for your country (note that this must be a valid ISO code). Please note that the country code must be the same here than in the `logokeywords` file and for the example folder.

- Copy the `logohighlightstyle.en_US.xml` file by renaming it to `logohighlightstyle.`code`.xml` where `code` is your country code ( the 2- or 4-letter ISO code)

- In line 4 of the file, there is `language name="en_US"`...: here you change en_US to your language's ISO code (2 or 4 letters).

- Translate into your own language the content of the `item` tag (&ie; the information between `item` and `item`). This content must match the `logokeyword` file. For example translate while in: `item` while `item` and leave the spaces as they are (one at the beginning and one at the end). Please don't translate anything else.

- Save your file as UTF-8 (in &kate;, use Save As... and change to utf8 in the box on the right of the file name).

- Commit your file (add your filename in the `Makefile.am`) or send it to Anne-Marie.

- In case of any doubt, please contact Anne-Marie Mahfouf annemarie.mahfouf@free.fr for more information.

## How To Translate the examples

The examples are located in the &kturtle; source in the `kdeedu/kturtle/examples` folder.

- Create a folder with your language's ISO code as name.

- Copy the English examples in this folder and rename the files with your language translation. This will allow users to easily and quickly understand what the example is about.

- See in `kturtle/src/data/keywords/` the file corresponding to your language. This file must be done before translating the examples. Replace, in the example files, all English keywords with your translated keywords.

- Save your file as UTF-8 (in &kate;, use Save As... and change to utf8 in the box on the right of the file name)

- Commit your folder (add a `Makefile.am` inside) or send it to Anne-Marie.

- In case of any doubt, please contact Anne-Marie Mahfouf, annemarie.mahfouf@free.fr for more information.

- Finally, if you want, you can add your own examples in this folder.