<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!-- Define an entity for your application if it is not part of KDE
       SVN -->
  <!ENTITY mancala "Mancala">
  <!ENTITY kappname "&mancala;">
  <!ENTITY package "kdegames"
><!-- kdebase, kdeadmin, etc.  Leave
                                     this unchanged if your
                                     application is not maintained in KDE CVS -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Estonian  "INCLUDE">
]>
<!-- ................................................................ -->

<book lang="&language;">
<bookinfo>
<title
>&mancala; käsiraamat</title>

<authorgroup>
	<author
><firstname
>A.H.M. Mahfuzur</firstname
> <surname
>Rahman</surname
> <affiliation
> <address
>65mahfuz90@gmail.com</address>
		</affiliation>
	</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-2010</year>
	<holder
>A.H.M. Mahfuzur Rahman</holder>
</copyright>

<!--<legalnotice
>&FDLNotice;</legalnotice
>-->

<date
>2010-04-05</date>
<releaseinfo
>0.2</releaseinfo>

<abstract>
	<para
>&mancala; on terve rea kõikjal maailma mängitava mängu avatud lähtekoodiga versioon. Mängu nimi <quote
>&mancala;</quote
> tuleneb araabia sõnast <quote
>naqala</quote
>, mis otsetõlkes tähendab <quote
>liikuma</quote
>.</para>
</abstract>
<keywordset>
	<keyword
>KDE</keyword>
	<keyword
>kdegames</keyword
> <!-- do not change this! -->
	<keyword
>mäng</keyword
> <!-- do not change this! -->
	<keyword
>mancala</keyword
><!--Application name goes here-->
<!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<keyword
>loogikamäng</keyword>
	<keyword
>lauamäng</keyword>
<!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<keyword
>üks mängija</keyword>
</keywordset>
</bookinfo>

<!-- The contents of the documentation begin here.  Label
each chapter so with the id attribute. This is necessary for two reasons: it
allows you to easily reference the chapter from other chapters of your
document, and if there is no ID, the name of the generated HTML files will vary
from time to time making it hard to manage for maintainers and for the CVS
system. Any chapter labelled (OPTIONAL) may be left out at the author's
discretion. Other chapters should not be left out in order to maintain a
consistent documentation style across all KDE apps. -->

<chapter id="introduction">
    <title
>Sissejuhatus</title>
	<note
><title
>Mängu tüüp:</title
><para
>loogikamäng, lauamäng</para
></note
><!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<note
><title
>Mängijate arv:</title
><para
>Üks</para
></note
><!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<para
>Mancala on ühe mängijaga lauamäng. Õigupoolest pole see üks mäng, vaid terve mängude kogu.</para>
	<para
>Mancala mängimiseks on vajalik laud, mõned tassid ja kivid. Tasside ja kivide arv igas tassis erineb mänguti. Kui lauda pole käepärast, võib seda mängida kas või otse maas. Mõnel pool kasutatakse tasside asemel merikarpe või maasse süvendatud pesasid. Kivide osa võivad täita mis tahes esemed. </para>
	<para
>Mancalal on väga palju variante. Käesoleval juhul on aluseks võetud kaherealine mancala kahe mängijaga (üks inimene, teine arvuti). </para>
<!-- The introduction chapter contains a brief introduction for the
application that explains what it does and where to report
problems. Basically a long version of the abstract.  Don't include a
revision history. (see installation appendix comment) -->
</chapter>

<chapter id="howto">
    <title
>Kuidas mängida</title
> <!-- do not change this! -->
<!--IMPORTANT: If the game has no defined objective, please remove the below line.-->
	<note
><title
>Eesmärk:</title>
	<para
>Hõivata rohkem kive kui vastane.</para
></note
><!--Describe the objective of the game.-->
    <sect1 id="starting">
    <title
>Mängu alustamine</title>
<!--How to play description. Don't be to specific on rules as they have a separate section in this document-->
      <screenshot>
        <screeninfo
>&mancala; liides</screeninfo>
        <mediaobject>
          <imageobject
><imagedata format="PNG" fileref="main_window.png"/></imageobject>
          <textobject
><phrase
>&mancala; liides</phrase
></textobject>
        </mediaobject>
      </screenshot>
   <para
>Sel pildil näeb, mismoodi &mancala; välja näeb. Liides on õige lihtne.</para>
   
   <para
>Pildil on näha mäng nimega kalah. Teisi mänguvariante võib valida liitkastist või menüükäsuga <menuchoice
><guimenu
>Fail</guimenu
><guisubmenu
>Uus mäng</guisubmenu
><guimenuitem
><replaceable
>Mängu nimi</replaceable
></guimenuitem
></menuchoice
>.</para>
   
   <note
><title
>Märkus:</title
><para
>Mängureeglite põhjaliku kirjelduse leiab käsiraamatu osadest <link linkend="basic_concept"
>Põhialused</link
> and <link linkend="game_specific_rules"
>Konkreetsete mängude reeglid</link
>.</para
></note>
   
   <para
>Kui soovid mängu mis tahes hetkel taaskäivitada, saab seda teha kas tööriistaribale klõpsates või valides menüükäsu <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Käivita mäng uuesti</guimenuitem
></menuchoice
>.</para>
   
   <para
>Valida saab ka mängu raskusastme: Praegu on olemas kolm astet: lihtne, keskmine ja raske. Astme saab valida olekuribalt või menüükäsuga <menuchoice
><guimenu
>Seadistused</guimenu
><guisubmenu
>Raskusaste</guisubmenu
><guimenuitem
><replaceable
>aste</replaceable
></guimenuitem
></menuchoice
>.</para>
   
   <para
>Kui teed midagi, mis ei ole lubatud, näidatakse selle kohta teadet olekuribal. Kui näiteks mõni pesa on tühi ja sa soovid siiski just sealt liikuda, siis öeldakse sulle: <quote
>Vabandust, käiguks ei jagu kive.</quote
></para>
   </sect1>
  
    <sect1 id="basic_concept">
    <title
>Põhialused</title>
      <para
>&mancala; sisaldab praegu seitse mängu: kalah, oware, barbados_warri, bechi, dakon, sungka ja chungka.</para>
   
      <para
>Enne iga mängu seletamist tuleks tutvustada mõningaid mancala mängudele üldiselt kehtivaid reegleid. Kõigi mängude kirjeldamine väljub käsiraamatu ulatusest, mistõttu keskendutakse ainult käesolevasse mängurakendusse kaasatud mängudele.</para>
      
      <para
>Kõik kaherealised mängud sisaldavad mitut tassi (rakenduses pesa) ning igas neis mitut kivi. Pesade arv võib mänguti erineda. Mängija päralt on mõned pesad ja suur pesa, mis toimib hoiukohana. Kivisid saab liigutada pesast pesasse, aga kui see on pandud hoiukohta, siis sinna see ka jääb.</para>
      <para
>Kõigepealt tuleb paika panna mõned kriteeriumid:</para>
      <variablelist>
       <varlistentry>
          <term
><emphasis
>Minimaalne külvatavate kivide arv</emphasis
></term>
          <listitem>
             <para
>Kivide arv pesas, mida on vaja lubatud käigu sooritamiseks, erineb mänguti. Kalahi puhul on selleks üks, bechi puhul aga kaks kivi.</para>
          </listitem>
       </varlistentry>
       <varlistentry>
          <term
><emphasis
>Pärast külvi allesjäävate kivide arv</emphasis
></term>
          <listitem>
             <para
>Pärast käimist jääb mõnes mängus pesa tühjaks, aga mõnes on nõutav, et sinna jääks teatav arv kive. Kalahis võib pesa tühjaks jääda, aga bechi puhul on nõutav, et alles jääks üks kivi.</para>
          </listitem>
       </varlistentry>
       <varlistentry>
          <term
><emphasis
>Liikumise suund</emphasis
></term>
          <listitem>
             <para
>Mõnes mängus liigub mängija päri-, mõnes aga vastupäeva. Lubatud on isegi tingimusliku suunaga liikumine (bechi puhul).</para>
          </listitem>
       </varlistentry>
       <varlistentry>
          <term
><emphasis
>Külvamine</emphasis
></term>
          <listitem>
             <para
>Mängija käiku nimetatakse külvamiseks. Mängija peab oma käigu korral valima pesa, kust ta hakkab liikuma ehk külvama. Lubatud on kaks eri tüüpi külvamist:</para>
             <itemizedlist>
               <listitem>
                 <para
>Ühekordne: kehtib näiteks kalahis. Kui mängija valib käiguks pesa ning selles on minimaalselt käiguks vajalik arv kive, siis jäetakse pessa nõutud arv kive ning teised kaotatakse (ühekaupa) järgmistesse pesadesse (liikumissuunas) või hoiukohta, kuni kivid on otsas. Kui viimane kivi satub hoiukohta, võib järgneda boonuskäik (kui see on üldse lubatud). Võimalik on ka hõivamine, kui viimane kivi satub mängija pessa (ristihõive, kui see on lubatud) või vastase pessa (arvhõive ja ridahõive).</para>
               </listitem>
               <listitem>
                 <para
>Mitmekordne: kui esimese külvi viimane kivi satub pessa, kus sellega tekib nii palju kive, et on võimalik teha käik, siis võetakse ette teine külvamine. See kestab seni, kuni kivi satub pessa, kust enam käia ei saa.</para>
               </listitem>
              </itemizedlist>
          </listitem>
       </varlistentry>
       <varlistentry>
          <term
><emphasis
>Boonuskäik</emphasis
></term>
          <listitem>
             <para
>Mõnes mängus on lubatud boonuskäik, kui viimane kivi satub mängija hoiukohta. Näide: kalah.</para>
          </listitem>
       </varlistentry>
       <varlistentry>
          <term
><emphasis
>Hõive</emphasis
></term>
          <listitem>
             <para
>Mängudes on kasutusel eri tüüpi hõived, nimelt:</para>
             <itemizedlist>
               <listitem>
                 <para
>Risthõive: kui viimane kivi satub (mängija poolel) pessa, mis oli varem tühi, siis ta hõivab kõik kivid, mis asuvad otse selle vastu jäävas vastase poole pesas (kui seal kive on). Näide: kalah.</para>
               </listitem>
               <listitem>
                 <para
>Arvhõive: kui viimane kivi satub vastase pessa ning sinna tekib selle tulemusel teatav kindel arv kive, siis saab need hõivata. Näide: oware, kui arv on 2 või 3.</para>
               </listitem>
               <listitem>
                 <para
>Ridahõive: kui arvhõive on lubatud ning (sõltuvalt mängust) vastase eelmised või järgmised pesad sisaldavad sama arvu kive, siis hõivatakse ka need, kuni reegel enam ei kehti. Näited: oware, barbados_warri, bechi.</para>
               </listitem>
              </itemizedlist>
          </listitem>
       </varlistentry>
    </variablelist>
   <para
>Selles mängus teeb esimese käigu inimene. Mängaja pool on alumine pool. Käik tähendab vajadust külvata. Kui pärast käiku on võimalik kive hõivata, siis seda ka tehakse. Kui boonuskäik on lubatud ja võimalik, siis võetakse ka see ette. Pärast mängijat jõuab kätte arvuti kord käia. Nii kestab mäng seni, kuni täidetakse eesmärk. Selleks on rohkendada kivide arvu hoiukohas. Kui kõik kivid on seal, on läbi ka mäng. Rohkem kive kogunud mängija võidab.</para>
   </sect1>

      <sect1 id="game_specific_rules">
      <title
>Konkreetsete mängude reeglid</title>
         <para
>Mängud erinevad mõnevõrra ja neist erinevustest tulebki allpool juttu.</para>
   <para
><emphasis
>Kalah</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Piirkond</segtitle>
       <segtitle
>Külvamine</segtitle>
       <segtitle
>Liikumine</segtitle>
       <segtitle
>Min. külvatavate kivide arv</segtitle>
       <segtitle
>Laua suurus</segtitle>
       <segtitle
>Kive pesas</segtitle>
       <segtitle
>Hõive</segtitle>
       <segtitle
>Boonuskäik</segtitle>
       <seglistitem
><seg
>Lähis-Ida</seg
><seg
>ühekordne</seg
><seg
>vastupäeva</seg
><seg
>1</seg
><seg
>2 x 6 (2 rida, 6 pesa igas reas)</seg
><seg
>4</seg
><seg
>risthõive</seg
><seg
>lubatud</seg>
       </seglistitem>
   </segmentedlist>
   <para
><emphasis
>Oware</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Piirkond</segtitle>
       <segtitle
>Külvamine</segtitle>
       <segtitle
>Liikumine</segtitle>
       <segtitle
>Min. külvatavate kivide arv</segtitle>
       <segtitle
>Laua suurus</segtitle>
       <segtitle
>Kive pesas</segtitle>
       <segtitle
>Hõive</segtitle>
       <segtitle
>Boonuskäik</segtitle>
       <seglistitem
><seg
>Ghana</seg
><seg
>ühekordne</seg
><seg
>vastupäeva</seg
><seg
>1</seg
><seg
>2 x 6</seg
><seg
>4</seg
><seg
>arv- ja ridahõive (2 või 3)</seg
><seg
>pole lubatud</seg>
       </seglistitem>
   </segmentedlist>
   <para
><emphasis
>Barbados Warri</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Piirkond</segtitle>
       <segtitle
>Külvamine</segtitle>
       <segtitle
>Liikumine</segtitle>
       <segtitle
>Min. külvatavate kivide arv</segtitle>
       <segtitle
>Laua suurus</segtitle>
       <segtitle
>Kive pesas</segtitle>
       <segtitle
>Hõive</segtitle>
       <segtitle
>Boonuskäik</segtitle>
       <seglistitem
><seg
>Barbados</seg
><seg
>ühekordne</seg
><seg
>vastupäeva</seg
><seg
>1</seg
><seg
>2 x 6</seg
><seg
>4</seg
><seg
>arv- ja ridahõive (2 või 3)</seg
><seg
>pole lubatud</seg>
       </seglistitem>
   </segmentedlist>
   <para
><emphasis
>Bechi</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Piirkond</segtitle>
       <segtitle
>Külvamine</segtitle>
       <segtitle
>Liikumine</segtitle>
       <segtitle
>Min. külvatavate kivide arv</segtitle>
       <segtitle
>Laua suurus</segtitle>
       <segtitle
>Kive pesas</segtitle>
       <segtitle
>Hõive</segtitle>
       <segtitle
>Boonuskäik</segtitle>
       <seglistitem
><seg
>Eritrea (levinud kunama rahva seas)</seg
><seg
>ühekordne</seg
><seg
>tingimuslik (liikumine mängija kahest paremale käele jäävast pesast vastupäeva, teistest päripäeva)</seg
><seg
>2</seg
><seg
>2 x 4 </seg
><seg
>6 (algselt)</seg
><seg
>arv- ja ridahõive (paarisarvu kivide korral)</seg
><seg
>pole lubatud</seg>
       </seglistitem>
   </segmentedlist>
   <para
><emphasis
>Dakon</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Piirkond</segtitle>
       <segtitle
>Külvamine</segtitle>
       <segtitle
>Liikumine</segtitle>
       <segtitle
>Min. külvatavate kivide arv</segtitle>
       <segtitle
>Laua suurus</segtitle>
       <segtitle
>Kive pesas</segtitle>
       <segtitle
>Hõive</segtitle>
       <segtitle
>Boonuskäik</segtitle>
       <seglistitem
><seg
>Java saar</seg
><seg
>mitmekordne</seg
><seg
>vastupäeva</seg
><seg
>2</seg
><seg
>2 x 7</seg
><seg
>7 (algselt)</seg
><seg
>risthõive</seg
><seg
>pole lubatud</seg>
       </seglistitem>
   </segmentedlist>
   <para
><emphasis
>Chungka</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Piirkond</segtitle>
       <segtitle
>Külvamine</segtitle>
       <segtitle
>Liikumine</segtitle>
       <segtitle
>Min. külvatavate kivide arv</segtitle>
       <segtitle
>Laua suurus</segtitle>
       <segtitle
>Kive pesas</segtitle>
       <segtitle
>Hõive</segtitle>
       <segtitle
>Boonuskäik</segtitle>
       <seglistitem
><seg
>Mariaani saared (Okeaania)</seg
><seg
>mitmekordne</seg
><seg
>päripäeva</seg
><seg
>2</seg
><seg
>2 x 7</seg
><seg
>7</seg
><seg
>risthõive</seg
><seg
>pole lubatud</seg>
       </seglistitem>
   </segmentedlist>
   <para
><emphasis
>Sungka</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Piirkond</segtitle>
       <segtitle
>Külvamine</segtitle>
       <segtitle
>Liikumine</segtitle>
       <segtitle
>Min. külvatavate kivide arv</segtitle>
       <segtitle
>Laua suurus</segtitle>
       <segtitle
>Kive pesas</segtitle>
       <segtitle
>Hõive</segtitle>
       <segtitle
>Boonuskäik</segtitle>
       <seglistitem
><seg
>Filipiinid</seg
><seg
>mitmekordne</seg
><seg
>päripäeva</seg
><seg
>2</seg
><seg
>2 x 7</seg
><seg
>7</seg
><seg
>risthõive</seg
><seg
>lubatud</seg>
       </seglistitem>
   </segmentedlist>
   </sect1>
   
   <sect1 id="tipstricks">
      <title
>Nipid ja nõuanded</title>
      <para
>Mõned uutele mängijatele tulusad näpunäited:</para>
      
      <itemizedlist>
      <listitem
><para
>Kui boonuskäigud on lubatud, proovi neid hankida. Samuti püüa vastane jätta boonuskäiguta. Püüa ka kive hõivata: korralik vastase kivide hõivamine võib tuua kiiresti suure võidu.</para
></listitem>
      <listitem
><para
>Mäng käib arvutamisoskuse peale, nii et kui oskad kenasti arvutada, on sul tubli eelis.</para
></listitem>
      </itemizedlist>
      <para
>Eksperimenteeri julgelt ja omanda ise vajalikud oskused. Õnne ja rõõmu mängimiseks!</para>
      </sect1>
</chapter>


<chapter id="credits">

<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE
distribution. -->

<title
>Autorid ja litsents</title>

<para
>&mancala; </para>
<para
>Rakenduse autoriõigus 2009-2010: A.H.M. Mahfuzur Rahman <email
>65mahfuz90@gmail.com</email
> </para>

<para
>Dokumentatsiooni autoriõigus &copy; 2010: A.H.M. Mahfuzur Rahman <email
>65mahfuz90@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
>&mancala; hankimine</title>
&install.intro.documentation; &install.compile.documentation; </sect1>

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

</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->

