# Het handboek van &kbruch;

## Inleiding

&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.

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.

It is possible to enter the number of ratios and the maximum for the main denominator.

&kbruch; is erg klein, en is gericht op het basisidee van een opgavengenerator. Een direct beschikbaar helpsysteem geeft contextgevoelige informatie voor de verschillende situaties.

&kbruch; provides a text interface as well. This means you can use &kbruch; without starting the &X-Window;. To do this you use the `-t` command line option.

It is free and licensed under the &GNU; Public License.

## &kbruch; gebruiken

### Hoofdscherm

U ziet hier een schermafbeelding van het hoofdscherm van &kbruch;:

Het hoofdscherm van &kbruch; direct na de start Hoofdscherm van &kbruch;

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:

- the menu bar with the 2 menus Task and Help

- the toolbar, where you can set the difficulty of the generated tasks

- het statistische gedeelte, waarin het aantal gemaakte opgaven wordt getoond, en hoeveel ervan goed of fout waren.

- het gedeelte waarin de antwoorden van een opgave kunnen worden ingevoerd.

### Opdrachtparameters

Er zijn 3 parameters die de moeilijkheidsgraad van de gegenereerde opgaven beïnvloeden:

Termen

- Het aantal termen (afzonderlijke breuken) in elke opgave, in te stellen van 2 tot en met 5.

Maximale grootte van de noemer

- 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.

Bewerkingen

- Bewerkingen die in de opgaven moeten voorkomen: Optellen/Aftrekken, Vermenigvuldigen/Delen of Alle bewerkingen.

Nadat deze parameters zijn veranderd, moet u nog klikken op de knop Nieuwe opgave in de werkbalk om een opgave te genereren met de nieuwe parameters. U kunt dit ook doen met Opgave Nieuwe opgave in de menubalk.

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.

Als er nog geen antwoord is gegeven op de huidige opgave, en er op Nieuwe opgave 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.

De gekozen parameters zullen worden opgeslagen als &kbruch; wordt afgesloten, en weer hersteld bij de volgende keer dat het programma wordt gestart.

### Beantwoorden van opgaven

Het antwoord op een opgave moet worden ingevoerd in de twee invoervakken. Het bovenste is voor de teller en het onderste voor de noemer.

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.

After you have entered the result you should click the Check Task 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:

Antwoord gecontroleerd Antwoord gecontroleerd

This task was solved correctly. The correct value is shown in 2 different forms. The second form just in front of the word CORRECT is only used in some countries and must be read as 4 + 1/4 in the given case.

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.

Niet vereenvoudigd antwoord Niet vereenvoudigd antwoord

Voor een volgende opgave moet er op de knop Volgende opgave worden geklikt. Als de parameters voor de volgende opgave moeten worden veranderd, moet dat eerst worden gedaan.

### Het statistische gedeelte

In dit gedeelte van het scherm is te zien:

- hoeveel opgaven er zijn gemaakt

- hoeveel opgaven er goed zijn beantwoord

- hoeveel opgaven er niet goed zijn beantwoord

Om opnieuw te beginnen moet op de knop Opnieuw worden geklikt. Deze is linksonder te vinden.

De statistieken worden opgeslagen als &kbruch; wordt afgesloten, en worden weer hersteld bij het opnieuw starten van het programma.

## The Text Interface and Generator Mode

&kbruch; offers a text interface as well. You can start this interface directly from a shell:

``kbruch` `-t``

or

``kbruch` `--text``

Main Menu Main Menu

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:

``kbruch` `-g``

or

``kbruch` `--generate``

Generator Mode Generator Mode

As shown in the screenshot, you can stop the generator mode by pressing &Ctrl;C. 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.

## Dankbetuigingen en licentie

&kbruch;

Programma en documentatie: copyright 2001-2004 Sebastian Stein seb.kde@hpfsc.de

Dank aan:

- Anne-Marie Mahfouf voor het leiden van het &kde;-Eduproject

- Klas Kalass voor zijn hulp bij het uitdenken van het uiterlijk

- Eva Brucherseifer voor het schrijven van KMath (&kbruch;'s GUI (grafische interface) is hierop gebaseerd)

- Dominique Devriese voor het verhelpen van programmafouten

- Stefan Schumacher voor het testen van een erg vroege versie

- Sven Guckes for testing the text interface

- David Faure voor de hulp met &kde;--CVS en &kde;-Bugzilla

- Robert Gogolok voor de hulp met &kde;-CVS

- John Kesson voor het doorlezen op fouten van het handboek

&meld.fouten;&vertaling.jaap; &underFDL; &underGPL;

## Installatie

### Hoe &kbruch; te verkrijgen

&install.intro.documentation;

### Vereisten

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

U kunt &kbruch; vinden op de thuispagina van &kbruch; , en het programma maakt deel uit van het &kde;-Eduproject.

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

### Compileren en Installeren

&install.compile.documentation;
&documentation.index;