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

<book lang="&language;">

<bookinfo>
<title
>Il manuale di &kbruch;</title>

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

<othercredit role="translator"
><firstname
>Pino</firstname
><surname
>Toscano</surname
><affiliation
><address
><email
>toscano.pino@tiscali.it</email
></address
></affiliation
><contrib
>Traduzione italiana</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; è un piccolo programma per generare esercizi con le frazioni. L'utente risolve gli esercizi inserirendo numeratore e denominatore corretti. Il programma controlla che i dati inseriti siano corretti e risponde di conseguenza. </para>
	
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>educazione</keyword>
<keyword
>frazione</keyword>
<keyword
>matematica</keyword>
<keyword
>denominatore</keyword>
<keyword
>kbruch</keyword>
</keywordset>

</bookinfo>

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

<para
>&kbruch; è un piccolo programma per generare esercizi con le frazioni. L'utente risolve gli esercizi inserirendo numeratore e denominatore corretti. Il programma controlla che i dati inseriti siano corretti e risponde di conseguenza. </para>
<para
>Il generatore di esercizi può essere impostato con vari parametri. L'utente può decidere di risolvere esercizi con addizione e sottrazione e/o moltiplicazione e divisione. </para>
<para
>È possibile inserire il numero di frazioni ed il massimo valore del denominatore principale. </para>
<para
>&kbruch; è un'applicazione molto compatta e si concentra sull'idea di un generatore di esercizi. Un sistema di aiuto contestuale fornisce informazioni riguardanti le varie situazioni. </para>
<para
>&kbruch; fornisce anche un'interfaccia di testo. Infatti, puoi usare &kbruch; senza avviare &X-Window;. Per fare ciò, usa l'opzione a riga di comando <option
>-t</option
>. </para>
<para
>È libero e rilasciato sotto la &GNU; Public License. </para>
</chapter>

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

<sect1 id="overview">
<title
>La finestra principale</title>

<para
>Possiamo vedere un'istantanea della finestra principale di &kbruch;:</para>

<screenshot>
	<screeninfo
>La finestra pricipale di &kbruch;, subito dopo il suo avvio</screeninfo>
	<mediaobject>
		<imageobject>
			<imagedata fileref="gui_main.png" format="PNG"/>
		</imageobject>
		<textobject>
			<phrase
>La finestra principale di &kbruch;</phrase>
		</textobject>
	</mediaobject>
</screenshot>


<para
>Tutte le azioni vengono eseguite in questa finestra. Per questo &kbruch; è molto facile da usare, anche per gli utenti giovani! La finestra principale è separata in 4 parti: <itemizedlist>
	<listitem
><para
>la barra dei menu con i due menu <guimenu
>Esercizio</guimenu
> e <guimenu
>Aiuto</guimenu
> </para
></listitem>
	<listitem
><para
>la barra degli strumenti, dove puoi impostare la difficoltà degli esercizi generati </para
></listitem>
	<listitem
><para
>la parte statistica, dove puoi vedere quanti esercizi hai risolto correttamente e quanti tentativi hai fatto </para
></listitem>
	<listitem
><para
>la parte dell'esercizio, dove inserisci il risultato dell'esercizio corrente </para
></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="task_paras">
<title
>Paramentri degli esercizi</title>
<para
>Ci sono 3 parametri che influenzano la difficoltà degli esercizi generati:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Frazioni</guilabel
></term>
<listitem
><para
>Il numero di frazioni, compreso tra 2 e 5 (entrambi inclusi), presenti in ogni esercizio.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Max denom. principale</guilabel
></term>
<listitem
><para
>Il più alto numero che &kbruch; userà come denominatore principale negli esercizi; varia da un minimo di 10 ad un massimo di 50.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Operazioni</guilabel
></term>
<listitem
><para
>Le operazioni su cui lavorare nell'esercizio: <guilabel
>Addizione/sottrazione</guilabel
>, <guilabel
>Moltiplicazione/divisione</guilabel
> o <guilabel
>Tutte le operazioni</guilabel
>.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Dopo aver cambiato i parametri è necessario fare clic sul pulsante <guimenu
>Nuovo esercizio</guimenu
> nella barra degli strumenti per generare un esercizio con i nuovi parametri. Puoi richiamare quest'azione anche dalla barra dei menu scegliendo <menuchoice
><guimenu
>Esercizio</guimenu
><guimenuitem
>Nuovo esercizio</guimenuitem
></menuchoice
>. </para>
<note>
<para
>Qualsiasi cambiamento al numero di frazioni provoca il ritorno del valore del massimo denominatore principale al valore predefinito. Così devi cambiare prima il numero di frazioni e dopo il massimo denominatore principale. </para>
</note>
<para
>Se non hai risolto l'esercizio corrente e selezioni <guimenu
>Nuovo esercizio</guimenu
>, l'esercizio sarà contato come non risolto correttamente. Per evitare questo inconveniente cambia i parametri dopo aver risolto un esercizio ma prima di generarne uno nuovo. </para>
<para
>I parametri scelti vengono salvati all'uscita da &kbruch; e ripristinati al successivo avvio. </para>
</sect1>

<sect1 id="solve_task">
<title
>Risolvere gli esercizi</title>
<para
>Dopo aver risolto l'esercizio, inserisci il risultato nelle due caselle. Inserisci il numeratore in quella in alto e il denominatore in quella in basso. </para>
<para
>Se il risultato è negativo, il segno meno può essere inserito sia al numeratore sia al demoninatore. Se il risultato è 0, puoi lasciare entrambe le caselle vuote. Se il risultato ha il denominatore uguale a 1, puoi lasciare vuota la casella in basso. </para>
<para
>Dopo aver inserito il risultato fai clic sul pulsante <guimenu
>Controlla esercizio</guimenu
> che si trova sotto le caselle di testo. &kbruch; controllerà i dati inseriti e mostrerà il risultato corretto. La finestra principale cambia quindi un po', come puoi vedere nell'istantenea: </para>
<screenshot>
<screeninfo
>Un esercizio controllato</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="checked.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Un esercizio controllato</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>Questo esercizio è stato risolto correttamente. Il valore corretto è mostrato in 2 forme. La seconda forma che si trova subito davanti alla parola <guilabel
>CORRETTO</guilabel
> è usata solo in alcuni paesi e deve essere letta come 4 + 1/4 nel nostro caso. </para>
<note>
<para
>Devi sempre inserire il risultato ridotto, poiché molti insegnati considerano più corretti solo tali risultati. Se inserisci il risultato non ridotto, &kbruch; mostrerà un piccolo messaggio come quello nell'istantanea sottostante. </para>
</note>
<screenshot>
<screeninfo
>Un risultato non ridotto</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="reduced.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Un risultato non ridotto</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para
>Per continuare con l'esercizio successivo, fai clic sul pulsante <guimenu
>Prossimo esercizio</guimenu
>. Se vuoi cambiare i parametri per l'esercizio successivo fallo prima di fare clic sul pulsante <guimenu
>Prossimo esercizio</guimenu
>. </para>
</sect1>

<sect1 id="statistics">
<title
>La parte statistica</title>
<para
>In questa parte della finestra puoi vedere: <itemizedlist>
	<listitem
><para
>quanti esercizi sono stati risolti </para
></listitem>
	<listitem
><para
>quanti esercizi sono stati risolti correttamente </para
></listitem>
	<listitem
><para
>quanti esercizi non sono stati risolti correttamente </para
></listitem>
</itemizedlist>
</para>
<para
>Puoi azzerare le statistiche facendo clic sul pulsante <guimenu
>Azzera</guimenu
> in basso. </para>
<para
>Le statistiche sono salvate all'uscita da &kbruch; e ripristinate al successivo avvio. </para>
</sect1>

</chapter>

<chapter id="config">
<title
>L'interfaccia di testo e la modalità generatore</title>
<para
>&kbruch; offre anche un'interfaccia di testo. Puoi avviare quest'interfaccia direttamente da una shell: </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>-t</option
></userinput>
</para>
<para
>o </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>--text</option
></userinput>
</para>
<screenshot>
<screeninfo
>Il menu principale</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="text_main.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Il menu principale</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>Se sei un insegnante potresti essere interessato a generare molti esercizi complicati. &kbruch; fornisce per questo scopo una modalità generatore. Puoi avviarla solo da riga di comando: </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>-g</option
></userinput>
</para>
<para
>o </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>--generate</option
></userinput>
</para>
<screenshot>
<screeninfo
>La modalità generatore</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="generator.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>La modalità generatore</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>Come mostrato nell'istantanea, puoi fermare la modalità generatore premendo <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>. Non è possibile influenzare il generatore di esercizi: non puoi impostare, quindi, i parametri, quali il numero di frazioni, il massimo denominatore principale e il tipo di operazioni presenti. </para>
</chapter>

<chapter id="credits">

<title
>Ringraziamenti e licenza</title>
<para
>&kbruch;</para>
<para
>Copyright del programma e della documentazione, 2001-2003 Sebastian Stein <email
>kbruch@hpfsc.de</email
> </para>

<para
>I ringraziamenti vanno a:</para>

<itemizedlist>
	<listitem
><para
>Anne-Marie Mahfouf per la gestione del progetto &kde; Edu </para
></listitem>
	<listitem
><para
>Eva Brucherseifer per aver scritto <application
>KMath</application
> (l'interfaccia grafica di &kbruch; si basa su questo programma) </para
></listitem>
	<listitem
><para
>Dominique Devriese per correzioni di bug </para
></listitem>
	<listitem
><para
><ulink url="http://www.net-tex.de/"
>Stefan Schumacher</ulink
> per aver provato una delle prime versioni </para
></listitem>
	<listitem
><para
><ulink url="http://www.guckes.net/"
>Sven Guckes</ulink
> per aver provato l'interfaccia di testo </para
></listitem>
	<listitem
><para
>David Faure per aver aiutato con il <acronym
>CVS</acronym
> e Bugzilla di &kde; </para
></listitem>
	<listitem
><para
>Robert Gogolok per aver aiutato con il <acronym
>CVS</acronym
> di &kde; </para
></listitem>
	<listitem
><para
>John Kesson per aver letto una bozza del manuale </para
></listitem>
</itemizedlist>

<para
>Traduzione italiana di Pino Toscano <email
>toscano.pino@tiscali.it</email
></para
> 
&underFDL; &underGPL; </chapter>

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

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

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

<para
>Per usare &kbruch; senza problemi è necessario &kde; 3.1 o successivo </para>

<para
>&kbruch; può essere trovato sulla <ulink url="http://edu.kde.org/kbruch/"
>homepage di &kbruch;</ulink
> ed è parte del progetto &kde; Edu</para>

<para
>Puoi trovare una lista delle modifiche nel file ChangeLog nella distribuzione di &kbruch; o guardando i messaggi di commit sul <acronym
>CVS</acronym
>.</para>

</sect1>

<sect1 id="compilation">
<title
>Compilazione e installazione</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
-->
