# &kgeography; käsiraamat

## Sissejuhatus

&kgeography; on &kde; õpiprogramm. See lubab tundma õppida mõningate riikide poliitilist struktuuri (poliitilised üksused, nende pealinnad ja lipud).

## &kgeography; kiirtutvustus

Kui käivitad &kgeography; esimest korda, palutakse sul valida mõne riigi kaart.

Kaartide loendit saab filtreerida tekstivälja Kaartide filtreerimine abil. Kirjuta lihtsalt paar kaardi nime algustähte kasti, millega juba piiratakse tunduvalt nimekirja.

&kgeography; esimesel käivitamisel &kgeography; esimesel käivitamisel

Valime Kanada Valitud on Kanada Valitud on Kanada

Seejärel ilmub &kgeography; peaaken Kanada kaardiga: &kgeography; peaaken &kgeography; peaaken

Nüüd võid valida vasakul asuvast menüüst, millist laadi õppimist või testimist soovid ette võtta: &kgeography; menüü &kgeography; menüü

Kaardi uurimine: klõps &HPNga; kaardi mõnel osal näitab teavet selle kohta.Kui klõpsad seal pisikesele teabeikoonile, avatakse süsteemi vaikimisi brauseris vastava osa kohta käiv Wikipedia lehekülg: Kaardi uurimine Kaardi uurimine

Haldusüksuse asukoht: kõigepealt päritakse, mitmele küsimusele soovid vastata Mitu küsimust Mitu küsimust

Siis palutakse sul klõpsata konkreetsel poliitilisel üksusel: Klõpsa poliitilisel üksusel Klõpsa poliitilisel üksusel

Kui oled kõigile küsimustele vastanud, näidatakse tulemusi, kus on kirjas õiged ja valed vastused: Sinu tulemused Sinu tulemused

Haldusüksusee asetamine kaardile: kursor võtab haldusüksuse kuju ja sa pead selle kaardile asetama: Haldusüksuse asetamine kaardile Haldusüksuse asetamine kaardile

Haldusüksus äraarvamine pealinna põhjal: sinu käest küsitakse, millisele neljast pakutavast poliitilisest üksusest kuulub etteantud pealinn: Haldusüksuse äraarvamine pealinna põhjal Haldusüksuse äraarvamine pealinna põhjal

Testi lõppemisel näidatakse sulle tulemusi: Sinu tulemused Sinu tulemused

Haldusüksuse pealinnad: sulle antakse ette pealinn ja neli haldusüksuse nime, mille seast tuleb valida õige. Testi lõppemisel näidatakse tulemusi.

Haldusüksuse äraarvamine lipu põhjal: sulle näidatakse lippu ja sa pead arvama, millisele poliitilisele üksusele see kuulub. Lipuküsimus Lipuküsimus

Haldusüksuste lipud: sulle antakse ette poliitilise üksuse nimi ja sa pead valima nelja lipu seast õige. Poliitilise üksuse lipu arvamine Poliitilise üksuse lipu arvamine

## &kgeography; kasutamine

&kgeography; näitab infot mõningate maade kohta ja testib sind selle info tundmises. &kgeography; pilt Pilt

### &kgeography; muud omadused

&kgeography; üks võimalusi on kaarti suurendada või vähendada. Suurendus Suurendus Kui klõpsata ikoonile Suurendus, võib kaardil joonistada nelinurga, mida suurendatakse. Suurendusrežiimis saab &HPNga; klõpsates taastada kaardi originaalsuuruse (sama tulemuse annab käsk Originaalsuurus), kerimisribadega kaardil liikuda või liikumiskäsuga lohistada kaarti &HVNga;. Automaatse suurenduse võimalus muudab kaardi võimalikult suureks.

## Kaartide loomine

&kgeography; kaart koosneb vähemalt kahest failist: üks on kaardi pilt, teine selle kirjeldus.

### Abitööriist

Sellelt aadressilt leiab Yann Verley loodud tööriista, mille abil ta valmistas Prantsusmaa kaardi. Kasutamiseks käivita see ja loe abiteadet. Põhimõtteliselt tekitab see lihttekstifailist `.kgm`-faili ning omistab igale poliitilisele üksusele erineva värvi, millega saad siis kaardi värviliseks muuta.

Albert Astals Cid on kirjutanud teisegi tööriista nimetusega colorchecker.py. Selle kasutamiseks on vajalik PyQt4. Anna käivitamisel argumendiks vajalik .kgm-fail (samas kataloogis peab olema ka kaardi .png-fail). See teatab sulle, kas mõni kaardi piksel on teist värvi, kui on määratud .kgm-failis.

Palun tutvu ka õppematerjaliga How to add maps &kgeography; veebileheküljel.

### Kirjeldusfail

Kirjeldusfail on nõutav ja selle laiend on `.kgm`. Selle alguses peab seisma `!DOCTYPE kgeographyMap`, seejärel `map` ja lõpus `map`.

Nende siltide vahel peab asuma:

- `mapFile` ja `mapFile`: kaardi pilti sisaldava faili nimi, ⪚ europe.png.

- `name` ja `name`: kaardi nimi, ⪚ Europe.

- `divisionsName` ja `divisionsName`: poliitilise üksuse üldnimi kaardil, s.t. provints, osariik, maakond vms.

- `division` ja `division` iga kaardi poliitilise üksuse kohta.

Igal poliitilisel üksusel peavad olema järgmised sildid:

- `name` ja `name`: haldusüksuse nimi, ⪚ Albania.

- `capital` ja `capital`: poliitilise üksuse pealinna nimi, ⪚ Tirana.

- `ignore` ja `ignore`: võib olla `yes`, `allowClickMode`, `allowClickFlagMode` ja `no`. Kui silt on `yes`, ignoreeritakse poliitilist üksust antud kaardi üksuste näitamisel. Sel juhul paistab, nagu poleks seda üksust &kgeography; viktoriinirežiimides üldse olemas. Kui see on `allowClickMode`, küsib &kgeography; haldusüksust ainult režiimis Klõpsa kaardil haldusüksusel..., mitte aga teiste viktoriinide korral. Kui see on `allowClickFlagMode`, küsib &kgeography; haldusüksust ainult režiimis Klõpsa kaardil haldusüksusel... ja lipuviktoriinides, mitte aga teiste viktoriinide korral. Kui see on `no`, on üksus näha kõigis režiimides (nii viktoriinides kui ka lihtsal sirvimisel). See ei ole kohustuslik silt ja kui silt `ignore` puudub, arvestatakse automaatselt selle väärtuseks `no`. Näiteks Algeria korral on sellele sildile määratud väärtuseks `yes` Europe kaardi kohta, mis tähendab, et Algeria on nähtamatu kõigis viktoriinides, mis korraldatakse kaardiga Europe.

- `flag` ja `flag`: poliitilise üksuse lippu sisaldav fail, ⪚ albania.png. See ei ole kohustuslik silt. Pole vaja üksuste korral, mille ignoreerimissildi (`ignore`) väärtuseks on `yes`.

- `color` ja `color`: värv, millega poliitilist üksust kaardil näidatakse.

- `falseCapital` ja `falseCapital`: neid võib olla suvaline arv, neid kasutatakse väärate vastuste pakkumisel pealinnaviktoriini nimekirja; vastasel juhul kasutatakse teiste haldusüksuste pealinnade nimesid.

Värv määratakse kolme sildiga:

- `red` ja `red`: värvi punane komponent. Sobivad väärtused vahemikus 0 kuni 255.

- `green` ja `green`: värvi roheline komponent. Sobivad väärtused vahemikus 0 kuni 255.

- `blue` ja `blue`: värvi sinine komponent. Sobivad väärtused vahemikus 0 kuni 255.

Mõistlik on luua kaks-kolm libaüksust, näiteks vesi (Water), piir (Frontier) ja rannik (Coast), ning anda nende sildile `ignore` väärtuseks `yes`. Ära unusta `määramast` värvi kõigile piiridele 0,0,0 kujul RGB-s. Anna väärtuseks 1,1,1 või midagi sellist, et piirijoon oleks näha haldusüksuse asetamisel kaardile.

Kõik nimed (pealinnad ja üksused) peavad olema inglise keeles.

### Kaardifail

Kaardifail on õieti päris lihtne, aga selle loomine nõuab omajagu vaeva. See peab olema PNG-vormingus. Mõned kaardid eeskujuks leiab CIA kaardikogust. Kui ükski kaart sulle ei sobi, võid alla laadida maailma PDF-faili, teha sellest ekraanipildi ja asuda seda töötlema. Kõik poliitilised üksused kaardil peavad olema ühe konkreetse värviga. Selleks on kõige parem kasutada pilditöötlemisrakendusi, näiteks The Gimp ja Kolourpaint.

### Lipud

Kui kasutad lipusilti (`flag`), pead pakkuma ka lipufaili. Need peavad olema PNG-vormingus ning parem oleks, kui need oleks mõõtmetes 300x200 pikslit ja sa saaksid pakkuda ka SVG-faili. Peaaegu kõigi maailma riikide ja mõningate riikide poliitiliste üksuste SVG-lipud leiab Sodipodi lipukogust.

### Testimine

Enne seda, kui saadad kaardi Albertile &Albert.Astals.Cid.mail;, peaksid seda testima, et selles poleks vigu. Selleks talita järgmiselt:

- Aseta kaardi kirjelduse ja kaardi pildi fail kataloogi `$`KDEDIR`/share/apps/kgeography/`

- Aseta lipu PNG-failid (kui neid on) kataloogi `$`KDEDIR`/share/apps/kgeography/flags/`

Seejärel peaksid saama avada oma kaardi &kgeography;s.

Kui sa ei tea, milline on sinu muutuja `$`KDEDIR`` väärtus, anna käsureal korraldus ``kde4-config` `--prefix``.

Tööriistaga colorchecker.py saab kontrollida, kas kaardile ei ole jäänud ülearuseid värve, mis on .kgm-failis defineerimata.

### Mittepoliitilised kaardid

Kas mittepoliitilisi kaarte võib ka teha? Jah, muidugi! Näide mittepoliitilise kaardi loomise kohta Näide mittepoliitilise kaardi loomise kohta

Mõistagi võib üksuse mõistet laiendada jõgedele või mägedele. Sellise kaardi loomisel tuleks silmas pidada, et enamasti on jõgi või mägi liiga pisike, nii et tuleks luua mõnevõrra avaram klõpsamisala. Toodud näites ongi jõel laiem ala ning seda tuvastab värv <20,76,34>.

## Käskude seletused

### &kgeography; peaaken

#### Menüü Fail

&Ctrl;O Fail Ava kaart...

- Avab kaardi valimise dialoogi. Kui kirjutad piisavalt kiiresti paar soovitud kaardi nime algustähte, valitakse esimene sobiv kaart.

&Ctrl;Q Fail Välju

- Lõpetab &kgeography; töö

#### Menüü Vaade

Vaade Suurendus

- Lülitab sisse suurendusrežiimi, mille puhul saab kaardi osa suurendada kaardile vastavat ristkülikut joonistades

Vaade Originaalsuurus

- Kehtestab kaardi esialgse suuruse, nagu selle määrab kaardifail. Sama toimega on klõps &HPNga; suurendusrežiimis.

Vaade Automaatne suurendus

- Kehtestab &kgeography; akna suuruse muutmisel kaardile automaatse suurenduse, kasutades ära võimalikult suure pinna

Vaade Liiguta

- Liigutab aktiivset kaarti. Seda saab kasutada ainult siis, kui oled kaarti suurendanud.

#### Menüü Seadistused

&kgeography; kasutab tavapäraseid &kde; menüü Seadistused kirjeid, millest kõneleb lähemalt &kde; põhialuste käsiraamatu menüüd Seadistused käsitlev osa.

#### Menüü Abi

&kgeography; kasutab &kde; tavapärast abimenüüd, mida kirjeldab &kde; põhialuste käsiraamat, kuid lisab sellele omalt poolt kaks kirjet:

Abi Lahtiütlus

- Näitab lahtiütlust &kgeography;s kasutatud kaartide, lippude ja tõlgete täpsuse kohta.

Abi Kaardi autor

- Näitab aktiivse kaardi loonud autori nime.

## Seadistamine

Küsimuse joondus

- Määrab küsimuse asukoha aknas. Vaikimisi on selleks Ülal vasakul.

Ootamine kontrollimise järel

- Märkimise korral tuleb pärast vastuse andmist klõpsata nupule Nõus.

Fookus järgib hiirt

- Märkimise korral võrdub tühikuklahvi vajutamine hiirekursori all asuvale nupule klõpsamisega.

Kaardijaotiste värvid

- Siin saab valida, kas värvid on alati ühesugused (nii on see vaikimisi) või hoopis juhuslikud. Viimasel juhul võib olla hõlpsam keskenduda haldusüksuste kujule, mitte neid tähistavale värvile.

## Autorid ja litsents

&kgeography;

Rakenduse autoriõigus 2004-2008: Albert Astals Cid &Albert.Astals.Cid.mail;

Dokumentatsiooni autoriõigus © 2005: &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; 2008: Kushal Das kushaldas@gmail.com

Tõlge eesti keelde: Marek Laane bald@starman.ee

&underFDL; &underGPL;

## Paigaldamine

### &kgeography; hankimine

&install.intro.documentation;

### Kompileerimine ja paigaldamine

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