# &kgeography; käsiraamat

Anne-Marie Mahfouf &Anne-Marie.Mahfouf.mail;
Kushal Das kushaldas@gmail.com
Marek Laane

    bald@starman.ee

Tõlge eesti keelde
2005 &Anne-Marie.Mahfouf;
2008 Kushal Das
&FDLNotice;
2013-11-13
0.8.1 (&kde; 4.13)

&kgeography; on &kde; geograafia õpiprogramm. Praegu saab kasutada seitset erinevat õppemeetodit:

- Kaartide sirvimine ja neile klõpsates kohanimede, pealinnade ja lippude tundmaõppimine

- Mäng, mis annab ette geograafilise nimetuse ja sina pead kaardil sellele klõpsama

- Mäng, mis annab sulle ette pealinna ja sina pead ära arvama, mille pealinn see on

- Mäng, mis annab ette poliitilise üksuse ja sina pead ära arvama selle pealinna

- Mäng, mis näitab poliitilise üksuse lippu ja sina pead ära arvama üksuse nime

- Mäng, mis annab ette poliitilise üksuse nime ja sina pead ära arvama selle lipu

- Mäng, mis annab ette tühja kaardi ja sul tuleb sinna asetada poliitilised üksused

KDE kdeedu KGeography geograafia kaardid riigid

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