Manuel de KGeography

# Manuel de KGeography

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

Kushal Das `<kushaldas@gmail.com>`

Traduction française : Pierre Buard
Traduction française : Xavier Besnard
Version Applications 20.12 (22-12-2020)

Copyright © 2005 Anne-Marie Mahfouf

Copyright © 2008 Kushal Das

Note légale

KGeography est un outil d'apprentissage de la géographie pour KDE. A ce jour, 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.

Chapitre 1. Introduction
Introduction

# Chapitre 1. 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, leurs divisions, capitales de ces divisions et drapeaux associés, le cas échéant.

Chapitre 2. Premiers pas dans KGeography
Premiers pas dans KGeography

# Chapitre 2. 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.

### Astuce

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.

Nous choisissons ici le Canada

Et la fenêtre principale de KGeography apparait avec la carte du Canada :

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

Parcourir une carte : un clic avec le bouton gauche de la souris sur une zone de la carte affichera les informations correspondantes, si vous cliquez sur la petite icône d'informations, une page Wikipédia correspondant à la division s'ouvrira dans votre navigateur défini par défaut dans votre système :

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

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

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

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

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

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

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.

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

Chapitre 3. Utiliser KGeography
Utiliser KGeography

# Chapitre 3. Utiliser KGeography

KGeography affiche des informations sur les pays et vous teste sur celles-ci.

## Fonctionnalités additionnelles de KGeography

Une autre fonctionnalité de KGeography consiste à pouvoir zoomer sur la carte.

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 bouton droit de la souris 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 bouton gauche de la souris. La fonctionnalité Zoom automatique agrandira la carte autant que possible.

Chapitre 4. Comme créer des cartes
Comme créer des cartes

# Chapitre 4. 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, veuillez simplement le lancer et lire le message d'aide. Pour simplifier, il crée un fichier `.kgm` à partir d'un fichier de type texte, ainsi qu'un second fichier contenant les couleurs 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 simplement 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`.

### Astuce

Veuillez également consulter le tutoriel Comment ajouter des cartes présent sur le site Internet de KGeography.

Le fichier de description
Le fichier de description

## Le fichier de description

Le fichier de description est nécessaire et son extension est `.kgm`. Il doit commencer par `<?xml version= « 1.0 » encoding= « utf-8 »>`, suivi de `< !DOCTYPE kgeographyMap>` puis par `<map>` et enfin par `</map>`.

Entre ces balises, il doit y avoir :

- `<Fichier de carte>` et `</Fichier de carte>` : le nom du fichier (sans aucun emplacement) contenant l'image de la carte, par exemple « europe.png ».

- `<nom>` et `</nom>` : le nom de la carte, par exemple « `Europe` ».

- `<Nom du pays>` et `</Nom du pays>` : le nom général du pays sur la carte, comme Provinces, États, Régions, etc..

- Une entrée `<division>` et `</division>` pour chaque division de la carte.

Chaque division a ces balises :

- `<nom>` et `</nom>` : le nom du pays, par exemple « `Albanie` ».

- `<capitale>` et `</capitale>` : le nom de la capitale pour le pays, par exemple « `Tirana` ».

- `<ignore>` et `</ignore>` : accepte comme paramètres `yes`, `allowClickMode`, `allowClickFlagMode` et `no`. Si cette balise est positionnée à `yes`, alors la division sera ignorée lors de questions sur les divisions de la carte. Cela fonctionnera comme si cette division n'existait pas dans les modes de tests de KGeography. Si cette balise est positionnée à `allowClickMode`, alors KGeography fera une demande pour 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... mais pas dans les autres modes. Si cette balise est paramétrée avec `no`, alors, la division apparaitra dans tous les modes (navigation et tests). Cette balise est optionnelle et lorsque la balise `<ignore>` est absente, cela fonctionne de la même façon qu'avec la balise `no`. Par exemple, « Algérie » possède une 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 du pays, par exemple « `albania.png` ». Cette étiquette est optionnelle. Elle n'est pas nécessaire pour les pays ayant une étiquette `<ignore>` avec le paramètre `yes`.

- `<blurredflag>` et `</blurredflag>` : le fichier (Sans aucun emplacement) contenant le drapeau flouté de la division, par exemple « `blurred_albania.png` ». Cette étiquette est optionnelle. Elle devrait être utilisée, dans les situations où le drapeau porte le nom de la division à laquelle il appartient, écrite sur celle-ci. Cela peut rendre les jeux de devinettes de drapeaux trop faciles, et par conséquent, la soumission des drapeaux avec le texte flou est encouragée.

- `<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 sont utilisées pour la fourniture d'une liste de mauvaises réponses à la question de la capitale au lieu de les choisir parmi d'autres listes de capitales de pays.

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

- `<Rouge>` et `</Rouge>` : 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.

- `<Bleu>` et `</Bleu>` : composante de bleu de la couleur. Les valeurs valables sont comprises entre 0 et 255.

### Astuce

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`. Veuillez `ne pas de définir` de couleur 0,0,0 en RGB, pour les « Frontier » (Frontière). Veuillez la définir en quelque chose comme 1,1,1 afin que la bordure de la frontière apparaisse lors du placement des divisions sur la carte.

### Important

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

Le fichier carte
Le fichier carte

## Le fichier carte

Le fichier de cartes est assez simple mais laborieux à créer. Il doit être au format PNG. Vous pourrez trouver des cartes à transformer à la page Cartes de référence CIA. Si aucune carte ne correspond à vos besoins, vous pouvez télécharger la carte politique du monde, réaliser une capture 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 GIMP ou KolourPaint.

Drapeaux
Drapeaux

## Drapeaux

Si vous avez employé la balise `<flag>`, vous devrez fournir des fichiers de drapeaux. Ils devront être au format PNG et, encore mieux, faire 300 x 200 pixels, de plus, vous devrez fournir un fichier au format SVG. Pour obtenir des drapeaux au format SVG de la plupart des pays du monde et de quelques sous-divisions, vous pouvez consulter la collection de drapeaux Sodipodi.

Comme mentionné précédemment, nous vous encourageons à fournir des fichiers de drapeaux flous pour les drapeaux ayant des sous-divisions. Les mêmes exigences s'appliquent aux fichiers de drapeaux flous qu'aux fichiers de drapeaux ordinaires. Bien qu'il n'y ait pas de notation de nom prescrite pour les fichiers flous, nous vous recommandons de les enregistrer avec le nom du drapeau d'origine préfixé avec `floutés_`, par exemple « `flou_albania.png` »

Comment tester
Comment tester

## Comment tester

Avant d'envoyer votre carte à Albert `(aacid AT kde.org)`, vous devriez la tester pour être sûr qu'elle ne contient aucune erreur. Pour cela, vous effectuerez les tâches suivantes :

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

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

Une fois fait, vous devriez être capable d'ouvrir la carte à partir de KGeography.

Si vous ignorez quelle est votre `$`XDG_DATA_HOME``, saisissez `qtpaths `--paths Dossier-Utilisateur`` dans un terminal.

### Astuce

Utilisez l'outil « colorchecker.py » à partir des outils d'assistance, pour vérifier s'il reste des couleurs sur la carte, qui sont non définies dans le fichier `.kgm`.

Cartes non politiques
Cartes non politiques

## Cartes non politiques

Est-il possible de créer des cartes non politiques ? Oui, c'est possible !

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.

Chapitre 5. Références des commandes
Références des commandes

# Chapitre 5. Références des commandes

## La fenêtre principale de KGeography

### Le menu Fichier

Fichier → Ouvrir une carte... (Ctrl+O)

  Ouvre la boite 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.

Fichier → Quitter (Ctrl+Q)

  Quitte KGeography.

### Le menu Affichage

Affichage → Zoom

  Active le mode en zoom et dessine 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 bouton droit de la souris en mode zoom effectue la même action.

Affichage → Zoom automatique

  Applique un zoom automatique à 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

De plus, KGeography possède des éléments communs de menu KDE Configuration. Pour plus d'informations, veuillez consulter la section Menu de configuration des fondamentaux de KDE.

### Le menu Aide

KGeography fournit le menu Aide par défaut 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.

Chapitre 6. Configuration
Configuration

# Chapitre 6. 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, un appui sur 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.

Chapitre 7. Remerciements et licence
Remerciements et licence

# Chapitre 7. Remerciements et licence

KGeography

Copyright du programme, 2004-2008 Albert Astals Cid `(aacid AT kde.org)`

Copyright de la documentation, 2005 Anne-Marie Mahfouf `(annma AT kde.org)` 2008 Kushal Das `(kushaldas AT gmail.com)`

Traduction française par Pierre Buard `(pierre.buard AT gmail.com)`.

Cette documentation est soumise aux termes de la Licence de Documentation Libre GNU (GNU Free Documentation License).

Ce programme est soumis aux termes de la Licence Générale Publique GNU (GNU General Public License).