# &khangman;i käsiraamat

## Sissejuhatus

&khangman; tugineb tuntud poomismängule. See on mõeldud enam kui kuueaastastele lastele. Mängul on neli raskusastet (loomad ehk loomanimed, lihtne, keskmine ja raske). Sõna valitakse juhuslikult, tähed on peidetud ning sul tuleb sõna tähti ükshaaval pakkudes ära arvata. Iga kord, kui pakud vale tähe, joonistatakse poomispildile kriipsuke juurde. Nii et parem arva sõna ära, enne kui pooja oma tegevusega lõpule jõuab! Pakkuda saab 10 korda.

Selle mängu idee andis mulle 2000. aasta juunis minu toona üheksa ja poole aastane poeg Joachim.

## &khangman;i kasutamine

&khangman; esmakordsel käivitamisel &khangman;i pilt

Selline näeb &khangman; välja esimesel käivitamisel. Tase on lihtne, keel vaikekeel (antud juhul inglise keel), taustateema puudub ja poojapildid ei ole läbipaistvad. Kõik tasemesse, keelde või tausta esitamisse tehtud muudatused salvestatakse seadistustefaili ja taastatakse mängu järgmisel käivitamisel.

Taseme ja tausta muutmine on imelihtne: selleks tuleb vaid kasutada tööriistaribal asuvaid liitkaste. Ka uue sõna võtmine ja mängust väljumine on hõlpus - sedagi saab teha vastavate nuppudega tööriistaribal.

### Üldised kasutamisjuhised

Sõna näidatakse peidetult, saad teada ainult seda, mitu tähte selles on. Tähti tuleb pakkuda ükshaaval. Sõna valitakse juhuslikult, aga kindlasti ei tule üks sõna kaks korda järjest.

Kõik sõnad on nimisõnad (mitte tegusõnad, omadussõnad &etc;).

Pole tähtis, kas pakud tähe väikese või suurena, sest rakendus peab kõiki tähti väiketähtedeks, välja arvatud saksakeelsete sõnade puhul, mis algavad suure tähega. Ka seda teeb rakendus automaatselt.

Parajasti mängitav tase ja keel on näha olekuribal.

Iga kord, kui pakud tähe, mida sõnas ei esine, tõmbab pooja pildile kriipsukese juurde. Sõna äraarvamiseks saab pakkuda 10 korda. Pärast seda näidatakse õiget sõna.

Tasemeid on neli: lihtne, keskmine, raske, loomad ning lisaks veel mõne keele puhul muud temaatilised tasemed. Rakendus jälgib kõigis keeltes kõiki andmefaile.

Lihtsal tasemel on ka sõnad lihtsad, seotud igapäevaeluga. See sobib lastele vanuses kuus kuni üheksa aastat. Loomade tasemes kasutatakse ainult loomanimesid, nii et seegi on suhteliselt lihtne, kuigi siin esineb ka üpris haruldasi loomi. Keskmisel tasemel on sõnad pikemad ja raskemad. See sobib lastele vanuses üle üheksa aasta. Raske tase on... nojah, raske, &ie; sõnad on keerulisemad ega pruugi olla sugugi tavalised. See tase esitab tõelise väljakutse isegi täiskasvanutele.

Kui sõna on ära arvatud (või pooja oma tegevusega lõpule jõudnud), küsitakse, kas soovid proovida uue sõnaga. Sellele võid vastata klahvidega J või E või hiirega klõpsates. Kui vastad Ei, lõpetab mäng oma töö. Kui vastad Jah, pakutakse äraarvamiseks uus sõna.

Pakutav täht tuleb kirjutada vastavale väljale (hiirekursor juba asub seal) ning vajutada klahvi &Enter;. Kui täht sõnas esineb, asetatakse see õigele kohale (kui seda esineb mitmel korral, siis kõigisse sobivatesse kohtadesse). Kui tähte sõnas ei esine, läheb see eksimuste väljale ning akna paremas osas asub tegutsema pooja, kes tõmbab joonisele juurde ühe kriipsu. Kui sa ei ole sõna kümne pakkumisega ära arvanud, oled kaotanud ning saad lisaks poomisele näha ka õiget sõna.

Mängu ajal võid alati valida ka uue äraarvamise, kasutades selleks menüüs Mäng olevat käsku Uus või klõpsates tööriistariba nupule Uus. Tööriistaribal paiknev tasemenupp aga võimaldab suvalisel hetkel taset muuta, mis ühtlasi pakub äraarvamiseks uue sõna.

Tulevased parandused lubavad kasutajal luua oma sõnafaile või avada mõne muu faili peale nende nelja, mis on rakendusega kaasas.

You can play &khangman; in thirteen languages: Brazilian Portuguese, Catalan, Czech, Danish, Dutch, English, Finnish, French, German, Italian, Portuguese, Spanish and Swedish. You can easily change the Language by going in the Languages menu and choosing another language.

Pane tähele, et nüüd on võimalik kirjutada ka keelele omaseid eritähti, kasutades selleks eritähtede tööriistariba. Sellel on nupud kõigi vastava keele eritähtedega, näiteks é prantsuse keele puhul. Sellisel nupul klõpsamine sisestab vastava tähe sisendväljale ning seda, kas see on õige või mitte, saab kontrollida klõpsuga nupule 'Kontrolli'. Mõistagi võib eritähtede sisestamiseks kasutada ka klaviatuuri, kui sellel on vastavad tähed. Tööriistariba saab oma soovi kohaselt peita. See, kas riba on peidetud või mitte, jäetakse meelde, ning &khangman;i järgmisel korral käivitamisel on see samuti vastavalt peidetud või nähtaval.

Please note that for Czech special characters you will need a font that supports these characters so you can see them displayed. Choosing Arial in KDE Control Center as a general font and adjusting all fonts will work fine.

### Natuke abi

Esmalt on mõtet pakkuda täishäälikuid, seejärel levinumaid kaashäälikuid: l, t, r, n, s

Kui näed prantsuse või inglise keele korral täheühendit io, tasub pakkuda n.

Brasiilia protugali, hispaania, katalaani ja portugali keele puhul näidatakse ka rõhumärkidega täishäälikuid, kui pakkuda vastav rõhumärgita vokaal. Nii näidatakse näiteks a pakkumisel ka kõiki diakriitiliste märkidega a-sid. Seda muidugi juhul, kui Seadistused Rõhumärkidega tähtede kirjutamine ei ole sisse lülitatud. Kui Seadistused Rõhumärkidega tähtede kirjutamine on sees, tuleb rõhumärkidega tähed sul ise sisestada. Kui kirjutad sellisel juhul a, siis ongi see a ning kui soovid, et selle asemel sisestataks näiteks ã, tuleb sul just see ka sisestada.

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%).

## Menüüriba ja tööriistaribad

### &khangman;i peaaken

Menüüs Mäng on kaks kirjet: Uus ja Välju.

Uus avab uue mängu, &ie; uue sõna äraarvamiseks käesoleval tasemel. Välju lõpetab mängu, sulgedes peaakna ja kirjutades parajasti kehtivad seadistused seadistustefaili.

The Languages menu has thirteen menu items: Brazilian Portuguese, Catalan, Czech, Danish, Dutch, English, Finnish, French, German, Italian, Portuguese, Spanish and Swedish. As default, if your &kde; language is one of those thirteen, then it is set as default otherwise English is chosen. After your first game, the language you set up the last time you used &khangman; is restored.

Menüü Seadistused lubab hõlpsasti seadistada &khangman;i. Kõigepealt annavad käsud Tööriistaribad ja Olekuriba näitamine võimaluse näidata või peita tööriistaribasid ja olekuriba.

Tööriistaribasid on kaks: peamine tööriistariba ülal, kus on nupud ja liitkastid, ning tähtede tööriistariba, mis juhul, kui seda näidatakse, asub all. Viimasel asuvad iga keele eritähed: rõhumärkidega tähed ja muud erilised tähestiku elemendid. See võimaldab mängu hõlpsasti kasutada ilma klaviatuuri seadistustega vaeva nägemata: klõpsa vajalikule eritähele ja see ilmubki nähtavale. Klahvile &Enter; vajutades selgub, kas täht esineb äraarvatavas sõnas või mitte. Soovi korral saab selle tööriistariba ka peita. See salvestatakse ka seadistustefaili, nii et kui peidad tööriistariba, ei ole seda näha ka &khangman;i järgmisel käivitamisel.

Mõistagi on võimalik tööriistaribasid liigutada just sinna, kuhu süda soovib. Aseta selleks hiirekursor tööriistariba vasakus servas paiknevale väiksele sangale, vajuta &HVN; alla ja lohista tööriistariba ekraanil sinna, kus soovid seda näha. Kui klõpsad mõnel tööriistaribal hiire parema nupuga, ilmub hüpikmenüü, mis võimaldab tööriistaribaga teatud toiminguid ette võtta.

Kiirklahvide seadistamine... avab &kde; tavapärase kiirklahvide dialoogi, kus saab klahve või klahvikombinatsioone seostada teatud toimingutega. Näiteks &Ctrl;Q on tavaline käsklus rakenduse töö lõpetamisele (menüükäsk Välju).

Ka Tööriistaribade seadistamine... on &kde; tavaline tööriistaribade kohandamise dialoog, mis võimaldab ikoone tööriistaribadele lisada või eemaldada. Kui märkida ära võimalus Täisekraani režiim, muudetakse aken kogu ekraani katvaks. Peamisel tööriistaribal paiknev ikoon Välju täisekraanrežiimist toob sind tagasi varasema mänguakna suuruse juurde.

Võimalus Läbipaistvad pildid lubab määrata, kas poojapildid on läbipaistvad või mitte.

Armsa pooja pildid lubab muuta viimase kriipsukese lisamise poomispildile mõnevõrra inimsõbralikumaks. See tähendab, et mehikest ei pooda üles, vaid ta jääb köit käes hoidma. See on mõeldud ennekõike väiksemate laste tundeid silmas pidades.

Võimalus Rõhumärkidega tähtede kirjutamine on kasutatav ainult Brasiilia portugali, hispaania ja katalaani keele korral. Sisselülitamisel on kasutajal võimalik kirjutada rõhumärkidega tähti, näiteks ã. Kui see ei ole sisse lülitatud, siis sobib tavaline täht ka kõigi sarnaste rõhumärkidega tähtede leidmiseks, seega kirjutades a leitakse ka sõnas esinevad ã ja muud rõhumärkidega a-d.

Vihje lubamine on kasutatav ainult prantsuse ja itaalia keele korral. Kui nende puhul see võimalus sisse lülitada, võib mängus kuhu tahes &HPN;ga klõpsata ja näha neli sekundit vihjet. See vihje abistab sõna äraarvamisel.

Arvesta, et läbipaistvaid pilte ei saa kasutada, kui tausta ei ole valitud. Läbipaistvus toimib ainult tausta korral. Vaikimisi on läbipaistvus sisse lülitatud.

&khangman;i sinine teema &khangman;i sinine teema

Siin on näha &khangman; sinise teemaga, läbipaistvate piltidega, katalaani keeles ja raskel tasemel. Näha on ka tähtede tööriistariba.

Taseme saab valida liitkastist, valida on lihtsa, keskmise, raske ja loomade taseme vahel. Lihtsa taseme korral käivad sõnad elementaarsete asjade kohta, mida võiks teada kuue-seitsmeaastane laps. Keskmine tase on veidi keerulisem, raske päris raske ja loomade taseme korral tuleb ära arvata ainult loomanimesid.

Kõik sõnad on nimisõnad, ühtegi verbi ega omadussõna ei kasutata. Valitud tase on näha olekuribal.

Väljale on lubatud kirjutada ainult tähti, mitte aga numbreid või muid märke.

## Käskude seletused

### Menüüd ja kiirklahvid

#### Menüü Mäng

&Ctrl;N Mäng Uus

- Uus mäng, &ie; uus sõna

&Ctrl;Q Mäng Välju

- Lõpetab &khangman;i töö

#### Menüü Keeled

Keeled Keeled

- Võimalus valida, mis keeles sõnu esitatakse

#### Menüü Seadistused

Seadistused Tööriistaribad Peamise tööriistariba näitamine

- Lülitab peamise tööriistariba näitamist sisse ja välja

Seadistused Tööriistaribad Tähtede tööriistariba näitamine

- Lülitab tähtede tööriistariba näitamist sisse ja välja

Seadistused Olekuriba näitamine

- Lülitab olekuriba näitamist sisse ja välja

&Ctrl;T Seadistused Läbipaistvad pildid

- Lülitab poomispiltide läbipaistvust sisse ja välja

&Ctrl;S Seadistused Armsa pooja pildid

- Lülitab poomispiltide leebema ja algupärase variandi vahel

&Ctrl;A Seadistused Rõhumärkidega tähtede kirjutamine

- Võimaldab kirjutada emakeelseid diakriitiliste märkidega tähti (Brasiilia portugali, hispaania, katalaani ja portugali keele puhul)

&Ctrl;T Seadistused Vihje lubamine

- Lubab hiire parema klõpsuga näha vihjet (ainult prantsuse ja itaalia keele puhul)

&Ctrl;&Shift;F Seadistused Täisekraan

- Lülitab täisekraanirežiimi

Seadistused Kiirklahvide seadistamine...

- Võimaldab seadistada klahve ja klahvikombinatsioone, mille abil sooritada mitmesuguseid tegevusi.

Seadistused Tööriistaribade seadistamine...

- Võimaldab seadistada, mis peab olema näha tööriistaribal

#### Menüü Abi

&help.menu.documentation;

## &khangman;i sõnum arendajatele

### Kuidas lisada sõnu mängu uuele keelele

Thanks to Stefan Asserhäll, it is very easy to add a new language directly to the game. The procedure described here can also be found in the `khangman` source folder in the file `README.languages`. However, as there are already thirteen languages, it will be difficult to add others as the menu will be too long. So please follow the procedure below but instead of committing your files you send them to me tarred and gzipped. That way I'll make your language available on the &khangman; web page. Next &khangman; release (with &kde; 3.3) will have a wizard to easily download and install new languages.

Tõmba endale &khangman;i uusim CVS versioon. Sõnad paiknevad neljas eraldi failis, üks fail iga taseme kohta. Failid asuvad kataloogis `/khangman/data/keele_kood`. Fail `easy.txt` on lihtsa taseme, `medium.txt` keskmise, `anmals.txt` loomade ja `hard.txt` raske taseme jaoks.

1. Anna &konsole;is uue keele kataloogi ja failide loomiseks järgmised käsud:

       ./add_language keele_kood

   `keele_kood` tuleb siin asendada soovitud keele koodiga.

2. Redigeeri uue kataloogi kõiki tekstifaile ning asenda kõik sõnad tõlgetega. Pole oluline kasutada just inglis- või muukeelsete sõnade tõlkeid, kuid sõnade pikkus ja raskusaste ei tohiks siiski muutuda.

   Sõnu võib muidugi ka otse tõlkida, aga mõttekas on kasutada oma keele arusaama sõnade raskusastmest ja ka uusi sõnu lisada. Näiteks table ehk laud on inglise keeles lihtsa taseme sõna, aga mõnes muus keeles võib see kuuluda ka näiteks keskmisele tasemele. Nii et kasuta sõnade muutmisel oma paremat äranägemist ja seesmist tunnetust. Sõnade arv failis ei ole oluline, neid võib täiesti vabalt ka rohkem olla.

   Arvesta, et kõik sõnad peaks olema nimisõnad.

   Arvesta, et faile redigeerides tuleb kasutada UTF-8 kodeeringut. Kui sinu lemmikredaktor seda ei suuda, püüa kasutada &kwrite;'i või &kate;t. Faili &kwrite;'is või &kate;s avades saab utf8 kodeeringu valida ülal paremal asuvast liitkastist.

   Palun säilita oma keele kataloogis ingliskeelsete failide failinimed.

3. Anna uute failide paigaldamiseks käsud:

       make
       make install

   `make install` võib sõltuvalt paigaldusest nõuda, et oleksid administraatori (`root`) õigustes.

4. Käivita mäng ja kontrolli, kas keel on lisatud:

       khangman

5. Saada uue keele failid CVSi käsuga:

       cvs commit -m "Added new language keele_nimi_(inglise keeles)"

Kui soovid, et uus keel kasutaks ka vihjeid, tuleb veidi rohkem vaeva näha. Kasutada tuleb kvtml vormingut ning kõige parem oleks eeskujuks vaadata, mida on tehtud prantsuse ja itaalia keele puhul. Silt `o` käib sõna, silt `t` vihje kohta. Püüa hoida vihjed vastavuses taseme raskusastmega. Lihtsal tasemel võiks ka vihje olla üsna lihtne, kuid raskel tasemel võib vaja minna juba näiteks sõnaraamatu seletust. Püüa mitte kasutada vihjes äraarvatava sõnaga sarnaseid sõnu, mis annaks vahest liiga palju ette!

Näide kvtml faili kohta:

    <?xml version="1.0"?>
    <!DOCTYPE kvtml SYSTEM "kvoctrain.dtd">
    <kvtml>
    <e>
    <o>cane</o>
    <t>è il tuo animale domestico preferito</t>
    </e>
    ...
    ...
    </kvtml>

### &khangman;i tulevikukavad

Et keeli on aina juurde tulnud, ei ole enam mõttekas neid otse rakendusega kaasa panna. Meil on kavas vahetult pakkuda ainult mõnda keelt, näiteks inglise, prantsuse, saksa ja hispaania, ning teised keeled teha kättesaadavaks i18n mooduli ja allalaadimise vahendusel. &khangman; kasutab ära klassi `KNewStuff`, et pakkuda nõustajat, mis lubab kasutajal lisakeeli hõlpsasti alla laadida ja paigaldada. Sama idee on ka &klettres;i ja &kstars;i kohta, sest me ei soovi paketti &package; mõistuseväliselt suureks paisutada.

Veel üks tulevikukava on mõistagi vihjete pakkumine igas keeles.

Samuti on meie mõtetes mõlkunud kasutada &khangman;i mängimisel muid kvtml faile kui need, mis on KDE-Edu veebileheküljel. Näiteks võiks ju mängida maailma pealinnadega, kus näiteks vihje ütleks ära riigi ja sina peaksid siis pealinna ära arvama. Või mõne muu keele õppimisel antaks vihje sinu emakeeles ja sina peaksid ära arvama, kuidas kõlab see mingis muus keeles.

## Küsimused ja vastused

&reporting.bugs; &updating.documentation;

Ma saan veateate, mis ütleb, et pilte ei leita.

Vaikimisi on mäng paigaldatud kataloogi `/usr/local/kde`, nii et lisa enne mängu käivitamist oma otsinguteele `/usr/local/kde` ja määra muutuja `KDEDIR` väärtuseks `/usr/local/kde`. Väga lihtne on &khangman;i seadistada võtmega `--prefix`=$`KDEDIR`, kus $`KDEDIR` on koht, kuhu &kde; on paigaldatud. See võib vastavalt distributsioonile ja operatsioonisüsteemile tublisti erineda.

&khangman; ei käivitu korrektselt pärast seda, kui uuendasin &kde; 3.2 versiooni

Selle põhjuseks võib olla seadistustefaili muutumine. Palun eemalda kataloogist `$HOME/.kde/share/config` fail `khangmanrc`.

## Autorid ja litsents

&khangman;

Rakenduse autoriõigus 2001-2003: Anne-Marie Mahtouf annma AT kde DOT org

Kaasaaitajad:

- Hangmani graafika: Renaud Blanchard kisukuma AT chez DOT com

- Helid: Ludovic Grossard ludovic.grossard AT libertysurf DOT fr

- Sinine teema, ikoonid ja kood: Primoz Anzur zerokode AT yahoo DOT com

- Rootsi keele andmefailid, abi koodi kirjutamisel, läbipaistvad pildid ja i18n parandused: Stefan Asserhäll stefan DOT asserhall AT telia DOT com

- Looduseteema: Joe Bolin jbolin AT users DOT sourceforge DOT net

- Armsa pooja pildid: Matt Howe mdhowe AT bigfoot DOT com

- Hispaania keele andmefailid: eXParTaKus expartakus AT expartakus DOT com

- Taani keele andmefailid: Erik Kjaer Pedersen erik AT mpim-bonn DOT mpg DOT de

- Soome keele andmefailid: Niko Lewman niko DOT lewman AT edu DOT hel DOT fi

- Brasiilia portugali keele andmefailid: João Sebastião de Oliveira Bueno gwidion AT mpc DOT com DOT br

- Katalaani keele andmefailid: Antoni Bella bella5 AT teleline DOT es

- Itaalia keele andmefailid: Giovanni Venturi jumpyj AT tiscali DOT it

- Hollandi keele andmefailid: Rinse rinse AT kde DOT nl

- Portugali keele andmefailid: Pedro Morais morais AT kde DOT org

- Abi koodi kirjutamisel: Robert Gogolok robertgogolok AT gmx DOT de

- Abi koodi kirjutamisel: Benjamin Meyer ben AT meyerhome DOT net

- Koodiparandused: Lubos Lunàk l.lunak AT kde DOT org

- Koodiparandused: Albert Astals Cid tsdgeos AT terra DOT es

Dokumentatsiooni autoriõigus 2001-2003 Anne-Marie Mahtouf annma AT kde DOT org

&underFDL; &underGPL;

## Paigaldamine

### Kuidas hankida &khangman;

&install.intro.documentation;

### Kompileerimine ja paigaldus

&install.compile.documentation;
&documentation.index;