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

<book lang="&language;">

<bookinfo>
<title
>Das Handbuch zu &kbruch;</title>

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

<othercredit role="translator"
><firstname
>Sebastian</firstname
><surname
>Stein</surname
><affiliation
><address
><email
>kbruch@hpfsc.de</email
></address
></affiliation
><contrib
>Deutsche Übersetzung</contrib
></othercredit
> 

</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; ist ein kleines Programm zur Erzeugung von Aufgaben mit Brüchen. Der Nutzer muss die Aufgabe lösen, indem er die richtigen Werte für Zähler und Nenner eingibt. Das Programm überprüft die Eingabe und wertet diese aus. </para>
	
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>Bildung</keyword>
<keyword
>Bruch</keyword>
<keyword
>Mathematik</keyword>
<keyword
>Hauptnenner</keyword>
<keyword
>KBruch</keyword>
</keywordset>

</bookinfo>

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

<para
>&kbruch; ist ein kleines Programm zur Erzeugung von Aufgaben mit Brüchen. Der Nutzer muss die Aufgabe lösen, indem er die richtigen Werte für Zähler und Nenner eingibt. Das Programm überprüft die Eingabe und wertet diese aus. </para>
<para
>Die Aufgabenerzeugung kann über verschiedene Parameter angepasst werden. So kann der Nutzer entscheiden, ob er eine Aufgabe mit Addition/Subtraktion und/oder Multiplikation/Division lösen möchte. </para>
<para
>Es kann die Termanzahl und die maximale Größe des Hauptnenners angegeben werden. </para>
<para
>&kbruch; ist sehr kompakt und konzentriert sich auf die Idee eines Aufgabenerzeugers. Das Handbuch bietet Hilfe für die verschiedenen Situationen. </para>
<para
>&kbruch; bietet weiterhin eine reine Textoberfläche. D.h. man kann &kbruch; nutzen, ohne &X-Window; starten zu müssen. Dazu muss man die Kommandozeilenoption <option
>-t</option
> nutzen. </para>
<para
>Es ist frei und lizenziert unter der &GNU; Public License. </para>
</chapter>

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

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

<para
>Hier sieht man ein Bildschirmfoto von &kbruch;'s Hauptfenster:</para>

<screenshot>
	<screeninfo
>&kbruch; Hauptfenster, direkt nach dem Start</screeninfo>
	<mediaobject>
		<imageobject>
			<imagedata fileref="gui_main.png" format="PNG"/>
		</imageobject>
		<textobject>
			<phrase
>&kbruch; Hauptfenster</phrase>
		</textobject>
	</mediaobject>
</screenshot>


<para
>Die komplette Bedienung findet in diesem Fenster statt. Dadurch wird gesichert, dass &kbruch; einfach zu bedienen ist, sogar für junge Nutzer! Das Hauptfenster unterteilt sich in 4 Teile: <itemizedlist>
	<listitem
><para
>Die Menüzeile mit den 2 Menüs <guimenu
>Aufgabe</guimenu
> und <guimenu
>Hilfe</guimenu
>. </para
></listitem>
	<listitem
><para
>die Symbolleiste, mit der man die Schwierigkeit der gestellten Aufgaben anpassen kann </para
></listitem>
	<listitem
><para
>den Statistikteil wo man sehen kann, wieviel Aufgaben bereits gelöst wurden und wieviel davon richtig waren </para
></listitem>
	<listitem
><para
>den eigentlichen Aufgabenteil, wo man das entsprechende Ergebnis eingeben muss </para
></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="task_paras">
<title
>Aufgabenparameter</title>
<para
>Es gibt 3 Parameter, die die Schwierigkeit der Aufgaben steuern:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Terme</guilabel
></term>
<listitem
><para
>Die Anzahl von Termen in einer gegebenen Aufgabe, von 2 bis einschließlich 5.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>max. Größe des Hauptnenners</guilabel
></term>
<listitem
><para
>Die höchste Zahl für den Hauptnenner, die &kbruch; für eine Aufgabe ermitteln wird. Der Wert liegt zwischen 10 und 50.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rechenarten</guilabel
></term>
<listitem
><para
>Rechenarten, die in dieser Aufgabe genutzt werden sollen:<guilabel
>Addition/Subtraktion</guilabel
>, <guilabel
>Multiplikation/Division</guilabel
> oder <guilabel
>Alle Rechenarten gemischt</guilabel
>.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Nachdem man die Parameter eingestellt hat, muss man auf die <guimenu
>Neue Aufgabe</guimenu
> Schaltfläche in der Symbolleiste klicken. Dadurch wird eine neue Aufgabe unter Verwendung der neuen Parameter erstellt. Man findet diesen Befehl auch unter <menuchoice
><guimenu
>Aufgabe</guimenu
><guimenuitem
>Neue Aufgabe</guimenuitem
> </menuchoice
>. </para>
<note>
<para
>Jedesmal, wenn die Termanzahl geändert wird, wird die Einstellung für den max. Hauptnenner auf einen Standardwert zurückgesetzt. Deshalb sollte man zuerst die Termanzahl einstellen und erst dann den max. Hauptnenner. </para>
</note>
<para
>Wurde die aktuelle Aufgabe noch nicht gelöst und der Nutzer gibt den Befehl <guimenu
>Neue Aufgabe</guimenu
>, dann wird die aktuelle Aufgabe als falsch gelöst gewertet. Um dies zu verhindern, sollte man die Parameter nach der Überprüfung der Lösung ändern, aber bevor man eine neue Aufgabe erzeugen lässt. </para>
<para
>Die Parametereinstellungen werden beim Beenden von &kbruch; gespeichert und beim nächsten Start wiederhergestellt. </para>
</sect1>

<sect1 id="solve_task">
<title
>Aufgaben lösen</title>
<para
>Nachdem man die angezeigte Aufgabe gelöst hat, muss man das Ergebnis in die beiden Eingabefelder eintragen. In das obere Eingabefeld ist der Zähler einzutragen, in das untere Feld der Nenner. </para>
<para
>Falls das Ergebnis negativ ist, kann das entsprechende Minuszeichen entweder mit dem Zähler oder mit dem Nenner eingetragen werden. Falls das Ergebnis 0 ist, können beide Eingabefelder leer gelassen werden. Hat das Ergebnis einen Nenner von 1, kann das untere Eingabefeld leergelassen werden. </para>
<para
>Nachdem das Ergebnis eingetragen wurde, muss man auf die Schaltfläche <guimenu
>Überprüfe Aufgabe</guimenu
> unter den Eingabefeldern klicken. &kbruch; überprüft die Eingabe und zeigt das richtige Ergebnis an. Dazu verändert sich das Fenster ein wenig, wie auf dem Bildschirmfoto zu sehen ist: </para>
<screenshot>
<screeninfo
>Überprüfte Aufgabe</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="checked.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Überprüfte Aufgabe</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>Diese Aufgabe wurde richtig gelöst. Das richtige Ergebnis wird in 2 unterschiedlichen Schreibweisen angezeigt. Die 2. Form vor dem Wort RICHTIG wird nur in einigen Ländern verwendet und muss gelesen werden als 10 + 3/8 für die Aufgabe im Beispiel. </para>
<note>
<para
>Das Ergebnis muss immer gekürzt eingegeben werden, da die meisten Lehrer nur volle Punkte auf gekürzte Ergebnisse geben. &kbruch; zeigt einen kurzen Hinweis wie im unten dargestellten Bildschirmfoto, wenn man das richtige Ergebnis ungekürzt eingibt. </para>
</note>
<screenshot>
<screeninfo
>Ungekürztes Ergebnis</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="reduced.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Ungekürztes Ergebnis</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para
>Um mit der nächsten Aufgabe fortzufahren, klickt man auf die <guimenu
>Nächste Aufgabe</guimenu
> Schaltfläche. Möchte man die Parameter für die nächste Aufgabe ändern, dann muss dies vor dem Klick auf die Schaltfläche <guimenu
>Nächste Aufgabe</guimenu
> geschehen. </para>
</sect1>

<sect1 id="statistics">
<title
>Statistikteil</title>
<para
>In diesem Teil des Hauptfensters kann man ablesen: <itemizedlist>
	<listitem
><para
>wieviel Aufgaben bearbeitet wurden </para
></listitem>
	<listitem
><para
>wieviel Aufgaben richtig gelöst wurden </para
></listitem>
	<listitem
><para
>wieviel Aufgaben falsch gelöst wurden </para
></listitem>
</itemizedlist>
</para>
<para
>Man kann die Statistik über die <guimenu
>Zurücksetzen</guimenu
> Schaltfläche unter den Werten zurücksetzen. </para>
<para
>Die Statistikwerte werden beim Beenden von &kbruch; gespeichert und beim nächsten Start geladen. </para>
</sect1>

</chapter>

<chapter id="config">
<title
>Die Textoberfläche und der Erzeugermodus</title>
<para
>&kbruch; bietet eine reine Textoberfläche. Man startet diese Oberfläche direkt von der Kommandozeile: </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>-t</option
></userinput>
</para>
<para
>oder  </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>--text</option
></userinput>
</para>
<screenshot>
<screeninfo
>Hauptmenü</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="text_main.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Hauptmenü</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>Lehrer sind eventuell daran interessiert, eine große Anzahl von schwierigen Aufgaben erzeugen zu lassen. Für diesen Zweck gibt es den Erzeugermodus. Dieser kann nur von einer Kommandozeile aus aufgerufen werden: </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>-g</option
></userinput>
</para>
<para
>oder  </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>--generate</option
></userinput>
</para>
<screenshot>
<screeninfo
>Erzeugermodus</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="generator.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Erzeugermodus</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>Wie im Bildschirmfoto zu sehen ist, kann man den Erzeugermodus über die Tastenkombination <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
> beenden. Die Schwierigkeit der erzeugten Aufgaben kann nicht beeinflusst werden, da man keine Parameter wie Termanzahl, max. Hauptnenner oder gewünschte Rechenarten setzen kann. </para>
</chapter>

<chapter id="credits">

<title
>Mitwirkende und Lizenz</title>
<para
>&kbruch;</para>
<para
>Copyright für Programm und Dokumentation, 2001-2003 Sebastian Stein <email
>kbruch@hpfsc.de</email
> </para>

<para
>Dank geht an:</para>

<itemizedlist>
	<listitem
><para
>Anne-Marie Mahfouf für das Managen des &kde; Edu Projektes </para
></listitem>
	<listitem
><para
>Eva Brucherseifer für <application
>KMath</application
> (&kbruch;'s Oberfläche basiert auf dieser Arbeit) </para
></listitem>
	<listitem
><para
>Dominique Devriese für Fehlerbeseitigung </para
></listitem>
	<listitem
><para
><ulink url="http://www.net-tex.de/"
>Stefan Schumacher</ulink
> für den Test einer sehr frühen Version </para
></listitem>
	<listitem
><para
><ulink url="http://www.guckes.net/"
>Sven Guckes</ulink
> für den Test der Textoberfläche </para
></listitem>
	<listitem
><para
>David Faure für seine Unterstützung bei &kde; <acronym
>CVS</acronym
> und &kde; Bugzilla </para
></listitem>
	<listitem
><para
>Robert Gogolok für seine Unterstützung bei &kde; <acronym
>CVS</acronym
> </para
></listitem>
	<listitem
><para
>John Kesson für Korrekturlesen des Handbuchs </para
></listitem>
</itemizedlist>

<para
>Sebastian Stein<email
>kbruch@hpfsc.de</email
></para
> 
&underFDL; &underGPL; </chapter>

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

<sect1 id="getting-kbruch">
<title
>Woher man &kbruch; bekommt</title>
&install.intro.documentation; </sect1>

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

<para
>Um &kbruch; erfolgreich einsetzen zu können, braucht man &kde; 
> 3.1 . </para>

<para
>&kbruch; findet man unter <ulink url="http://edu.kde.org/kbruch/"
> der &kbruch; Homepage</ulink
>. &kbruch; ist ein Teil des &kde; Edu Projektes.</para>

<para
>Ein Liste mit Änderungen ist in der ChangeLog Datei im &kbruch; Paket zu finden, oder man verfolgt die <acronym
>CVS</acronym
> Commit Nachrichten.</para>

</sect1>

<sect1 id="compilation">
<title
>Kompilierung und 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
-->
