<?xml version="1.0" ?>
<!--IMPORTANT: please note that 'Do not change this!' notice does not apply to translators -->
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kajongg "<application
>Kajongg</application
>">
<!ENTITY kappname "&kajongg;">
<!ENTITY kappversion "0.4"
><!--Application version. Use this variable everywhere it is needed.-->
<!ENTITY package "kdegames"
> <!-- do not change this! -->
<!ENTITY % Estonian "INCLUDE"
> <!-- change language only here -->
<!ENTITY % addindex "IGNORE"
> <!-- do not change this! -->
<!ENTITY s1 "s1">
<!ENTITY s9 "s9">
<!ENTITY b1 "b1">
<!ENTITY b9 "b9">
<!ENTITY c1 "c1">
<!ENTITY c9 "c9">
<!ENTITY we "we">
<!ENTITY ws "ws">
<!ENTITY ww "ww">
<!ENTITY wn "wn">
<!ENTITY db "db">
<!ENTITY dr "dr">
<!ENTITY dg "dg">
<!ENTITY chow "chow">
<!ENTITY pung "pung">
<!ENTITY kong "kong">
<!ENTITY mahjongg "mahjongg">
<!ENTITY originalcall "originalcall">
<!ENTITY violatesoriginalcall "violatesoriginalcall">
<!ENTITY dangerousgame "dangerousgame">
<!ENTITY nochoice "nochoice">
<!ENTITY payforall "payforall">
<!ENTITY payers "payers">
<!ENTITY payees "payees">
<!ENTITY absolute "absolute">
<!ENTITY lastsource "lastsource">
]>
<book lang="&language;"
> <!-- do not change this! -->
<bookinfo>
<title
>The &kappname; Handbook</title
> <!-- This is the title of this docbook. -->
<!-- List of immidiate authors begins here. -->
<!--INPORTANT! - All other contributors: [to be determined] -->
<authorgroup>
<author
><personname
> <firstname
>Wolfgang</firstname
> <surname
>Rohdewald</surname
> </personname
> <email
>wolfgang@rohdewald.de</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>
<date
>2010-03-19</date
><!-- Date of (re)writing, or update.-->
<releaseinfo
>&kappversion;</releaseinfo
><!-- Application version number. Use the variable definitions within header to change this value.-->
<!--Short description of this document. Do not change unless necessary!-->
<abstract>
<para
>This documentation describes the game of &kappname; version &kappversion;</para>
</abstract>
<!--List of relevant keywords-->
<keywordset>
<keyword
>KDE</keyword
> <!-- do not change this! -->
<keyword
>kdegames</keyword
> <!-- do not change this! -->
<keyword
>mäng</keyword
> <!-- do not change this! -->
<keyword
>kajongg</keyword
><!--Application name goes here-->
<!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
<keyword
>lauamäng</keyword>
<keyword
>arkaadmäng</keyword>
<keyword
>klotsimäng</keyword>
<keyword
>kivid</keyword>
<!--Number of possible players. It can be: One, Two,..., Multiplayer-->
<keyword
>neli mängijat</keyword>
<!--All other relevant keywords-->
</keywordset>
</bookinfo>
<!--Content begins here: -->
<chapter id="introduction"
><title
>Sissejuhatus</title
> <!-- do not change this! -->
<note
><title
>Mängu tüüp:</title
><para
>lauamäng, arkaadmä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
>Neli</para
></note
><!--Number of possible players. It can be: One, Two,..., Multiplayer-->
<para
>&kajongg; is a board game created after the famous oriental game of Mahjong (from Chinese <foreignphrase lang="zh"
>麻將</foreignphrase
>). It is played by four players. Worldwide many different rulesets are in use. Right now &kajongg; supports the Classical Chinese rules as played in Germany, eventually other main rulesets will follow. It is possible to customize or add new rulesets. Please do so and send them to the program author for integration! </para>
<para
>&kajongg;i võib kasutada kahel viisil: mängu tulemuste määramine käsitsi, millisel juhul mäng käib nagu ikka, ilma arvuti abita, ning &kajongg;i kasutamine tulemuste arvutamiseks ja arvepidamiseks. Teine võimalus &kajongg;i kasutada on mängida mis tahes inim- ja arvutimängijate kombinatsiooni vastu. </para>
</chapter>
<chapter id="screen_layout"
><title
>Mängu välimus</title>
<para>
<screenshot>
<screeninfo
>&kajongg;i pilt</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="gamescreen.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Pilt</phrase
></textobject>
</mediaobject>
</screenshot>
</para>
<para
>Mänguakna osade lühike selgitus. </para>
<variablelist>
<varlistentry>
<term
>Tööriistariba</term>
<listitem
><para
>Tööriistariba asub menüüriba all ja sisaldab kõige sagedamini vaja minevate toimingute nuppe. Tööriistariba sisu saab muuta. Samuti võib selle peita, mis annab mänguväljale veidi rohkem ruumi. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Mängulaud</term>
<listitem
><para
>Mängulaud on akna suurim osa. Seal on näha neli 18 kivi pikkust müüri (pikkus võib ka veidi erineda sõltuvalt reeglitest, näiteks sellest, kas kasutatakse boonuskive või mitte). Müürile on kirjutatud mängijate nimed ning (hetkel teadaolev) jaotuse väärtus, samuti on seal näha mängijate tuulekivi. Valitseval tuulel on värviline taust - ülal toodud pildil on see nii ida (E) puhul. </para
><para
><link linkend="play"
>Mängimise</link
> ajal paiknevad seespool müüri mängijate ära visatud kivid. Need paiknevad suvaliselt. Viimati ära visatud kivi ümber on näha sinine raam. </para
><para
><link linkend="scoreGame"
>Mängu tulemuste käsitsi määramise</link
> korral on seespool müüri näha kõik saadaolevad kivid. Need võib määrata mängijatele hiirt või klaviatuuri kasutades. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Mängija ala</term>
<listitem
><para
>Iga mängija ees on ala, kus paiknevad tema kivid. Ülemises reas on näha paljastatud, alumises varjatud kivid. <link linkend="scoreGame"
>Mängu tulemuste käsitsi määramise</link
> korral näidatakse varjatud kive kogu kivi katva varjuga. Boonuskivid paiknevad paremas servas. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Dialoog</term>
<listitem
><para
>Dialoog näitab valikuid, mida mängija saab kasutada. Enamasti lisandub neile edenemisriba, mis näitab, kui palju on mängijal jäänud aega valik langetada. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Statusbar</term>
<listitem
><para
>The Statusbar is located at the bottom of the screen and contains the current totals for the players. </para
></listitem>
</varlistentry>
</variablelist>
</chapter>
<chapter id="scoreGame"
><title
>Mängu tulemuste käsitsi määramine</title
> <!-- do not change this! -->
<para
>Selles režiimis on &kajongg; kasutusel ainult tulemuste määramiseks. Mäng ise käib, nagu ikka, tõeliste inimestega tõelise mängulaua taga ning mängu lõpus tuleb anda &kajongg;ile teada, millised kivid mängijatel olid, ja kõik muu, mida &kajongg; vajab tulemuste arvutamiseks. Teine võimalus on muidugi tulemused käsitsi paberil välja arvutada ning nad siis rakendusse sisestada. Seejärel jagab &kajongg; mängijate vahel punktid ja kirjutab tulemused andmebaasi. Mängu on võimalik peatada, käivitada uue mängu teiste mängijatega või jätkata vana mängu mängimist. Kõik reeglid salvestatakse koos mänguga, mistõttu on võimalik eri mänge mängida eri reeglitega. </para>
<itemizedlist>
<listitem
><para
>Vali menüükäsk <guimenu
>Mäng</guimenu
> / <guimenuitem
>Määra mängu tulemused käsitsi</guimenuitem
> või vajuta klahve <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>. </para
></listitem>
<listitem
><para
>Nüüd võid valida kas olemasoleva lõpetamata mängu või alustada uut mängu. Viimasel juhul palutakse sul määrata mängijad ja valida reeglid. &kajongg; pakub välja eelmise mängu väärtused. Kui eelmist mängu pole, pakutakse välja esimesed neli defineeritud mängijat. Pane tähele, et reeglistikku ega ühtegi selle reeglit ei saa pärast valikut enam muuta. Küll saab seda teha eelnevalt <link linkend="ruleset-options"
>reeglite redaktoris</link
>. </para
></listitem>
<listitem
><para
>Siis ilmub uus aken nimega "Selle jaotuse tulemused". Lähemalt kõneleb sellest osa <link linkend="enterhand-tiles"
>Tulemuse arvutab &kajongg;</link
>. </para
></listitem>
<listitem
><para
>Jaotuse tulemuste salvestamise järel saad edasi minna järgmise jaotuse juurde. </para
></listitem>
</itemizedlist>
<sect1 id="enterhand"
><title
>Jaotuse tulemuste sisestamine</title>
<sect2 id="enterhand-scores">
<title
>Tulemused</title>
<screenshot>
<screeninfo
>&kajongg;i pilt</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="enterhand.png" format="PNG"/>
</imageobject
> <textobject
><phrase
>Pilt</phrase
></textobject>
</mediaobject>
</screenshot>
<para
>Selles aknas saab sisestada jaotuse tulemused. See ilmub automaatselt nähtavale, kui &kajongg; arvab, et sul läheb seda vaja. Seda saab lasta näidata või peita kiirklahviga <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> või vastava menüükäsuga. </para>
<para
>Nagu ikka, on valitseva tuule taust värviline. </para>
<para
>Siin saab käsitsi sisestada kõigi mängijate tulemused. Teine võimalus on täpselt kindlaks määrata, millised kivid olid igal mängijal käes. Sellisel juhul muutub vastav käsitsi määratud tulemuse väärtuse väli halliks: &kajongg; arvutab tulemuse automaatselt välja. </para>
<para
>After having entered all relevant data for a hand, press the button <guibutton
>Save hand</guibutton
>. The hand values will be entered in the data base, and they are also entered in the score table. You might be prompted to change the seating positions of the players but you can choose not to change seats. The proposed changes are currently not customizable - if a ruleset needs something different, we will change that. </para>
<para
>If the player might have won, the checkbox in the column "Winner" will be enabled - click this for the winner. </para>
<para
>Olekuriba uuendatakse, nii et see näitab mängijate tulemusi, ning sa saad edasi minna järgmise jaotuse juurde. </para>
<sect3 id="enterhand-manually">
<title
>Tulemuse käsitsi sisestamine</title>
<para
>Hea mängija võib eelistada tulemuse isiklikku arvutamist. Sel juhul võib selle otse sisestada. See on võimalik ainult siis, kui antud mängija puhul pole valitud ühtegi kivi. </para>
<para
>Tulemuse käsitsi sisestamisel peab see sisaldama kõike peale karistuste, siin ei ole mingeid valitavaid reegleid. On siiski üks erand, nimelt "ohtlik mäng". See ei mõjuta mingeid tulemusi ega ole karikkumine. See tähendab lihtsalt, et punktide jagamine mängijate vahel toimub teistmoodi: rikkuja peab maksma kõik võitjale. Teised kaks mängijat selles ei osale. Praegu ei saa seda kuidagi kohandada. </para>
</sect3>
<sect3 id="enterhand-tiles">
<title
>Tulemuse arvutab &kajongg;</title>
<para
>Kui annad &kajongg;ile otse teada, millised kivid mängijatel olid, on aknas tulemuste sisestamine võimatu. Lisades mängijale kive, näed, kuidas tema tulemused muutuvad - aga niipea, kui oled lisanud 14. kivi, muutub tulemus nulliks. See võib algul üllatada, aga kui sa ei märgi seda ühtlasi võitvaks jaotuseks, peetakse seda niinimetatud pikaks käeks, mis annab alati null punkti. Nii on see määratletud klassikalise hiina reeglistikuga, teistes reeglistikes võib muidugi teisiti olla. </para>
<para
>Kive ja kombinatsioone saab seostada mängijaga kas hiire või klaviatuuri või mõlema abil. Hiirega lihtsalt lohista kivid mängija alasse. Sel juhul küsitakse, kas soovid liigutada üksikut, paari, pungi, kongi, nõueldud kongi või chow'd. Ülemine rida on paljastatud, alumine varjatud kividele. Boonuskivid on näha paremas servas. Kive ja kombinatsioone võib liigutada ka ridade või mängijate vahel ning tagasi kesksesse valikualasse. </para>
<para
>If you prefer using the keyboard, you can use 	 to move between the central selector and the player regions. The keys <keycap
>eswnESWN</keycap
> move a tile to the players East, South, West and North. The keys <keycap
>xX</keycap
> move it back to the central selector. <keycap
>ESWN</keycap
> moves to the concealed row, <keycap
>eswn</keycap
> moves to the exposed row. You can move the cursor between tiles or melds using the arrow keys, the currently selected tile or meld has a blue frame. Since the key arrows are far away from letters on the keyboard, you can also use the letters <keycap
>hjkl</keycap
> or <keycap
>HJKL</keycap
> for moving the cursor. <keycap
>hH</keycap
> move left, <keycap
>jJ</keycap
> move down, <keycap
>kK</keycap
> move up, <keycap
>lL</keycap
> move right. This is how the unix editor "vi" does it. The KDE browser konqueror and even this help program also support those keys in the same way. Those keys may differ if you use a language other than English but it is currently not possible to configure them. </para>
<para
>Valikuid "Viimane kivi" ja "Viimane kombinatsioon" on vaja mõningate reeglite puhul (nt. "viimane kivi lõpetab paari"). Neid saab kasutada ainult võitva jaotuse korral. </para>
<para
>Akna parempoolses osas saab käsitsi rakendada mõningaid reegleid. Millised reeglid seal näha on, sõltub kehtivast reeglistikust ja kividest. Ülal näidatud pildil võib kaotanud mängijatele rakendada valikut "ohtlik mäng", aga ka see sõltub kehtivast reeglistikust ja mängijate kividest. Arendajate eesmärk on hoida käsitsi valitavate reeglite nimekiri nii lühike kui võimalik. Parimal juhul peaks &kajongg; olema alati võimeline automaatselt tuvastama, milliseid reegleid on vaja rakendada, aga mõnikord pole &kajongg;il selleks piisavalt teavet või teadmisi. </para>
</sect3>
</sect2>
<sect2 id="enterhand-penalties">
<title
>Karistused</title>
<screenshot>
<screeninfo
>&kajongg;i pilt</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="penalty.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Pilt</phrase
></textobject>
</mediaobject>
</screenshot>
<para
><link linkend="enterhand"
>Tulemuste käsitsi sisestamise akna</link
> nupp <guibutton
>Karistused</guibutton
> avab akna, kus saab sisestada karistusi. Seda võib teha igal hetkel, sõltumata tavalisest tulemuste arvestamise mehhanismist.</para>
<para
>The <guilabel
>offense</guilabel
> selection shows all offenses that might be applicable to the hands the players hold. Choose among them.</para>
<para
>Seejärel saab täpsustada <guilabel
>Kogukaristust</guilabel
>. See on kogusumma, mida rikkuja peab teistele tasuma. See jagatakse saajate vahel võrdselt.</para>
<para
>Sõltuvalt rikkumise tüübist on tasujate ja saajate arv erinev. Igal juhul näidatakse õiget arvu mängijaid. Mängija valimise korral kontrollib &kajongg;, et see mängija esineks ainult ühel korral, kohandades vastavalt teisi mängijaid. </para>
</sect2>
</sect1>
</chapter>
<chapter id="play"
><title
>Mängimine</title>
<sect1 id="robotplay">
<title
>Mängimine arvuti vastu</title>
<para
>Kõigepealt ilmub sisselogimisdialoog. Sisesta mänguserver, millega soovid ühineda, ja oma kasutajanimi. Kui valid erikirje "Kohalik mäng", pead sisestama ainult oma nime (või soostuma pakutud nimega) ja valima reeglistiku. Sel juhul käivitatakse kohe kohalik mäng, milles mängid kolme robotmängija vastu. </para>
</sect1>
<sect1 id="humanplay">
<title
>Mängimine sõpradega</title>
<para
>Kui soovid mängida tõeliste inimestega, siis läheb vaja mänguserverit, millega kõik mängijad, kaasa arvatud sina ise, peavad olema ühendatud. Selleks vali mõni server või sisesta käsitsi uue serveri nimi ning määra oma parool selles serveris. Vaikimisi pakutakse välja viimati kasutatud parool. </para
><para
>Kui sul ei ole antud serveris sisestatud kasutajanimele vastavat kontot, päritakse sinu käest, kas soovid konto luua. Kui vastad jaatavalt, näed järgmist dialoogi, kus tuleb soovitud parool kaks korda sisestada. Konto luuakse nüüd automaatselt. </para
><para
>Pärast edukat sisselogimist mänguserverisse, näed serveri laudade nimekirja koos vabade kohtadega. Liitu mõne lauaga või loo endale uus laud. Kui lood uue laua, tasub oodata, kuni teised mängijad võtavad selle taga kohad sisse. Siiski võib uue laua taga ka kohe mängima hakata, sel juhul täidavad tühjad kohad robotmängijad. </para
><para
>Laudade nimekirjas on näha iga laua taga kasutatav reeglistik. Reeglistiku ja selle nime saadab mänguserverisse mängija, kes laua lõi. Kui sul juhtub olema samasugune reeglistik, näitab laud reeglistiku juures sinu nime - sellest võib olla abi, kui laua looja peaks kõnelema mõnda muud keelt ja on reeglistiku kuidagi teisiti nimetanud. Kui sinu kohaliku reeglistiku nime näidatakse, on see esitatud mustana. Kui sul aga pole samasugust reeglistikku, näeb nime punasena ning sa võid nupu <guibutton
>Võrdle</guibutton
> abil võrrelda seda enda reeglistikuga. </para
><para
>You can start the Kajongg game server in two different ways: <itemizedlist
><listitem
><para
>loo ühendus serveriga "localhost". See on sinu enda arvuti. Kui sa seda teed ja mänguserver ei tööta, käivitatakse see automaatselt. Kui sa aga mängimise lõpetad, peatatakse ka serveri töö. </para
></listitem
><listitem
><para
>käivita käsitsi server mis tahes arvutis. Selleks tuleb lihtsalt minna käsureale ja käivitada programm "kajonggserver". Käsuga "kajonggserver --help" näeb kõiki võimalikke võtmeid, näiteks saab muuta vaikimisi porti 8149. Server töötab seni, kuni selle töö lõpetad. </para
></listitem
></itemizedlist>
</para
><para
>In both cases you need to tell the other players how they can reach your game server. They need the URL or simply an IP address and the port your server is listening on. This might be something like "mypc.dyndns.org:8149" where 8149 is the port. Of course you need to configure your firewall such that the remote player can reach that port. The communication will be encrypted. </para
><para
>Võimalike vigade esinemisel oleks mõttekas kasutada võtit "--showtraffic". See näitab sulle konsoolis, kus mänguserver on käivitatud ning millised sõnumid liiguvad mänguserveri ja klientide vahel. </para>
<sect2 id="playing-caveats">
<title
>Hoiatus</title>
<itemizedlist
><listitem
><para
>Kui tahad olla kindel, et ükski inimmängija ei peta, peaks sul olema ligipääs arvutile, milles mänguserver töötab. Loomulikult ei ole võimalik takistada näiteks kahel mängijal kokku mängimast ja teineteist abistamast, õieti ei saa isegi seda kontrollida, kas kaks mängijat on ikka kaks või üks ja seesama inimene. </para
></listitem
></itemizedlist>
</sect2>
</sect1>
<sect1 id="playing-play">
<title
>How to play</title>
<para
>Sinu käest päritakse, mida soovid teha. Sõltuvalt akna suurusest on selleks mõeldud väike dialoog kas akna paremas või allservas. Kui akna laius ületab kõrgust, näeb dialoogi paremal. Mõnikord näeb dialoogis aega: kui see saab täis, valitakse automaatselt esimene võimalik vastus. Aegumist saab seadistada reeglite redaktoris (<guilabel
>Valikud</guilabel
>, <guilabel
>Nõudluse aegumine</guilabel
>). Aegumine on ühesuguse pikkusega kõigile mängijatele, seepärast ongi see reeglistiku osa. </para
><para
>Kui pead valima mõne käes oleva kivi, võid nende vahel liikuda paremale ja vasakule liikuvate nooleklahvidega või tähtedega h ja l. Loomulikult võib seda teha ka hiirega. </para
><para
>Sageli pakub dialoog valikuid, mida sa tegelikult ei saa kasutada, näiteks võimalust kuulutada välja pung, ehkki sul pole selleks vajalikke kive. See on sihilik, et kõik oleks täpselt nagu tõelises mängus. </para
><para
>Ära visatud kivid asetatakse juhuslikult sissepoole müüri. Mõnes mänguvariandis on ka kindlaks määratud, kuhu kivid asetada, aga see pole veel seadistatav. Kui see muutub seadistatavaks, hakkab see seadistus kuuluma reeglistikku. </para>
</sect1>
</chapter>
<chapter id="interface"
><title
>Liidese tutvustus</title
> <!-- do not change this! -->
<!-- This section has to do with menubar. Describe every single entry in order. Use <variablelist
> and <varlistentry
>. Split the chapter into sections using <sect1(2,3)
> for better viewing.-->
<sect1 id="game-menu">
<title
>Menüü <guimenu
>Mäng</guimenu
></title>
<variablelist>
<varlistentry id="game-menu-scoreGame">
<term
><menuchoice
><guimenu
>Mäng</guimenu
> <guimenuitem
>Määra mängu tulemused käsitsi</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>See on mõeldud ainult mängitud mängu tulemuste käsitsi sisestamiseks.</action
></para
><para
>Vastavalt soovile võib laadida vana mängu või alustada uut. Vaikimisi näidatakse valikunimekirjas ainult ootel, s.t lõpetamata mänge. Lisavõimalusena saab lasta näidata kõiki mänge, ka neid, mis on lõpetatud. Siin saab ka mänge kustutada.</para
></listitem>
</varlistentry>
<varlistentry id="game-menu-play">
<term
><menuchoice
><guimenu
>Mäng</guimenu
><guimenuitem
>Mängi</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Võimaldab mängida teiste, nii inimeste kui ka arvutitega.</action
></para
></listitem>
</varlistentry>
<varlistentry id="game-menu-abort">
<term
><menuchoice
><guimenu
>Mäng</guimenu
> <guimenuitem
>Katkesta</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Katkestab aktiivse mängu. Kui tegemist oli ainult mängu tulemuste sisestamisega, saab seda hiljem jätkata. Kui aga mängid &kajongg;i abil, siis selliseid mänge veel taastada ei saa.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Mäng</guimenu
> <guimenuitem
>Välju</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Lõpetab</action
> &kappname;i töö.</para
></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="view-menu">
<title
>Menüü <guimenu
>Vaade</guimenu
></title>
<variablelist>
<varlistentry id="view-scoring">
<term
><menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Tulemused</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Tulemuste dialoog</action
>: näitab või peidab tulemuste dialoogi. Seda selgitatakse lähemalt <link linkend="enterhand"
>siin</link
>. </para
></listitem>
</varlistentry>
<varlistentry id="view-scoretable">
<term
><menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Edetabel</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Edetabel</action
> <screenshot
> <screeninfo
>Edetabel</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="scoretable.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Pilt</phrase
> </textobject
> </mediaobject
> </screenshot
> Näitab edetabelit. Vasakpoolne veerg väärtustega E, S, W, N näitab mängija tuult. Valitseva tuule taust on kollakas. Võitja taust on tulemuse veerus roheline. Veerg ∆ näitab, kui palju pidi mängija selles jaotuses teistele mängijatele tasuma või kui palju ta ise sai. Veerg ∑ näitab bilanssi. Vihjed pakuvad rohkem üksikasju, nii näeb kõiki reegleid, mida antud jaotuse korral rakendati.</para
><para
>Alumine osa näitab kasutatud reeglistikku. Tulemuste tabeli ja reeglistiku vahel asub eraldaja, mida liigutades on võimalik mõlema osa suurust muuta. </para
></listitem>
</varlistentry>
<varlistentry id="view-explain-scores">
<term
><menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Tulemuste selgitus</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Tulemuste selgitus</action
> <screenshot
> <screeninfo
>Edetabel</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="explain.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Edetabel</phrase
> </textobject
> </mediaobject
> </screenshot
> Selgitab, kuidas arvutati aktiivse jaotuse tulemused. </para
></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="settings-menu">
<title
>Menüü <guimenu
>Seadistused</guimenu
></title>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Mängijad</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Võimaldab lisada, muuta ja kustutada mängijaid.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Muuda vaatenurka</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Võimaldab muuta kivide vaatamise nurka vastupäeva.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Täisekraanirežiim</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Võimaldab lülitada täisekraanirežiimi ja tavalise aknarežiimi vahel.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Tööriistariba näitamine</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Näitab või peidab tööriistariba.</action
></para
></listitem>
</varlistentry>
<varlistentry id="settings-menu-statusbar">
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Olekuriba näitamine</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Shows or hides the Statusbar.</action
></para
></listitem>
</varlistentry>
<varlistentry id="settings-menu-shortcuts">
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Kiirklahvide seadistamine...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Avab &kde; tavapärase kiirklahvide seadistamise dialoogi</action
>, kus saab muuta &kappname;is kasutatavaid <link linkend="default-keybindings"
>kiirklahve</link
>.</para
></listitem>
</varlistentry>
<varlistentry id="settings-menu-toolbar">
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Tööriistaribade seadistamine...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Avab &kde; standardse dialoogi, kus saab muuta tööriistaribal näidatavaid ikoone.</action
></para
></listitem>
</varlistentry>
<varlistentry id="settings-menu-settings">
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>&kappname;i seadistamine...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Avab &kappname;i <link linkend="configuration"
>seadistustedialoogi</link
>.</action
></para
></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="help"
><!--This is a standard Help menubar entry. Only change if needed.-->
<title
>Menüü <guimenu
>Abi</guimenu
></title>
&help.menu.documentation; </sect1>
</chapter>
<chapter id="configuration"
><title
>Mängu seadistamine</title
> <!-- do not change this! -->
<!--This section describes configuration &GUI;. If your game is configured using menubar exclusively, please remove this section.-->
<screenshot>
<screeninfo
>Seadistustedialoog</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="config_play.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Seadistustedialoog</phrase>
</textobject>
</mediaobject>
</screenshot>
<para
>Menüükäsk <menuchoice
><guimenu
>Seadistused</guimenu
><guimenuitem
>&kappname;i seadistamine...</guimenuitem
></menuchoice
> avab &kappname;i seadistustedialoogi.</para>
<para
>Kui klõpsata nupule <guibutton
>Loobu</guibutton
>, tühistatakse kõik seadistustesse tehtud muudatused, kaasa arvatud need, mida oled teinud reeglite redaktoriga.</para>
<para
>Eri kaarte saab valida ka klaviatuuri abil: <keycombo action="simul"
>&Ctrl;<keycap
>1</keycap
></keycombo
> valib esimese kaardi <guilabel
>Mäng</guilabel
>, <keycombo action="simul"
>&Ctrl;<keycap
>2</keycap
></keycombo
> teise kaardi ja nii edasi. </para>
<sect1 id="play-options"
><title
><guilabel
>Mängu</guilabel
> valikud</title>
<variablelist>
<varlistentry>
<term>
<guilabel
>Kivide varju näitamine</guilabel>
</term>
<listitem
><para
>Sisselülitamise korral näidatakse kivide piirdeid ja varje. Samuti jääb kiviridade vahele veidi ruumi ning müüri kive näidatakse nii, et on selgelt näha, et see on kahe või kolme kivi kõrgune. Väljalülitamise korral on vaade lihtsam ja kivid natuke suuremad. See valik võib olla kasulik väiksema arvutiekraani korral. </para
></listitem>
</varlistentry>
<varlistentry>
<term>
<guilabel
>Paljastamata kivide korraldamine kombinatsioonidesse</guilabel>
</term>
<listitem
><para
>Sisselülitamise korral rühmitatakse käes olevad kivid kombinatsioonidesse. Mõnikord ei pruugi rühmitamine olla just selline, nagu sulle meeldib, nii et selle võib ka välja lülitada, mis matkib tõelist mängu. </para
></listitem>
</varlistentry>
<varlistentry>
<term>
<guilabel
>Võimalusel helide kasutamine</guilabel>
</term>
<listitem
><para
>Sisselülitamisel on võimalik kuulata ära visatud kivide nimesid ja nõudlusi. Kui teised mängijad on salvestanud oma häälega helifailid, on neid võimalik kuulda. </para
></listitem>
</varlistentry>
<varlistentry>
<term>
<guilabel
>Teised võivad minu häält kuulda</guilabel>
</term>
<listitem
><para
>Kui oled salvestanud oma häälega helifailid, siis selle valiku sisselülitamisel kuulevad teised mängijad sinu ära visatud kive ja nõudlusi sinu häälega. </para
></listitem>
</varlistentry>
</variablelist>
<sect2
><title
>Heli</title>
<para
>Võimalik on salvestada helifailid oma väljaütlemistega, mida teised mängijad saavad kuulda. Selleks on vaja siiski veidi vaeva näha: </para>
<itemizedlist
><listitem
><para
>First you need to find out where to store your voice files. This directory normally is ~/.kde/share/apps/kajongg. So if your login name is joe, this might be /home/joe/.kde/share/apps/kajongg. In there you will also find the database kajongg.db. </para
></listitem
><listitem
><para
>In the directory you just found, generate a new subdirectory with the name <filename class="directory"
>voices</filename
>. </para
></listitem
><listitem
><para
>In the directory <filename class="directory"
>voices</filename
> generate another subdirectory with your player name. This is the name you use when connecting to a game server. You may also want to define voices for the players <filename
>ROBOT 1</filename
>, <filename
>ROBOT 2</filename
>, <filename
>ROBOT 3</filename
>. </para
></listitem
><listitem
><para
>In that subdirectory, you can place the sound files. They have to be encoded with the <ulink url="http://xiph.org/vorbis/"
>Ogg Vorbis</ulink
> audio compressor, the file names need to have the extension <filename class="extension"
>.ogg</filename
>. </para
></listitem
><listitem
><para
>Failinimed peavad olema näiteks <filename
>s3.ogg</filename
>, mis antud juhul vastab kivile 3. Sellised failid tuleks luua kõigi kivide ning võimalike nõudluste ja väljakuulutamiste tarvis. </para
></listitem
></itemizedlist>
<para
>Palun kontrolli, et heli kestus oleks lühike, aga see kõlaks selgelt - mäng võib minna väga kiirelt, kui oled selle käppa saanud. Lihtsam on kõigepealt panna kirja kõik helid, mida sinu arvates vaja läheb. Ära loe neid üksteise järel, vaid püüa iga heli välja öelda, nagu see oleks ainuke, ja nii, nagu see võiks kõlada, kui oled mänguhoos. Väljaütlemine võib nõuda veidi harjutamist.</para>
<para
>Toome ära ühe võimaluse helifailide loomiseks: </para
><para
><itemizedlist
><listitem
><para
>Salvesta helifailid programmiga <command
>qarecord</command
> ja kindlasti <literal
>WAV</literal
>-vormingusse. Kõnele selles ühes helifailis kõik helid. </para
></listitem
><listitem
><para
>Redigeeri faili heliredaktoriga <command
>audacity</command
>. Kasuta redaktoris hiirt helilainete vahemiku märkimiseks. Redaktor esitab valitud osa. Korda, kuni oled valinud korrektse osa. See võib olla lihtsam menüükäsuga <menuchoice
><guimenu
>Vaade</guimenu
><guimenuitem
>Suurenda</guimenuitem
></menuchoice
>. Kasuta menüükäsku <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Ekspordi valik</guimenuitem
></menuchoice
> ja salvesta ogg-vormingusse. <guilabel
>Valikute</guilabel
> all vali madal kvaliteet - see on piisav ja isegi soovitav, sest nii väheneb heli teistele mängijatele edastamise aeg. </para
></listitem
></itemizedlist
></para>
<para
>Allpool on ära toodud failide nimed, mida sul tuleks luua. Alati lisa neile faililaiend <filename
>.ogg</filename
>:</para>
<table>
<title
>Helifailide nimed</title>
<tgroup cols="2">
<tbody>
<row>
<entry
>&s1; .. &s9;</entry
><entry
>Kivid 1 kuni 9</entry>
</row>
<row>
<entry
>&b1; .. &b9;</entry>
<entry
>Bambused 1 kuni 9</entry>
</row>
<row>
<entry
>&c1; .. &c9;</entry>
<entry
>Märgid 1 kuni 9</entry>
</row>
<row>
<entry
>&we; &ws; &ww; &wn;</entry>
<entry
>Tuuled - ida, lõuna, lääs, põhi</entry>
</row>
<row>
<entry
>&db; &dr; &dg;</entry>
<entry
>Draakonid - sinine/valge, punane, roheline</entry>
</row>
<row>
<entry
>&chow; &pung; &kong; &mahjongg;</entry>
<entry
>Peamised nõudlused</entry>
</row>
<row>
<entry
>&originalcall; &violatesoriginalcall;</entry>
<entry
>Algkäik ja selle rikkumine</entry>
</row>
<row>
<entry
>&dangerousgame;</entry>
<entry
>Mängija kaotab kontrolli (ohtlik mäng)</entry>
</row>
<row>
<entry
>&nochoice;</entry>
<entry
>Mängija kuulutab, et tema ainuke valik on mängida ohtlikult</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>
</sect1>
<sect1 id="tiles-options"
><title
><guilabel
>Kivide</guilabel
> valikud</title>
<screenshot>
<screeninfo
>Kivide valija</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="config_tiles.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Kivide valija</phrase
></textobject>
</mediaobject>
</screenshot>
<para
><guilabel
>Kivide</guilabel
> valija abil saab valida kivide graafilise välimuse. </para>
</sect1>
<sect1 id="background-options"
><title
><guilabel
>Tausta</guilabel
> valikud</title>
<screenshot>
<screeninfo
>Tausta valija</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="config_background.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Tausta valija</phrase
></textobject>
</mediaobject>
</screenshot>
<para
><guilabel
>Tausta</guilabel
> valija võimaldab valida mängulaua tausta graafilise välimuse. </para
><para
>Mõned taustad, näiteks Hiina maastik, nõuavad laadimiseks veidi aega. Kui arvad, et rakendus peaks käivituma kiiremini või et peaakna suuruse muutmine võtab liiga kaua aega, proovi mõnda muud tausta. </para>
</sect1>
<sect1 id="ruleset-options"
><title
>Reeglite redaktor</title>
<screenshot>
<screeninfo
>Reeglite redaktor</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="ruleseteditor.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Reeglite redaktor</phrase
></textobject>
</mediaobject>
</screenshot>
<para
>Reeglite redaktoriga saab kohandada reeglistikke. Valmisreeglistikke näidatakse kaldkirjas, kohandatud reeglistikke tavalises kirjas. Valmisreeglistikke ei saa kasutaja kuidagi muuta, küll võib seda teha &kajongg;i uuendamine. Kohandatud reeglistikke uuendamisel ei muudeta. </para
><para
>Uue mängu käivitamisel on võimalik valida selle reeglistik. Kasutada saab kõiki reeglistikke, mis on defineeritud reeglite redaktori abil. Reeglistik salvestatakse koos mänguga, nii et siin võib reeglistikke alati muuta - muudatused mõjutavad ainult edaspidiseid mänge. </para>
<sect2
><title
>Reegel, tulemus ja ühik</title
><para
>Tee lihtsalt topeltklõps sellel, mida soovid muuta.</para>
</sect2>
<sect2
><title
>Definitsioon</title
><para
>Reegli definitsioon võib olla päris keeruline. Seda seletab lähemalt eraldi peatükk <link linkend="rule"
>Reegli defineerimine</link
>. Tavaliselt ei ole põhjust definitsiooni muuta. Põhimõtteliselt määrab see kindlaks, millise jaotuse korral antud reegel rakendub.</para>
</sect2>
<sect2
><title
>Kopeerimine ja eemaldamine</title
><para
>Kopeerida võib kogu reeglistikku või ainult selle üht reeglit. Et valmisreeglistikke muuta ei saa, saab üksikreegleid kopeerida ainult kohandatud reeglistikesse. </para
><para
>Soovi korral võib eemaldada kogu kohandatud reeglistiku või ainult kindla reegli. Ka seda võib teha siis, kui mõni olemasolev mäng kasutab muudetavat reeglistikku, sest nagu öeldud, salvestatakse reeglistik koos mänguga. Soovi korral võib näha vanade mängude reeglistikke: <link linkend="game-menu-scoreGame"
>laadi</link
> vana mäng ja <link linkend="view-menu"
>vaata selle tulemusi</link
>. </para>
</sect2>
<sect2
><title
>Võrdlemine</title
><para>
<screenshot>
<screeninfo
>Reeglistiku võrdleja</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="differ.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Reeglistiku võrdleja</phrase
></textobject>
</mediaobject>
</screenshot>
Võrdlemiskäsku saab kasutada, kui valitud on terve reeglistik. See võimaldab võrrelda üht reeglistikku teisega. </para
></sect2>
</sect1>
<sect1 id="default-keybindings">
<title
>Vaikimisi kiirklahvid</title>
<para
>The menu entry <menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Configure Shortcuts...</guimenuitem
></menuchoice
> allows you to change the default keyboard bindings.</para>
<para
>The default keybindings are as follows: </para>
<para>
<variablelist>
<varlistentry>
<term
><keycap
>F1</keycap
></term>
<listitem>
<para
>Avab käesoleva käsiraamatu. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
></term>
<listitem>
<para
>Mängu tulemuste käsitsi määramine. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></term>
<listitem>
<para
>Mängimine sõpradega või arvutimängijatega. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;<keycap
>W</keycap
></keycombo
></term>
<listitem>
<para
>Aktiivse mängu katkestamine. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></term>
<listitem>
<para
>Rakendusest väljumine. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;<keycap
>T</keycap
></keycombo
></term>
<listitem>
<para
>Edetabeli avamine. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
></term>
<listitem>
<para
>Vaatenurga muutmine. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><keycombo action="simul"
>&Shift;<keycap
>F1</keycap
></keycombo
></term>
<listitem>
<para
>"Mis see on?" abi </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>F</keycap
></keycombo
></term>
<listitem>
<para
>Täisekraanirežiim </para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>
<chapter id="rule"
><title
>Reegli defineerimine</title>
<para
>Tulemuste mootorit ja veel paljusid &kajongg;i omadusi saab kohandada reeglite redaktoriga. Reegel koosneb nimest, tulemusest (kaasa arvatud ühikust) ja <link linkend="ruledefinition"
>definitsioonist</link
>. </para>
<sect1 id="rulegroups">
<title
>Reeglirühmad</title>
<para
>Reeglitel on mitmeid rühmi:</para>
<variablelist>
<varlistentry>
<term
>Kombinatsiooni reeglid</term>
<listitem
><para
>Kombinatsiooni reeglid rakendatakse konkreetsele kombinatsioonidele sõltumata ülejäänud jaotusest. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Jaotuse reeglid</term>
<listitem
><para
>Jaotuse reeglid kehtivad kogu jaotusele ja kõigile mängijatele. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Mah Jongg Rules</term>
<listitem
><para
>Mah Jongg rules specify how a winnable hand has to look like. This is normally four melds with 3 or 4 tiles each and a pair. But special hands may look differently, for example the 13 Orphans in Classical Chinese. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Võitja reeglid</term>
<listitem
><para
>Võitja reeglid kehtivad kogu jaotusele, aga ainult võitjale. See sisaldab enamikku erilisi jaotusi. Neid reeglite puhul ei pea rakendamiseks tingimata olema korrektne kivide arv. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Valikud</term>
<listitem
><para
>Siit leiab mitmeid eriparameetreid, näiteks piirangujaotuse punktid. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Karistused</term>
<listitem
><para
>Karistusi rakendab käsitsi kasutaja </para
></listitem>
</varlistentry>
</variablelist>
<sect2 id="executionorder"
><title
>Rakendamise järjekord</title>
<para>
<itemizedlist>
<listitem
><para
>rakendatavate reeglite nimekirja loomine kombinatsiooni ja jaotuse reeglite põhjal</para
></listitem>
<listitem
><para
>using the Mah Jongg rules find out if the declared winner hand is really a winner hand.</para
></listitem>
<listitem
><para
>võitja korral rakendatavate võitja reeglite lisamine</para
></listitem>
<listitem
><para
>kui mõnel leitud reeglil on toiming "&absolute;", siis ainult nende alles jätmine. Praegu ei ole veel määratletud, mis juhtub siis, kui neid leitakse enam kui üks.</para
></listitem>
<listitem
><para
>kui mõned reeglid defineerivad piirangud, siis kõigi teiste hülgamine</para
></listitem>
<listitem
><para
>leitud reeglite rakendamine toodud järjekorras</para
></listitem>
</itemizedlist>
</para>
</sect2>
</sect1>
<sect1 id="ruledefinition">
<title
>Definitsioon</title>
<para
>Definitsioon koosneb ühestainsast stringist, sest seda peab olema hõlpus salvestada andmebaasi. See koosneb mitmest osast, mida eraldavad kaks märki "||". Iga osa väljendab kas tingimust, mille korral reeglit rakendatakse, või siis mõnda toimingut. Defineerida saab ainult ühe toiminguosa, kuid tingimusavaldisi võib olla mitu. Reegel rakendub otsekohe, kui vähemalt üks tingimus vastab jaotusele.</para
><para
>&kajongg; pakub omalt poolt valmisreeglistikku, mis vastab klassikalise hiina mängu reeglitele, nagu need on defineerinud Saksamaa DMJL. See peaks andma ohtralt eeskuju.</para
><para
>Lubatud osad on järgmised:</para>
<variablelist>
<varlistentry>
<term
>Tõstutundetu regulaaravaldis</term>
<listitem
><para
>Osa, mille alguses seisab I, on <link linkend="regex"
>regulaaravaldis</link
>, mis ei tee vahet suur- ja väiketähtedel. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Toiming</term>
<listitem
><para
>Osa, mille alguses seisab A, sisaldab <link linkend="actions"
>toimingute</link
> nimekirja. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Käsitsimängu avaldis</term>
<listitem
><para
>This is an optional <link linkend="regex"
>Regular Expression</link
>. For scoring manual games, it defines whether this rule should be selectable by the user with a checkbox. The leading M does not belong to the Regular Expression. An example would be the Rule "Last Tile Taken from Dead Wall". </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Regulaaravaldis</term>
<listitem
><para
>Kõik muud osad kujutavad endast <link linkend="regex"
>regulaaravaldist</link
>. </para
></listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="regex">
<title
>Regulaaravaldised</title>
<para
>Regulaaravaldised on väga võimas programmeerimise abivahend, mis võimaldab leida sobivaid märgistringe. Aga see on ühtlasi ka päris keeruline ja raske. Kindlasti ei ole see mõeldud tavalise mängija jaoks. On lausa terved raamatud, mis ainult regulaaravaldiste seletamisega tegelevadki.</para>
<para
>Regulaaravaldistel on mitmeid "dialekte". &kajongg; on kirjutatud programmeerimiskeeles Python. Et Pythoni standardteek sisaldab regulaaravaldiste moodulit, siis seda dialekti ongi kasutatud. </para
><para
>Lähemalt räägib sellest <ulink url="http://docs.python.org/library/re.html#regular-expression-syntax"
></ulink
> </para
><para
>Kogu teave jaotuse kohta, mis võib mõjutada tulemust, on kodeeritud ühteainsasse stringi. &kajongg; kontrollib siis, kas regulaaravaldis vastab sellele stringile. Kui jah, siis reeglit ka rakendatakse.</para>
<para
>Toome näiteks regulaaravaldise, mis vastab piirangujaotusele "Kõik rohelised":</para
><programlisting
>( |[bB][23468]|[dD]g)*[fy/]</programlisting>
<sect2
><title
>Jaotusestringi struktuur</title>
<para
>Jaotusestringi sisu on alati ühesugune sõltumata sellest, millist keelt kasutad oma töökeskkonnas.</para>
<para
>Jaotust esindav string koosneb mitmest osast, mida eraldavad tühikud. Nende osade järjestus on alati ühesugune, välja arvatud alguses leiduvad kombinatsioone puudutavad osad.</para>
<para
>&kajongg; võib varjatud kivid rühmitada sellistesse kombinatsioonidesse, et tulemus oleks võimalikult hea. Sealjuures ei ole vahet, kuidas varjatud kivid on õieti rühmitatud. Aga kui tegemist on piirangujaotustega, siis ei pruugi see toimida. Seepärast püüab &kajongg; kasutada kivide algset rühmitamist, nagu selle on sisestanud kasutaja, aga ka ümberrühmitatud kive. Mõlema variandi korral rakendatakse kõiki reegleid. Kasutusele võetakse see variant, mis saavutab suurema kogutulemuse.</para>
<para
>Toome siin näite. Tegelikult on see kõik ühel real, aga loetavuse huvides jagasime selle siin kahe rea peale. Lisaks on seda korratud, sest mõningaid regulaaravaldisi on palju hõlpsam kirjutada, kui selle osade järjestust saab muuta. Vaatame kongi röövimise reeglit: selle regulaaravaldis uurib enne kombinatsioone gruppi L (viimane kivi).</para
><programlisting
><literal
>c1c1c1C1 s1s2s3 b6b6b7b7b8b8 b5b5 fn yn
/c416s000b000b000b200 -C416s000b000b000b200 %n Mneka LB5B5B5</literal
></programlisting>
<para
>Kivi tähistab kaks märki. Esimese puhul tähistab s kivi (stone), b bambust, c märki (character), w tuult (wind), d draakonit, y aastaajaboonust ja f lilleboonust. Teise märgi puhul tähistavad 1-9 kive, e, s, w, n tuuli, w, r, g draakoneid (white - valge, red - punane, green - roheline) ning 1, 2, 3, 4 boonuskive. Paljastatud kivide puhul on esimene märk väike-, varjatud kivide puhul suurtäht.</para>
<para
>Kõik järgnevad osad on alati olemas ja just sellises järjekorras, välja arvatud osa "Viimane kivi". See on olemas ainult võitva jaotuse puhul. <variablelist>
<varlistentry>
<term
>Kombinatsioon</term>
<listitem
><para
>Osa, mis algab mõnega järgmistest tähtedest, on kombinatsioon: <literal
>sbcdwSBCDW</literal
>. Kombinatsioon võib sisaldada suvalise arvu kive. &kajongg; jagab liiga paljude kividega kombinatsioonid, püüdes saavutada maksimaalse tulemuse.</para
><para
>Kongide puhul on kasutusel eriline süntaks: c1c1c1c1 on paljastatud kong, c1c1c1C1 on paljastatud kong, mille neljas kivi täiendas varjatud pungi. Seda on vaja piirangumänguks "varjatud õiges värvis mäng". c1C1C1c1 on varjatud väljakuulutatud kong, C1C1C1C1 varjatud väljakuulutamata kong. Aga et see ei ole välja kuulutatud, käsitletakse seda pungina. Niisiis, see kombinatsioon jagatakse pungiks C1C1C1 ja üksikuks C1.</para
><para
>Boonuskivid esinevad pärast kõiki kombinatsioone.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Kokkuvõte</term>
<listitem
><para
>The part starting with / holds summary information about the melds. This makes it easier to write some regular expressions. Every meld is represented by four characters. The first character is one out of <literal
>sbcdwSBCDW</literal
>, again lowercase for exposed and uppercase for concealed. The second character is a number saying how many tiles the meld holds. This is 1 up to 4 for a kong. The 0 is used for a chow. The last two characters hold the value of this meld. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Alternatiivne kokkuvõte</term>
<listitem
><para
>Osa, mille alguses seisab -, on samasugune äsja tutvustatud kokkuvõttega, kuid see sisaldab nõueldud konge varjatud kongidena. Mõned reeglid, näiteks "Kolm varjatud pongi", käsitlevad nõueldud kongi varjatuna. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Jaotuse pikkus</term>
<listitem
><para
>Osa, mille alguses seisab %, sisaldab teavet jaotuse pikkuse kohta: s tähistab lühikest kätt, milles on liiga vähe kive, n korrektse kivide arvuga jaotust ja l pikka kätt, milles on liiga palju kive. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Mah Jongg</term>
<listitem
><para
>The part starting with m, M or x holds additional information. M stands for the winner hand, m for a loser hand, and x stands for a hand that is forbidden to say Mah Jongg. M/m/x is followed by one character for the own wind, one character for the prevailing wind, one character for the source of the last tile leading to Mah Jongg, one character for the declarations a player made.</para
><para
>Viimane kivi võib olla pärit mitmest kohast: w=müür, d=äravisatud, e=surnud müür, z=elava müüri viimane kivi, Z=elava müüri viimane kivi, ära visatud, k=kongi röövimine, l=taevane/maine õnnistus. Väärtused w ja d on erilised - need on omamoodi vaheväärtused. Kui valida viimaseks kiviks varjatud kivi, määratakse päritoluks w. Edasi sätestavad mitmed reeglid, et neid saab rakendada ainult juhul, kui viimane kivi on pärit müürist. Niisiis võimaldab see tegelikult rakendatavate reeglite paremat eelvalikut. Asja paremaks mõistmiseks lugege palun tulemuste käsitsi määramise reegleid, samuti <link linkend="actions"
>toimingu</link
> &lastsource; kohta.</para
> <para
>Võimalikud väljakuulutamised on järgmised: a=avakäigul, t=kahekordne õnn. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Viimane kivi</term>
<listitem
><para
>Osa, mille alguses seisab L, sisaldab teavet viimase kivi kohta. Seal on kirjas viimane kivi ise ja seejärel kombinatsioon, mis lõpetati viimase kiviga. Seda viimast kombinatsiooni on vaja reeglile "Viimane kivi on ainuke võimalik", sest mõnikord ei piisa ainult viimase kivi teadmisest. Pane tähele, et viimane kombinatsioon ei saa olla kong, sest kui see lõpetab kongi, tuleb võtta asenduskivi. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>Piirangujaotus</term>
<listitem
><para
>See ei ole veel teostatud, kuid seda võib vaja minna selliste reeglite jaoks, nagu on näiteks defineerinud BMJA (Inglismaal). Osa, mille alguses seisab K, sisaldab kõiki võimalikke kive, mille olemasolu tuleb kontrollida, et jagada punkte piirangujaotuse eest. Võiks muidugi käituda ka sirgjoonelisemalt ja kontrollida kõiki kive, aga see võiks võtta liiga palju aega. </para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
</sect1>
<sect1 id="actions">
<title
>Toimingud</title>
<para
>Kõik reegli toimingud on defineeritud ühesainsas stringis. Neid eraldavad tühikud. Mõned neist defineerivad väärtuse. </para>
<variablelist>
<varlistentry>
<term
>&payforall;</term>
<listitem
><para
>Mängija tegi midagi väga vastikut, mistõttu ta peab kõigile tasuma. See ei ole siiski karistus, sest tasusumma on sama, ainult tasuja muutub. Lisaks ei pea kaks asjasse mittepuutuvat tasujat summasid vahetama. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>&payers;=X</term>
<listitem
><para
>Defineerib, mitmele tasujale see karistusreegel kehtib. X on arv. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>&payees;=X</term>
<listitem
><para
>Defineerib, mitmele saajale see karistusreegel kehtib. X on arv. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>&absolute;</term>
<listitem
><para
>See toiming defineerib absoluutse tasu. Jaotuse tulemist eiratakse. Seda kasutatakse karistusreeglite puhul. </para
></listitem>
</varlistentry>
<varlistentry>
<term
>&lastsource;</term>
<listitem
><para
>This action defines the source of the last tile. Used by manual rules like "last tile from dead end". Setting the last source with this action serves as a filter for other rules - if they trigger only for certain sources. Those other rules can of course also be manual rules. So this filtering will narrow down the amount of manual rules the user gets shown in the scoring dialog. If this seems complicated, just play around with the scoring dialog and watch checkboxes appear and disappear depending on the source of the last tile. </para
></listitem>
</varlistentry>
</variablelist>
</sect1>
</chapter>
<chapter id="problems"
><title
>Teadaolevad probleemid</title>
<itemizedlist>
<listitem
><para
>Praegu ei ole veel mängijal endal võimalik avada kontot mänguserveris.</para
></listitem>
<listitem
><para
>Mängimisrežiimis ei ole veel karistused võimalikud.</para
></listitem>
<listitem
><para
>Arvutimängijad on veel üpris rumalad.</para
></listitem>
<listitem
><para
>Arvutimängijate nimesid ei saa veel muuta.</para
></listitem>
<listitem
><para
>Arvutimänge ei saa veel jätkata.</para
></listitem>
</itemizedlist>
</chapter>
<chapter id="future"
><title
>Võimalikud tulevased omadused</title>
<itemizedlist>
<listitem
><para
>Uued reeglistikud. Soovitavalt võiksid neid pakkuda inimesed, kes kasutavad pakutud reeglistikku regulaarselt.</para
></listitem>
<listitem
><para
>Helide lisamine. Väljakuulutamisi "chow" jne. peaks olema võimalik esitada, samuti ära visatud kivide nimesid. Standardhelide kindlaks määramine, samuti mängijatele võimaluse andmine salvestada oma häält.</para
></listitem>
</itemizedlist>
</chapter>
<chapter id="faq"
><title
>Korduma kippuvad küsimused</title
> <!-- do not change this! -->
<!--This chapter is for frequently asked questions. Please use <qandaset
> <qandaentry
> only!-->
<qandaset>
<!--Following is a standard list of FAQ questions.-->
<qandaentry>
<question
><para
>Ma soovin muuta mängu välimust. On see võimalik? </para
></question>
<answer
><para
>Yes. To change the way &kappname; looks use the <link linkend="settings-menu-settings"
>menubar</link
> to open the <link linkend="configuration"
>configuration utility</link
>.</para
></answer>
</qandaentry>
<qandaentry>
<question
><para
>Kas kive saab mängijatele omistada ka klaviatuuri abil?</para
></question>
<answer
><para
>Jah. Vaata lõiku <link linkend="enterhand-tiles"
>Tulemuse arvutab &kajongg;</link
>.</para
></answer>
</qandaentry>
<!--Please add more Q&As if needed-->
</qandaset>
</chapter>
<chapter id="credits"
><title
>Autorid ja litsents</title
> <!-- do not change this! -->
<!--This chapter is for credits and licenses.-->
<para
>&kappname; for &kde; </para>
<para
>Rakenduse autoriõigus © 2009, 2010: <personname
><firstname
>Wolfgang</firstname
><surname
>Rohdewald</surname
></personname
> <email
>wolfgang@rohdewald.de</email
> </para>
<para
>Dokumentatsiooni autoriõigus © 2009, 2010: <personname
><firstname
>Wolfgang</firstname
><surname
>Rohdewald</surname
></personname
> <email
>wolfgang@rohdewald.de</email
> </para>
<!-- !!!do not change ANYTHING after this line!!!! -->
<para
>Tõlge eesti keelde: Marek Laane <email
>bald@smail.ee</email
></para
>
&underFDL; &underGPL; </chapter>
<appendix id="installation">
<title
>Paigaldamine</title>
<para
>Kasuta .deb-paketti aadressilt <ulink url="http://www.kde-apps.org/content/show.php/kajongg?content=103206"
></ulink
>. Kui see ei toimi, võid samalt aadressilt alla laadida kajongg-x-y.tar.gz ja seejärel sooritada järgmised toimingud: <programlisting
>tar xfz kajongg-x-y.tar.gz
cd kajongg-x-y
./setup.py install
</programlisting>
</para
><para
>Mõlemal juhul tuleb üle kontrollida, et paigaldatud oleks ka mõned muud vajalikud paketid. Debiani pakett ei sisalda veel selliseid nõudmisi. &kajongg; vajab (sulgudes on ära toodud vastavad Debiani paketid): </para>
<itemizedlist>
<listitem
><para
>KDE4 mängude teek (libkdegames5)</para
></listitem>
<listitem
><para
>Python 2.5 või uuem (python)</para
></listitem>
<listitem
><para
>QT4.4 või uuem (libqt4-core, libqt4-gui, libqt4-svg, libqt4-sql, libqt4-sql-sqlite)</para
></listitem>
<listitem
><para
>QT4 Pythoni seosed (python-qt4, python-qt4-sql)</para
></listitem>
<listitem
><para
>KDE4 Pythoni seosed (python-kde4)</para
></listitem>
<listitem
><para
>Pythoni twisted teek (python-twisted-core)</para
></listitem>
<listitem
><para
>sqlite3 (libsqlite3-0)</para
></listitem>
</itemizedlist>
</appendix>
&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-omittag:t
sgml-shorttag:t
sgml-namecase-general:t
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:nil
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
