# 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;
2020-12-22
Applicaties 20.12

&kgeography; is een leerprogramma van &kde; voor Aardrijkskunde. 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 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 Info opent de wikipedia-pagina voor dit gedeelte in de standaard browser: Ontdekkingsreis in de kaart

Ontdekkingsreis in de kaart

Locatie 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

Je vindt hier een hulpprogramma (gemaakt door Yann Verley, waarmee hij de kaart van Frankrijk heeft gemaakt). Om te weten hoe je het moet gebruiken moet je 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 voor elk kaartgedeelte, en waarmee dus de kaart kunt kleuren.

Nog een hulpmiddel is colorchecker.py (kleuren kiezen), gemaakt door Albert Astals Cid. Hiervoor is PyQt4 nodig. Gebruik het maar met bestandsnaam `.kgm` als argument (het bestand met de extensie `.png` voor de kaart moet in dezelfde map aanwezig zijn). Hiermee kun je zien of er pixels zijn in de kaart met een onbekende kleur.

Lees ook de cursus Hoe kaarten toe te voegen op de webpagina van &kgeography;.

### Bestand met beschrijving

Het bestand met de beschrijving is nodig, met de extensie `.kgm`. Het moet beginnen met ?xml version="1.0" encoding="utf-8", daarna !DOCTYPE kgeographyMap, gevolgd door map en eindigen met map.

Binnen deze zogenaamde "tags" moet aanwezig zijn:

- mapFile en mapFile: de naam van het bestand (zonder pad er naar toe) dat de afbeelding bevat van de kaart, ⪚ `europe.png`.

- naam en naam: de naam van de kaart, ⪚ `Europa`.

- divisionsName en divisionsName: de algemene naam van kaartgedeelten in deze kaart, dus Provincies, Staten, Landen, &etc;

- Een division en division voor elk kaartgedeelte.

Elk kaartgedeelte heeft deze "tags":

- name en name: de naam van het kaartgedeelte, ⪚ `Albania`.

- hoofdstad en hoofdstad: de naam van de hoofdstad van het kaartgedeelte, ⪚ `Tirana`.

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

- vlag en vlag: 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" negeren op `ja` is ingesteld.

- blurredflag en blurredflag: het bestand (zonder enig pad) die de vervaagde vlag van de opdeling bevat, ⪚ `blurred_albania.png`. Deze tag is optioneel. Het zou gebruikt moeten worden in situaties waar de vlag de naam heeft van de opdeling heeft waarop het behoort te worden geschreven. Dit kan het spel de vlag raden te gemakkelijk maken en daarom wordt het indienen van de vlaggen met de vervaagde tekst aangemoedigd.

- kleur en kleur: de kleur van het kaartgedeelte.

- foutHoofdstad en foutHoofdstad: 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 gemakkelijk 2 of 3 lege kaartgedeelten te maken zoals `Water`, `Grens` en `Kust` en daarna de "tag" negeren op `ja` in te stellen. Vergeet niet `geen` kleur 0,0,0 in RGB in te stellen voor enige `Grens`. Maak het maar zoiets als 1,1,1 zodat in de kaart een grenslijn verschijnt zodra er 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

Als u de "tag" vlag gebruikt moet u de vlagbestanden aanleveren. Met de extensie PNG. Nog beter is het als zij 300x200 pixels groot zijn en u hiervoor een &SVG;-bestand levert. Voor bijna alle &SVG;-vlaggen kunt u terecht op de Sodipodi vlaggenverzameling.

Zoals eerder opgemerkt moedigen we u aan om vervaagde vlagbestanden voor vlaggen te leveren die de opdeling erop heeft geschreven. Dezelfde vereisten zijn van toepassing op de vervaagde vlagbestanden als op de reguliere vlagbestanden. Terwijl er geen voorgeschreven naamnotatie voor de vervaagde bestanden zijn, bevelen we aan deze op te slaan met de naam van de originele vlag met voorloop `blurred_`, ⪚ `blurred_albania.png`

### 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` 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 wordt een rechthoek in de kaart getekend waarin wordt ingezoomd

Beeld Originele grootte

  Weer Instellen van de kaartgrootte 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 zoomen in de kaart, zodat de beschikbare ruimte zo goed mogelijk wordt gebruikt, bij wijzigen van het 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 aangezet, triggert het drukken op &Space; de knop onder de muisaanwijzer.

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;