# Handboek van &kgeography;

## Inleiding

&kgeography; is een programma van &kde; voor het leren van Aardrijkskunde. 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;.

### 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 die 300x200 pixels (beeldpunten) groot zijn en u er een SVG-bestand bij levert. U kunt SVG-vlaggen van bijna alle landen in de wereld en sommige andere delen verkrijgen op de verzamelingg van vlaggen op Sodipodi.

### 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 `$`XDG_DATA_HOME`/share/apps/kgeography/`

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

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

U kunt uw `$`XDG_DATA_HOME`` te weten komen door in een tekstscherm de opdracht ``qtpath` `--path HomeLocation`` 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

&kgeography; heeft de voor &kde; gebruikelijke ingangen in het menu Instellingen. Meer informatie vindt u in de sectie Instelllingenmenu in de Basisinformatie van &kde;.

#### Het menu Help

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

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;
&documentation.index;