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

<book lang="&language;">

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

<authorgroup>
<author
> <firstname
>Anne-Marie</firstname
> <othername
></othername
> <surname
>Mahtouf</surname
> <affiliation
> <address
><email
>annma@kde.org</email
></address
> </affiliation
> </author>
</authorgroup>


<copyright>
<year
>2001</year
><year
>2002</year>
<holder
>Anne-Marie Mahtouf</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>


<date
>2002-10-08</date>
<releaseinfo
>0.8</releaseinfo>

<abstract>
<para
> &khangman; on klassikaline laste poomismäng, mis on kohandatud &kde; jaoks. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>KHangMan</keyword>
<keyword
>lapsed</keyword>
<keyword
>sõnad</keyword>
</keywordset>

</bookinfo>

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

<para
> &khangman; tugineb tuntud poomismängule ning on mõeldud lastele vanuses kuus aastat ja enam. Mängul on neli raskusastet. Sõna valitakse juhuslikult, tähed on varjatud ja sul tuleb sõna ära arvata tähti üksteise järel pakkudes. Iga kord, kui oled valesti pakkunud, joonistatakse poomispildile üks kriips juurde. Seepärast on äärmiselt kasulik arvata sõna ära enne, kui sind on üles poodud! Sul on kasutada üheksa pakkumisvõimalust. </para>
<para
> Selle mängu idee andis mulle 2000. aasta juunis minu üheksa ja poole aastane poeg Joachim. </para>

</chapter>

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

<screenshot
> <screeninfo
>Siin on pilt &khangman;i mängust</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="khangman1.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>&khangman;i pilt</phrase
> </textobject
> </mediaobject
> </screenshot>


<sect1 id="general-usage">
<title
>Üldised kasutamisjuhised</title>

<para
>Sõna esitatakse varjatult. See tuleb ära arvata tähti üksteise järel pakkudes. Sõnavalik on juhuslik. Igal tasemel on 44 erinevat sõna.</para>

<important
><para
>Kõik sõnad on nimisõnad ning trükitähtedega.</para
></important>

<para
> Mängu käivitades on tase alati lihtne. </para>
<para
> Kui pakud tähe, mida sõnas ei ole, joonistatakse poomispilti natuke edasi. Sõna äraarvamiseks on 10 tähepakkumisvõimalust. Pärast seda näidatakse sulle sõna. </para>
<para
> Tasemeid on neli: lihtne, keskmine, raske ja loomad. </para>
<para
> Lihtsal tasemel on sõnad väga kerged, seotud igapäevaeluga. See sobib lastele vanuses 6-9 aastat. Loomade tasemel on tegemist ainult loomanimedega, nii et ka seda võib lihtsaks pidada. Siiski on mõned nimed lihtsamad, mõned aga keerukamad. Keskmisel tasemel on sõnad pikemad ja keerulisemad, nii et see sobib enam kui üheksa-aastastele lastele. Raske tase ongi RASKE, st sõnad on päris keerulised ja mitte väga levinud. See tase pakub peamurdmist ka täiskasvanutele. </para>

<para
>Kui sõna on ära arvatud (või poomispilt valmis saanud), pakutakse sulle võimalust uueks mänguks ja sa võid kasutada klahvi <keycap
>J</keycap
> või <keycap
>E</keycap
> või hoopis hiirt pakkumisele 'ei' või 'jah' vastata.</para>

</sect1>
<sect1 id="few-tips">
<title
>Natuke abi</title>
<para
> Esialgu on mäng kahjuks ingliskeelne, seepärast püüa esmalt pakkuda täishäälikuid, seejärel levinumaid kaashäälikuid : l, t, r, n, s </para>
<para
> Kui näed järjestikku tähti 'io', paku 'n'. </para>
<para
> Kas tead, et inglise keeles on kõige levinum täht 'e' (12,7%), millele järgnevad 't' (9,1%), 'a' (8,2%), 'i' (7,0%) ja 'n' (6,7%). </para>
</sect1>
</chapter>

<chapter id="commands">
<title
>Käskude seletused</title>

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

<para
>Klõps nupul <guibutton
>Sulge</guibutton
> võimaldab mängust väljuda. Klõps nupul <guibutton
>Abi</guibutton
> toob nähtavale selle käsiraamatu. Taset saab valida hüpikkastist, mis avaneb nupule <guibutton
>Tase</guibutton
> vajutades.</para>

</sect1>
</chapter>

<chapter id="developers">
<title
>&khangman;i sõnum arendajatele</title>

<sect1 id="changing-words">
<title
>Kuidas muuta sõnu</title>

<para
>Laadi alla &khangman;i viimase versiooni <literal role="extension"
>tar.gz</literal
>-fail. Paki see lahti mingisse kataloogi (näiteks <filename class="directory"
>/usr/local/bin</filename
>). Sõnad on salvestatud nelja eraldi faili, üks iga taseme jaoks. Failide asukoht on <filename class="directory"
>khangman/data</filename
>. Fail <filename
>easy.txt</filename
> on lihtsa taseme jaoks, <filename
>level2.txt</filename
> keskmise, <filename
>level3.txt</filename
> loomade ja <filename
>level4.txt</filename
> raske taseme jaoks.</para>

<para
> Redigeeri iga faili oma lemmikredaktoriga (nt &kedit; või &kate; või <application
>Emacs</application
>). Muuda sõnu, kirjutades igale reale ühe sõna, kusjuures tähtede arv ei tohi olla suurem kui 12. </para>

<note
><para
>Igas neljast tekstifailist on 44 sõna (see tähendab 44 sõna, üks sõna igal real). Kui sa seda suurust muudad, siis muuda vastavalt ka teisi faile, et neil kõigil oleks ühepalju ridu/sõnu. Seejärel korrigeeri failis <filename
>khangman.cpp</filename
> esimest määrangurida, mida nimetatakse 'wordsnum'. <screen width="40">
int wordsnum=sinu_uus_sõnade_arv;
</screen
> </para
></note>

<para
> Salvesta fail ja anna selle korrektseks paigaldamiseks administraatorina käsk <userinput
><command
>make</command
> <option
>install</option
></userinput
>, kui oled mängu juba kompileerinud. Kui veel ei ole, siis terminalis <userinput
><command
>./configure</command
> <option
>--prefix=$<envar
>KDEDIR</envar
></option
></userinput
>, <userinput
><command
>make</command
></userinput
> ja <userinput
><command
>make</command
> <parameter
>install</parameter
></userinput
>.</para>

</sect1>

</chapter>

<chapter id="faq">
<title
>Küsimused ja vastused</title>

&reporting.bugs;
&updating.documentation;

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>Ma saan veateate, mis ütleb, et pilte ei leita.</para>
</question>
<answer>
<para
>Mäng paigaldatakse vaikimisi kataloogi <filename class="directory"
>/usr/local/kde</filename
>, nii et lisa oma otsinguteele <filename class="directory"
>/usr/local/kde/bin</filename
> ja määra enne mängu käivitamist muutujaks <envar
>KDEDIR</envar
> <filename class="directory"
>/usr/local/kde</filename
>. Hõlpus on konfigureerida &khangman;i võtmega <option
>--prefix</option
>=$<envar
>$KDEDIR</envar
>, kus $<envar
>KDEDIR</envar
> on koht, kuhu on paigaldatud &kde;. See võib olenevalt distributsioonist ja operatsioonisüsteemist tublisti erineda.</para>
</answer
> 
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title
>Tänusõnad ja litsents</title>

<para
> &khangman; </para>
<para
> Programmi copyright 2001: Anne-Marie Mahtouf <email
>annma@kde.org</email
> </para>
<para
> Kaasaaitajad: <itemizedlist
> <listitem
><para
>graafika: Renaud Blanchard <email
>kisukuma@chez.com</email
></para
> </listitem
> <listitem
><para
>heli: Ludovic Grossard <email
>ludovic.grossard@libertysurf.fr</email
></para
> </listitem
> <listitem
><para
>logo: Primoz Anzur <email
>zerokode@yahoo.com</email
></para
> </listitem
> </itemizedlist
> </para>

<para
> Dokumentatsiooni copyright 2001: Anne-Marie Mahtouf <email
>annma@kde.org</email
> </para>


&underFDL;               <!-- FDL: do not remove -->
&underGPL;        	 <!-- GPL License -->

</chapter>

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

<sect1 id="getting-khangman">
<title
>Kuidas hankida &khangman;</title>

&install.intro.documentation;

</sect1>

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

&install.compile.documentation;

</sect1>
</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
