# Manuel de &kgeography;

Anne-Marie Mahfouf &Anne-Marie.Mahfouf.mail;
Kushal Das kushaldas@gmail.com
&traducteurPierreBuard;
2005 &Anne-Marie.Mahfouf;
2008 Kushal Das
&FDLNotice;
13/11/2013
0.8.1 (&kde; 4.13)

&kgeography; est un outil d'apprentissage de la géographie pour &kde;. Il est utilisable de sept manières différentes :

- parcourir les cartes en cliquant sur une division pour voir son nom, sa capitale et son drapeau,

- le jeu vous donne le nom d'une division et vous devez cliquer dessus,

- le jeu vous donne une capitale et vous devez deviner la division à laquelle elle appartient,

- le jeu vous donne une division et vous devez deviner sa capitale,

- le jeu vous montre le drapeau d'une division dont vous devez deviner le nom,

- le jeu vous donne le nom d'une division à laquelle vous devez associer un drapeau,

- le jeu affiche une carte vide sur laquelle vous devez placer les divisions une à une.

KDE kdeedu KGeography géographie cartes pays

## Introduction

&kgeography; est un outil d'apprentissage de la géographie pour &kde;. Il vous permet d'en apprendre plus sur les divisions politiques de quelques pays (&cad; leurs divisions, capitales de ces divisions et drapeaux associés, le cas échéant).

## Premiers pas dans &kgeography;

Lorsque vous exécutez &kgeography; pour la première fois, il vous demandera d'abord de choisir une carte avec laquelle commencer.

Il est possible de filtrer la liste des cartes à l'aide de la zone de texte Filtre de cartes. Saisissez les premières lettres du nom de la carte afin de réduire la liste à quelques entrées.

Voici une copie d'écran de &kgeography; au premier lancement
Voici une copie d'écran de &kgeography; au premier lancement

Nous choisissons ici le Canada Canada est sélectionné

Canada est sélectionné

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

Fenêtre principale de &kgeography;

Vous pouvez alors choisir quel genre d'apprentissage ou d'évaluation vous souhaitez grâce au menu situé à gauche : Menu de &kgeography;

Menu de &kgeography;

Parcourir la carte : un clic avec le &BGS; sur une zone de la carte affichera les informations correspondantes, si vous cliquez sur la petite icône d'information, cela ouvrira dans votre navigateur la page Wikipédia correspondant à la division : Parcourir la carte

Parcourir la carte

Emplacement des provinces et territoires : il vous est d'abord demandé combien de questions vous souhaitez Nombre de questions

Nombre de questions

Ensuite, il vous sera demandé de cliquer sur la division donnée : Cliquez sur une division

Cliquez sur une division

Lorsque vous avez répondu à toutes les questions, le résultat s'affichera avec le nombre de réponses correctes et incorrectes : Vos réponses

Vos réponses

Placez les provinces et territoires sur la carte : le curseur prend la forme d'une division que vous devez placer sur la carte : Placez une division sur la carte

Placez une division sur la carte

Les provinces et territoires par capitales : il vous est demandé d'associer une capitale à l'une des quatre divisions données : Associez une capitale à sa division

Associez une capitale à sa division

Les résultats s'affichent une fois le test fini : Vos réponses

Vos réponses

Capitales des provinces et territoires : pour une division donnée, retrouvez sa capitale parmi quatre propositions. Comme précédemment, les résultats seront affichés à la fin.

Les provinces et territoires par drapeaux : un drapeau est affiché et vous devez trouver à quelle province il appartient. Une question de drapeau

Une question de drapeau

Drapeaux des provinces et territoires : à partir du nom d'une province, vous devez trouver le bon drapeau parmi les quatre proposés. Associez le drapeau à la province

Associez le drapeau à la province

## Utiliser &kgeography;

&kgeography; affiche des informations sur les pays et vous teste sur celles-ci. Voici une copie d'écran de &kgeography;

Copie d'écran

### Fonctionnalités additionnelles de &kgeography;

Une autre fonctionnalité de &kgeography; consiste à pouvoir zoomer sur la carte. Zoom

Zoom
Vous pouvez cliquer sur le bouton Zoom et dessiner un rectangle afin de zoomer sur une partie de la carte. En mode zoom, vous pouvez cliquer avec le &BDS; pour rétablir la taille d'origine de la carte (l'action Taille originale produit le même effet). Utilisez les barres de défilement, les touches de direction ou la molette de la souris pour vous déplacer sur la carte zoomée ou utilisez l'action Déplacer qui permettra de faire glisser la carte en utilisant le &BGS;. La fonctionnalité Zoom automatique agrandira la carte autant que possible.

## Comme créer des cartes

Une carte dans &kgeography; est composée de deux fichiers : le premier est une image de la carte et l'autre contient sa description.

### Outils d'aide

Vous trouverez ici un outil, créé par Yann Verley, l'ayant aidé pour la carte de France. Pour comprendre son utilisation, exécutez-le et lisez le message d'aide. Pour simplifier, il crée un fichier `.kgm` à partir d'un fichier texte en plus d'un second contenant les couleurs qu'il a assignées à chaque division, afin que vous puissiez remplir la carte avec elles.

Il existe aussi l'outil colorchecker.py écrit par Albert Astals Cid. Vous aurez besoin de PyQt4 pour l'exécuter. Lancez-le avec le nom du fichier .kgm comme argument (vous aurez aussi besoin du fichier .png de la carte dans le même dossier). Ceci vous dira si un pixel sur la carte a une couleur qui n'est pas définie dans le fichier de description .kgm.

Veuillez également vous référer au tutoriel Comment ajouter des cartes présent sur le site web de &kgeography;.

### Le fichier de description

Le fichier de description est nécessaire et son extension est `.kgm`. Il doit commencer par !DOCTYPE kgeographyMap, suivi de map et se terminer par map.

Entre ces balises, il doit y avoir :

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

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

- divisionsName et divisionsName : le nom générique des divisions de cette carte, &cad; provinces, états, pays, etc.

- Une entrée division et division pour chaque division de la carte.

Chaque division a ces balises :

- name et name : le nom de la division, &pex; Albanie.

- capital et capital : le nom de la capitale de la division, &pex; Tirina.

- ignore et ignore : accepte comme paramètres `yes`, `allowClickMode`, `allowClickFlagMode` et `no`. Si cette balise est paramétrée avec `yes`, alors la division sera ignorée lorsque des questions sur les divisions de la carte ; cette division disparaîtra des tests de &kgeography;. Si cette balise est paramétrée avec `allowClickMode`, alors &kgeography; prendra en compte cette division en mode Emplacement de... mais pas lors des autres tests. Si cette balise est paramétrée avec `allowClickFlagMode`, alors &kgeography; demandera cette division en mode Emplacement de... et pour les tests avec les drapeaux mais pas dans les autres modes. Paramétrer cette balise avec `no` signifie que la division apparaîtra dans tous les modes (parcourir et tests). Cette balise est optionnelle et lorsque ignore est absent, cela revient au même que de la paramétrée avec `no`. Par exemple Algérie a sa balise paramétrée avec `yes` sur la carte Europe ce qui signifie que Algérie ne sera présente dans aucun des tests de la carte Europe.

- flag et flag : le fichier (sans aucun emplacement) contenant le drapeau de la division, &pex; albanie.png. Cette balise est optionnelle. Elle n'est pas nécessaire pour les divisions ayant une balise ignore avec le paramètre `yes`.

- color et color : la couleur de la division sur la carte.

- falseCapital et falseCapital : il peut y avoir n'importe quel nombre de paires de falseCapital (fausse capitale), elles servent à fournir une liste de mauvaises réponses à la question de la capitale au lieu de les choisir parmi d'autres divisions.

La couleur est définie en utilisant ces trois balises :

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

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

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

Il est pratique de créer 2 ou 3 fausses divisions comme Water (Eau), Frontier (Frontière) et Coast (Côte) ayant la balise ignore paramétrée avec `yes`. N'oubliez pas de définir une couleur pour les Frontier (Frontière) différente de 0,0,0 en RGB. Veuillez la définir en quelque chose comme 1,1,1 afin que la bordure apparaisse lors du placement des divisions sur la carte.

Tous les noms (capitales et divisions) doivent être en anglais.

### Le fichier carte

Le fichier carte est assez simple mais laborieux à créer. Il doit être au format PNG. Vous pourrez trouver des cartes à transformer sur C.I.A. Reference Maps. Si aucune carte ne correspond à vos besoins, vous pouvez télécharger la carte politique du monde, réaliser une copie d'écran et travailler à partir de celle-ci. Chaque division sur la carte devra avoir une, et seulement une, couleur. Pour accomplir cela, vous pouvez utiliser des éditeurs d'images comme The GIMP ou KolourPaint.

### Drapeaux

Si vous employé la balise flag, vous devrez fournir des fichiers de drapeaux. Ils devront être au format PNG et, encore mieux, faire 300x200 pixels avec un fichier SVG en plus. Pour obtenir des drapeaux en SVG de la quasi-totalité des pays du monde et de quelques divisions, vous pouvez consulter la collection de drapeaux Sodipodi.

### Comment tester

Avant d'envoyer votre carte à Albert &Albert.Astals.Cid.mail;, vous devriez la tester pour être sûr qu'elle ne contient pas d'erreurs. Pour accomplir cela, vous effectuerez les tâches suivantes :

- Placer la description de la carte ainsi que son image dans `$`KDEDIR`/share/apps/kgeography/`

- Placer les fichiers drapeaux PNG (le cas échéant) dans `$`KDEDIR`/share/apps/kgeography/flags/`

Une fois ceci fait, vous devriez être capable d'ouvrir la carte à partir de &kgeography;.

Si vous ne savez pas quelle est votre `$`KDEDIR``, saisissez ``kde4-config` `--prefix`` dans un terminal.

Utilisez l'outil d'aide « colorchecker.py » pour vérifier s'il reste des couleurs sur la carte qui ne sont pas définies dans le fichier .kgm.

### Cartes non politiques

Est-il possible de créer des cartes non politiques ? Oui, c'est possible ! Exemple montrant comment réaliser une carte non politique

Exemple montrant comment réaliser une carte non politique

Bien sûr, le concept de division peut être étendu aux rivières ou montagnes. Durant la création de la carte, vous devez avoir à l'esprit que, la plupart du temps, la rivière ou la montagne sera trop petite pour avoir sa propre zone de sélection. Dans cet exemple, la rivière aurait eu la zone marron et la couleur <20,76,34> comme identifiant.

## Références des commandes

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

#### Le menu Fichier

&Ctrl;O Fichier Ouvrir une carte...

  Ouvre la boîte de dialogue de sélection de carte. En saisissant rapidement les premières lettres de la carte recherchée, le curseur se positionnera sur la carte correspondante.

&Ctrl;Q Fichier Quitter

  Quitte &kgeography;

#### Le menu Affichage

Affichage Zoom

  Active le mode zoom permettant de dessiner un rectangle pour zoomer sur une zone de la carte.

Affichage Taille originale

  Réinitialise la carte à sa taille originale telle que définit par son fichier. Un clic du &BDS; en mode zoom effectue la même action.

Affichage Zoom automatique

  (Dés)Active le zoom automatique de la carte en utilisant le plus d'espace possible lors du redimensionnement de la fenêtre de &kgeography;.

Affichage Déplacer

  Déplacer la carte actuelle. Cet élément n'est activé que si vous avez zoomé sur la carte.

#### Le menu Configuration

&kgeography; propose les entrées habituelles du menu Configuration de &kde;, reportez-vous à la section concernant le menu Configuration des Fondamentaux de &kde; pour plus d'informations.

#### Le menu Aide

&kgeography; fournit le menu Aide standard de &kde;, tel que décrit dans les Fondamentaux de &kde;, avec deux entrées supplémentaires :

Aide Dégagement de responsabilité

  Affiche une clause de non-responsabilité concernant la précision des cartes, drapeaux et traductions utilisés par &kgeography;.

Aide Auteur de la carte

  Affiche le nom de l'auteur de la carte ouverte.

## Configuration

Alignement des questions

  Détermine la position des questions dans la fenêtre, En haut à gauche par défaut.

Attendre la validation

  En cochant cette option, l'utilisateur devra cliquer sur Valider après avoir choisi une réponse.

Le focus suit le curseur

  En cochant cette option, une pression de la touche espace activera le bouton sous le pointeur de la souris.

Couleurs des divisions de la carte

  Choisissez de toujours appliquer les mêmes couleurs (par défaut) ou de les générer aléatoirement : cette dernière option assignera des couleurs aléatoires aux divisions de la carte. Ceci aide l'utilisateur à se concentrer à apprendre les formes des divisions et non plus simplement mémoriser les couleurs.

## Remerciements et licence

&kgeography;

Copyright du programme, 2004-2008 Albert Astals Cid &Albert.Astals.Cid.mail;

Copyright de la documentation, 2005 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; 2008 Kushal Das kushaldas@gmail.com

Traduction française par &PierreBuard;.

&underFDL; &underGPL;

## Installation

### Comment obtenir &kgeography;

&install.intro.documentation;

### Compilation et installation

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