[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-commits
Subject:    playground/edu/doc/kalcul
From:       Anne-Marie Mahfouf <annma () kde ! org>
Date:       2005-07-01 0:40:33
Message-ID: 1120178433.023719.30095.nullmailer () svn ! kde ! org
[Download RAW message or body]

SVN commit 430345 by annma:

improve doc


 M  +94 -6     index.docbook  
 AM            kalcul5.png  
 AM            kalcul6.png  
 AM            kalcul7.png  
 AM            kalcul8.png  


--- trunk/playground/edu/doc/kalcul/index.docbook #430344:430345
@@ -168,15 +168,103 @@
 </sect1>
 </chapter>-->
 
-<!---<chapter id="technical">
-<title>Technical stuff</title>
-Here you can explain technical stuff your app deals with. 
-This chaptercan be made an entity if you think other apps will need it too. For example if you deal with \
                prime numbers in your app,
-you can explain here what prime numbers are.
+<chapter id="tools">
+<title>Tools</title>
 <para>
+This chapter explains the two main &kalcul; tools: the Exercise Dialog and the Level Editor.</para>
+<sect1 id="exercise-dialog">
+<title>The Exercise Dialog</title>
+<para>The Exercise Dialog let you choose which type of exercise you want the child/pupil to take.
 </para>
-</chapter>-->
+<para>When you choose the <guimenu>Tools</guimenu> -&gt; <guimenuitem>Exercise Dialog</guimenuitem> \
menu, you see this dialog first:</para>  
+<screenshot>
+<screeninfo>The Exercise Dialog</screeninfo>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="kalcul5.png" format="PNG"/>
+      </imageobject>
+      <textobject>
+        <phrase>The Exercise Dialog</phrase>
+      </textobject>
+    </mediaobject>
+</screenshot>
+
+<para>Practice is a timed test with random questions of a specified type.</para>
+<para>Level is a timed test with a Level you can choose.</para>
+<para>When you choose Practice, the screen below is displayed:</para>
+
+<screenshot>
+<screeninfo>Choose the type</screeninfo>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="kalcul6.png" format="PNG"/>
+      </imageobject>
+      <textobject>
+        <phrase>Choose the type</phrase>
+      </textobject>
+    </mediaobject>
+</screenshot>
+
+<para>Clicking any type will choose this type for your next test. You can set the maximum number for \
each term of the operation and other parameters in <guimenu>Settings</guimenu> -&gt; \
<guimenuitem>Configure &kalcul;...</guimenuitem> dialog.</para> +</sect1>
+
+<para>If you select Level in the first screen of the Exercise Dialog, you will get the following dialog \
which lists all the <filename>.kalcul</filename> files present on your system.</para> +
+<screenshot>
+<screeninfo>Choose the level</screeninfo>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="kalcul7.png" format="PNG"/>
+      </imageobject>
+      <textobject>
+        <phrase>Choose the level</phrase>
+      </textobject>
+    </mediaobject>
+</screenshot>
+
+<para>Choose a Level. The characteristics of the level are displayed on the right. Clicking on Go! will \
load the selected Level.</para> +<sect1 id="level-editor">
+<title>The Level Editor</title>
+<para>The Level Editor allows you to write your own tests.
+</para>
+
+<screenshot>
+<screeninfo>Level Editor</screeninfo>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="kalcul8.png" format="PNG"/>
+      </imageobject>
+      <textobject>
+        <phrase>Level Editor</phrase>
+      </textobject>
+    </mediaobject>
+</screenshot>
+
+</sect1>
+</chapter>
+
+<chapter id="configuration">
+<title>Settings</title>
+<para>
+This chapter explains the <guimenu>Settings</guimenu> -&gt; <guimenuitem>Configure \
&kalcul;...</guimenuitem> dialog.</para> +
+<sect1 id="general">
+<title>The General tab</title>
+<para></para>
+</sect1>
+
+<sect1 id="timer">
+<title>The Timer tab</title>
+<para></para>
+</sect1>
+
+<sect1 id="advanced">
+<title>The Advanced tab</title>
+<para></para>
+</sect1>
+</chapter>
+
 <chapter id="commands">
 <title>Command Reference</title>
 
** trunk/playground/edu/doc/kalcul/kalcul5.png #property changes
Name: svn:mime-type
   + application/octet-stream
** trunk/playground/edu/doc/kalcul/kalcul6.png #property changes
Name: svn:mime-type
   + application/octet-stream
** trunk/playground/edu/doc/kalcul/kalcul7.png #property changes
Name: svn:mime-type
   + application/octet-stream
** trunk/playground/edu/doc/kalcul/kalcul8.png #property changes
Name: svn:mime-type
   + application/octet-stream


[prev in list] [next in list] [prev in thread] [next in thread]