Jump to content

Projects/Edu/KLettres

From KDE TechBase

HowTo add a new language to KLettres

Here is a an outline of what to do if you want to add your own language to KLettres. Please keep in mind that KLettres is meant to help learning the alphabet and the more useful syllables in your language. Maybe some letters of the alphabet are never pronounced so you can remove those.

You will need 2 sets of sounds, one for the alphabet and one for the syllables, one file with the data, and one file with the special characters in your language, if there are any.

Recording the Sounds

  • Put each sound in a file, wav, ogg or mp3. ogg is better as it's free (versus mp3) the alphabet sounds can be stored as a-0.ogg, a-1.ogg, etc. or a.ogg, b.ogg etc. the syllables sounds can be stored as ad-0.ogg, ad-1.ogg and so on or ba.ogg, bi.ogg, etc.., but use only lower ascii characters for the file names.
  • Each sound needs to be 1.5 to 2 seconds. If shorter, it will not play. Please add blank if necessary.
  • Place all the alphabet sounds in a folder named alpha and all syllables sounds in a folder named syllab

Write sounds.xml

  • Create a text file sounds.xml, preferably using Kate as editor or another editor capable of different encoding. In this file, write all the alphabet sounds and syllable sounds you recorded, like this example for the czech language:
<klettres>
 <language code="cs">
  <menuitem> <label>&Czech</label>
  </menuitem>
  <alphabet>
   <sound name="A" file="cs/alpha/a.ogg" />
     ...
  </alphabet>
  <syllables>
   <sound name="BA" file="cs/syllab/ba.ogg" />
     ...
  </syllables>
 </language>
</klettres>
  • Replace "cs" with the two letter code and "Czech" with the name of your language. Write the sound names with the special characters of your language in upper case in utf8.

Write <language>.txt file

  • Create a text file cs.txt (replace "cs" with the two letter code of your language) with each special character in your language in upper case on one line. And save both text files with utf8 encoding (upper right dropbox in kate allows that)

Send me a tar Package

  • tar the 2 sounds directories plus the 2 text files and please send them to AT kde DOT org | that address
  • I will then place the sounds in the corresponding i18n module and also on the KLettres website so they will be available via File -> Get A New Language in KLettres.

Good luck and thanks a lot!