Das Handbuch zu KGeography

# Das Handbuch zu KGeography

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

Kushal Das `<kushaldas@gmail.com>`

Übersetzung: Burkhard Lück
Version Anwendungen 20.12 (2020-12-22)

Copyright © 2005 Anne-Marie Mahfouf

Copyright © 2008 Kushal Das

Rechtlicher Hinweis

KGeography ist ein Erdkunde-Lernprogramm von KDE. Derzeit gibt es sieben verschiedenen Übungen:

- Landkarte erkunden, indem Sie in der Karte auf ein Land klicken und dessen Name, Hauptstadt und Flagge angezeigt wird

- Der Name eines Landes wird gefragt und Sie müssen es auf der Karte anklicken.

- Ein Land anhand des Namens der Hauptstadt raten

- Die Hauptstadt eines Landes raten

- Ein Land anhand der Flagge erraten

- Die Flagge eines Landes erraten

- Länder auf einer leeren Landkarte platzieren

Kapitel 1. Einleitung
Einleitung

# Kapitel 1. Einleitung

KGeography ist ein Erdkunde-Lernprogramm von KDE. Damit können Sie die politischen Daten einiger Länder lernen (Länder, ihre Hauptstädte und ihre Flaggen).

Kapitel 2. Kurze Einführung in KGeography
Kurze Einführung in KGeography

# Kapitel 2. Kurze Einführung in KGeography

Beim ersten Start von KGeography müssen Sie eine Karte auswählen.

### Tipp

Sie können das Textfeld Karten filtern benutzen, um für die Liste der Karten einen Filter einzugeben. Geben Sie einige Buchstaben der gesuchten Karte ein, dann wird die erste passende Karte ausgewählt.

Hier ist Kanada ausgewählt

Die Karte von Kanada wird im Hauptfenster von KGeography angezeigt:

Nun können Sie im Menü auf der linken Seite des Programmfensters mehrere Übungen auswählen:

Landkarte erkunden: Klicken Sie mit der linken Maustaste in ein Gebiet auf der Karte, dann werden Informationen darüber angezeigt. Klicken Sie auf das ; Info-Symbol, um de Wikipedia-Seite für dieses Gebiet im Standardbrowser ihres Systems zu öffnen.

Lage von Provinzen und Territorien: Zuerst müssen Sie die Anzahl der Fragen eingeben.

Dann wird der Name eines Landes angezeigt, Sie müssen das Land auf der Karte finden und darauf klicken.

Wenn Sie alle Fragen beantwortet haben, wird ein Dialog mit allen richtigen und falschen Antworten angezeigt.

Platzieren von Provinzen und Territorien auf der Karte: Der Mauszeiger nimmt den Umriss einer Provinz an und diese muss auf der Karte platziert werden:

Provinzen und Territorien nach deren Hauptstadt raten: Aus vier vorgegebenen Provinzen raten Sie das Land mit der abgefragten Hauptstadt:

Das Ergebnis wird am Ende angezeigt:

Hauptstadt einer Provinz oder eines Territoriums raten: Ordnen Sie die angegebene Hauptstadt einer der vier vorgegebenen Provinzen zu. Wie bei den vorherigen Übungen wird am Ende Ihr Ergebnis angezeigt.

Provinz oder Territorium anhand der Flagge erkennen: Eine Flagge wird angezeigt und Sie müssen die zugehörige Provinz erraten.

Flagge einer Provinz oder eines Territoriums erkennen: Zu einer vorgegebenen Provinz müssen Sie die zugehörige Flagge herausfinden.

Kapitel 3. Arbeiten mit KGeography
Arbeiten mit KGeography

# Kapitel 3. Arbeiten mit KGeography

KGeography zeigt Informationen über einige Länder an und überprüft Ihre Kenntnisse.

## Weitere Eigenschaften von KGeography

In KGeography können Sie die Anzeige eines Bereichs der Karte vergrößern.

Wählen Sie Größe und zeichnen auf der Karte ein Rechteck des Bereiches, der vergrößert werden soll. Im Vergrößerungsmodus können Sie mit Klicken der rechte Maustaste die Karte wieder in der Originalgröße anzeigen, genauso wie mit dem Menüeintrag Originalgröße. Benutzen Sie die Bildlaufleisten, das Mausrad oder die Pfeiltasten, um den Kartenausschnitt zu verschieben oder wählen Sie im Menü Verschieben, um den Ausschnitt mit der linken Maustaste zu verschieben. Die Funktion Automatische Größenveränderung zeigt die Karte so groß wie möglich an.

Kapitel 4. Karten erstellen
Karten erstellen

# Kapitel 4. Karten erstellen

Eine Karte in KGeography besteht aus zwei Dateien, dem Kartenbild und der zugehörigen Beschreibung.

## Hilfsmittel

Hier finden Sie ein Hilfsprogramm zur Erstellung von Karten, geschrieben von Yann Verley, um die Karte von Frankreich herzustellen. Starten Sie das Programm, um eine Hilfe zu Anwendung zu lesen. Das Programm erzeugt eine `.kgm`-Datei mit den zugewiesenen Farben für jedes Land aus einer Textdatei zur weiteren Bearbeitung. Dann können Sie in der Kartendatei die Länder mit den angegebenen Farben kolorieren.

Albert Astals Cid hat ein weiteres Hilfsprogramm colorchecker.py geschrieben. Dieses Programm läuft nur mit PyQt4. Starten Sie das Programm mit dem Namen der `.kgm`-Datei als Argument, die `.png`-Date der Karte muss sich im gleichen Ordner befinden. Das Skript überprüft, ob die Farben aller Pixel der Karte in der Beschreibungsdatei `.kgm` definiert sind.

### Tipp

Bitte lesen Sie ebenfalls die Anleitung Karten erstellen auf der KGeography-Webseite.

Beschreibungsdatei
Beschreibungsdatei

## Beschreibungsdatei

Die Beschreibungsdatei ist zwingend erforderlich und muss die Dateierweiterung `.kgm` haben. Diese Datei muss mit `<?xml version="1.0" encoding="utf-8">` und `<!DOCTYPE kgeographyMap>` beginnen, gefolgt von `<map>` und mit `</map>` enden.

Innerhalb dieser Marken sind folgende Einträge nötig:

- `<mapFile>` und `</mapFile>`: Der Name der Datei (ohne Pfad) mit dem Kartenbild, z. B. „`europe.png`“.

- `<name>` und `</name>`: der Name der Karte, z. B. „`Europa`“.

- `<divisionsName>` und `</divisionsName>`: der allgemeine Name von Einheiten auf der Karte, d. h. von Provinzen, Bundesstaaten, Ländern usw.

- Eine Marke `<division>` und `</division>` für jedes Land in der Karte.

Jedes Land muss diese Marken enthalten:

- `<name>` und `</name>`: Der Name des Landes, z. B. „`Albanien`“.

- `<capital>` ud `</capital>`: der Name der Hauptstadt des Landes, z. B. „`Tirana`“.

- `<ignore>` und `</ignore>`: Mögliche Werte sind `yes`, `allowClickMode`, `allowClickFlagMode` und `no`. Mit `yes` wird dieses Land bei der Abfrage nach Ländern übergangen, als wäre es nicht vorhanden. Mit `allowClickMode` fragt KGeography nach dem Land nur in der Übung Lage von ..., aber nicht in den anderen Übungen. Ist dieses Tag auf `allowClickFlagMode` gesetzt, wird auch bei den Flaggen-Übungen danach gefragt. Setzen Sie diese Marke auf den Wert `no`, um damit das Land in alle Übungen (Erkunden und Abfragen) aufgenommen wird. Diese Marke `<ignore>` darf fehlen, dann wird als Wert `no` angenommen. Für „`Algerien`“ zum Beispiel ist der Wert auf `yes` in der „`Europa`“karte gesetzt, damit ist „`Algerien`“ aus allen Fragen zur „`Europa`“karte ausgeschlossen.

- `<flag>` und `</flag>`: Die Datei (ohne Dateipfad) mit der Flagge des Landes, z. B. „`albania.png`“. Diese Marke darf auch fehlen. Sie ist für Länder mit dem Wert`yes` für die Marke `<ignore>` nicht erforderlich.

- `<color>` und `</color>`: Die Farbe der Länder in der Karte.

- `<falseCapital>` and `</falseCapital>`: Es ist eine beliebige Anzahl von `falseCapital`-Paaren erlaubt. Hierüber kann eine Liste falscher Antworten auf die Hauptstadt-Frage bereitgestellt werden, ohne dass hierzu aus den Hauptstädten anderer Länder gewählt werden muss.

Die Farbe wird durch drei Marken festgelegt:

- `<red>` und `</red>`: Rotanteil der Farbe mit gültigen Werten zwischen 0 und 255.

- `<green>` und `</green>`: Grünanteil der Farbe mit gültigen Werten zwischen 0 und 255.

- `<blue>` und `</blue>`: Blauanteil der Farbe mit gültigen Werten zwischen 0 und 255.

### Tipp

Es ist sinnvoll, zwei oder drei falsche „Länder“ wie „`Wasser`“, „`Grenze`“ und „`Küste`“ zu erstellen und ihnen mit der Marke `<ignore>` den Wert `yes` zu geben. `Setzen` Sie die Farbe für alle „`Grenzen`“ auf einen RGB-Wert von z. B. 1,1,1, nicht auf 0,0,0, damit beim der Darstellung Ränder gezeichnet werden.

### Wichtig

Schreiben Sie alle Namen von Städten und Ländern auf Englisch.

Kartendatei
Kartendatei

## Kartendatei

Die Kartendatei ist einfach aufgebaut, aber schwierig zu erstellen. Die Datei muss das PNG Format haben. Unter Cia-Referenz-Karten finden Sie einige Karten für die weitere Bearbeitung. Außerdem können Sie die Politische Weltkarte herunterladen, ein Bildschirmfoto aufnehmen und damit weiter arbeiten. Jedes Land auf der Karte sollte eine eindeutige Farbe haben. Verwenden Sie dazu Bildbearbeitungsprogramme wie Gimp oder KolourPaint.

Flaggen
Flaggen

## Flaggen

Wenn Sie die Marke `<flag>` benutzt haben, sollten Sie auch die erforderlichen Flaggendateien erstellen. Diese Dateien müssen in eine Größe von 300x200 Pixeln im SVG-Format haben, oder noch besser als SVG-Datei vorliegen. SVG-Dateien fast aller Länder der Erde und weiterer Provinzen sollten Sie in der Sodipodi Flaggensammlung suchen.

Test der Karten
Test der Karten

## Test der Karten

Bevor Sie Ihre Karte an Albert `(aacid AT kde.org)` schicken, sollten Sie sie auf Fehler überprüfen, Dazu sind folgende Schritte erforderlich:

- Kopieren Sie die Beschreibungsdatei und die Kartendatei in den Ordner `$`XDG_DATA_HOME`/share/apps/kgeography/`

- Kopieren Sie die vorhandene Flaggendateien (PNG-Dateien) in den Ordner `$`XDG_DATA_HOME`/share/apps/kgeography/flags/`

Danach können Sie Ihre Karte im Programm KGeography öffnen.

Wenn Sie `$`XDG_DATA_HOME`` Ihrer Installation nicht kennen, geben Sie den Befehl `qtpaths `--paths HomeLocation`` auf der Konsole ein.

### Tipp

Benutzen Sie das Programm colorchecker.py, um zu überprüfen, ob alle Farben in der Karte auch in der `.kmg`-Datei definiert sind.

Nicht politische Karten
Nicht politische Karten

## Nicht politische Karten

Ist es möglich nichtpolitische Karten zu erstellen? Natürlich!

Sebstverständlich kann das Länderkonzept um geografische Objekte wie Flüsse und Berge erweitert werden. Denken Sie bei der Bearbeitung der Karte daran, dass Flüsse und Berge in der Karte zu klein sind und daher einen zusätzlichen Fläche zum Anklicken brauchen. In diesem Beispiel hat der Fluss eine kastanienbraune Fläche und <20,76,34> als Farbe.

Kapitel 5. Befehlsreferenz
Befehlsreferenz

# Kapitel 5. Befehlsreferenz

## Das Hauptfenster von KGeography

### Das Menü Datei

Datei → Karte öffnen ... (Strg+O)

  Öffnet den Dialog zur Auswahl einer Karte. Geben Sie schnell die ersten Buchstaben der gesuchten Karte ein, dann wird die erste passende Karte ausgewählt.

Datei → Beenden (Strg+Q)

  Beendet KGeography.

### Das Menü Ansicht

Ansicht → Größe

  Wechselt in den Vergrößerungsmodus. Ziehen Sie mit der linken Maustaste ein Rechteck in der Karte, dann wird dieser Ausschnitt vergrößert.

Ansicht → Originalgröße

  Zeigt die Karte wieder in der ursprünglichen in der Kartendatei definierten Größe an. Mit einem rechten Maustaste in vergrößerter Anzeige kann dieselbe Aktion ausgeführt werden.

Ansicht → Automatische Größenveränderung

  Zeigt die Karte in der größtmöglichen Vergrößerung bei einer Änderung des KGeography-Fensters an.

Ansicht → Verschieben

  Verschiebt den Ausschnitt aus der aktuellen Karte. Dieser Eintrag ist nur verfügbar, wenn die Kartenansicht vergrößert wurde.

### Das Menü Einstellungen

KGeography benutzt die bekannten KDE-Einträge im Menü Einstellungen, weitere Informationen dazu finden Sie im Abschnitt über das Menü Einstellungen der KDE-Grundlagen.

### Das Menü Hilfe

KGeography hat zusätzlich zum bekannten KDE-Hilfemenü, das in den KDE-Grundlagenerläutert wird, zwei zusätzliche Einträge:

Hilfe → Haftungsausschluss

  Zeigt eine Erklärung über die Richtigkeit von Karten, Flaggen und Übersetzungen in KGeography

Hilfe → Kartenautor

  Zeigt den Namen des Autors an,der die geöffnete Karte erstellt hat.

Kapitel 6. Einrichtung
Einrichtung

# Kapitel 6. Einrichtung

Ausrichtung der Fragen

  Bestimmt die Position der Fragen im Fenster, die Voreinstellung ist Oben links.

Auf Überprüfung warten

  Ist dies aktiviert, müssen Sie den Knopf Akzeptieren nach der Auswahl einer Antwort drücken.

Aktivierung bei Mauskontakt

  Ist diese Einstellung aktiviert, kann mit der Leertaste der Knopf unter dem Mauszeiger gedrückt werden.

Farben der Verwaltungseinheiten in der Karte

  Wählen Sie aus, ob wie in der Voreinstellung immer dieselben oder zufällige Farben verwendet werden, dann erhalten die Verwaltungseinheiten in der Karte zufällige Farben. Das hilft Ihnen, die Umrisse der Verwaltungseinheiten und nicht deren Farben zu lernen.

Kapitel 7. Danksagungen und Lizenz
Danksagungen und Lizenz

# Kapitel 7. Danksagungen und Lizenz

KGeography

Programm Copyright 2004-2008 Albert Astals Cid `(aacid AT kde.org)`

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

Übersetzung Burkhard Lück`(lueck AT hube-lueck.de)`

Diese Dokumentation ist unter den Bedingungen der GNU Free Documentation License veröffentlicht.

Dieses Programm ist unter den Bedingungen der GNU General Public License veröffentlicht.