Warning, /education/klettres/doc/index.docbook is written in an unsupported language. File is not indexed.

0001 <?xml version="1.0" ?>
0002 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
0003   <!ENTITY % addindex "IGNORE">
0004   <!ENTITY % English "INCLUDE"><!-- change language only here -->
0005 ]>
0006 
0007 <book id="klettres" lang="&language;">
0008 
0009 <bookinfo>
0010 <title>The &klettres; Handbook</title>
0011 
0012 <authorgroup>
0013 <author>
0014 <firstname>Anne-Marie</firstname>
0015 <surname>Mahfouf</surname>
0016 <affiliation>
0017 <address>&Anne-Marie.Mahfouf.mail;</address>
0018 </affiliation>
0019 </author>
0020 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0021 </authorgroup>
0022 
0023 <copyright>
0024 <year>2001</year><year>2007</year>
0025 <holder>&Anne-Marie.Mahfouf;</holder>
0026 </copyright>
0027 <legalnotice>&FDLNotice;</legalnotice>
0028 
0029 <date>2020-12-29</date>
0030 <releaseinfo>Applications 20.12</releaseinfo>
0031 
0032 <abstract>
0033 <para>
0034 &klettres; is an application specially designed to do help the user
0035 to learn alphabet in a new language and then to learn to read simple syllables.
0036 The user can be a young child aged from two and a half or an adult that wants to learn
0037 the basics of a foreign language.</para>
0038 <para>
0039 Twenty five languages are available at the moment:  Arabian, Brazilian Portuguese, Czech, Danish,
0040 Dutch, British English, US English, Phonics English, French, German, Hebrew, Hungarian,
0041 Italian, Kannada, Low Saxon, Malayalam, Norwegian Bokmål, Punjabi, Luganda, Romanized Hindi,
0042 Russian, Spanish, Slovak, Telugu and Ukrainian but only English, French and your language
0043 if it is among those are installed by default.
0044 </para>
0045 <para>
0046 &klettres; is really easy to use. The language can be changed using the 
0047 <guimenu>Language</guimenu> menu. The user can also choose the Level from 
0048 1 to 4 in a combo box in the toolbar or via the <guimenu>Level</guimenu> menu. Themes
0049 (background and font color) can be changed in a combo box or in the
0050 <menuchoice><guimenu>Look</guimenu> <guimenuitem>Themes</guimenuitem></menuchoice> menu.
0051 Four themes are available: <guimenuitem>Kid</guimenuitem>, <guimenuitem>Desert</guimenuitem>,
0052 <guimenuitem>Savannah</guimenuitem> and <guimenuitem>Aqua</guimenuitem>.
0053 Finally, the mode can be changed from kid to grown-up using the 
0054 <guimenu>Look</guimenu> menu.
0055 </para>
0056 
0057 </abstract>
0058 
0059 <keywordset>
0060 <keyword>KDE</keyword>
0061 <keyword>kdeedu</keyword>
0062 <keyword>klettres</keyword>
0063 <keyword>alphabet</keyword>
0064 <keyword>sounds</keyword>
0065 <keyword>language</keyword>
0066 <keyword>keyboard</keyword>
0067 </keywordset>
0068 
0069 </bookinfo>
0070 
0071 <chapter id="introduction">
0072 <title>Introduction</title>
0073 
0074 <para>&klettres; is a very simple application that helps a child or an
0075 adult to learn the alphabet and some simple sounds in his own language
0076 or in another language.  The program picks up a letter or a syllable
0077 in random, this letter/syllable is displayed and the sound is played.
0078 The user should then type this letter or syllable. Training is done in
0079 the levels where the letter/syllable is not displayed, only the sound
0080 is played. The user does not need to know how to use the mouse, the
0081 keyboard only is needed.</para>
0082 
0083 <para>There are twenty five languages available at the moment: see the list above. If your
0084 &kde; language is among those, then it is taken as default, otherwise
0085 French is the default.
0086 You can easily get any additional available language by using the
0087 <menuchoice><guimenu>File</guimenu><guimenuitem>Get Alphabet in New
0088 Language...</guimenuitem></menuchoice> menu item, provided that your computer is connected to
0089 the Internet.</para>
0090 
0091 <!-- add a note for the sound, what does KLettres needs -->
0092 
0093 <para>Two different modes allow you to adapt &klettres; to
0094 your need and have the full usual interface or a stripped interface. For a
0095 child, the menubar is no longer visible. We assume that a child will not want to
0096 set the language himself.  A combo box allows him to choose the different
0097 levels. For an older user, the background is not so childish and the menubar is
0098 present in the Grown-Up style. Four different themes
0099 (<guimenuitem>Kid</guimenuitem>, <guimenuitem>Desert</guimenuitem>,
0100 <guimenuitem>Savannah</guimenuitem> and <guimenuitem>Aqua</guimenuitem>) set
0101 up a different background with different fonts and colors.</para>
0102 
0103 <note>
0104 <para>You do not need the language keyboard layout anymore as you can use the 
0105 special <guilabel>Special Characters</guilabel> toolbar to type any special
0106 character in each language. Select the <menuchoice><guimenu>Settings</guimenu>
0107 <guisubmenu>Toolbars Shown</guisubmenu><guimenuitem>Special Characters</guimenuitem></menuchoice>
0108 menu item and the toolbar will appear at the bottom of &klettres;. Click on the letter
0109 you want and it will be shown in the input field. This toolbar can be dragged 
0110 anywhere on your screen.</para>
0111 <para>
0112 If you prefer having the language keyboard layout, please use &systemsettings;, in the
0113 category <guilabel>Hardware</guilabel>, <guimenu>Input Devices</guimenu> on the page
0114 <guimenuitem>Keyboard</guimenuitem> in order to set the correct keyboard layout.</para>
0115 </note>
0116 </chapter>
0117 
0118 <chapter id="using-klettres">
0119 <title>Using &klettres;</title>
0120 <para>&klettres; has 4 levels. Levels 1 and 2 deal with the alphabet and
0121 levels 3 and 4 concern syllables. For a very young child (2 1/2 to 4), I would
0122 suggest that he/she is sitting on your lap in front of the computer and
0123 that you do the game together.</para>
0124 
0125 <sect1 id="levels1-and2">
0126 <title>Levels 1 and 2</title>
0127 
0128 <screenshot>
0129 <screeninfo>Screenshot of &klettres; Level 1</screeninfo>
0130         <mediaobject>
0131           <imageobject>
0132             <imagedata fileref="klettres1.png" format="PNG"/>
0133           </imageobject>
0134            <textobject>
0135             <phrase>&klettres; level1</phrase>
0136           </textobject>
0137         </mediaobject>
0138 </screenshot>
0139 
0140 <para>Level is Level 1, language is French, theme is Desert
0141 and mode is <emphasis>grown-up</emphasis>.</para>
0142 <note>
0143 <para>
0144 If your &kde; language is among the supported languages then this will be the
0145 default language the first time you run &klettres;. For other languages, English
0146 is the default. 
0147 &klettres; comes with English, French and your default language if among those listed
0148 above and you can get additional languages via <menuchoice><guimenu>File</guimenu>
0149 <guimenuitem>Get Alphabet in New Language...</guimenuitem></menuchoice> menu item
0150 provided you have an Internet connection.
0151 </para>
0152 </note>
0153 <para>
0154 In level 1, the user sees the letter and hears the sound. He then has to type in 
0155 the letter in the box. If it is correct, the next letter appears (without having 
0156 to press &Enter; or whatever). If the user types the wrong letter, 
0157 he hears the sound again. In this level, the user memorizes the letters, associates 
0158 them with their sound and recognizes them on the keyboard.
0159 </para>
0160 
0161 <note>
0162 <para>The user can type in either lower or uppercase letters. The letters are
0163 automatically put in uppercase so that a child will match them with the keyboard. 
0164 He can type only one letter at atime.</para>
0165 <para>When you type a letter in the input field, there is no need to press 
0166 &Enter; and the program waits for a short while before testing if 
0167 the letter is right. This short wait is to leave time to a young child to understand 
0168 what he/she just typed, especially if this is the wrong letter. You can change this 
0169 time by using the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
0170 &klettres;...</guimenuitem></menuchoice> menu item and the <guilabel>Timer</guilabel>
0171 page which will bring you a dialog where you can set two different times: one for
0172 the <guilabel>Kid Mode</guilabel> and one for the <guilabel>Grown-up Mode</guilabel>.
0173 </para>
0174 </note>
0175 
0176 <para>
0177 After the first time, the language setting is saved in a configuration file
0178 on closing of &klettres; and loaded the next time, with the level you were in.
0179 </para>
0180 <para>The mode (kid or grown-up) is saved in the config file and therefore
0181 is kept until you change.</para>
0182 <para>The letters appear in random order. They are not the same consecutively.</para>
0183 
0184 <para>
0185 <screenshot>
0186 <screeninfo>Screenshot of &klettres; Level 2</screeninfo>
0187         <mediaobject>
0188           <imageobject>
0189             <imagedata fileref="klettres2.png" format="PNG"/>
0190           </imageobject>
0191            <textobject>
0192             <phrase>&klettres; level2</phrase>
0193           </textobject>
0194         </mediaobject>
0195 </screenshot>
0196 </para>
0197 <para>Here is a screenshot of Level 2 with the <emphasis>kid</emphasis> mode, <emphasis>Kid</emphasis> theme and Danish language.</para>
0198 
0199 <para>Clicking in the level combo-box and choosing <guilabel>Level
0200 2</guilabel> or using the <guimenu>Level</guimenu> menu brings you to level 2. In that level, the user only
0201 hears the sound of the letter and has to type in the letter. If he
0202 is wrong, the letter appears to help him.</para>
0203 </sect1>
0204 
0205 <sect1 id="levels3-and4">
0206 <title>Levels 3 and 4</title>
0207 
0208 <para>
0209 <screenshot>
0210 <screeninfo>Screenshot of &klettres; Level 3</screeninfo>
0211         <mediaobject>
0212           <imageobject>
0213             <imagedata fileref="klettres3.png" format="PNG"/>
0214           </imageobject>
0215            <textobject>
0216             <phrase>&klettres; level3</phrase>
0217           </textobject>
0218         </mediaobject>
0219 </screenshot>
0220 </para>
0221 
0222 <para>Here you can see &klettres; level 3, <emphasis>grown-up</emphasis> mode, <emphasis>Savannah</emphasis> theme and Czech language.
0223 </para>
0224 
0225 <para>
0226 In level 3, the user sees the syllable and hears the sound. He then
0227 has to type in the letters in the box. If the first letter of the
0228 sound is wrong, the user cannot type in the second one. The letter
0229 disappears and he has to try again. The number of letters is two or
0230 three, it depends of the language.</para>
0231 
0232 <screenshot>
0233 <screeninfo>Screenshot of &klettres; Level 4</screeninfo>
0234         <mediaobject>
0235           <imageobject>
0236             <imagedata fileref="klettres4.png" format="PNG"/>
0237           </imageobject>
0238            <textobject>
0239             <phrase>&klettres; level4</phrase>
0240           </textobject>
0241         </mediaobject>
0242 </screenshot>
0243 
0244 <para>Here you can see &klettres; level 4, <emphasis>kid</emphasis> mode, <emphasis>Desert</emphasis> theme and Slovak language.
0245 </para>
0246 
0247 <para>The sounds appear in random order.</para> <para>Clicking in the
0248 level combo-box or using the <guimenu>Level</guimenu> menu in the menubar
0249 and choosing <guilabel>Level 4</guilabel> brings you
0250 to level 4. In that level, the user only hears the sound of the
0251 syllable and has to type in the letters. This level is quite difficult
0252 for a young child.</para>
0253 
0254 </sect1>
0255 
0256 <sect1 id ="configuring">
0257 <title>Configuration dialog</title>
0258 <para>The configuration dialog has two pages: one for <guilabel>Font</guilabel>
0259 and one for the <guilabel>Timer</guilabel>.</para>
0260 
0261 <sect2 id="about-font">
0262 <title>About font</title>
0263 
0264 <para>
0265 You can easily 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 <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &klettres;...</guimenuitem></menuchoice> menu item you will find a <guilabel>Font</guilabel> page with a font chooser dialog. The new font will be applied to both the displayed letter/syllable and the user field.
0266 </para>
0267 
0268 <warning>
0269 <para>
0270 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.
0271 </para>
0272 </warning>
0273 
0274 <para>
0275 You can also choose here the size you like the best. This size will be kept in configuration.
0276 </para>
0277 
0278 <screenshot>
0279 <screeninfo>Screenshot of &klettres; Font Chooser Dialog</screeninfo>
0280         <mediaobject>
0281           <imageobject>
0282             <imagedata fileref="klettres5.png" format="PNG"/>
0283           </imageobject>
0284            <textobject>
0285             <phrase>&klettres; Font Chooser Dialog</phrase>
0286           </textobject>
0287         </mediaobject>
0288 </screenshot>
0289 
0290 <para>Here you can see &klettres; Font Chooser Dialog.
0291 </para>
0292 </sect2>
0293 
0294 <sect2 id="timers">
0295 <title>Timer</title>
0296 
0297 <para>The timer set the time between two letters &ie; the time during which a letter is displayed. The units are tenths of seconds.
0298 </para>
0299 
0300 <para>The <guilabel>Timer</guilabel> page in the <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure &klettres;...</guimenuitem></menuchoice> menu item has two timers settings: one for the <guilabel>Kid Mode</guilabel> and one for the <guilabel>Grown-up Mode</guilabel>. Defaults are 4 tenths of seconds for <guilabel>Kid Mode</guilabel> and 2 tenths of seconds for <guilabel>Grown-up Mode</guilabel>. Increasing the time leaves you more time to see your errors.</para>
0301 
0302 <screenshot>
0303 <screeninfo>Screenshot of &klettres; Timer Settings</screeninfo>
0304     <mediaobject>
0305       <imageobject>
0306         <imagedata fileref="klettres6.png" format="PNG"/>
0307       </imageobject>
0308        <textobject>
0309         <phrase>Screenshot of &klettres; Timer Settings</phrase>
0310       </textobject>
0311     </mediaobject>
0312 </screenshot>
0313 
0314 </sect2>
0315 </sect1>
0316 <sect1 id="Get-new-stuff">
0317 <title>Getting a new language</title>
0318 <para>You might want to use &klettres; to help you learn a new language. By using the <menuchoice><guimenu>File</guimenu>
0319 <guimenuitem>Get Alphabet in New Language...</guimenuitem></menuchoice> menu item, you will see a new dialog with the list of available languages (you need to be connected to the Internet to use that feature).</para>
0320 <screenshot>
0321 <screeninfo>Get a New Language Dialog</screeninfo>
0322     <mediaobject>
0323       <imageobject>
0324         <imagedata fileref="klettres-newstuff.png" format="PNG"/>
0325       </imageobject>
0326        <textobject>
0327         <phrase>Get a New Language Dialog</phrase>
0328       </textobject>
0329     </mediaobject>
0330 </screenshot>
0331 <para>Click on the <guilabel>Install</guilabel> button on the right of the language you want to install.</para>
0332 <para>Please note that some files have several MB so it might be slow depending on your connection.</para>
0333 <para>After the file is downloaded, it is automatically installed and when you close the <guilabel>Get Hot New Stuff</guilabel> dialog you'll see the new language in the <guimenu>Language</guimenu> menu and you can use it immediately.</para>
0334 
0335 <para>When a language is downloaded, you then can see the <guilabel>Install</guilabel> button turning to <guilabel>Uninstall</guilabel>.</para>
0336 <para>The next screenshot shows Danish installed.</para>
0337 <screenshot>
0338 <screeninfo>Danish is installed</screeninfo>
0339     <mediaobject>
0340       <imageobject>
0341         <imagedata fileref="klettres-newstuff2.png" format="PNG"/>
0342       </imageobject>
0343        <textobject>
0344         <phrase>Danish is installed</phrase>
0345       </textobject>
0346     </mediaobject>
0347 </screenshot>
0348 </sect1>
0349 </chapter>
0350 
0351 <chapter id="commands">
0352 <title>Command Reference</title>
0353 
0354 <sect1 id="klettres-mainwindow">
0355 <title>The Main &klettres; Window</title>
0356 
0357 <sect2>
0358 <title>The File Menu</title>
0359 
0360 <variablelist>
0361 
0362 <varlistentry>
0363 <term><menuchoice>
0364 <shortcut>
0365 <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
0366 </shortcut>
0367 <guimenu>File</guimenu>
0368 <guimenuitem>New Sound</guimenuitem>
0369 </menuchoice></term>
0370 <listitem><para><action>Play</action> a new sound.</para></listitem>
0371 </varlistentry>
0372 
0373 <varlistentry>
0374 <term><menuchoice>
0375 <shortcut>
0376 <keycap>F5</keycap>
0377 </shortcut>
0378 <guimenu>File</guimenu>
0379 <guimenuitem>Replay Sound</guimenuitem>
0380 </menuchoice></term>
0381 <listitem><para><action>Play</action> the same sound again.</para></listitem>
0382 </varlistentry>
0383 
0384 <varlistentry>
0385 <term><menuchoice>
0386 <guimenu>File</guimenu>
0387 <guimenuitem>Get Alphabet in New Language...</guimenuitem>
0388 </menuchoice></term>
0389 <listitem><para><action>Opens</action> the <guilabel>Get Hot New Stuff</guilabel> dialog for &klettres; to download a new language.</para></listitem>
0390 </varlistentry>
0391 
0392 <varlistentry>
0393 <term><menuchoice>
0394 <shortcut>
0395 <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
0396 </shortcut>
0397 <guimenu>File</guimenu>
0398 <guimenuitem>Quit</guimenuitem>
0399 </menuchoice></term>
0400 <listitem><para><action>Quits</action> &klettres;.</para></listitem>
0401 </varlistentry>
0402 </variablelist>
0403 
0404 </sect2>
0405 
0406 <sect2>
0407 <title>The Level Menu</title>
0408 
0409 <variablelist>
0410 
0411 <varlistentry>
0412 <term><menuchoice>
0413 <guimenu>Level</guimenu>
0414 <guimenuitem>Level 1</guimenuitem>
0415 </menuchoice></term>
0416 <listitem><para><action>Choose</action> the level 1 (letter displayed and sound).</para></listitem>
0417 </varlistentry>
0418 
0419 <varlistentry>
0420 <term><menuchoice>
0421 <guimenu>Level</guimenu>
0422 <guimenuitem>Level 2</guimenuitem>
0423 </menuchoice></term>
0424 <listitem><para><action>Choose</action> the level 2 (no letter displayed, sound only).</para></listitem>
0425 </varlistentry>
0426 
0427 <varlistentry>
0428 <term><menuchoice>
0429 <guimenu>Level</guimenu>
0430 <guimenuitem>Level 3</guimenuitem>
0431 </menuchoice></term>
0432 <listitem><para><action>Choose</action> the level 3 (syllable displayed and sound).</para></listitem>
0433 </varlistentry>
0434 
0435 <varlistentry>
0436 <term><menuchoice>
0437 <guimenu>Level</guimenu>
0438 <guimenuitem>Level 4</guimenuitem>
0439 </menuchoice></term>
0440 <listitem><para><action>Choose</action> the level 4 (no syllable displayed, sound only).</para></listitem>
0441 </varlistentry>
0442 
0443 </variablelist>
0444 
0445 </sect2>
0446 <sect2>
0447 <title>The Language Menu</title>
0448 
0449 <variablelist>
0450 
0451 <varlistentry>
0452 <term><menuchoice>
0453 <guimenu>Language</guimenu>
0454 <guimenuitem>English</guimenuitem>
0455 </menuchoice></term>
0456 <listitem><para><action>Choose</action> the English language.</para></listitem>
0457 </varlistentry>
0458 
0459 <varlistentry>
0460 <term><menuchoice>
0461 <guimenu>Language</guimenu>
0462 <guimenuitem>French</guimenuitem>
0463 </menuchoice></term>
0464 <listitem><para><action>Choose</action> the French language.</para></listitem>
0465 </varlistentry>
0466 
0467 </variablelist>
0468 
0469 </sect2>
0470 
0471 <sect2>
0472 <title>The Look Menu</title>
0473 
0474 <variablelist>
0475 <varlistentry>
0476 <term><menuchoice>
0477 <guimenu>Look</guimenu>
0478 <guisubmenu>Themes</guisubmenu>
0479 </menuchoice></term>
0480 <listitem><para>A submenu for <action>switch</action> to the Kid, Desert, Savannah or Aqua theme.</para></listitem>
0481 </varlistentry>
0482 
0483 <varlistentry>
0484 <term><menuchoice>
0485 <shortcut>
0486 <keycombo action="simul">&Ctrl;<keycap>K</keycap></keycombo>
0487 </shortcut>
0488 <guimenu>Look</guimenu>
0489 <guimenuitem>Mode Kid</guimenuitem>
0490 </menuchoice></term>
0491 <listitem><para><action>Toggle</action> the kid mode: no menubar.</para></listitem>
0492 </varlistentry>
0493 
0494 <varlistentry>
0495 <term><menuchoice>
0496 <shortcut>
0497 <keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo>
0498 </shortcut>
0499 <guimenu>Look</guimenu>
0500 <guimenuitem>Mode Grown-up</guimenuitem>
0501 </menuchoice></term>
0502 <listitem><para><action>Toggle</action> the grown-up mode: normal interface.</para></listitem>
0503 </varlistentry>
0504 </variablelist>
0505 
0506 <para>
0507 Additionally &klettres; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
0508 menu items, for more information read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings"
0509 >Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
0510 of the &kde; Fundamentals.
0511 </para>
0512 
0513 </sect2>
0514 
0515 </sect1>
0516 </chapter>
0517 
0518 <chapter id="sounds">
0519 <title>Adding Sounds to &klettres;</title>
0520 
0521 <para>
0522 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'. Then record the most current syllables and put them in a folder named 'syllab'.</para> 
0523 <para>Create a text file <filename>sounds.xml</filename>, 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:</para>
0524 <programlisting>&lt;klettres&gt;
0525 &lt;language code="cs"&gt;
0526     &lt;menuitem&gt;
0527       &lt;label&gt;&amp;Czech&lt;/label&gt;
0528     &lt;/menuitem&gt;
0529     &lt;alphabet&gt;
0530         &lt;sound name="A" file="cs/alpha/a.ogg" /&gt;
0531         ...
0532     &lt;/alphabet&gt;
0533     &lt;syllables&gt;
0534         &lt;sound name="BA" file="cs/syllab/ba.ogg" /&gt;
0535         ...
0536     &lt;/syllables&gt;
0537   &lt;/language&gt;
0538 &lt;/klettres&gt;</programlisting>
0539 <para>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 uppercase in utf8.</para>
0540 
0541 <para>Additionally you can tell about special letters in your language so we can easily generate the special <guimenuitem>Special Characters</guimenuitem> toolbar. Create a text file <filename>cs.txt</filename> (replace "cs" with the two letter code of your language) with each special character of your language in uppercase on one line.
0542 And save both text files with <quote>utf8</quote> encoding (upper right dropbox in &kate; allows that).</para>
0543 
0544 <para>The sounds should be in ogg format and long enough for the audio player 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 the mailinglist <email>kde-edu@kde.org</email>.
0545 </para>
0546 
0547 <para>
0548 See the <ulink url="https://edu.kde.org/klettres/add_language.php">&klettres; website</ulink> for more up to date instructions on how to add a new language.
0549 </para>
0550 </chapter>
0551 
0552 <chapter id="faq">
0553 <title>Questions and Answers</title>
0554 
0555 <qandaset id="faqlist">
0556 <qandaentry>
0557 <question>
0558 <para>The background picture does not appear.</para>
0559 </question>
0560 <answer>
0561 <para>If you build &klettres; yourself, you need to configure with the <option>--prefix</option> option
0562 set to your &kde; folder or to add this folder to your
0563 path.</para> </answer>
0564 </qandaentry>
0565 <qandaentry>
0566 <question>
0567 <para>I do not hear any sounds.</para>
0568 </question>
0569 <answer>
0570 <para>Make sure that &phonon; is working on your system. To do so, open &systemsettings; and in the <guilabel>Hardware</guilabel> category click on <guilabel>Multimedia</guilabel>.
0571 </para>
0572  </answer>
0573 </qandaentry>
0574 <qandaentry>
0575 <question>
0576 <para>I do not see  some letters on the icons on the special <guimenuitem>Special Characters</guimenuitem> toolbar. I see rectangles instead or the icons are too small for some languages.</para>
0577 </question>
0578 <answer>
0579 <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> 
0580 <para>If you have &Windows; on your machine, you can use the TTF fonts from
0581 &Windows; (Arial is in those) via <guilabel>Font Management</guilabel> in the <guilabel>Appearance</guilabel> category of the &systemsettings; and add the &Windows; Font
0582 folder.</para></answer>
0583 </qandaentry>
0584 <qandaentry>
0585 <question>
0586 <para>Why are there only twenty five languages?</para>
0587 </question>
0588 <answer>
0589 <para>In order to add a new language, we need the sounds
0590 for the alphabet and some basic syllables. Someone speaking natively
0591 the new language must record these sounds in ogg format. For levels 3
0592 and 4, the syllables must be chosen by a teacher or someone who knows how children learn: these must be the
0593 syllables you have to learn just after the alphabet in order to learn
0594 well the basics of this language. Please send a mail to <email>kde-edu@kde.org</email> if you are
0595 able to do that. See <ulink url="https://edu.kde.org/klettres/add_language.php">the &klettres; website</ulink> for detailed instructions on how to add a new language.</para> </answer>
0596 </qandaentry>
0597 </qandaset>
0598 </chapter>
0599 
0600 <chapter id="credits">
0601 
0602 <title>Credits and License</title>
0603 
0604 <para>
0605 &klettres;
0606 </para>
0607 <para>
0608 Program copyright 2001-2007 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;
0609 </para>
0610 <para>
0611 I am very grateful to the following people whose contribution has been greatly valuable:
0612 <itemizedlist>
0613 <listitem><para>Brazilian Portuguese sounds: Lindonjohnson Monte (Father) and Michelle Monte 09 years (Son)
0614 <email>lindon_johnson@brturbo.com.br</email></para> </listitem>
0615 <listitem><para>Czech sounds: Eva Mikulčíková
0616 <email>evmi@seznam.cz</email></para> </listitem>
0617 <listitem><para>Danish sounds: Erik Kjaer Pedersen
0618 <email>erik@binghamton.edu</email></para> </listitem>
0619 <listitem><para>Dutch sounds: Geert Stams
0620 <email>geert@pa3csg.myweb.nl</email></para> </listitem>
0621 <listitem><para>English sounds: Robert Wadley
0622 <email>robntina@juno.com</email></para></listitem>
0623 <listitem><para>French sounds: Ludovic Grossard
0624 <email>grossard@kde.org</email></para></listitem>
0625 <listitem><para>German sounds: Helmut Kriege
0626 <email>h.kriege@freenet.de</email></para></listitem>
0627 <listitem><para>Hebrew sounds: Assaf Gorgon
0628 <email>assafgordon@gmail.com</email></para></listitem>
0629 <listitem><para>Italian sounds: Pietro Pasotti
0630 <email>pietro@itopen.it</email></para></listitem>
0631 <listitem><para>Kannada sounds: Vikram Vincent 
0632 <email>vincentvikram@gmail.com</email></para></listitem>
0633 <listitem><para>Low Saxon sounds: Manfred Wiese and Sönke Dibbern
0634 <email>s_dibbern@web.de</email></para></listitem>
0635 <listitem><para>Luganda sounds: John Magoye and Cormac Lynch
0636 <email>cormaclynch@eircom.net</email></para></listitem>
0637 <listitem><para>Romanized Hindi sounds: Vikas Kharat
0638 <email>kharat@sancharnet.in</email></para></listitem>
0639 <listitem><para>Spanish sounds: Ana Belén Caballero and Juan Pedro Paredes
0640 <email>neneta @iquis.com</email></para></listitem>
0641 <listitem><para>Slovak sounds: Silvia Motyčková and Jozef Říha
0642 <email>silviamotycka@seznam.cz</email></para></listitem>
0643 <listitem><para>Telugu sounds: Pavithran Shakamuri
0644 <email>pavithran.s@gmail.com</email></para></listitem>
0645 <listitem><para>Original icons:  &Primoz.Anzur;
0646 <email>zerokode@yahoo.com</email></para></listitem>
0647 <listitem><para>Support and coding guidance: &Robert.Gogolok;
0648 &Robert.Gogolok.mail;</para></listitem>
0649 <listitem><para>&SVG; icon: Chris Luetchford
0650 <email>chris@os11.com</email></para></listitem>
0651 <listitem><para>Code for generating special characters icons: Peter Hedlund
0652 <email>peter@peterandlinda.com</email></para></listitem>
0653 <listitem><para>Port to KConfig XT, coding help: &Waldo.Bastian;
0654 &Waldo.Bastian.mail;</para></listitem>
0655 <listitem><para>Kids and grownup &SVG; icons, Desert theme: &Danny.Allen;
0656     <email>dannya40uk@yahoo.co.uk</email></para></listitem>
0657 <listitem><para>Timer setting widget: Michael Goettsche
0658     <email>michael.goettsche@kdemail.net</email></para></listitem>
0659 </itemizedlist>
0660 </para>
0661 
0662 <para>
0663 Documentation copyright 2001-2006
0664 &Anne-Marie.Mahfouf;&Anne-Marie.Mahfouf.mail;
0665 </para>
0666 
0667 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
0668 
0669 &underFDL;               <!-- FDL: do not remove. Commercial development should
0670  -->
0671 
0672 &underGPL;               <!-- GPL License -->
0673 </chapter>
0674 
0675 &documentation.index;
0676 </book>
0677 <!--
0678 Local Variables:
0679 mode: sgml
0680 sgml-minimize-attributes:nil
0681 sgml-general-insert-case:lower
0682 sgml-indent-step:0
0683 sgml-indent-data:nil
0684 End:
0685 -->