<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kshisen;">
  <!ENTITY package "kdegames">
  <!ENTITY % Estonian  "INCLUDE" 
> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

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

<authorgroup>
<author
> <firstname
>Dirk</firstname
> <surname
>Doerflinger</surname
> <affiliation
> <address
><email
>ddoerflinger@web.de</email
></address
> </affiliation
> </author>
<othercredit role="reviewer">
<firstname
>Frerich</firstname
><surname
>Raabe</surname>
<contrib
>Korrigeerija</contrib>
<affiliation
><address
><email
>raabe@kde.org</email
></address
></affiliation>
</othercredit>
</authorgroup>

<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>

<date
>2003-03-03</date>
<releaseinfo
>1.03.01</releaseinfo>

<abstract>
<para
></para>
</abstract>

<keywordset>
      <keyword
>KDE</keyword>
      <keyword
>kdegames</keyword>
      <keyword
>kshisen</keyword>
      <keyword
>mäng</keyword>
      <keyword
>shisen-sho</keyword>
</keywordset>

</bookinfo>


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

<para
>&kshisen; on Mahjonggi sarnane ühe mängijaga mäng, mis kasutab samasuguseid klotse nagu Mahjongg.</para
> 

<para
>Mängu eesmärk on eemaldada mänguväljalt kõik klotsid.</para>

</chapter>

<chapter id="playing-kshisen">
<title
>&kshisen;i mängimine</title>

<sect1 id="rules">
<title
>Reeglid</title>

<para
>Mängu eesmärk on eemaldada mänguväljalt kõikklotsid. Korraga saab eemaldada ainult kaks ühesugust klotsi. Need saab eemaldada juhul, kui neid saab ühendada maksimaalselt kolme liituva joonega. Jooned võivad olla horisontaalsed või vertikaalsed, mitte aga diagonaalsed. </para>

<para
>Neid jooni ei pea ise tõmbama, mäng märgib need sinu eest. Märgi ainult ära kaks ühesugust klotsi ja kui neid saab ühendada maksimaalselt kolme liituva joonega, siis märgitakse need automaatselt ning klotsid eemaldatakse. </para>

<para
>Arvesta, et jooned saavad liikuda vaid seal, kus nad takistusi ei kohta ehk ümber klotsivälja. Kui tundub, et enam võimalusi pole, võid kasutada vihjevõimalust, mis näitab kaht ühesugust eemaldamisvõimalusega klotsi. Klõps &HPN;ga klotsil näitab kõiki samasuguseid klotse sõltumata sellest, kas nad on parajasti eemaldatavad või mitte.</para>

<para
>Mäng on läbi, kui käike enam ei ole ja mõned klotsid on siiski väljale jäänud (seda ei peaks juhtuma, kui menüüs <guimenu
>Seadistused</guimenu
> on sisse lülitatud võimalus <guimenuitem
>Keela lahenduseta mängud</guimenuitem
>, sest sellisel juhul on kõigil mängudel vähemalt üks võiduvõimalus, kuigi võib muidugi juhtuda, et sa valid just vale võimaluse...).</para>

<para
>Tulemus <quote
>S</quote
> arvutatakse järgmist valemit kasutadest (kus <quote
>n</quote
> kujutab klotside arvu mängu algul ning <quote
>t</quote
> aega (sekundites), mis kulus välja puhastamiseks): <inlineequation
> <alt
>S=(n/t)*sqrt(n84)/0,0014</alt
> <inlinemediaobject
><imageobject
> <imagedata fileref="score-formula.png" format="PNG"/> </imageobject
></inlinemediaobject
></inlineequation
> Kui mängimise ajal oli <guilabel
>Gravitatsioon</guilabel
> sisse lülitatud, korrutatakse tulemuse veel kahega.</para>
</sect1>

<sect1 id="game-menu">
<title
>Menüü <guimenu
>Mäng</guimenu
></title>

<para
>Menüü <guimenu
>Mäng</guimenu
> võimaldab valida mänguga seotud valikuid:</para>

<variablelist
> <varlistentry
> <term
><menuchoice
> <shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>N</keycap
></keycombo
></shortcut
> <guimenu
>Mäng</guimenu
><guimenuitem
>Uus</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Lõpetab käesoleva mängu</action
> ja käivitab uue seansi uue klotsivalikuga. </para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
><keycombo
><keycap
>P</keycap
></keycombo
></shortcut
> <guimenu
>Mäng</guimenu
> <guimenuitem
>Paus</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Peatab kogu mängu</action
>, eriti aga taimeri, mis mõjutab otseselt tulemust. Vahetub ka menüükirje: <guimenuitem
>Käivita mäng uuesti</guimenuitem
> võimaldab edasi mängida.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Mäng</guimenu
><guimenuitem
>Näita rekordeid</guimenuitem
></menuchoice
></term
> <listitem
><para
>Näitab Shisen-Sho (kohaliku) rekorditabeli esikümmet.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
><keycombo
><keycap
>H</keycap
></keycombo
></shortcut
> <guimenu
>Mäng</guimenu
><guimenuitem
>Anna vihje</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Näitab vihjena</action
>, millised kaks klotsi saab eemaldada.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>R</keycap
></keycombo
></shortcut
> <guimenu
>Mäng</guimenu
><guimenuitem
>Käivita mäng uuesti</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Taaskäivitab mängu sama klotsivalikuga.</action
></para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Mäng</guimenu
><guimenuitem
>Kas mäng on lahendatav?</guimenuitem
></menuchoice
></term
> <listitem
><para
>Näitab dialoogi, mis <action
>ütleb, kas mäng on lahendatav või mitte</action
>. Kui menüüst <guimenu
>Seadistused</guimenu
> on sisse lülitatud võimalus <guimenuitem
>Keela lahenduseta mängud</guimenuitem
>, on see kirje täiesti mõttetu.</para
></listitem
> </varlistentry
> </variablelist>

<para
>Mõningaid menüükäske saab kasutada ka kiirklahvidega. Nende loetelu on toodud <xref linkend="key-bindings"/>.</para
> 

</sect1>

<sect1 id="edit-menu">
<title
>Menüü <guimenu
>Redigeerimine</guimenu
></title>

<variablelist
> <varlistentry
> <term
><menuchoice
> <shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Redigeerimine</guimenu
><guimenuitem
>Võta tagasi</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Võtab viimase käigu tagasi</action
>. Sama, mis tööriistariba nupp <guibutton
>Võta tagasi</guibutton
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Redigeerimine</guimenu
><guimenuitem
>Tee uuesti</guimenuitem
></menuchoice
></term
> <listitem
><para
><action
>Teeb viimase käigu uuesti</action
>. Sama, mis tööriistariba nupp <guibutton
>Tee uuesti</guibutton
>.</para
></listitem
> </varlistentry
> </variablelist>
</sect1>
</chapter>

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

<sect1 id="settings-menu">
<title
>Menüü <guimenu
>Seadistused</guimenu
></title>

<para
>&kshisen;i käitumist saab mitmeti muuta. Kõiki neid võimalusi saab kasutada menüü <guimenu
>Seadistused</guimenu
> abil.</para>

<para
>Valitud seadistused salvestatakse automaatselt.</para>

<variablelist
> <varlistentry
> <term
> <menuchoice
><guimenu
>Seadistused</guimenu
> <guisubmenu
>Suurus</guisubmenu
></menuchoice
></term
> <listitem
><para
>Alammenüüs <guisubmenu
>Suurus</guisubmenu
> saab muuta klotside arvu mängus. Mida rohkem klotse, seda raskem (ja rohkem aega nõudev) on ka mäng. </para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guisubmenu
>Kiirus</guisubmenu
></menuchoice
></term
> <listitem
><para
>Alammenüü <guisubmenu
>Kiirus</guisubmenu
> määrab aja, mille jooksul korrektselt valitud klotsid eemaldatakse. </para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guisubmenu
>Tase</guisubmenu
></menuchoice
></term
> <listitem
><para
>Alammenüü <guisubmenu
>Tase</guisubmenu
> võimaldab valida mängu raskusastme.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Gravitatsioon</guimenuitem
></menuchoice
></term
> <listitem
><para
>Selle lubamine muudab mängu veel raskemaks: kui klots eemaldatakse, langevad kõik tema kohal asunud klotsid ühe positsiooni võrra allapoole. </para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Keela lahenduseta mängud</guimenuitem
></menuchoice
></term
> <listitem
><para
>Kui see on lubatud, siis pakutakse uue mängu käivitamisel ainult selliseid mänge, millel on lahendus. Märkus: see ei tähenda siiski, et sul poleks võimalik eksida ning jõuda lahendamatusse seisu, kus ainus võimalus proovida lahenduseni jõuda on mäng taaskäivitada, aga igal juhul on selle võimaluse valimisel mäng <emphasis
>vähemalt</emphasis
> ühe lahendusega.</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="key-bindings">
<title
>Kiirklahvid</title>

<para
>Vaikimisi kiirklahvid on järgmised: </para>
<simplelist
> <member
></member
> <member
></member
> <member
></member
> <member
></member
> <member
>Käivita mäng uuesti: <keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
></member
> <member
>Välju: <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></member
> <member
>Võta tagasi: <keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></member
> <member
>Tee uuesti: <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></member
> <member
>Mis see on?: <keycombo action="simul"
>&Shift;<keycap
>F1</keycap
></keycombo
></member
> </simplelist>
</sect1>
</chapter>


<chapter id="credits">
<title
>Autorid ja litsents</title>

<para
> &kshisen;i autoriõigus 1999: Mario Weilguni <email
>mweilguni@sime.com</email
> </para>


<para
> Dokumentatsiooni autoriõigus 2000: Dirk Doerflinger <email
>ddoerflinger@gmx.net</email
> </para>

<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-kshisen">
<title
>Shisen-Sho hankimine</title>

&install.intro.documentation;

</sect1>

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

<para
> &kshisen;i edukaks kompileerimiseks on vajalik  &kde; 3.x. Kõik nõutavad teegid, samuti &kshisen; ise, on leitavad aadressil &kde-ftp;.</para>
</sect1>


<sect1 id="compilation">
<title
>Kompileerimine ja paigaldamine</title>

&install.compile.documentation;

</sect1>
</appendix>

</book>

