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

<book lang="&language;">

<bookinfo>
<title
>&kbruch;i käsiraamat</title>

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

<othercredit role="translator"
><firstname
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@online.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</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; on väike rakendus, mis aitab harjutada murdudega arvutamist. Kasutaja saab siin lahendada ülesandeid murdudele õigeid lugejaid ja nimetajaid määrates. Rakendus kontrollib vastuse õigsust ja annab teada, mida ta sellest arvab. </para>
	
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>haridus</keyword>
<keyword
>murrud</keyword>
<keyword
>matemaatika</keyword>
<keyword
>nimetaja</keyword>
<keyword
>kbruch</keyword>
</keywordset>

</bookinfo>

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

<para
>&kbruch; on väike rakendus, mis aitab harjutada murdudega arvutamist. Kasutaja saab siin lahendada ülesandeid murdudele õigeid lugejaid ja nimetajaid määrates. Rakendus kontrollib vastuse õigsust ja annab teada, mida ta sellest arvab. </para>
<para
>Ülesannete loomist on võimalik väga mitmeti kohandada. Nii saab kasutaja näiteks otsustada, kas soovib lahendada liitmis-lahutamisülesandeid või korrutamis-jagamistehteid või neid kõiki segiläbi. </para>
<para
>Samuti saab määrata, mitu tehet tehakse ja kui suur võib olla vastuse nimetaja. </para>
<para
>&kbruch; on väga kompaktne ning keskendub ennekõike oma peamisele eesmärgile luua ülesandeid. Abisüsteem pakub kontekstile vastavat infot erinevate olukordade selgitamiseks. </para>
<para
>&kbruch;i on võimalik kasutada ka tekstirežiimis, see tähendab, et &kbruch;i saab kasutada ka siis, kui &X-Window; ei tööta. Selle võimaluse kasutamiseks tuleb käsureal anda võti <option
>-t</option
>. </para>
<para
>KBruch on vaba tarkvara, mida levitatakse vastavalt &GNU; Avalikule Litsentsile. </para>
</chapter>

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

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

<para
>&kbruch;i peaaken:</para>

<screenshot>
	<screeninfo
>&kbruch;i peaaken kohe pärast käivitamist</screeninfo>
	<mediaobject>
		<imageobject>
			<imagedata fileref="gui_main.png" format="PNG"/>
		</imageobject>
		<textobject>
			<phrase
>&kbruch;i peaaken</phrase>
		</textobject>
	</mediaobject>
</screenshot>


<para
>Kogu tegevus toimbuki selles aknas. Nii saavad &kbruch;i kasutada ka päris väikesed lapsed. Peaaken on jagatud neljaks: <itemizedlist>
	<listitem
><para
>menüüriba kahe menüüga (<guimenu
>Ülesanne</guimenu
> ja <guimenu
>Abi</guimenu
>) </para
></listitem>
	<listitem
><para
>tööriistariba, kus saab määrata loodavate ülesannete raskusastme </para
></listitem>
	<listitem
><para
>statistikaosa, kus saab näha, kui palju ülesandeid on kokku proovitud lahendada ja kui palju neist on õigesti lahendatud </para
></listitem>
	<listitem
><para
>ülesandeosa, kus saab anda esitatud ülesandele vastuse </para
></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="task_paras">
<title
>Ülesande parameetrid</title>
<para
>Loodava ülesande raskusastet mõjutab kolm parameetrit:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Tegurid</guilabel
></term>
<listitem
><para
>Tegurite (erinevate murdude) arv iga ülesande jaoks kahest viieni (kaasa arvatud).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Nimetaja maks. väärtus</guilabel
></term>
<listitem
><para
>Suurim number, mida &kbruch; kasutab loodavates ülesannetes nimetajana (minimaalselt 10, maksimaalselt 50).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Tehted</guilabel
></term>
<listitem
><para
>Tehted, mida ülesannetes kasutada: <guilabel
>Liitmine/lahutamine</guilabel
>, <guilabel
>Korrutamine/jagamine</guilabel
> või <guilabel
>Kõik tehted segiläbi</guilabel
>.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Pärast parameetrite muutmist tuleb vastava ülesande loomiseks klõpsata tööriistaribal nupule <guimenu
>Uus ülesanne</guimenu
>. Seda võib teha ka menüükäsuga <menuchoice
><guimenu
>Ülesanne</guimenu
><guimenuitem
>Uus ülesanne</guimenuitem
></menuchoice
>. </para>
<note>
<para
>Nimetaja maksimaalne väärtus määratakse alati vaikeväärtusele, kui muuta tehete arvu. Seepärast tuleb alati esmalt muuta tehete arvu ja alles seejärel valida nimetaja maksimaalne väärtus. </para>
</note>
<para
>Kui käesolev ülesanne ei ole lahendatud, kuid sa annad käsu <guimenu
>Uus ülesanne</guimenu
>, loetakse käesolev ülesanne valesti lahendatuks. Selle vältimiseks tuleb muuta parameetreid pärast seda, kui ülesanne on lahendatud, kuid enne uue ülesande käivitamist. </para>
<para
>Valitud parameetrid salvestatakse &kbruch;i sulgemisel ja need taastatakse rakenduse uuel käivitamisel. </para>
</sect1>

<sect1 id="solve_task">
<title
>Ülesannete lahendamine</title>
<para
>Kui oled ülesande lahendanud, tuleb vastus kirjutada kahte sisendkasti, millest ülemine on lugeja ja alumine nimetaja jaoks. </para>
<para
>Kui tulemus on negatiivne, võib miinusmärgi kirjutada kas lugeja või nimetaja ette. Kui tulemus on 0, võib mõlemad kastid tühjaks jätta. Kui tulemuse nimetaja on 1, võib tühjaks jätta alumise kasti. </para>
<para
>Kui vastus on antud, tuleb klõpsata sisendkastide all asuvale nupule <guimenu
>Kontrolli vastust</guimenu
>. &kbruch; kontrollib siis sinu vastust ja näitab õiget vastust. See toob kaasa peaekraani kerge muutumise, mida võib näha allpool: </para>
<screenshot>
<screeninfo
>Kontrollitud ülesanne</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="checked.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Kontrollitud ülesanne</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>See ülesanne lahendati õigesti. Õiget vastust näidatakse kahel viisil, teine neist, mis seisab otse sõna ÕIGE ees, on kasutusel ainult üksikutes maades ning antud juhul tuleb seda tõlgendada kui 4 + 1/4. </para>
<note>
<para
>Vastus tuleb alati anda taandatud kujul - nagu ka koolis hindavad õpetajad vastuse enamasti absoluutselt õigeks ainult siis, kui see on taandatud. Kui annad vastuse taandamata kujul, näitab &kbruch; järgmist teadaannet. </para>
</note>
<screenshot>
<screeninfo
>Taandamata tulemus</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="reduced.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Taandamata tulemus</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para
>Järgmise ülesande juurde asumiseks klõpsa nupule <guimenu
>Järgmine ülesanne</guimenu
>. Kui soovid muuta järgmise ülesande parameetreid, tee seda kohe ja alles pärast seda klõpsa nupule <guimenu
>Järgmine ülesanne</guimenu
>. </para>
</sect1>

<sect1 id="statistics">
<title
>Statistikaosa</title>
<para
>Peaakna selles osas on näha: <itemizedlist>
	<listitem
><para
>kui palju ülesandeid on lahendatud </para
></listitem>
	<listitem
><para
>kui palju ülesandeid on õigesti lahendatud </para
></listitem>
	<listitem
><para
>kui palju ülesandeid on valesti lahendatud </para
></listitem>
</itemizedlist>
</para>
<para
>Statistika saab nullida klõpsuga numbrite all asuvale nupule <guimenu
>Nulli</guimenu
>. </para>
<para
>Statistika salvestatakse &kbruch;i sulgemisel ja see taastatakse rakenduse uuel käivitamisel. </para>
</sect1>

</chapter>

<chapter id="config">
<title
>Tekstiliides ja genereerimisrežiim</title>
<para
>&kbruch; võimaldab kasutada ka tekstiliidest. Selle saab käivitada otse shellist käsuga: </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>-t</option
></userinput>
</para>
<para
>või </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>--text</option
></userinput>
</para>
<screenshot>
<screeninfo
>Peamenüü</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="text_main.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Peamenüü</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>Kui oled õpetaja, võib sind huvitada terve rea keerukate ülesannete loomine. Selleks pakub &kbruch; välja genereerimisrežiimi. Seda saab käivitada ainult käsurealt käsuga: </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>-g</option
></userinput>
</para>
<para
>või </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>--generate</option
></userinput>
</para>
<screenshot>
<screeninfo
>Genereerimisrežiim</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="generator.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Genereerimisrežiim</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>Nagu pildil näha, saab genereerimisrežiimi peatada klahvikäsuga <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>. Ülesannete genereerimist ei saa mõjutada, pole võimalik määrata parameetreid, nagu näiteks tehete arv, nimetaja maksimaalne väärtus või milliseid tehteid kasutada. </para>
</chapter>

<chapter id="credits">

<title
>Autorid ja litsents</title>
<para
>&kbruch;</para>
<para
>Rakenduse ja dokumentatsiooni autoriõigus 2001-2003: Sebastien Stein <email
>kbruch@hpfsc.de</email
> </para>

<para
>Tänu väärivad:</para>

<itemizedlist>
	<listitem
><para
>Anne-Marie Mahtouf &kde; Edu-projekti hooldamise eest </para
></listitem>
	<listitem
><para
>Eva Brucherseifer rakenduse <application
>KMath</application
> kirjutamise eest (sellele tugineb &kbruch;i graafiline kasutajaliides) </para
></listitem>
	<listitem
><para
>Dominique Devriese vigade parandamise eest </para
></listitem>
	<listitem
><para
><ulink url="http://www.net-tex.de/"
>Stefan Schumacher</ulink
> ühe varase versiooni testimise eest </para
></listitem>
	<listitem
><para
><ulink url="http://www.guckes.net/"
>Sven Guckes</ulink
> tekstiliidese testimise eest </para
></listitem>
	<listitem
><para
>David Faure abi eest &kde; <acronym
>CVS</acronym
>i ja &kde; Bugzilla kasutamisel </para
></listitem>
	<listitem
><para
>Robert Gogolok abi eest &kde; <acronym
>CVS</acronym
>i kasutamisel </para
></listitem>
	<listitem
><para
>John Kesson käsiraamatu korrektuuri lugemise eest </para
></listitem>
</itemizedlist>

<para
>Tõlge eesti keelde: Marek Laane <email
>bald@online.ee</email
></para
> 
&underFDL; &underGPL; </chapter>

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

<sect1 id="getting-kbruch">
<title
>Kuidas &kbruch;i hankida</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Nõuded</title>

<para
>&kbruch;i edukaks paigaldamiseks on vajalik &kde; 
> 3.1. </para>

<para
>&kbruch;i leiab <ulink url="http://edu.kde.org/kbruch/"
>&kbruch;i koduleheküljelt</ulink
>, see on üks osa &kde; Edu-projektist</para>

<para
>Muudatuste nimekirja leiab &kbruch;iga kaasatulevast failist ChangeLog, samuti saab neid uurida <acronym
>CVS</acronym
>i kirjete põhjal.</para>

</sect1>

<sect1 id="compilation">
<title
>Kompileerimine ja paigaldamine</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
-->
