# &kgeography; käsiraamat

## Sissejuhatus

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

Praegu on saadaval järgmised kaardid: Aafrika, Aasia, Austria, Brasiilia, Euroopa, Hiina, Hispaania, Itaalia, Itaalia provintsid, Kanada, Lõuna-Ameerika, Norra, Poola, Prantsusmaa, Põhja- ja Kesk-Ameerika, Saksamaa, USA ja maailm.

## &kgeography; kiirtutvustus

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

Valime Kanada Kanada valimine Kanada valimine

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

Vaata kaarti: klõps &HVN;ga kuskil kaardil näitab selle kohta infot: Vaata kaarti Vaata kaarti

Klõpsa kaardil haldusüksusel: 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

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

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

Arva pealinn haldusüksuse põhjal: sulle antakse ette poliitiline üksus ja neli linnanime, mille seast tuleb valida õige. Testi lõppemisel näidatakse tulemusi.

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

Arva lipp haldusüksuse põhjal: 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 Suurendusrežiimis saab &HPN;ga klõpsates taastada kaardi originaalsuuruse (sama tulemuse annab käsk Originaalsuurus), kerimisribadega kaardil liikuda või liikumiskäsuga lohistada kaarti &HVN;ga.

## 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 klaartekstifailist `.kgm`-faili ning omistab igale poliitilisele üksusele erineva värvi, millega saad siis kaardi värviliseks muuta.

### Kirjeldusfail

Kirjeldusfail on nõutav ja selle laiend on `.kgm`. Selle alguses peab seisma `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.

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

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

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 tsdgeos@terra.es, peaksid seda testima, et selles poleks vigu. Selleks talita järgmiselt:

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

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

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

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

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

&Ctrl;Q Fail Välju

- Lõpetab &kgeography; töö

#### Menüü Vaade

Vaade Suurendus

- Kehtestab suurendusrežiimi

Vaade Originaalsuurus

- Kehtestab kaardi esialgse suuruse

Vaade Liiguta

- Liigutab kaarti

#### Menüü Seadistused

Seadistused Tööriistariba näitamine/peitmine

- Näitab või peidab &kgeography; tööriistariba.

Seadistused Kiirklahvide seadistamine...

- Võimaldab seadistada &kgeography; kiirklahve.

Seadistused Tööriistaribade seadistamine...

- Võimaldab seadistada &kgeography; tööriistaribasid.

#### Menüü Abi

&help.menu.documentation;

## Autorid ja litsents

&kgeography;

Rakenduse autoriõigus 2004-2005: Albert Astals Cid tsdgeos@terra.es

Dokumentatsiooni autoriõigus © 2005: &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;

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;