Handboek van KGeography

# Handboek van KGeography

Anne-Marie Mahfouf `<annma@kde.org>`

Kushal Das `<kushaldas@gmail.com>`

Vertaler/Nalezer: Jaap Woldringh
herziening Applicaties 20.12 (2020-12-22)

Copyright © 2005 Anne-Marie Mahfouf

Copyright © 2008 Kushal Das

Juridische kennisgeving

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

Hoofdstuk 1. Inleiding
Inleiding

# Hoofdstuk 1. 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).

Hoofdstuk 2. Snelgids voor KGeography
Snelgids voor KGeography

# Hoofdstuk 2. Snelgids voor KGeography

Bij de eerste keer dat KGeography wordt gestart word je gevraagd met welke kaart je wilt beginnen.

### Tip

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.

We kiezen hier Canada

En het hoofdvenster van KGeography met de kaart van Canada verschijnt:

In het menu links kun je nu kiezen wat voor oefening je wilt gaan doen:

Kaart onderzoeken: Klikken met de linkermuisknop 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:

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

Dan moet je op een bepaalde provincie klikken:

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

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

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:

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

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 vlag van een provincie of gebied: je krijgt een naam van een provincie waarna je uit vier vlaggen de juiste moet kiezen.

Hoofdstuk 3. Het werken met KGeography
Het werken met KGeography

# Hoofdstuk 3. Het werken met KGeography

KGeography toont informatie over enkele landen en test je kennis van deze landen.

## Nog meer eigenschappen van KGeography

Nog een eigenschap van KGeography is de mogelijkheid in een kaart te zoomen.

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

Hoofdstuk 4. Hoe kaarten te maken
Hoe kaarten te maken

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

### Tip

Lees ook de cursus Hoe kaarten toe te voegen op de webpagina van KGeography.

Bestand met beschrijving
Bestand met beschrijving

## 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, bijv. “`europe.png`”.

- `<naam>` en `</naam>`: de naam van de kaart, bijv. “`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, bijv. “`Albania`”.

- `<hoofdstad>` en `</hoofdstad>`: de naam van de hoofdstad van het kaartgedeelte, bijv. “`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 van“Europa” 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, bijv. “`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.

### Tip

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.

### Belangrijk

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

Het kaartbestand
Het kaartbestand

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

## 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_`, bijv. “`blurred_albania.png`”

Hoe te testen
Hoe te testen

## Hoe te testen

Voordat u uw kaart opstuurt naar Albert `(aacid AT kde.org)`, 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.

### Tip

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
Niet-politieke kaarten

## Niet-politieke kaarten

Is het mogelijk om niet-politieke kaarten te maken? Ja zeker!

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

Hoofdstuk 5. Overzicht van de opdrachten
Overzicht van de opdrachten

# Hoofdstuk 5. Overzicht van de opdrachten

## Het hoofdvenster van KGeography

### Het menu Bestand

Bestand → Kaart openen... (Ctrl+O)

  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.

Bestand → Afsluiten (Ctrl+Q)

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

Hoofdstuk 6. Configuratie
Configuratie

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

Hoofdstuk 7. Dankbetuigingen en Licentie
Dankbetuigingen en Licentie

# Hoofdstuk 7. Dankbetuigingen en Licentie

KGeography

Programma copyright 2004-2008 Albert Astals Cid `(aacid AT kde.org)`

Documentatie Copyright (c) 2005 Anne-Marie Mahfouf `(annma AT kde.org)` 2008 Kushal Das `(kushaldas AT gmail.com)`

Jaap Woldringh`(jjh punt woldringh op planet punt nl)`

Deze documentatie valt onder de bepalingen van de GNU vrije-documentatie-licentie.

Deze toepassing valt onder de bepalingen van de GNU General Public License.