<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
<!ENTITY kbruch "<application
>KBruch</application
>">
<!ENTITY package "kdeedu">
<!ENTITY % addindex "IGNORE">
<!ENTITY % Dutch "INCLUDE"
><!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title
>Het handboek van &kbruch;</title>

<authorgroup>
<author
><firstname
>Sebastian</firstname
> <surname
>Stein</surname
> <affiliation
> <address
><email
>seb.kde@hpfsc.de</email
></address>
</affiliation>
</author>

<othercredit role="translator"
><firstname
>Jaap</firstname
><surname
>Woldringh</surname
><affiliation
><address
><email
>jjh.woldringh@planet.nl</email
></address
></affiliation
><contrib
></contrib
></othercredit
> 

</authorgroup>

<copyright>
<year
>2001-2004</year>
<holder
>Sebastian Stein</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2004-02-18</date>
<releaseinfo
>3.1.91</releaseinfo>

<abstract>
<para
>&kbruch; is a small program to generate tasks with fractions. The user has to solve the given task by entering the right value for numerator and denominator. The program checks the input and gives feedback. </para>
	
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>onderwijs</keyword>
<keyword
>breuk</keyword>
<keyword
>rekenkunde</keyword>
<keyword
>noemer</keyword>
<keyword
>kbruch</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Inleiding</title>

<para
>&kbruch; is a small program to generate tasks with fractions. The user has to solve the given task by entering the right value for numerator and denominator. The program checks the input and gives feedback. </para>
<para
>The task generation can be adjusted by using different parameters. The user can decide if he wants to solve tasks with addition/subtraction and/or multiplication/division. </para>
<para
>It is possible to enter the number of ratios and the maximum for the main denominator. </para>
<para
>&kbruch; is erg klein, en is gericht op het basisidee van een opgavengenerator. Een direct beschikbaar helpsysteem geeft contextgevoelige informatie voor de verschillende situaties. </para>
<para
>&kbruch; provides a text interface as well. This means you can use &kbruch; without starting the &X-Window;. To do this you use the <option
>-t</option
> command line option. </para>
<para
>It is free and licensed under the &GNU; Public License. </para>
</chapter>

<chapter id="using-kbruch">
<title
>&kbruch; gebruiken</title>

<sect1 id="overview">
<title
>Hoofdscherm</title>

<para
>U ziet hier een schermafbeelding van het hoofdscherm van &kbruch;:</para>

<screenshot>
	<screeninfo
>Het hoofdscherm van &kbruch; direct na de start</screeninfo>
	<mediaobject>
		<imageobject>
			<imagedata fileref="gui_main.png" format="PNG"/>
		</imageobject>
		<textobject>
			<phrase
>Hoofdscherm van &kbruch;</phrase>
		</textobject>
	</mediaobject>
</screenshot>


<para
>All action takes place in this screen. This ensures that &kbruch; is easy to use even for young users! The main screen is separated into 4 parts: <itemizedlist>
	<listitem
><para
>the menu bar with the 2 menus <guimenu
>Task</guimenu
> and <guimenu
>Help</guimenu
> </para
></listitem>
	<listitem
><para
>the toolbar, where you can set the difficulty of the generated tasks </para
></listitem>
	<listitem
><para
>het statistische gedeelte, waarin het aantal gemaakte opgaven wordt getoond, en hoeveel ervan goed of fout waren. </para
></listitem>
	<listitem
><para
>het gedeelte waarin de antwoorden van een opgave kunnen worden ingevoerd. </para
></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="task_paras">
<title
>Opdrachtparameters</title>
<para
>Er zijn 3 parameters die de moeilijkheidsgraad van de gegenereerde opgaven beïnvloeden:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Termen</guilabel
></term>
<listitem
><para
>Het aantal termen (afzonderlijke breuken) in elke opgave, in te stellen van 2 tot en met 5.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Maximale grootte van de noemer</guilabel
></term>
<listitem
><para
>De grootste waarde van de noemers in de opgaven die &kbruch; moet genereren. Van een minimum van 10 tot en met de maximum grootte 50.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Bewerkingen</guilabel
></term>
<listitem
><para
>Bewerkingen die in de opgaven moeten voorkomen: <guilabel
>Optellen/Aftrekken</guilabel
>, <guilabel
>Vermenigvuldigen/Delen</guilabel
> of <guilabel
>Alle bewerkingen</guilabel
>.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Nadat deze parameters zijn veranderd, moet u nog klikken op de knop <guimenu
>Nieuwe opgave</guimenu
> in de werkbalk om een opgave te genereren met de nieuwe parameters. U kunt dit ook doen met <menuchoice
><guimenu
>Opgave</guimenu
> <guimenuitem
>Nieuwe opgave</guimenuitem
></menuchoice
> in de menubalk. </para>
<note>
<para
>De keuze van de maximale waarde voor de noemer wordt weer op een standaard waarde ingesteld als het aantal termen wordt veranderd. Dus dit aantal moet eerst worden ingesteld, voordat de maximale grootte van de noemer wordt ingesteld. </para>
</note>
<para
>Als er nog geen antwoord is gegeven op de huidige opgave, en er op <guimenu
>Nieuwe opgave</guimenu
> wordt geklikt, dan zal de opgave als niet goed beantwoord worden beschouwd. Om dit te voorkomen kunt u beter eerst de opgave beantwoorden voordat u om een nieuwe opgave vraagt. </para>
<para
>De gekozen parameters zullen worden opgeslagen als &kbruch; wordt afgesloten, en weer hersteld bij de volgende keer dat het programma wordt gestart. </para>
</sect1>

<sect1 id="solve_task">
<title
>Beantwoorden van opgaven</title>
<para
>Het antwoord op een opgave moet worden ingevoerd in de twee invoervakken. Het bovenste is voor de teller en het onderste voor de noemer. </para>
<para
>If the result is negative, you can enter a minus sign in front of the numerator or denominator. If the result is 0, you can leave both boxes empty. If the result has a denominator of 1, you can leave the lower box empty. </para>
<para
>After you have entered the result you should click the <guibutton
>Check Task</guibutton
> button below the input boxes. &kbruch; will check your input and present the correct result. Therefore the main screen changes a little, as you can see in the screenshot: </para>
<screenshot>
<screeninfo
>Antwoord gecontroleerd</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="checked.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Antwoord gecontroleerd</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>This task was solved correctly. The correct value is shown in 2 different forms. The second form just in front of the word <guilabel
>CORRECT</guilabel
> is only used in some countries and must be read as 4 + 1/4 in the given case. </para>
<note>
<para
>Het antwoord moet altijd vereenvoudigd worden gegeven (bijvoorbeeld 3/5 en niet 9/15) omdat de meeste onderwijzers alleen vereenvoudigde antwoorden goed zullen rekenen. &kbruch; toont een bericht als in de schermafbeelding hieronder, als een niet (zoveel mogelijk) vereenvoudigd antwoord wordt gegeven. </para>
</note>
<screenshot>
<screeninfo
>Niet vereenvoudigd antwoord</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="reduced.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Niet vereenvoudigd antwoord</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para
>Voor een volgende opgave moet er op de knop <guimenu
>Volgende opgave</guimenu
> worden geklikt. Als de parameters voor de volgende opgave moeten worden veranderd, moet dat eerst worden gedaan. </para>
</sect1>

<sect1 id="statistics">
<title
>Het statistische gedeelte</title>
<para
>In dit gedeelte van het scherm is te zien: <itemizedlist>
	<listitem
><para
>hoeveel opgaven er zijn gemaakt </para
></listitem>
	<listitem
><para
>hoeveel opgaven er goed zijn beantwoord </para
></listitem>
	<listitem
><para
>hoeveel opgaven er niet goed zijn beantwoord </para
></listitem>
</itemizedlist>
</para>
<para
>Om opnieuw te beginnen moet op de knop <guimenu
>Opnieuw</guimenu
> worden geklikt. Deze is linksonder te vinden. </para>
<para
>De statistieken worden opgeslagen als &kbruch; wordt afgesloten, en worden weer hersteld bij het opnieuw starten van het programma. </para>
</sect1>

</chapter>

<chapter id="config">
<title
>The Text Interface and Generator Mode</title>
<para
>&kbruch; offers a text interface as well. You can start this interface directly from a shell: </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>-t</option
></userinput>
</para>
<para
>or </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>--text</option
></userinput>
</para>
<screenshot>
<screeninfo
>Main Menu</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="text_main.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Main Menu</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>If you are a teacher you may be interested to generate a lot of complicated tasks. For this purpose &kbruch; provides a generator mode. You can only call it from a command line: </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>-g</option
></userinput>
</para>
<para
>or </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>--generate</option
></userinput>
</para>
<screenshot>
<screeninfo
>Generator Mode</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="generator.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Generator Mode</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>As shown in the screenshot, you can stop the generator mode by pressing <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>. It is not possible to influence the task generator. You cannot set parameters like the number of terms, maximum main denominator size or which operations should be used. </para>
</chapter>

<chapter id="credits">

<title
>Dankbetuigingen en licentie</title>
<para
>&kbruch;</para>
<para
>Programma en documentatie: copyright 2001-2004 Sebastian Stein <email
>seb.kde@hpfsc.de</email
> </para>

<para
>Dank aan:</para>

<itemizedlist>
	<listitem
><para
>Anne-Marie Mahfouf voor het leiden van het &kde;-Eduproject </para
></listitem>
	<listitem
><para
>Klas Kalass voor zijn hulp bij het uitdenken van het uiterlijk </para
></listitem>
	<listitem
><para
>Eva Brucherseifer voor het schrijven van <application
>KMath</application
> (&kbruch;'s GUI (grafische interface) is hierop gebaseerd) </para
></listitem>
	<listitem
><para
>Dominique Devriese voor het verhelpen van programmafouten </para
></listitem>
	<listitem
><para
><ulink url="http://www.net-tex.de/"
>Stefan Schumacher</ulink
> voor het testen van een erg vroege versie </para
></listitem>
	<listitem
><para
><ulink url="http://www.guckes.net/"
>Sven Guckes</ulink
> for testing the text interface </para
></listitem>
	<listitem
><para
>David Faure voor de hulp met &kde;-<acronym
>-CVS</acronym
> en &kde;-Bugzilla </para
></listitem>
	<listitem
><para
>Robert Gogolok voor de hulp met &kde;-<acronym
>CVS</acronym
> </para
></listitem>
	<listitem
><para
>John Kesson voor het doorlezen op fouten van het handboek </para
></listitem>
</itemizedlist>

&meld.fouten;&vertaling.jaap; 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installatie</title>

<sect1 id="getting-kbruch">
<title
>Hoe &kbruch; te verkrijgen</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Vereisten</title>

<para
>Om &kbruch; te kunnen gebruiken heeft u &kde; 
> 3.1 nodig </para>

<para
>U kunt &kbruch; vinden op <ulink url="http://edu.kde.org/kbruch/"
>de thuispagina van &kbruch;</ulink
> , en het programma maakt deel uit van het &kde;-Eduproject.</para>

<para
>You can find a list of changes in the file ChangeLog in the distribution of &kbruch; or see the <acronym
>CVS</acronym
> commit messages.</para>

</sect1>

<sect1 id="compilation">
<title
>Compileren en Installeren</title>
&install.compile.documentation; </sect1>

</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
