Translator's Guide to &kturtle; 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 kdeedu/kturtle/scripts, the files that needs translation can be found in kdeedu/kturtle/data, in those directories you also find README files which contains instructions for using/translating them. Creating a Directory to hold the Translated Files First, you need to create a directory to store the translated files. Create a directory called kde-i18n/code/data/kdeedu/kturtle/ in your KDE CVS directory, where code is your country code (the 2- or 4- letter ISO code). Copy the Makefile.am file from kdeedu/kturtle/data/ into this directory. Open it using your favorite text editor, replace all instances of en_US in the file with your country code (the one used above), and save the file. How To Translate the &logo; Keywords (commands) Copy the logokeywords.en_US.xml file from kdeedu/kturtle/data/ to the directory you have just created, and rename it to logokeywords.code.xml where code is your country code (the 2- or 4- letter ISO code). Translate the contents of the keyword tag (&ie; the information between keyword and keyword) into your own language wherever possible. Also, translate the contents of the alias tag, (&ie; the information between the alias and alias): these are used as shortcuts for the keyword. For example, translate while in: keywordwhilekeyword Please do not translate anything else and do not translate the English words in command name="english_word": these must stay in English. Last bit: do not change the order of this file, this is needed for Rafael Beccar's automatic translation generation scripts. 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 Translating the logohighlightstyle.en_US.xml is a breeze when using Rafael Beccar's script in kdeedu/kturtle/data/. Please make sure to read the README file in that directory. For backward compatibility with all people who do not want to the perl scripted blessing mentioned in the previous paragraph, here the old fashioned way of doing it: Copy the logohighlightstyle.en_US.xml file from kdeedu/kturtle/data/ to the directory you created to store the translated keywords file, and rename 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 do not 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 Again this task is simplified a lot by Rafael Beccar's script in kdeedu/kturtle/data/. 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. When you followed the instructions, 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 Makefile.am in kde-i18n/code/data/kdeedu/kturtle/ is updated according to the new files. For the Dutch the Makefile.am should look like this: 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) Here a description of how to do the translation WITHOUT the use of Rafael's perl scripts: Copy the English example files from kdeedu/kturtle/data/ to the directory used to store the translated keyword and hilighting files. Translate the filenames of the examples in your directory: this will allow users to easily and quickly understand what the example is about. Translate the keywords in the examples, using those in the logokeywords.xml for your language. The keywords file file must be done, first, before translating the examples. 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.