# Manuel de &kbruch;

## Introduction

&kbruch; est un petit programme qui génère des opérations avec des fractions. L'utilisateur doit résoudre l'opération donnée en donnant la bonne valeur au numérateur et au dénominateur. Le programme vérifie la réponse et donne la bonne.

Le générateur d'équations peut être ajusté en utilisant différents paramètres. L'utilisateur peut décider s'il veut résoudre des opération d'addition/soustraction et/ou de multiplication/division.

Il est possible de préciser le nombre de fractions et le nombre maximum du dénominateur commun.

&kbruch; est très compact et se concentre sur l'idée de générer des opérations. Un système d'aide en ligne vous aidera dans les différentes situations.

&kbruch; possède aussi une interface en mode console. Cela signifie que vous pouvez utiliser &kbruch; sans démarrer &X-Window;. Pour ce faire, utilisez l'option `-t`.

Ce logiciel est libre et sous licence &GNU;.

## Utiliser &kbruch;

### Écran principal

Voici une capture d'écran de la fenêtre principale de &kbruch;.

Écran principal de &kbruch;, après le démarrage Écran principal de &kbruch;

Tout se passe sur cet écran. Ce qui signifie que &kbruch; est simple à utiliser pour les jeunes utilisateurs. L'écran principal est séparé en 4 parties :

- la barre de menus, composée de deux menus Tâche et Aide

- la barre d'outils, où vous pouvez régler la difficulté des opérations générées

- la partie statistique, où vous pouvez voir combien d'opérations ont été résolues correctement ou essayées

- la partie équation, ou vous aurez à écrire le résultat de l'opération donnée

### Paramètres des opérations

Il y a 3 paramètres qui influent sur la difficulté des tâches générées :

Termes

- Le nombre de termes (de fractions) donnés dans chaque opération, de 2 à 5, inclus.

Dénominateur commun maximum

- Le plus grand nombre que &kbruch; utilisera comme dénominateur commun dans les opérations qu'il produit. De 10 à 50.

Opérations

- Les opérations qui doivent être utilisée dans l'équation : Addition/Soustraction, Multiplication/Division ou Toutes les opérations.

Après avoir changé les paramètres, vous devrez cliquer sur Nouveau problème dans la barre d'outil pour générer une opération utilisant les nouveaux paramètres. Vous pouvez aussi lancer cette action depuis la barre de menus avec Tâche Nouveau problème.

Votre sélection du dénominateur commun maximum sera remise à sa valeur par défaut à chaque fois que vous changerez le nombre de termes. Vous devriez donc d'abord changer le nombre de termes puis sélectionner le dénominateur commun maximal.

Si vous n'avez pas résolu l'opération et lancez l'action Nouveau problème, la tâche sera comptée comme non résolue correctement. Pour vous prémunir de cela, vous devrez changer les paramètres après avoir résolu une opération mais avant en avoir généré une autre.

Les paramètres choisis seront enregistrés à la fermeture de &kbruch; et restaurés au prochain démarrage.

### Résoudre des opérations

Après avoir résolu une opération, vous devez donner le résultat dans les deux champs. Dans celui du haut, vous écrivez le numérateur et dans celui du bas, le dénominateur.

Si le résultat est négatif, vous pouvez écrire le signe moins devant le numérateur ou le dénominateur. Si le résultat est 0, vous pouvez laisser les champs vides. Si le résultat a comme dénominateur 1, vous pouvez laisser le champ du bas vide.

Après avoir donné les résultats, vous devez cliquer sur le bouton Vérifier la solution situé sous les champs. &kbruch; vérifiera votre proposition et présentera le résultat correct. Alors, l'écran changera un petit peu, comme vous pouvez le voir sur la capture d'écran.

Solution vérifiée Solution vérifiée

Cette opération a été résolue correctement. La bonne valeur est montrée en 2 formes différentes. La seconde forme, juste à côté du mot CORRECT n'est utilisée que dans quelques pays et doit être lue comme 3 + 1/3 dans le cas donné.

Vous aurez à donner le résultat simplifié, car la plupart des professeurs n'accordent tous les points que si la forme est réduite. &kbruch; vous montrera un message comme celui vu sur le résultat précédent, si le résultat n'est pas simplifié.

Résultat non simplifié Résultat non simplifié

Pour continuer vers l'opération suivante, cliquez sur le bouton opération suivante. Si vous voulez changer les paramètres pour l'opération suivante, faites-le avant de cliquer sur le bouton Problème suivant.

### Partie statistique

Dans cette partie de l'écran principal, vous pouvez voir :

- combien d'opérations ont été résolues

- combien d'opérations ont été résolues correctement

- combien d'opérations ont été mal résolues

Vous pouvez remettre à 0 en cliquant sur le bouton Réinitialisation.

Les statistiques seront enregistrées à la fermeture de &kbruch; et restaurées au prochain démarrage.

## L'interface en mode texte et le mode générateur.

&kbruch; offre une interface texte. Vous pouvez la lancer directement depuis une invite de commande :

``kbruch` `-t``

ou

``kbruch` `--text``

Menu Principal Menu Principal

Si vous êtes un professeur, vous pouvez être intéressé par la génération d'opérations compliquées. Pour cela, &kbruch; possède un mode générateur. Vous ne pouvez le faire que depuis la ligne de commande suivante :

``kbruch` `-g``

ou

``kbruch` `--generate``

Mode Générateur Mode Générateur

Comme montré sur la capture d'écran, vous pouvez arrêter le mode générateur en pressant &Ctrl;C. Il n'est pas possible d'influencer le générateur d'opérations. Vous ne pouvez pas le paramétrer en mettant le nombre de termes, le dénominateur commun maximum ou les opérations devant être utilisées.

## Remerciements et licence

&kbruch;

Programme et Documentation protégés par Copyright en 2001-2003 par Sebastian Stein kbruch@hpfsc.de

Mes remerciements vont à :

- Anne-Marie Mahfouf à la direction du projet Education de &kde;.

- Eva Brucherseifer pour avoir écritKMath (l'interface de &kbruch; est basée sur son travail)

- Dominique Devriese pour avoir corrigé les anomalies.

- Stefan Schumacher pour avoir testé une version alpha

- Sven Guckes pour avoir testé l'interface en mode texte

- David Faure pour m'avoir aidé avec le CVS de &kde; et le Bugzilla de &kde;.

- Robert Gogolok pour m'avoir aidé avec le CVSde &kde;

- John Kesson pour avoir relu ce guide

Traduction française par &SimonDepiets;.

&underFDL; &underGPL;

## Installation

### Comment obtenir &kbruch;

&install.intro.documentation;

### Configuration minimale

Pour utiliser &kbruch;, vous avez besoin de &kde; > 3.1.

On peut trouver &kbruch; sur la page de &kbruch; et il fait partie du projet Edu de &kde;

Vous pouvez trouver une liste des changements dans le fichier ChangeLog de la distribution de &kbruch; ou voir les fichiers CVS

### Compilation et Installation

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