# Le manuel de &kgeography;

## Introduction

&kgeography; est un outil d'apprentissage de la géographie dans &kde;. Il vous permet d'apprendre les subdivisions politiques de certains pays (régions, capitales de ces régions et les drapeaux associés s'il y a lieu).

Les cartes disponibles dans la version actuelle sont : l'Afrique, l'Asie, l'Autriche, le Brésil, le Canada, la Chine, l'Europe, la France, l'Allemagne, l'Italie, l'Italie et ses provinces, L'Amérique du Nord et l'Amérique Centrale, la Norvège, la Pologne, l'Amérique du sud, l'Espagne, les USA et le monde.

## Démarrage rapide avec &kgeography;

Lorsque vous démarrez &kgeography; pour la première fois, il vous demande de choisir une carte. Voici une capture d'écran de &kgeography; au premier démarrage Voici une capture d'écran de &kgeography; au premier démarrage

Ici nous choisissons le Canada Le Canada est choisi Le Canada est choisi

Et la fenêtre principale de &kgeography; apparaît avec une carte du Canada : La fenêtre principale de &kgeography; La fenêtre principale de &kgeography;

Vous pouvez ensuite choisir quel type d'apprentissage ou de test vous voulez faire en regardant dans le menu sur la gauche. Le menu de &kgeography; Le menu de &kgeography;

Parcourir la carte : un clic avec le &BGS; sur une région de la carte va afficher les informations sur cette région : Parcourir la carte Parcourir la carte

Trouver une région sur la carte : on vous demande d'abord combien de questions vous voulez Nombre de questions Nombre de questions

Puis on vous demande de cliquer sur une province donnée : Cliquez sur une province Cliquez sur une province

Lorsque vous avez terminé toutes les questions, une boîte de dialogue avec les résultats s'affiche, montrant vos réponses correctes et fausses. Vos résultats Vos résultats

Trouver une région à partir de sa capitale : vous devez trouver le nom d'une province parmi quatre noms à partir du nom de sa capitale : Trouver une région à partir de sa capitale Trouver une région à partir de sa capitale

Et les résultats s'affichent lorsque le test est terminé : Vos résultats Vos résultats

Trouver la capitale d'une région : on vous donne le nom d'une capitale et quatre noms de régions et vous devez choisir le nom correct de la région. Comme précédemment, à la fin, une boîte de dialogue avec vos résultats s'affiche.

Trouver une région à partir de son drapeau : on vous montre un drapeau et vous devez trouver la région auquel il appartient. Le questionnaire sur les drapeaux Le questionnaire sur les drapeaux

Trouver le drapeau d'une région : un nom de région est donné et vous devez trouver le bon drapeau parmi quatre. faire correspondre le drapeau avec la région faire correspondre le drapeau avec la région

## Utiliser &kgeography;

&kgeography; affiche des informations sur certaines régions et teste vos connaissances sur ces informations. Voici une capture d'écran de &kgeography; Capture d'écran

### Plus de caractéristiques de &kgeography;

Une autre caractéristique de &kgeography; est la possibilité de zoomer sur une carte. Zoom Zoom Pendant que vous êtes en mode zoom, vous pouvez cliquer le &BGS; pour revenir à la taille d'origine de la carte (l'action Taille originale a le même effet). Utilisez les barres de déroulement pour parcourir la carte en mode zoom ou utilisez l'action Bouger qui vous permettra de faire glisser la carte en utilisant le &BGS;.

## Comment fabriquer des cartes

Une carte dans &kgeography; consiste en deux fichiers, l'un est l'image de la carte et l'autre en est sa description.

### Outil d'aide

Vous pouvez trouver ici un outil (fait par Yann Verley) qui l'a aidé à faire la carte de France. Pour comprendre son fonctionnement, lancez-le simplement et lisez le message d'aide. Cet outil crée le fichier `.kgm` depuis un fichier texte et crée un fichier avec les couleurs qu'il a données à chaque région, ainsi vous pouvez remplir la carte grâce à lui.

### Fichier de description

Ce fichier de description est indispensable et son extension est `.kgm`. Il doit commencer par `map` et se terminer par `map`.

À l'intérieur de ces balises doivent se trouver :

- `mapFile` et `mapFile` : le nom du fichier (sans aucun chemin) qui contient l'image de la carte, &pex; europe.png.

- `name` et `name` : le nom de la carte, &pex; Europe.

- Une balise `division` et `division` pour chaque région de la carte.

Chaque région contient ces balises :

- `name` et `name` : le nom de la région, &pex; Albanie.

- `capital` et `capital` : le nom de la capitale de la région, &pex; Tirana.

- `ignore` et `ignore` : peut être mise sur `yes`, `allowClickMode` et `no`. Si cette balise indique `yes` alors la région sera ignorée lors des questions sur les régions de la carte. Ce sera comme si la région n'existait pas dans le mode test de &kgeography;. Si cette balise indique `allowClickMode` alors &kgeography; va inclure cette région dans le mode Trouver une région sur la carte... mais pas dans les autres modes de test. Fixer cette balise à `no` indique que la région va apparaître dans tous les modes (navigation et tests). Cette balise est optionnelle et lorsqu'il n'y a pas de balise `ignore`, cela signifie qu'elle indique `no`. Par exemple l'Algérie a cette balise qui indique `yes` dans la carte d'Europe ce qui signifie que l' Algérie ne fera partie d'aucun test dans la carte de l'Europe.

- `flag` et `flag` : le fichier (sans le chemin) qui contient le drapeau de la région, &pex; albania.png. Cette balise est optionnelle. Elle n'est pas nécessaire pour les régions dont la balise `ignore` indique `yes`.

- `color` et `color` : la couleur que la région a sur la carte.

La couleur est définie en utilisant trois balises :

- `red` et `red` : la composante rouge de la couleur. Les valeurs valables sont comprises entre 0 et 255.

- `green` et `green` : la composante verte de la couleur. Les valeurs valables sont comprises entre 0 et 255.

- `blue` et `blue` : la composante bleue de la couleur. Les valeurs valables sont comprises entre 0 et 255.

Il est intéressant de créer deux ou trois subdivisions non nécessaires comme Eau, Frontière et Côte et de les accompagner de la balise `ignore` fixée sur `yes`.

Tous les noms (capitales et régions) doivent être en anglais.

### Le fichier de la carte

Le fichier de la carte est assez simple mais laborieux à créer. Il doit être en format PNG. Vous pouvez trouver des cartes à transformer à la référence des cartes de la Cia. Si aucune carte ne satisfait vos besoins, vous pouvez télécharger la carte politique du monde, en prendre une capture d'écran et travailler à partir de cela. Chaque région sur la carte doit avoir une et une seule couleur. Pour obtenir cela, vous pouvez utiliser un programme de retouche d'images comme Le Gimp et Kolourpaint.

### Les drapeaux

Si vous avez utilisé la balise `flag` vous devez fournir les fichiers pour les drapeaux. Ils doivent être en format PNG et ce serait mieux qu'ils soient 300x200 pixels et que vous fournissiez un fichier SVG avec. Pour obtenir des fichiers de drapeaux SVG pour presque tous les pays du monde et pour certaines régions, vous pouvez consulter la collection de drapeaux Sodipodi.

### Comment tester vos fichiers

Avant d'envoyer votre carte à Albert tsdgeos@terra.es, vous devriez la tester pour voir si elle n'a pas d'erreurs. Pour cela, vous devez suivre les étapes suivantes :

- copier le descriptif de la carte et le fichier image de la carte dans `$`KDEDIR`/share/apps/kgeography/`

- Copiez les fichiers PNG des drapeaux (si besoin est) dans `$`KDEDIR`/share/apps/kgeography/flags/`

Une fois que ceci est fait, vous devriez pouvoir ouvrir votre carte dans &kgeography;.

Si vous ne connaissez pas votre `$`KDEDIR``, saisissez ``kde-config` `--prefix`` dans un terminal.

### Cartes non politiques

Est-il possible de créer des cartes non politiques ? Oui, bien sûr ! Exemple de création d'une carte non politique Exemple de création d'une carte non politique

Bien sûr, le concept de subdivision peut s'étendre à une rivière ou une montagne. Durant la création d'une carte, vous devez garder à l'esprit que la plupart du temps la rivière ou la montagne seront trop petites donc vous devrez fournir une surface additionnelle pour le clic de la souris. Dans cet exemple la rivière aura la région de couleur marron et la couleur <20,76,34> comme identifiant.

## Référence des commandes

### La fenêtre principale de &kgeography;

#### Le menu Fichier

&Ctrl;O Fichier Ouvrir la carte...

- Ouvre la boîte de dialogue de choix d'une carte

&Ctrl;Q Fichier Quitte

- Quitte &kgeography;

#### Le menu Affichage

Affichage Zoom

- Entre dans le mode zoom

Affichage Taille originale

- Redimensionne la carte à sa taille originelle

Affichage Bouger

- Fait bouger la carte

#### Le menu Configuration

Configuration Afficher/Cacher la barre d'outils

- Affiche/Cache la barre d'outils de &kgeography;.

Configuration Configurer les raccourcis clavier...

- Configure les raccourcis clavier pour &kgeography;.

Configuration Configure les barres d'outils...

- Configure la barre d'outils de &kgeography;.

#### Le menu Aide

&help.menu.documentation;

## Remerciements et licence

&kgeography;

Programme copyright 2004-2005 Albert Astals Cid tsdgeos@terra.es

Documentation Copyright © 2005 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;

Traduction française par &AnneMarieMahfouf;

&underFDL; &underGPL;

## Installation

### Comment obtenir &kgeography;

&install.intro.documentation;

### Compilation et installation

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