doc/klettres/index.docbook

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
   3  "dtd/kdex.dtd" [
   4   <!ENTITY kappname "&klettres;"><!-- replace klettres here -->
   5   <!ENTITY package "kdeedu">
   6   <!ENTITY % addindex "IGNORE">
   7   <!ENTITY % English "INCLUDE"><!-- change language only here -->
   8 ]>
   9
  10 <book lang="&language;">
  11
  12 <bookinfo>
  13 <title>The &klettres; Handbook</title>
  14
  15 <authorgroup>
  16 <author>
  17 <firstname>Anne-Marie</firstname>
  18 <othername></othername>
  19 <surname>Mahfouf</surname>
  20 <affiliation>
  21 <address><email>annma@kde.org</email></address>
  22 </affiliation>
  23 </author>
  24 </authorgroup>
  25
  26 <copyright>
  27 <year>2001</year>
  28 <holder>Anne-Marie Mahfouf</holder>
  29 </copyright>
  30 <legalnotice>&FDLNotice;</legalnotice>
  31
  32 <date>2005-03-15</date>
  33 <releaseinfo>1.4</releaseinfo>
  34
  35 <abstract>
  36 <para>
  37 &klettres; is an application specially designed to do help the user
  38 to learn alphabet in a new language and then to learn to read simple syllables.
  39 The user can be a young child aged from two and a half or an adult that wants to learn
  40 the basics of a foreign language. </para>
  41 <para>
  42 Ten languages are available at the moment: Czech, Danish, Dutch, English, French, Italian, Luganda, Romanized Hindi, Spanish and Slovak but only English, French and your language if it is among those are installed by default.
  43 </para>
  44 <para>
  45 &klettres; is really easy to use. The language can be changed using the Languages menu. The user can also choose the Level from 1 to 4 in a drop-down box in the toolbar or via the Level menu. Themes (background and font color) can be changed in a drop down box or in the <guimenu>Look</guimenu> -&gt;<guimenuitem>Themes</guimenuitem> menu. Three themes are available: classroom, arctic and desert. Finally, the mode can be changed from kid to grown-up using the <guimenu>Look</guimenu> -&gt; <guimenuitem>Mode</guimenuitem> menu.
  46 </para>
  47
  48 </abstract>
  49
  50 <keywordset>
  51 <keyword>KDE</keyword>
  52 <keyword>kdeedu</keyword>
  53 <keyword>klettres</keyword>
  54 <keyword>alphabet</keyword>
  55 <keyword>Czech</keyword>
  56 <keyword>Danish</keyword>
  57 <keyword>Dutch</keyword>
  58 <keyword>English</keyword>
  59 <keyword>French</keyword>
  60 <keyword>Italian</keyword>
  61 <keyword>Romanized Hindi</keyword>
  62 <keyword>Spanish</keyword>
  63 <keyword>Slovak</keyword>
  64 <keyword>Luganda</keyword>
  65 <keyword>language</keyword>
  66 </keywordset>
  67
  68 </bookinfo>
  69
  70 <chapter id="introduction">
  71 <title>Introduction</title>
  72
  73 <para>&klettres; is a very simple application that helps a child or an
  74 adult to learn the alphabet and some simple sounds in his own language
  75 or in another language.  The program picks up a letter or a syllable
  76 in random, this letter/syllable is displayed and the sound is played.
  77 The user should then type this letter or syllable. Training is done in
  78 the levels where the letter/syllable is not displayed, only the sound
  79 is played. The user does not need to know how to use the mouse, the
  80 keyboard only is needed.</para>
  81
  82 <para>There are ten languages available at the moment: Czech, Danish, Dutch, English, French, Italian, Luganda, Romanized Hindi, Spanish and Slovak. If your KDE language is Czech, Danish, Dutch, English, French, Italian, Spanish or Slovak then your language is taken as default, optherwise French is the default. You can easily get any additional available language by using the <guimenu>File</guimenu> menu and <guimenuitem>Get Alphabet in New Language...</guimenuitem> menu item, provided that your computer is connected to the internet.</para>
  83
  84 <note><para>&klettres; needs &arts; running for the sound</para></note>
  85
  86 <para>Two different modes allow you to adapt &klettres; to
  87 your need and have the full usual interface or a stripped interface. For a child, the menu bar is no longer
  88 visible. We assume that a child will not want to set the language
  89 himself.  A drop-down box allows him to choose the different levels. For an
  90 older user, the background is not so childish and the menuBar is
  91 present in the Grown-Up style. Three different themes (classroom, arctic and desert) set up a different background with different fonts.</para>
  92
  93 <note>
  94 <para>You do not need the language keyboard layout anymore as you can use the Special Characters Toolbar to type any special character in each language. In the <guimenu>Settings</guimenu> menu, <guimenuitem>Toolbars</guimenuitem>, select Show Characters and the toolbar will appear at the bottom of &klettres;. Click on the letter you want and it will be shown in the input field. This toolbar can be dragged anywhere on your screen.</para>
  95 <para>
  96 If you prefer having the language keyboard layout, please use &kcontrol;, in the
  97 section <guimenu>Peripherals</guimenu> and submenu
  98 <guimenuitem>Keyboard</guimenuitem> in order to set the correct keyboard layout.</para>
  99 </note>
 100 </chapter>
 101
 102 <chapter id="using-klettres">
 103 <title>Using &klettres;</title>
 104 <para>&klettres; has 4 levels. Levels 1 and 2 deal with the alphabet and
 105 levels 3 and 4 concern syllables. For a very young child (2 1/2 to 4), I would
 106 suggest that he/she is sitting on your lap in front of the computer and
 107 that you do the game together.</para>
 108
 109 <sect1 id="levels1-and2">
 110 <title>Levels 1 and 2</title>
 111
 112 <screenshot>
 113 <screeninfo>Screenshot of &klettres; Level 1</screeninfo>
 114         <mediaobject>
 115           <imageobject>
 116             <imagedata fileref="klettres1.png" format="PNG"/>
 117           </imageobject>
 118            <textobject>
 119             <phrase>&klettres; level1</phrase>
 120           </textobject>
 121         </mediaobject>
 122 </screenshot>
 123
 124 <para>Level is Level 1, language is French, theme is desert
 125 and mode is <emphasis>grown-up</emphasis>.</para>
 126 <note>
 127 <para>
 128 If your KDE language is set to Czech, Danish, Dutch, English, French, Italian, Spanish or Slovak, then this will be the default language the first time you run KLetttres. For other languages, French is the default. &klettres; comes with French and your default language if among those listed above and you can get additional languages via <guimenu>File</guimenu> <guimenuitem>Get A New Language...</guimenuitem> provided you have an internet connection.
 129 </para>
 130 </note>
 131 <para>
 132 In level 1, the user sees the letter and hears the sound. He then has to type in the letter in the box. If it is correct, the next letter appears (without having to press <keycap>Enter</keycap> or whatever). If the user types the wrong letter, he hears the sound again. In this level, the user memorizes the letters, associates them with their sound and recognizes them on the keyboard.
 133 </para>
 134
 135 <note>
 136 <para>The user can type in either lower or upper case letters. The letters are automatically put in upper case so
 137 that a child will match them with the keyboard. He can type only one letter at a
 138 time.</para>
 139 <para>When you type a letter in the input field, there is no need to press <keycap>Enter</keycap> and the program waits for a short while before testing if the letter is right. This short wait is to leave time to a young child to understand what he/she just typed, especially if this is the wrong letter. You can change this time by using the <guimenu>Settings</guimenu> menu, <guimenuitem>Configure &klettres;...</guimenuitem>and the Timer tab which will bring you a dialog where you can set two different times: one for the kid mode and one for the grown-up mode.
 140 </para>
 141 </note>
 142
 143 <para>
 144 After the first time, the language setting is saved in a configuration file
 145 on closing of &klettres; and loaded the next time, with the level you were in.
 146 </para>
 147 <para>The mode (kid or grown-up) is saved in the config file and therefore
 148 is kept until you change.</para>
 149 <para>The letters appear in random order. They are not the same consecutively. </para>
 150
 151 <para>
 152 <screenshot>
 153 <screeninfo>Screenshot of &klettres; Level 2</screeninfo>
 154         <mediaobject>
 155           <imageobject>
 156             <imagedata fileref="klettres2.png" format="PNG"/>
 157           </imageobject>
 158            <textobject>
 159             <phrase>&klettres; level2</phrase>
 160           </textobject>
 161         </mediaobject>
 162 </screenshot>
 163 </para>
 164 <para>Here is a screenshot of Level 2 with the <emphasis>kid</emphasis> mode, <emphasis>classroom</emphasis> theme and Danish language.</para>
 165
 166 <para>Clicking in the <guilabel>Level</guilabel> combo-box and choosing <guilabel>Level
 167 2</guilabel> or using the <guimenu>Levels</guimenu> menu brings you to level 2. In that level, the user only
 168 hears the sound of the letter and has to type in the letter. If he
 169 is wrong, the letter appears to help him. </para>
 170 </sect1>
 171
 172 <sect1 id="levels3-and4">
 173 <title>Levels 3 and 4</title>
 174
 175 <para>
 176 <screenshot>
 177 <screeninfo>Screenshot of &klettres; Level 3</screeninfo>
 178         <mediaobject>
 179           <imageobject>
 180             <imagedata fileref="klettres3.png" format="PNG"/>
 181           </imageobject>
 182            <textobject>
 183             <phrase>&klettres; level3</phrase>
 184           </textobject>
 185         </mediaobject>
 186 </screenshot>
 187 </para>
 188
 189 <para>Here you can see &klettres; level 3, <emphasis>grown-up</emphasis> mode, <emphasis>arctic</emphasis> theme and Czech language.
 190 </para>
 191
 192 <para>
 193 In level 3, the user sees the syllable and hears the sound. He then
 194 has to type in the letters in the box. If the first letter of the
 195 sound is wrong, the user cannot type in the second one. The letter
 196 disappears and he has to try again. The number of letters is two or
 197 three, it depends of the language.</para>
 198
 199 <screenshot>
 200 <screeninfo>Screenshot of &klettres; Level 4</screeninfo>
 201         <mediaobject>
 202           <imageobject>
 203             <imagedata fileref="klettres4.png" format="PNG"/>
 204           </imageobject>
 205            <textobject>
 206             <phrase>&klettres; level4</phrase>
 207           </textobject>
 208         </mediaobject>
 209 </screenshot>
 210
 211 <para>Here you can see &klettres; level 4, <emphasis>kid</emphasis> mode, <emphasis>desert</emphasis> theme and Slovak language.
 212 </para>
 213
 214 <para>The sounds appear in random order. </para> <para>Clicking in the
 215 <guilabel>Level</guilabel> combo-box or using the <guimenu>Level</guimenu> menu in the menuBar
 216 and choosing <guilabel>Level 4</guilabel> brings you
 217 to level 4. In that level, the user only hears the sound of the
 218 syllable and has to type in the letters. This level is quite difficult
 219 for a young child. </para>
 220
 221 </sect1>
 222
 223 <sect1 id="about-font">
 224 <title>About fonts</title>
 225
 226 <para>
 227 There is one more setting you can change: the font that displays the letters. In some distribution, the default font used from the system is really ugly. In grown-up mode, in the <guimenu>Settings</guimenu> menu, in <guimenuitem>Configure &klettres;...</guimenuitem> you will find a Fonts tab with a font chooser dialog. The new font will be applied to both the displayed letter/syllable and the user field.
 228 </para>
 229
 230 <warning>
 231 <para>
 232 Changing font is also nice as some fonts (Helvetica for example) do not display correctly East-European languages as Czech and Slovak. If some letters or syllables are not displayed, please change the font and choose Arial for example.
 233 </para>
 234 </warning>
 235
 236 <para>
 237 You can also choose here the size you like the best.
 238 </para>
 239
 240 <screenshot>
 241 <screeninfo>Screenshot of &klettres; Font Chooser Dialog</screeninfo>
 242         <mediaobject>
 243           <imageobject>
 244             <imagedata fileref="klettres5.png" format="PNG"/>
 245           </imageobject>
 246            <textobject>
 247             <phrase>&klettres; Font Chooser Dialog</phrase>
 248           </textobject>
 249         </mediaobject>
 250 </screenshot>
 251
 252 <para>Here you can see &klettres; Font Chooser Dialog.
 253 </para>
 254
 255 </sect1>
 256 </chapter>
 257
 258 <chapter id="commands">
 259 <title>Command Reference</title>
 260
 261 <sect1 id="klettres-mainwindow">
 262 <title>The main &klettres; window</title>
 263
 264 <sect2>
 265 <title>The <guimenu>File</guimenu> Menu</title>
 266
 267 <variablelist>
 268 <varlistentry>
 269 <term><menuchoice>
 270 <shortcut>
 271 <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
 272 </shortcut>
 273 <guimenu>File</guimenu>
 274 <guimenuitem>Replay Sound</guimenuitem>
 275 </menuchoice></term>
 276 <listitem><para><action>Play</action> the same sound again</para></listitem>
 277 </varlistentry>
 278
 279 <varlistentry>
 280 <term><menuchoice>
 281 <shortcut>
 282 <keycombo action="simul">&Alt;<keycap>G</keycap></keycombo>
 283 </shortcut>
 284 <guimenu>File</guimenu>
 285 <guimenuitem>Get Alphabet in New Language...</guimenuitem>
 286 </menuchoice></term>
 287 <listitem><para><action>Opens</action> the Get Alphabet in New Language dialog for &klettres;</para></listitem>
 288 </varlistentry>
 289
 290 <varlistentry>
 291 <term><menuchoice>
 292 <shortcut>
 293 <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
 294 </shortcut>
 295 <guimenu>File</guimenu>
 296 <guimenuitem>Quit</guimenuitem>
 297 </menuchoice></term>
 298 <listitem><para><action>Quits</action> &klettres;</para></listitem>
 299 </varlistentry>
 300 </variablelist>
 301
 302 </sect2>
 303
 304 <sect2>
 305 <title>The <guimenu>Level</guimenu> Menu</title>
 306
 307 <variablelist>
 308
 309 <varlistentry>
 310 <term><menuchoice>
 311 <shortcut>
 312 <keycombo action="simul">&Alt;<keycap>L</keycap></keycombo>
 313 </shortcut>
 314 <guimenu>Level</guimenu>
 315 <guimenuitem>Level 1</guimenuitem>
 316 </menuchoice></term>
 317 <listitem><para><action>Choose</action> the level 1 (letter displayed and sound)</para></listitem>
 318 </varlistentry>
 319
 320 <varlistentry>
 321 <term><menuchoice>
 322 <shortcut>
 323 <keycombo action="simul">&Alt;<keycap>2</keycap></keycombo>
 324 </shortcut>
 325 <guimenu>Level</guimenu>
 326 <guimenuitem>Level 2</guimenuitem>
 327 </menuchoice></term>
 328 <listitem><para><action>Choose</action> the level 2 (no letter displayed, sound only)</para></listitem>
 329 </varlistentry>
 330
 331 <varlistentry>
 332 <term><menuchoice>
 333 <shortcut>
 334 <keycombo action="simul">&Alt;<keycap>3</keycap></keycombo>
 335 </shortcut>
 336 <guimenu>Level</guimenu>
 337 <guimenuitem>Level 3</guimenuitem>
 338 </menuchoice></term>
 339 <listitem><para><action>Choose</action> the level 3 (syllable displayed and sound)</para></listitem>
 340 </varlistentry>
 341
 342 <varlistentry>
 343 <term><menuchoice>
 344 <shortcut>
 345 <keycombo action="simul">&Alt;<keycap>4</keycap></keycombo>
 346 </shortcut>
 347 <guimenu>Level</guimenu>
 348 <guimenuitem>Level 4</guimenuitem>
 349 </menuchoice></term>
 350 <listitem><para><action>Choose</action> the level 4 (no syllable displayed, sound only)</para></listitem>
 351 </varlistentry>
 352
 353 </variablelist>
 354
 355 </sect2>
 356 <sect2>
 357 <title>The <guimenu>Languages</guimenu> Menu</title>
 358
 359 <variablelist>
 360
 361 <varlistentry>
 362 <term><menuchoice>
 363 <shortcut>
 364 <keycombo action="simul">&Alt;<keycap>E</keycap></keycombo>
 365 </shortcut>
 366 <guimenu>Languages</guimenu>
 367 <guimenuitem>English</guimenuitem>
 368 </menuchoice></term>
 369 <listitem><para><action>Choose</action> the English language</para></listitem>
 370 </varlistentry>
 371
 372 <varlistentry>
 373 <term><menuchoice>
 374 <shortcut>
 375 <keycombo action="simul">&Alt;<keycap>F</keycap></keycombo>
 376 </shortcut>
 377 <guimenu>Languages</guimenu>
 378 <guimenuitem>French</guimenuitem>
 379 </menuchoice></term>
 380 <listitem><para><action>Choose</action> the French language</para></listitem>
 381 </varlistentry>
 382
 383 </variablelist>
 384
 385 </sect2>
 386
 387 <sect2>
 388 <title>The <guimenu>Look</guimenu> Menu</title>
 389
 390 <variablelist>
 391 <varlistentry>
 392 <term><menuchoice>
 393 <shortcut>
 394 <keycombo action="simul">&Alt;<keycap>C</keycap></keycombo>
 395 </shortcut>
 396 <guimenu>Look</guimenu>
 397 <guisubmenu>Theme</guisubmenu>
 398 <guimenuitem>Classroom</guimenuitem>
 399 </menuchoice></term>
 400 <listitem><para><action>Switch</action> to the classroom theme</para></listitem>
 401 </varlistentry>
 402
 403 <varlistentry>
 404 <term><menuchoice>
 405 <shortcut>
 406 <keycombo action="simul">&Alt;<keycap>A</keycap></keycombo>
 407 </shortcut>
 408 <guimenu>Look</guimenu>
 409 <guisubmenu>Theme</guisubmenu>
 410 <guimenuitem>Arctic</guimenuitem>
 411 </menuchoice></term>
 412 <listitem><para><action>Switch</action> to the arctic theme</para></listitem>
 413 </varlistentry>
 414
 415 <varlistentry>
 416 <term><menuchoice>
 417 <shortcut>
 418 <keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>
 419 </shortcut>
 420 <guimenu>Look</guimenu>
 421 <guisubmenu>Theme</guisubmenu>
 422 <guimenuitem>Desert</guimenuitem>
 423 </menuchoice></term>
 424 <listitem><para><action>Switch</action> to the desert theme</para></listitem>
 425 </varlistentry>
 426
 427 <varlistentry>
 428 <term><menuchoice>
 429 <shortcut>
 430 <keycombo action="simul">&Ctrl;<keycap>K</keycap></keycombo>
 431 </shortcut>
 432 <guimenu>Look</guimenu>
 433 <guimenuitem>Mode Kid</guimenuitem>
 434 </menuchoice></term>
 435 <listitem><para><action>Toggle</action> the kid mode: no menubar</para></listitem>
 436 </varlistentry>
 437
 438 <varlistentry>
 439 <term><menuchoice>
 440 <shortcut>
 441 <keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo>
 442 </shortcut>
 443 <guimenu>Look</guimenu>
 444 <guimenuitem>Mode Grownup</guimenuitem>
 445 </menuchoice></term>
 446 <listitem><para><action>Toggle</action> the grown-up mode: normal interface</para></listitem>
 447 </varlistentry>
 448 </variablelist>
 449 </sect2>
 450
 451 <sect2>
 452 <title>The <guimenu>Settings</guimenu> Menu</title>
 453
 454 <variablelist>
 455 <varlistentry>
 456 <term><menuchoice>
 457 <shortcut>
 458 <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
 459 </shortcut>
 460 <guimenu>Settings</guimenu>
 461 <guimenuitem>Show MenuBar</guimenuitem>
 462 </menuchoice></term>
 463 <listitem><para><action>Toggle</action> the MenuBar</para></listitem>
 464 </varlistentry>
 465 <varlistentry>
 466 <term><menuchoice>
 467 <shortcut>
 468 <keycombo action="simul">&Alt;<keycap>T</keycap></keycombo>
 469 </shortcut>
 470 <guimenu>Settings</guimenu>
 471 <guimenuitem>Show ToolBar</guimenuitem>
 472 </menuchoice></term>
 473 <listitem><para><action>Toggle</action> the ToolBar</para></listitem>
 474 </varlistentry>
 475 <varlistentry>
 476 <term><menuchoice>
 477 <shortcut>
 478 <keycombo action="simul">&Alt;<keycap>A</keycap></keycombo>
 479 </shortcut>
 480 <guimenu>Settings</guimenu>
 481 <guimenuitem>Show Statusbar</guimenuitem>
 482 </menuchoice></term>
 483 <listitem><para><action>Toggle</action> the StatusBar</para>
 484 </listitem>
 485 </varlistentry>
 486 <varlistentry>
 487 <term><menuchoice>
 488 <shortcut>
 489 <keycombo action="simul">&Alt;<keycap>h</keycap></keycombo>
 490 </shortcut>
 491 <guimenu>Settings</guimenu>
 492 <guimenuitem>Configure Shortcuts...</guimenuitem>
 493 </menuchoice></term>
 494 <listitem><para><action>Configure</action> &klettres; shortcuts</para></listitem>
 495 </varlistentry>
 496 <varlistentry>
 497 <term><menuchoice>
 498 <shortcut>
 499 <keycombo action="simul">&Alt;<keycap>b</keycap></keycombo>
 500 </shortcut>
 501 <guimenu>Settings</guimenu>
 502 <guimenuitem>Configure Toolbars...</guimenuitem>
 503 </menuchoice></term>
 504 <listitem><para><action>Configure</action> &klettres; toolbars</para></listitem>
 505 </varlistentry>
 506 <varlistentry>
 507 <term><menuchoice>
 508 <guimenu>Settings</guimenu>
 509 <guimenuitem>Configure &klettres;...</guimenuitem>
 510 </menuchoice></term>
 511 <listitem><para><action>Configure</action> &klettres;: display a dialog with the Font configuration tab and the timers configuration tab.</para></listitem>
 512 </varlistentry>
 513
 514 </variablelist>
 515
 516 </sect2>
 517 </sect1>
 518 </chapter>
 519
 520 <chapter id="sounds">
 521 <title>Adding Sounds to &klettres;</title>
 522
 523 <para>
 524 If you would like to add sounds in your own language, it is very easy to do so. Record the alphabet sounds and place them in a folder named 'alpha'. Please write the letters (one per line) in a text file and save it with utf8 encoding in the 'alpha' folder. Then record the most current syllables and put them in a folder named 'syllab'. Write the syllables (one per line) in a text file and save it with utf8 encoding in the 'syllab' folder. The sounds should be in wav or ogg format and long enough for KAudioPlayer to play them (between 1.5 and 2 seconds long, please add some silence if they are too short). Then make a tarball of all that and send it to me. Additionally you can tell me about special letters in your language so I can easily generate the Special Characters Toolbar.
 525 </para>
 526
 527 <para>
 528 See <ulink url="http://edu.kde.org/klettres/add_language.php">the &klettres; website</ulink> for more detailed instructions on how to add a new language.
 529 </para>
 530 </chapter>
 531
 532 <chapter id="faq">
 533 <title>Questions and Answers</title>
 534
 535 &reporting.bugs;
 536 &updating.documentation;
 537
 538 <qandaset id="faqlist">
 539 <qandaentry>
 540 <question>
 541 <para>The background picture does not appear.</para>
 542 </question>
 543 <answer>
 544 <para>You need to configure with the <option>--prefix</option> option
 545 set to your &kde; folder or to add this folder to your
 546 path.</para> </answer>
 547 </qandaentry>
 548 <qandaentry>
 549 <question>
 550 <para>I do not hear any sounds</para>
 551 </question>
 552 <answer>
 553 <para>You need to have &arts; support and the &arts; daemon needs to be running. Make sure you compiled kdelibs with arts if you compiled KDE. In any doubt, ask your distribution. You can also check if &arts; is running in &kcontrol; -&gt; Sound &amp; Multimedia in the <guilabel>Sound System</guilabel> tab. There you must make sure that <guilabel>Enable the Sound System</guilabel> is checked.</para>
 554 <para>For KDE 3.4 users, you must also be sure that the player used to play KDE sounds is the default KDE sound system player. See in &kcontrol; the <guilabel>System Notifications</guilabel> tab, click on the Player Settings button on the bottom right and in the dialog please check <guilabel>Use the KDE sound system</guilabel>.
 555 </para>
 556  </answer>
 557 </qandaentry>
 558 <qandaentry>
 559 <question>
 560 <para>I do not see  some letters on the icons on the Special Characters Toolbar. I see rectangles instead for some languages.</para>
 561 </question>
 562 <answer>
 563 <para>&klettres; in Czech and Slovak needs Arial and if you do not have this font installed, please ask your distribution support how to install it.</para>
 564 <para>If you have Windows on your machine, you can use the TTF fonts from Windows (Arial is in those) via &kcontrol; -&gt; <guilabel>System Administration</guilabel> -&gt; <guilabel>Font Installer</guilabel> (click on <guilabel>Administrator mode</guilabel> and add the Windows Font folder).</para></answer>
 565 </qandaentry>
 566 <qandaentry>
 567 <question>
 568 <para>The letters on the icons on the Special Characters Toolbar are too small for some languages.</para>
 569 </question>
 570 <answer>
 571 <para>&klettres; in Czech and Slovak needs Arial and if you do not have this font installed, please ask your distribution support how to install it.</para>
 572 <para>If you have Windows on your machine, you can use the TTF fonts from Windows (Arial is in those) via &kcontrol; -&gt; <guilabel>System Administration</guilabel> -&gt; <guilabel>Font Installer</guilabel> (click on <guilabel>Administrator mode</guilabel> and add the Windows Font folder).</para></answer>
 573 </qandaentry>
 574 <qandaentry>
 575 <question>
 576 <para>Why are there only ten languages?</para>
 577 </question>
 578 <answer>
 579 <para>In order for me to add a new language, I need the sounds
 580 for the alphabet and some basic syllables. Someone speaking natively
 581 the new language must record these sounds in wav, mp3 or preferably, ogg format. For levels 3
 582 and 4, the syllables must be chosen by a teacher or someone who knows how children learn: these must be the
 583 syllables you have to learn just after the alphabet in order to learn
 584 well the basics of this language. Please send me a mail if you are
 585 able to do that. See <ulink url="http://edu.kde.org/klettres/add_language.php">the &klettres; website</ulink> for detailed instructions on how to add a new language.</para> </answer>
 586 </qandaentry>
 587 </qandaset>
 588 </chapter>
 589
 590 <chapter id="credits">
 591
 592 <title>Credits and License</title>
 593
 594 <para>
 595 &klettres;
 596 </para>
 597 <para>
 598 Program copyright 2001-2005 Anne-Marie Mahfouf <email>annma@kde.org</email>
 599 </para>
 600 <para>
 601 I am very grateful to the following people whose contribution has been greatly valuable:
 602 <itemizedlist>
 603 <listitem><para>Czech sounds: Eva Mikulčíková
 604 <email>evmi@seznam.cz</email></para> </listitem>
 605 <listitem><para>Dutch sounds: Geert Stams
 606 <email>geert@pa3csg.myweb.nl</email></para> </listitem>
 607 <listitem><para>Danish sounds: Erik Kjaer Pedersen
 608 <email>erik@binghamton.edu</email></para> </listitem>
 609 <listitem><para>French sounds: Ludovic Grossard
 610 <email>grossard@kde.org</email></para></listitem>
 611 <listitem><para>Slovak sounds: Silvia Motyčková and Jozef Říha
 612 <email>silviamotycka@seznam.cz</email></para></listitem>
 613 <listitem><para>Italian sounds: Pietro Pasotti
 614 <email>pietro@itopen.it</email></para></listitem>
 615 <listitem><para>English sounds: Robert Wadley
 616 <email>robntina AT juno DOT com</email></para></listitem>
 617 <listitem><para>Spanish sounds: Ana Belén Caballero and Juan Pedro Paredes
 618 <email>neneta @iquis.com</email></para></listitem>
 619 <listitem><para>Romanized Hindi sounds: Vikas Kharat
 620 <email>kharat@sancharnet.in</email></para></listitem>
 621 <listitem><para>Luganda sounds: John Magoye and Cormac Lynch
 622 <email>cormaclynch@eircom.net</email></para></listitem>
 623 <listitem><para>Classroom background picture: Renaud Blanchard
 624 <email>kisukuma@chez.com</email></para> </listitem>
 625 <listitem><para>Original icons:  Primoz Anzur
 626 <email>zerokode@yahoo.com</email></para></listitem>
 627 <listitem><para>Support and coding guidance: Robert Gogolok
 628 <email>mail@robert-gogolok.de</email></para></listitem>
 629 <listitem><para>SVG icon: Chris Luetchford
 630 <email>chris@os11.com</email></para></listitem>
 631 <listitem><para>Code for generating special characters icons: Peter Hedlund
 632 <email>peter@peterandlinda.com</email></para></listitem>
 633 <listitem><para>Port to KConfig XT, coding help: Waldo Bastian
 634 <email>bastian@kde.org</email></para></listitem>
 635 <listitem><para>Kids and grownup SVG icons, desert theme: Danny Allen
 636     <email>dannya40uk@yahoo.co.uk</email></para></listitem>
 637 </itemizedlist>
 638 </para>
 639
 640 <para>
 641 Documentation copyright 2001-2005 Anne-Marie Mahfouf <email>annma@kde.org</email>
 642 </para>
 643
 644 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
 645
 646 &underFDL;               <!-- FDL: do not remove. Commercial development should
 647  -->
 648
 649 &underGPL;               <!-- GPL License -->
 650 </chapter>
 651
 652 <!-- <appendix id="installation">
 653 <title>Installation</title>
 654
 655 &install.intro.documentation;
 656
 657 &install.compile.documentation;
 658
 659 </appendix>
 660 -->
 661 &documentation.index;
 662 </book>
 663 <!--
 664 Local Variables:
 665 mode: sgml
 666 sgml-minimize-attributes:nil
 667 sgml-general-insert-case:lower
 668 sgml-indent-step:0
 669 sgml-indent-data:nil
 670 End:
 671 -->
 672
 673
 674
 675
 676
 677
 678
 679
 680
 681
 682
 683
 684
 685