<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" 
"dtd/kdex.dtd" [

  <!ENTITY kappname "&cantor;">
  <!ENTITY package "kdeedu">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Estonian  "INCLUDE"
> 
]>
<book lang="&language;">

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

<authorgroup>
<author
><personname
> <firstname
>Alexander</firstname
> <surname
>Rieder</surname
> </personname
> <email
>alexanderrieder@gmail.com</email
> </author>
<othercredit role="translator"
><firstname
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@smail.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2009</year>
<holder
>Alexander Rieder</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2009-08-26</date>
<releaseinfo
>0.1</releaseinfo>

<abstract>
<para
>&cantor; on rakendus, mille eesmärk on pakkuda kena töölehevaadet teistele vaba takrvara matemaatikaprogrammidele. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>matemaatika</keyword>
<keyword
>matemaatika</keyword>
<keyword
>Cantor</keyword>
<keyword
>Sage</keyword>
<keyword
>R</keyword>
<keyword
>Maxima</keyword>
</keywordset>

</bookinfo>

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

<para
>&cantor; on rakendus, mis võimaldab kasutada oma lemmik-matemaatikarakendust kenas ja &kde;-ga lõimitud tööleheliideses. Mitmed dialoogid aitavad toime tulla levinumate ülesannetega ning töölehti on võimalik teistega jagada. </para>
</chapter>

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

<para
>Pilt: <screenshot>
<screeninfo
>&cantor;i pilt</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="screenshot.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Pilt</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>


<sect1 id="kapp-features">
<title
>&cantor;i omadused</title>
<itemizedlist>
  <listitem
><para
>Selgesti mõistetav töölehevaade avaldiste hindamiseks.</para
></listitem>
  <listitem
><para
>Töölehel näeb tulemusi graafiku kujul.</para
></listitem>
  <listitem
><para
>Lihtne pluginapõhine struktuur võimaldab lisada uusi taustaprogramme.</para
></listitem>
  <listitem
><para
>Uue kraami hankimise võimalus lubab alla laadida näidistöölehti (ja ka üles laadida).</para
></listitem>
  <listitem
><para
>Matemaatikavalemite kasutamine LaTeXi abil.</para
></listitem>
  <listitem
><para
>Taustaprogrammiteadlik süntaksi esiletõstmine.</para
></listitem>
  <listitem
><para
>Pluginapõhised abidialoogid levinumate ülesannete täitmiseks, näiteks funktsiooni integreerimiseks või maatriksi sisestamiseks.</para
></listitem>
</itemizedlist>
</sect1>

<sect1 id="backends">
<title
>&cantor;i taustaprogrammid</title>
<para
>&cantor; võimaldab kasutada mitut taustaprogrammi. Sinu valik sõltub sellest, mida soovid saavutada. </para>
<para
>Praegu on saadaval järgmised taustaprogrammid: <variablelist>
    <varlistentry>
      <term
>Sage:</term>
      <listitem>
	<para
>Sage on vaba ja avatud lähtekoodiga matemaatikatarkvara süsteem, mida levitatakse GPL litsentsi alusel. See ühendab paljude olemasolevate avatud lähtekoodiga pakettide võimsuse ühtse Pythonil põhineva liidese taha. Täpsemalt kõneleb sellest <ulink url="http://sagemath.org"
>http://sagemath.org</ulink
>. </para>
	</listitem>
    </varlistentry>
    <varlistentry>
      <term
>Maxima:</term>
      <listitem>
	<para
>Maxima on sümbol- ja arvavaldiste igakülgse kasutamise süsteem, kaasa arvatud diferentsiaalarvutus, integraalarvutus. Taylori read, Laplace'i teisendused, tavalised diferentsiaalvõrrandid, lineaarvõrrandite süsteemid, polünoomid ning hulgad, loendid, vektorid, maatriksid ja tensorid. Maxima tagab äärmiselt täpsed arvulised tulemused, kasutades selleks täpseid murde ning muutuva täpsusega täis- ja murdarve. Maxima võib esitada funktsioone ja andmeid kahe- ja kolmemõõtmeliste joonistena. Täpsemalt kõneleb sellest <ulink url="http://maxima.sourceforge.net"
>http://maxima.sourceforge.net</ulink
>. </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>R:</term>
      <listitem>
	<para
>R on statistiliste arvutuste ja graafika keel ja keskkond, sarnanedes S keelele ja keskkonnale. See pakub ohtralt statistika- (lineaarsed ja mittelineaarsed mudelid, klassikalised statistikatestid, aegridade analüüs, liigitamine, klasterdamine...) ja graafikameetodeid ning on äärmiselt hõlpsalt laiendatav. S keel on sageli statistikauuringute lemmiktööriist, R aga avatud lähtekoodiga tee neis osalemiseks. Täpsemalt kõneleb sellest <ulink url="http://www.r-project.org"
>http://www.r-project.org</ulink
>. </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>KAlgebra:</term>
      <listitem>
	<para
>KAlgebra on MathML-põhine graafikute arvutaja, mis kuulub KDE õpirakenduste projekti koosseisu. Täpsemat teavet annab veebilehekülg <ulink url="http://edu.kde.org/kalgebra/"
>http://edu.kde.org/kalgebra/</ulink
>. </para>
      </listitem>
    </varlistentry>
  </variablelist>
</para>
</sect1>

<sect1 id="workspace">
<title
>&cantor;i töötsoon</title>
<para>
<screenshot>
  <screeninfo
>&cantor;i töötsoon</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="screenshot.png" format="PNG"/>
    </imageobject>
    <imageobject>
      <imagedata fileref="screenshot.eps" format="EPS"/>
    </imageobject>
    <textobject>
      <phrase
>&cantor;i töötsoon</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>&cantor;i töötsoon koosneb kolmest osast: <orderedlist>
    <listitem
><para
>Kaardiriba, kus saab liikuda avatud töölehtede vahel;</para
></listitem>
    <listitem
><para
>Abipaneel, kus näeb käskude kohta teavet, kui sisestada "? käsk";</para
></listitem>
    <listitem
><para
>Tööleht ise.</para
></listitem>
  </orderedlist>
</para>
<sect2 id="worksheet">
<title
>Tööleht</title>
<para
>Tööleht on &cantor;i põhiline tööpiirkond. Selle abil saab sisestada avaldisi, lasta taustaprogrammil sooritada arvutusi ning vaadata tulemusi. Käsud, mida tööleht tunnistab, sõltuvad kasutatavast taustaprogrammist, mistõttu tuleb omandada vajaliku taustaprogrammi süntaks (selle juures on suureks abiks nupp Näita abi). Kui tead käsku, aga vajad täpsemat teavet, võid kirjutada "? käsk" ning töölehest paremal ilmubki nähtavale kontekstiabi. Kui soovid näha mõningaid näidistöölehti, vali menüüst <guimenu
>Fail</guimenu
> käsk <guimenuitem
>Laadi alla näidistöölehti</guimenuitem
> ning laadi alla töölehti, mida teised kasutajad on avalikuks teinud. </para>
<sect3 id="worksheet-settings">
  <title
>Seadistused</title>
  <para
>Menüü <guimenu
>Seadistused</guimenu
> võimaldab muuta mõningaid aktiivse töölehe välimuse seadistusi. </para>
  <variablelist>
    <varlistentry>
      <term
>Matemaatikavalemite kasutamine LaTeXi abil.</term>
      <listitem>
	<para
>See muudab viisi, kuidas näidatakse tulemusi. Sisselülitamise korral saadetakse tulemus läbi LaTeXi süsteemi, mis tagab visuaalselt kenad valemid. Näiteks <quote
>3*x^2*sqrt(2)*x+2/3</quote
> asemel näeb <inlinemediaobject>
	      <imageobject>
		<imagedata fileref="latex_formula.png" format="PNG"/>
	      </imageobject>
	      <imageobject>
		<imagedata fileref="latex_formula.eps" format="EPS"/>
	      </imageobject>
	      <textobject
><phrase
>3*x^2*sqrt(2)*x+2/3</phrase
></textobject>
	  </inlinemediaobject>
	</para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>Süntaksi esiletõstmine</term>
      <listitem>
	<para
>Süntaksi esiletõstmine suurendab koodi loetavust, tõstes eri värviga esile võtmesõnad või kokkukuuluvad sulud. </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term
>Lõpetamine</term>
      <listitem>
	<para
>Selle sisselülitamisel näitab &cantor; parajasti sisestatava käsu võimalikke kujusid, kui vajutad TAB-klahvi. Kui on ainult üks valik, sisestatakse see sinu eest. </para>
      </listitem>
    </varlistentry>
  <varlistentry>
    <term
>Reanumbrid</term>
    <listitem>
      <para
>See määrab, kas erinevate avaldiste ees on näha numbrid. Nii saab meeles hoida vanemaid tulemusi - Maximas käib see näiteks käsu <quote
>%O1</quote
> abil. </para>
    </listitem>
  </varlistentry>
  </variablelist>
</sect3>
</sect2>
</sect1>
<!--
<sect1 id="assistant-dlgs">
<title
>The assistant dialogs</title>
TODO add screenshots and descriptions of each assistant
</sect1>
-->
</chapter>
<chapter id="commands">
<title
>Käskude seletused</title>

<sect1 id="kapp-mainwindow">
<title
>&cantor;i peaaken</title>

<sect2 id="file-menu">
<title
>Menüü <guimenu
>Fail</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Uus</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Loob uue dokumendi</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Salvesta</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Salvestab dokumendi</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Välju</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Lõpetab</action
> &cantor;i töö</para
></listitem>
</varlistentry>
</variablelist>
</para>

</sect2>

<sect2 id="help-menu">
<title
>Menüü <guimenu
>Abi</guimenu
></title>
&help.menu.documentation; </sect2>

</sect1>
</chapter>

<chapter id="developers">
<title
>&cantor; arendajatele</title>

<para
>&cantor;it saab hõlpsasti laiendata pluginate abil. Kirjutada saab järgmisi asju <variablelist>
  <varlistentry>
    <term
>Taustaprogrammid:</term>
    <listitem>
      <para
>Uus taustaprogramm võimaldab kasutada &cantor;i liidest mõne teise programmiga. </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>Abilised:</term>
    <listitem>
      <para
>Abilised pakuvad dialooge levinumate ülesannete automatiseerimiseks (näiteks maatriksi sisestamine või skripti käivitamine). </para>
    </listitem>
  </varlistentry>
</variablelist>
</para>
<para
>Praegu puuduvad spetsiaalsed arendajate õppematerjalid ja API dokumentatsioon, nii et kui soovid pluginat kirjutada, tuleb endal lähtekoodi uurida. Kõik liiede definitsioonid asuvad kataloogis lib. Teostuse näidisteks on &cantor;iga kaasas olevad pluginad. </para>

</chapter>

<chapter id="faq">
<title
>Küsimused ja vastused</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
  <question
><para
>Menüükirje <guimenuitem
>Matemaatikavalemite kasutamine LaTeXi abil</guimenuitem
> puudub</para
></question>
  <answer
><para
>Kõik taustaprogrammid ei toeta kõiki võimalusi.</para
></answer>
</qandaentry>
<qandaentry>
  <question
><para
>Paigaldasin Sage/Maxima, aga vastavat taustaprogrammi pole näha.</para
></question>
  <answer>
    <para
>Asi võib olla selles, et &cantor; ei osanud seda üles leida. Ava seadistustedialoog ja muuda vajaliku rakenduse asukohta. </para>
  </answer>
</qandaentry>
<qandaentry>
  <question
><para
>Miks nii imelik nimi - mis on sellel pistmist matemaatikaga?</para
></question>
  <answer
><para
>Cantor on saanud nime saksa matemaatiku Georg Cantori järgi, kes oli hulgateooria looja.</para
></answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title
>Autorid ja litsents</title>

<para
>&cantor; </para>
<para
>Rakenduse autoriõigus 2009: Alexander Rieder <email
>alexanderrieder@gmail.com</email
> </para>

<para
>Dokumentatsiooni autoriõigus &copy; 2009: Alexander Rieder <email
>alexanderrieder@gmail.com</email
> </para>

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

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

<sect1 id="getting-kapp">
<title
>&cantor;i hankimine</title>
&install.intro.documentation; </sect1>

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

<para
>&cantor;i edukaks kasutamiseks on vajalik &kde; 4. Kui soovid ladumissüsteemi kasutada, peavad paigaldatud olema LaTeX ja LibSpectre. Kindla taustaprogrammi kasutamiseks peab paigaldatud olema vastav matemaatikapakett. </para>

<!--
<para>
All required libraries as well as &cantor; itself can be found
on <ulink url="ftp://ftp.kapp.org"
>The &cantor; home page</ulink
>.
</para>
-->


<!-- For a list of updates, you may refer to the application web site
or the ChangeLog file, or ... -->
<!--
<para>
You can find a list of changes at <ulink
url="http://apps.kde.org/kapp"
>http://apps.kde.org/kapp</ulink
>.
</para>
-->
</sect1>

<sect1 id="compilation">
<title
>Kompileerimine ja paigaldamine</title>
&install.compile.documentation; </sect1>

<sect1 id="configuration">
<title
>Seadistamine</title>

<para
>Sõltuvalt süsteemist võib olla vajalik muuta &cantor;i kasutatavate taustaprogrammide asukohta. </para>

</sect1>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->