kturtle/scripts/README.scripts

   1 kturtle/scripts/
   2 this directory of the source version KTurtle contains two scripts that will make translating of KTurtle to other langauges much easier.
   3
   4 When translating KTurtle more than just the usual 'documantation and strings' have to be translated, namely:
   5 - the examples (which are *.logo files),
   6 - the logokeyword.*.xml files, and
   7 - the logohighlightstyle.*.xml files.
   8
   9 These files are called data files, and their English originals can be found in kdeedu/kturtle/data.
  10 For more information on these files and their translation read:
  11 kdeedu/kturtle/data/README.data
  12
  13 In this directory you find Rafael Beccar's nifty tranlaton perl scripts that can make translating KTurtle human resourcefriendly.
  14
  15 This is how these scripts work:
  16
  17 But only logokeywords.YOURLANGCODE.xml needs to be under current directory..
  18
  19 If everything is working fine the general process is something like:
  20
  21
  22 1. MANUALLY TRANSLATE THE KEYWORD
  23 Copy the logokeywords.en_US.xml file (from kdeedu/kturtle/data) to the kturtle directory in your branch of the kde-i18n module (for Dutch this would be: kde-i18n/nl/data/kdeedu/kturtle). Translate the file, and change the name to:
  24 logokeywords.YOURLANGCODE.xml
  25
  26
  27 2. AUTOMAGICALLY GENERATE THE HIGHLIGHTSTYLE FOR YOUR LANGUAGE
  28 - Copy logokeywords.YOURLANGCODE.xml to kdeedu/kturtle/scripts
  29 - change directory to kdeedu/kturtle/sripts, and run:
  30 ./i18n_highlighting.pl logokeywords.YOURLANGCODE.xml
  31 - Now you have a translated logohighlightstyle.YOURLANGCODE.xml under current directory (kdeedu/kturtle/scripts)
  32
  33
  34 3. AUTOMAGICALLY GENERATE NEARLY FINISHED TRANSLATIONS OF THE EXAMPLES
  35 - change directory to kdeedu/kturtle/scripts, and run:
  36 ./i18n_examples.pl logokeywords.YOURLANGCODE.xml
  37 - the translated examples can then be found in current directory. Some manual adjusments are
  38 needed, namely: the sings in the code and the comments
  39
  40
  41 4. LAST BUT NOT LEAST!!!    CHECK IF EVERYTHING WORKS
  42 - move all the generated files to the kturtle directory in your branch of the kde-i18n module
  43 - check if it installs correctly
  44 - check if the fresh logo examples in your language run when KTurtle is set to your language (see the Settings)
  45
  46
  47 Please report BUGs when it doesnt work (bugs.kde.org)!
  48
  49 Thanks for the efford, we love you!
  50
  51
  52
  53
  54
  55
  56