<?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 % French "INCLUDE"
><!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title
>Manuel de &kbruch;</title>

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

&traducteurSimonDepiets; 

</authorgroup>

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

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2003-09-22</date>
<releaseinfo
>3.1.91</releaseinfo>

<abstract>
<para
>&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. </para>
	
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>education</keyword>
<keyword
>fraction</keyword>
<keyword
>mathématiques</keyword>
<keyword
>dénominateur</keyword>
<keyword
>kbruch</keyword>
</keywordset>

</bookinfo>

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

<para
>&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. </para>
<para
>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. </para>
<para
>Il est possible de préciser le nombre de fractions et le nombre maximum du dénominateur commun. </para>
<para
>&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. </para>
<para
>&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 <option
>-t</option
>. </para>
<para
>Ce logiciel est libre et sous licence &GNU;. </para>
</chapter>

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

<sect1 id="overview">
<title
>Écran principal</title>

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

<screenshot>
	<screeninfo
>Écran principal de &kbruch;, après le démarrage</screeninfo>
	<mediaobject>
		<imageobject>
			<imagedata fileref="gui_main.png" format="PNG"/>
		</imageobject>
		<textobject>
			<phrase
>Écran principal de &kbruch;</phrase>
		</textobject>
	</mediaobject>
</screenshot>


<para
>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 : <itemizedlist>
	<listitem
><para
>la barre de menus, composée de deux menus <guimenu
>Tâche</guimenu
> et <guimenu
>Aide</guimenu
> </para
></listitem>
	<listitem
><para
>la barre d'outils, où vous pouvez régler la difficulté des opérations générées </para
></listitem>
	<listitem
><para
>la partie statistique, où vous pouvez voir combien d'opérations ont été résolues correctement ou essayées </para
></listitem>
	<listitem
><para
>la partie équation, ou vous aurez à écrire le résultat de l'opération donnée </para
></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="task_paras">
<title
>Paramètres des opérations</title>
<para
>Il y a 3 paramètres qui influent sur la difficulté des tâches générées :</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Termes</guilabel
></term>
<listitem
><para
>Le nombre de termes (de fractions) donnés dans chaque opération, de 2 à 5, inclus.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Dénominateur commun maximum</guilabel
></term>
<listitem
><para
>Le plus grand nombre que &kbruch; utilisera comme dénominateur commun dans les opérations qu'il produit. De 10 à 50.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Opérations</guilabel
></term>
<listitem
><para
>Les opérations qui doivent être utilisée dans l'équation : <guilabel
>Addition/Soustraction</guilabel
>, <guilabel
>Multiplication/Division</guilabel
> ou <guilabel
>Toutes les opérations</guilabel
>.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Après avoir changé les paramètres, vous devrez cliquer sur <guimenu
>Nouveau problème</guimenu
> 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 <menuchoice
><guimenu
>Tâche</guimenu
><guimenuitem
>Nouveau problème</guimenuitem
></menuchoice
>. </para>
<note>
<para
>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. </para>
</note>
<para
>Si vous n'avez pas résolu l'opération et lancez l'action <guimenu
>Nouveau problème</guimenu
>, 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. </para>
<para
>Les paramètres choisis seront enregistrés à la fermeture de &kbruch; et restaurés au prochain démarrage. </para>
</sect1>

<sect1 id="solve_task">
<title
>Résoudre des opérations</title>
<para
>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. </para>
<para
>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. </para>
<para
>Après avoir donné les résultats, vous devez cliquer sur le bouton <guibutton
>Vérifier la solution</guibutton
> 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. </para>
<screenshot>
<screeninfo
>Solution vérifiée</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="checked.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Solution vérifiée</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>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 <guilabel
>CORRECT</guilabel
> n'est utilisée que dans quelques pays et doit être lue comme 3 + 1/3 dans le cas donné. </para>
<note>
<para
>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é. </para>
</note>
<screenshot>
<screeninfo
>Résultat non simplifié</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="reduced.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Résultat non simplifié</phrase>
  </textobject>
</mediaobject>
</screenshot>

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

<sect1 id="statistics">
<title
>Partie statistique</title>
<para
>Dans cette partie de l'écran principal, vous pouvez voir : <itemizedlist>
	<listitem
><para
>combien d'opérations ont été résolues </para
></listitem>
	<listitem
><para
>combien d'opérations ont été résolues correctement </para
></listitem>
	<listitem
><para
>combien d'opérations ont été mal résolues </para
></listitem>
</itemizedlist>
</para>
<para
>Vous pouvez remettre à 0 en cliquant sur le bouton <guimenu
>Réinitialisation</guimenu
>. </para>
<para
>Les statistiques seront enregistrées à la fermeture de &kbruch; et restaurées au prochain démarrage. </para>
</sect1>

</chapter>

<chapter id="config">
<title
>L'interface en mode texte et le mode générateur.</title>
<para
>&kbruch; offre une interface texte. Vous pouvez la lancer directement depuis une invite de commande : </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>-t</option
></userinput>
</para>
<para
>ou </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>--text</option
></userinput>
</para>
<screenshot>
<screeninfo
>Menu Principal</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="text_main.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Menu Principal</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>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 : </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>-g</option
></userinput>
</para>
<para
>ou </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>--generate</option
></userinput>
</para>
<screenshot>
<screeninfo
>Mode Générateur</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="generator.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Mode Générateur</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>Comme montré sur la capture d'écran, vous pouvez arrêter le mode générateur en pressant <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>. 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. </para>
</chapter>

<chapter id="credits">

<title
>Remerciements et licence</title>
<para
>&kbruch;</para>
<para
>Programme et Documentation protégés par Copyright en 2001-2003 par Sebastian Stein <email
>kbruch@hpfsc.de</email
> </para>

<para
>Mes remerciements vont à :</para>

<itemizedlist>
	<listitem
><para
>Anne-Marie Mahfouf à la direction du projet Education de &kde;. </para
></listitem>
	<listitem
><para
>Eva Brucherseifer pour avoir écrit<application
>KMath</application
> (l'interface de &kbruch; est basée sur son travail) </para
></listitem>
	<listitem
><para
>Dominique Devriese pour avoir corrigé les anomalies. </para
></listitem>
	<listitem
><para
><ulink url="http://www.net-tex.de/"
>Stefan Schumacher</ulink
> pour avoir testé une version alpha </para
></listitem>
	<listitem
><para
><ulink url="http://www.guckes.net/"
>Sven Guckes</ulink
> pour avoir testé l'interface en mode texte </para
></listitem>
	<listitem
><para
>David Faure pour m'avoir aidé avec le <acronym
>CVS</acronym
> de &kde; et le Bugzilla de &kde;. </para
></listitem>
	<listitem
><para
>Robert Gogolok pour m'avoir aidé avec le <acronym
>CVS</acronym
>de &kde; </para
></listitem>
	<listitem
><para
>John Kesson pour avoir relu ce guide </para
></listitem>
</itemizedlist>

<para
>Traduction française par &SimonDepiets;.</para
> 
&underFDL; &underGPL; </chapter>

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

<sect1 id="getting-kbruch">
<title
>Comment obtenir &kbruch;</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Configuration minimale</title>

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

<para
>On peut trouver &kbruch; sur <ulink url="http://edu.kde.org/kbruch/"
>la page de &kbruch;</ulink
> et il fait partie du projet Edu de &kde;</para>

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

</sect1>

<sect1 id="compilation">
<title
>Compilation et Installation</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
-->
