# Handboek van &kgeography;

Anne-Marie
Mahfouf
&Anne-Marie.Mahfouf.mail;
Kushal
Das
kushaldas@gmail.com
Jaap
Woldringh

    jjh puntwoldringh op planet punt nl

Nederlandse vertaling
2005
&Anne-Marie.Mahfouf;
2008
Kushal Das
&FDLNotice;
2009-01-25
0.5.9-10

&kgeography; is een leerprogramma van &kde; voor Aardrijkskunde. Op dit ogenblik kan het op zeven manieren worden gebruikt:

- Het bekijken van kaarten door op kaartgedeelten te klikken waarna je de naam ervan ziet, de hoofdstad en de vlag

- Een spel waarin de naam van een kaartgedeelte wordt genoemd waarna je erop moet klikken

- Een spel waarin een hoofdstad wordt genoemd waarna je moet antwoorden bij welk kaartgedeelte die hoort

- Een spel waarin een kaartgedeelte wordt genoemd en je moet antwoorden wat daarvan de hoofdstad is

- Een spel waarin de vlag wordt getoond van een kaartgedeelte en je moet antwoorden met de naam van dat kaartgedeelte

- Een spel waarin de naam wordt genoemd van een kaartgedeelte en je moet opgeven welke vlag erbij hoort

- In dit spel wordt een lege kaart getoond, waarin je de kaartgedeelten een voor een moet plaatsen

KDE
kdeedu
KGeography
aardrijkskunde
kaarten
landen

## Inleiding

&kgeography; is een programma in &kde; om Aardrijkskunde te leren. Hiermee kun je iets leren over de politieke indeling van sommige landen (onderdelen ervan, de bijbehorende hoofdsteden en eventuele vlaggen).

## Snelgids voor &kgeography;

Bij de eerste keer dat &kgeography; wordt gestart word je gevraagd met welke kaart je wilt beginnen. Dit is een schermbeeld van &kgeography; na de eerste keer dat het wordt gestart Dit is een schermbeeld van &kgeography; na de eerste keer dat het wordt gestart

We kiezen hier Canada Canada is gekozen Canada is gekozen

En het hoofdvenster van &kgeography; met de kaart van Canada verschijnt: hoofdvenster van &kgeography; hoofdvenster van &kgeography;

In het menu links kun je nu kiezen wat voor oefening je wilt gaan doen: menu van &kgeography; menu van &kgeography;

Kaart onderzoeken: Klikken met de &LMB; op een gebied in de kaart geeft informatie over dat gebied. Klikken op het kleine pictogram in het informatiekaartje opent een wikipedia-pagina over dat kaartdeel in de standaard browser van het systeem: Ontdekkingsreis in de kaart Ontdekkingsreis in de kaart

Plaats van provincies of gebieden: eerst krijg je de vraag hoeveel vragen je wilt beantwoorden Hoeveel vragen Hoeveel vragen

Dan moet je op een bepaalde provincie klikken: Klik op een provincie Klik op een provincie

Als je klaar bent met alle vragen zie je als resultaat een dialoogscherm met daarin je goede en foute antwoorden: Je score Je score

Plaats provincies of gebieden in de kaart: de muisaanwijzer krijgt de vorm van de provincie, die je in de kaart moet plaatsen: Plaats een kaartgedeelte in de kaart Plaats een kaartgedeelte in de kaart

Provincies of gebieden als je de naam weet van de hoofdstad: je kunt de naam van een provincie kiezen uit vier gegeven namen, als de hoofdstad is gegeven: Geef de naam van het kaartgedeelte als je de hoofdstad weet Geef de naam van het kaartgedeelte als je de hoofdstad weet

En de resultaten kun je zien als de test klaar is: Je score Je score

Hoofdsteden van provincies of gebieden: je krijgt een hoofdstad en vier namen van provincies waarvan je de goede moet kiezen. Net zoals hiervoor zie je als je klaar bent een dialoogscherm met de resultaten.

Provincies of gebieden als de vlag is gegeven: je ziet een vlag waarna je moet antwoorden bij welke provincie die vlag hoort. de vraag met de vlag de vraag met de vlag

De vlag van een provincie of gebied: je krijgt een naam van een provincie waarna je uit vier vlaggen de juiste moet kiezen. kies de vlag bij de provincie kies de vlag bij de provincie

## Het werken met &kgeography;

&kgeography; toont informatie over enkele landen en test je kennis van deze landen. Hier zie je een schermbeeld van &kgeography; Schermbeeld

### Nog meer eigenschappen van &kgeography;

Nog een eigenschap van &kgeography; is de mogelijkheid in een kaart te zoomen. Zoom Zoom . Je kunt op de knop Zoom drukken, en dan een rechthoek in de kaart maken met de muis, om op een bepaald gedeelte van de kaart in te zoomen. In de zoom-modus kun je door op de rechter muisknop te drukken terugkeren naar de gewone kaartgrootte (de actie Originele grootte heeft hetzelfde effect). Met behulp van de schuifbalken kun je in de gezoomde kaart verplaatsen, of gebruik de actie Verplaatsen waarmee je de kaart kunt slepen met behulp van de linker muisknop. Met Automatisch Zoom kun je de kaart zo groot mogelijk maken.

## Hoe kaarten te maken

Een kaart in &kgeography; wordt opgebouwd met behulp van twee bestanden, een bevat de kaartafbeelding en het andere de beschrijving.

### Hulpgereedschap

U kunt hier een hulpprogramma vinden (gemaakt door Yann Verley, waarmee hij de kaart van Frankrijk heeft gemaakt). Om te leren hoe het moet worden gebruikt moet u het gewoon uitvoeren en de hulptekst lezen. In principe maakt het van een gewoon tekstbestand een `.kgm`-bestand en maakt het een bestand aan met daarin de kleuren die het aan elk kaartgedeelte heeft toegekend, en waarmee dus de kaart kan worden ingevuld.

Er is nog een hulpmiddel, colorchecker.py, geschreven door Albert Astals Cid. Hiervoor is PyQt4 nodig. Draai het met de naam van het kgm-bestand als argument (in dezelfde map moet ook het .png-bestand van de kaart aanwezig zijn). Hierdoor komt u te weten of er in de kaart pixels voorkomen met een afwijkende kleur die niet is gedefinieerd in de beschrijving in het .kgm-bestand.

### Bestand met beschrijving

Hiervoor is het bestand nodig met de beschrijving ervan, het heeft de extensie `.kgm`.Het bestand moet moet beginnen met `map` en eindigen met `map`.

Binnen deze zogenaamde "tags" moet aanwezig zijn:

- `mapFile` en `mapFile`: de naam van het bestand (zonder pad) dat de kaartafbeelding bevat, zoals bijvoorbeeld europe.png.

- `name` en `name`: de naam van de kaart, zoals bijvoorbeeld Europe (namen moeten in het Engels zijn).

- `divisionsName` en `divisionsName`: de algemene naam van kaartgedeelten in deze kaart, dus provincies, staten, landen, enz.

- Een `division` en `division` voor elk kaartgedeelte.

Elk kaartgedeelte heeft deze "tags":

- `name` en `name`: de naam van het kaartgedeelte, zoals bijvoorbeeld Albania (namen moeten in het Engels zijn).

- `capital` en `capital`: de naam van de hoofdstad van het kaartgedeelte, zoal bijvoorbeeld Tirana (let op: namen in het Engels).

- `ignore` en `ignore`: kunnen worden ingesteld op `yes`, `allowClickMode`, `allowClickFlagMode` en op `no`. Indien ingesteld op `yes` wordt het kaartgedeelte genegeerd bij het vragen naarkaartgedeelten in deze kaart. Het is dan alsof dit kaartgedeelte niet bestaat voor &kgeography;. Indien ingesteld op `allowClickMode` vraagt &kgeography; naar dit kaartgedeelte in de modus Locatie van ...maar niet bij andere vragen. Indien ingesteld op `allowClickFlagMode` vraagt &kgeography; naar dit kaartgedeelte in de modus Locatie van ... en in de vragen met vlaggen, maar niet in andere vragen. Instellen op `no` betekent dat het kaartgedeelte in alle vragen kan worden gevraagd, (bladeren en quizzen). Deze instelling is optioneel, en als er geeninstelling `ignore` is, betekent dit hetzelfde als deinstelling `no`. Bijvoorbeeld voor Algerije is de instelling `yes` in de kaart van Europa, wat betekent dat Algerije in geen enkele vraag over de kaart vanEuropa wordt gevraagd.

- `flag` en `flag`: het bestand (zonder pad) met de vlag van het kaartgedeelte, bijvoorbeeld albania.png. Deze "tag" is optioneel. Niet nodig voor die kaartgedeelten waarvan de "tag" `ignore` op `yes` is ingesteld.

- `color` en `color`: de kleur van het kaartgedeelte.

- `falseCapital` en `falseCapital`: Er kan elk gewenst aantal paren zijn van foutieve hoofdsteden, die worden gebruikt in een lijst van foutieve antwoorden op de vraag naar de hoofdstad, in plaats van het kiezen van de foute antwoorden uit die van de hoofdsteden van andere kaartgedeelten.

De kleur wordt met behulp van drie "tags" gegeven:

- `red` en `red`: rode kleurcomponent. Geldige waarden zijn tussen 0 en 255.

- `green` en `green`: groene kleurcomponent. Geldige waarden zijn tussen 0 en 255.

- `blue` en `blue`: blauwe kleurcomponent. Geldige waarden zijn tussen 0 en 255.

Het is gemak dient de mens: maak als dat zo uitkomt 2 of 3 oneigenlijke kaartgedeelten aan, zoals voor Water, Grens en Kust en stel daarna de "tag" `ignore` op `yes`. Vergeet hierbij niet de Grenskleur op een andere waarde dan 0,0,0 in RGB (wit) in te stellen. Maak het zoiets als 1,1,1 zodat er een grens zichtbaar wordt wanneer een kaartgedeelte in de kaart wordt geplaatst.

Alle namen (hoofdsteden en kaartgedeelten) moeten in het Engels zijn.

### Het kaartbestand

Het is vrij eenvoudig om dit kaartbestand te maken, maar het vereist wel veel werk. Het moet een PNG -bestand zijn. U kunt enige kaarten vinden op Cia Reference Maps die u kunt aanpassen. Als er geen kaarten bij zijn die u kunt gebruiken kunt u depolitical world map ophalen van het internet, een schermbeeld ervan maken en van daaruit werken. Ieder kaartgedeelte moet een en slechts een kleur hebben. Om dit voor elkaar te krijgen kunt u gebruik maken van beeldbewerkingsprogramma's zoals The Gimp en Kolourpaint.

### Vlaggen

Indien u de "tag" `flag` gebruikt moet u de bestanden met de vlaggen ter beschikking stellen. Die moeten PNG-bestanden zijn en het is beter als zij 300x200 pixels (beeldpunten) bevatten en u er een SVG-bestand bij levert. U kunt SVG-vlaggen van bijna alle landen in de wereld en sommige andere kaartgedeelten verkrijgen op de Sodipodi vlaggenverzameling.

### Hoe te testen

Voordat u uw kaart opstuurt naar Albert tsdgeos@terra.es moet u die testen op fouten. U kunt dit als volgt doen:

- Plaats de beschrijving en het beeldbestand van de kaart in de map `$`KDEDIR`/share/apps/kgeography/`

- Plaats de PNG-bestanden voor de vlaggen (als die er zijn) in `$`KDEDIR`/share/apps/kgeography/flags/`

. Hierna moet u de kaart kunnen openen vanuit &kgeography;.

U kunt uw `$`KDEDIR`` te weten komen door in een tekstscherm de opdracht ``kde4-config` `--prefix`` in te typen.

Met het hulpmiddel colorchecker.py kunt u controleren of er nog kleuren in de kaart aanwezig zijn, die niet in het .kgm-bestand zijn gedefinieerd.

### Niet-politieke kaarten

Is het mogelijk om niet-politieke kaarten te maken? Ja zeker! Voorbeeld van het maken van een niet-politieke kaart Voorbeeld van het maken van een niet-politieke kaart

Natuurlijk, het idee van kaartgedeelten kan worden uitgebreid tot een rivier of een berg. Tijdens het maken van de kaart zult u eraan moeten denken dat de rivier of berg meestal zo klein is dat u in een extra klikbare oppervlakte moet voorzien. In dit voorbeeld krijgt de rivier een kastanjebruine oppervlakte met de naam in de kleur <20,76,34>.

## Overzicht van de opdrachten

### Het hoofdvenster van &kgeography;

#### Het menu Bestand

&Ctrl;O Bestand Kaart openen...

  Openen van het dialoogvenster voor het kiezen van een kaart

&Ctrl;Q Bestand Afsluiten

  &kgeography; Afsluiten

#### Het menu Beeld

Beeld Zoom

  Gaat in zoom-modus, daarna een rechthoek tekenen in de kaart waarop wordt ingezoomd

Beeld Originele grootte

  Instellen van de originele grootte van de kaart

Beeld Automatisch Zoom

  Instellen van de grootst mogelijke kaartgrootte met automatisch zoom

Beeld Verplaatsen

  Verplaatst de huidige kaart. Dit is alleen actief na inzoomen in de kaart.

#### Het menu Instellingen

Instellingen Werkbalk tonen

  Tonen/verbergen van de werkbalk van &kgeography;.

Instellingen Sneltoetsen...

  Instellen van sneltoetsen in &kgeography;.

Instellingen Werkbalk instellen...

  Instellen van de werkbalk in &kgeography;.

#### Het menu Help

&kgeography; heeft een standaard Help-menu van &kde;, zoals hieronder beschreven, met twee toevoegingen:

Beeld Afwijzing van verantwoordelijkheid

  Toont een tekst, waarin de verantwoordelijkheid voor de nauwkeurigheid van de kaarten, vlaggen en vertalingen in &kgeography;.wordt afgewezen.

Help Auteur kaart

  Toont de naam van de auteur van de huidige kaart.

In het Help-menu van &kde; komt standaard voor:

&help.menu.documentation;

## Dankbetuigingen en Licentie

&kgeography;

Programma copyright 2004-2008 Albert Astals Cid tsdgeos@terra.es

Documentatie Copyright © 2005 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; 2008 Kushal Das kushaldas@gmail.com

Jaap Woldringhjjh punt woldringh op planet punt nl

&underFDL; &underGPL;

## Installatie

### Het verkrijgen van &kgeography;

&install.intro.documentation;

### Compileren en Installatie

&install.compile.documentation;

&documentation.index;