# Handboek van &kgeography;

Anne-Marie Mahfouf &Anne-Marie.Mahfouf.mail;
Kushal Das kushaldas@gmail.com
&Jaap.Woldringh;
2005 &Anne-Marie.Mahfouf;
2008 Kushal Das
&FDLNotice;
2013-11-13
0.8.1 (&kde; 4.13)

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

U kunt de kaart filteren met het tekstveld Kaarten filteren. Als u de eerste letters invult van de naam van de kaart, wordt de keuze al snel beperkt tot slechts enkele er mee overeenkomende namen.

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;

Schermafdruk

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

Lees ook de cursus Hoe kaarten toe te voegen op de webpagina van &kgeography;, (http://userbase.kde.org/KGeography/Making_Maps).

### Bestand met beschrijving

Hiervoor is het bestand nodig met de beschrijving ervan, het heeft de extensie `.kgm`. Het moet beginnen met !DOCTYPE kgeographyMap, gevolgd door de tag map en worden afgesloten met de tag map. Een tag is een soort kenmerkende tekst.

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

- negeren en negeren: kunnen worden ingesteld op `ja`, `allowClickMode`, `allowClickFlagMode` en op `nee`. Indien ingesteld op `ja` wordt het kaartgedeelte genegeerd bij het vragen naar kaartgedeelten 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 `nee` betekent dat het kaartgedeelte in alle vragen kan worden gevraagd, (bladeren en quizzen). Deze instelling is optioneel, en als er geen instelling ignore is, betekent dit hetzelfde als de instelling `nee`. Bijvoorbeeld voor Algerije is de instelling `ja` 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 &Albert.Astals.Cid.mail;, 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 de dialoog waarin u een kaart kunt kiezen. Tijdens het typen van de eerste letters van de door u gezochte kaart, wordt de eerst kaart die hieraan voldoet getoond.

&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

  Stelt de kaartgrootte weer in op de oorspronkelijke waarde, zoals gedefinieerd in het kaartbestand, Dit zelfde wordt bereikt door te klikken met de &RMB; in zoom-modus.

Beeld Automatisch Zoom

  Instellen van automatisch inzoomen in de kaart, zodat de beschikbare ruimte zo goed mogelijk wordt gebruikt, zonder de grootte te veranderen van het venster van &kgeography;.

Beeld Verplaatsen

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

#### Het menu Instellingen

Het menu Instellingen van &kgeography; bevat de gebruikelijke onderdelen voor &kde;-applicaties. Voor meer informatie zie Instellingenmenu in de basisinformatie van &kde;.

#### Het menu Help

&kgeography; heeft een standaard Help-menu voor &kde;, zoals is beschreven in de Basisinformatie van &kde; , maar met nog twee extra onderdelen::

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.

## Configuratie

Uitlijnen van vragen

  Bepaalt de positie van de vragen in het venster, standaard is Links boven.

Wachten op bevestigen

  Indien aan, moet de gebruiker klikken op de knop Accepteren na het kiezen van een antwoord.

Focus volgt muis

  Indien aan, wordt de knop onder de muisaanwijzer geactiveerd door op de spatiebalk te klikken.

Kleuren van de kaartdelen

  U kunt kiezen of u altijd dezelfde kleuren wilt behouden (standaard), of dat u de kleuren willekeurig wilt kiezen: met deze optie aan, worden de diverse kaartdelen willekeurig gekleurd. Hierdoor moet de gebruiker zich er toe zetten om de vormen van de kaartdelen te leren, in plaats van de kleuren.

## Dankbetuigingen en Licentie

&kgeography;

Programma copyright 2004-2008 Albert Astals Cid &Albert.Astals.Cid.mail;

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 installeren

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