# Manuale di &kgeography;

Anne-Marie Mahfouf &Anne-Marie.Mahfouf.mail;
Kushal Das kushaldas@gmail.com
Pino Toscano

    toscano.pino@tiscali.it

Traduzione italiana
2005 &Anne-Marie.Mahfouf;
2008 Kushal Das
&FDLNotice;
2013-05-28
0.8.1 (&kde; 4.11)

&kgeography; è uno strumento per l'apprendimento della geografia per &kde;. Al momento ha sette modalità d'uso:

- Consulta le mappe facendo clic su una divisione di una mappa per vedere il suo nome, la sua capitale e la sua bandiera

- Il gioco ti dice il nome della divisione della mappa e tu devi farci clic sopra

- Il gioco ti dice una capitale e tu devi indovinare la divisione a cui appartiene

- Il gioco ti dice una divisione e tu devi indovinare la sua capitale

- Il gioco ti mostra la bandiera di una divisione della mappa e devi indovinare il suo nome

- Il gioco ti dice il nome di una divisione della mappa e tu devi indovinare la sua bandiera

- Il gioco mostra una mappa vuota e devi piazzarci sopra le divisioni, una per una

KDE kdeedu KGeography geografia mappe nazioni

## Introduzione

&kgeography; è uno strumento per l'apprendimento della geografia per &kde;. Ti permette di apprendere le divisioni politiche di alcune nazioni (divisioni, capitali di queste divisioni e le loro bandiere se ve ne sono).

## Introduzione rapida a &kgeography;

Quando avvii &kgeography; per la prima volta, ti chiede per prima cosa di scegliere una mappa con cui iniziare. Immagine di &kgeography; al primo avvio

Immagine di &kgeography; al primo avvio

Qui scegliamo il Canada È stato scelto il Canada

È stato scelto il Canada

E appare la finestra principale di &kgeography; con la mappa del Canada: La finestra principale di &kgeography;

La finestra principale di &kgeography;

Quindi, guardando al menu sulla sinistra, puoi quindi scegliere quale tipo di apprendimento o di test vuoi fare: Il manu di &kgeography;

Il menu di &kgeography;

Esplora la mappa: un clic con il &LMB; su un'area della mappa mostrerà le informazioni su quell'area; se fai clic sulla piccola icona nella finestra a comparsa, verrà aperta la pagina di Wikipedia di quella divisione usando il browser predefinito di sistema: Consulta la mappa

Consulta la mappa

Trova province o territori: prima ti viene chiesto il numero di domande che vuoi Quante domande

Quante domande

Poi ti viene chiesto di fare clic su una provincia specifica: Fai clic su una provincia

Fai clic su una provincia

Quando hai finito tutte le domande, viene mostrata una finestra di dialogo con i risultati mostrando le tue risposte corrette e quelle non corrette: I tuoi risultati

I tuoi risultati

Piazza province o territori nella mappa: il cursore prende la forma di una provincia e devi piazzarla nella mappa: Piazza una divisione sulla mappa

Piazza una divisione sulla mappa

Province o territori secondo capitale: ti viene chiesto di trovare il nome di una provincia, data la sua capitale, in una lista di 4: Indovina una divisione dalla sua capitale

Indovina una divisione dalla sua capitale

Alla fine del test, vengono mostrati i risultati: I tuoi risultati

I tuoi risultati

Capitali di province e territori: hai una capitale e quattro nomi di provincia e devi scegliere quello corretto. Come prima, alla fine viene mostrata una finestra di dialogo con i risultati.

Province o territori secondo bandiera: viene mostrata una bandiera e tu devi trovare la provincia a cui appartiene. la domanda sulla bandiera

la domanda sulla bandiera

Bandiere di province e territori: viene dato il nome di una provincia e devi trovare la bandiera corretta in una scelta di quattro. fai corrispondere la bandiera alla provincia

fai corrispondere la bandiera alla provincia

## Uso di &kgeography;

&kgeography; mostra le informazioni su alcune nazioni e ti propone test su queste informazioni. Immagine di &kgeography;

Immagine

### Altre caratteristiche di &kgeography;

Un'altra caratteristica di &kgeography; è la possibilità di cambiare l'ingrandimento di una mappa. Ingrandimento

Ingrandimento
Puoi premere Ingrandimento e disegnare un rettangolo per ingrandire una parte della mappa. Mentre sei in modalità ingrandimento, puoi premere il &RMB; per ritornare alla dimensione originale della mappa (l'azione Dimensione originale ha lo stesso effetto). Usa le barre di scorrimento, i pulsanti freccia o la rotellina del mouse per muovere la mappa ingrandita o usa l'azione Muovi che ti permetterà di trascinare la mappa usando il &LMB;. La funzione Ingrandimento automatico ingrandirà la mappa il più possibile.

## Come creare mappe

Una mappa in &kgeography; è composta almeno da due file, uno è l'immagine della mappa e l'altro è la sua descrizione.

### Strumento di supporto

Puoi trovare qui uno strumento (creato da Yann Verley) che lo ha aiutato con la mappa della Francia. Per vedere il suo utilizzo, eseguilo semplicemente e leggi il messaggio di aiuto. Sostanzialmente, crea il file `.kgm` da un file di testo semplice e crea un file con i colori che ha assegnato a ogni divisione, così puoi riempire la mappa a seconda di quei colori.

C'è un altro strumento, colorchecker.py, scritto da Albert Astals Cid. Hai bisogno di PyQt4 per eseguirlo. Eseguilo passando il file .kgm come argomento (hai bisogno anche del file .png della mappa nella stessa cartella). Lo strumento ti dirà se ci sono pixel nella mappa con un colore non definito nel file .kgm (di descrizione).

Consulta che l'esercitazione How to add maps («Come aggiungere mappe») sul sito web di &kgeography;.

### File di descrizione

Il file di descrizione è richiesto e la sua estensione è `.kgm`. Dovrebbe cominciare con !DOCTYPE kgeographyMap, seguito da map e finire con map.

Dentro quei tag ci dovrebbero essere:

- mapFile e mapFile: il nome del file (senza alcun percorso) contenente l'immagine della mappa, ⪚ europe.png.

- name e name: il nome della mappa, ⪚ Europe.

- Un divisionsName e divisionsName: il nome generale delle divisioni in questa mappa, cioè Provinces, States, Countries, &etc;.

- Un division e division per ogni divisione nella mappa.

Ogni divisione ha questi tag:

- name e name: il nome della divisione, ⪚ Albania.

- capital e capital: il nome della capitale della divisione, ⪚ Tirana.

- ignore e ignore: può essere impostato a `yes`, `allowClickMode`, `allowClickFlagMode` e `no`. Se questo tag è impostato a `yes`, allora la divisione non sarà considerata nelle domande sulle divisioni in quella mappa. È come se questa divisione non esistesse nella modalità a quiz di &kgeography;. Se questo tag è impostato a `allowClickMode`, allora &kgeography; chiederà la divisione nella modalità Trova ... ma non in altri quiz. Se questo tag è impostato a `allowClickFlagMode`, allora &kgeography; chiederà la divisione nella modalità Trova ... e nei quiz con bandiere, ma non in altri quiz. Impostare questo tag a `no` significa far sì che la divisione venga considerata in tutte le modalità (sfoglia e quiz). Questo tag è opzionale e se non vi è un tag ignore, allora è come se fosse impostato a `no`. Per esempio Algeria ha questa tag impostata a `yes` nella mappa Europa, e ciò significa che Algeria non sarà inclusa dei quiz della mappa Europa.

- flag e flag: il file (senza alcun percorso) contenente la bandiera della divisione, ⪚ albania.png. Questo tag è opzionale. Non richiesta per divisioni il cui tag ignore è impostato a `yes`.

- color e color: il colore che la divisione ha nella mappa.

- falseCapital e falseCapital: ci possono essere varie coppie di falseCapital, sono usate per fornire una lista di risposte fasulle alle domande sulle capitali invece di usare le capitali di altre divisioni come risposte fasulle.

Il colore è definito usando tre tag:

- red e red: la componente di rosso del colore. Valori validi sono quelli compresi tra 0 e 255.

- green e green: la componente di verde del colore. Valori validi sono quelli compresi tra 0 e 255.

- blue e blue: la componente di blu del colore. Valori validi sono quelli compresi tra 0 e 255.

È conveniente creare 2 o 3 false divisioni come Water, Frontier e Coast e impostarle con il tag ignore impostato a `yes`. Non dimenticare di `non impostare` il colore di ogni Frontier a 0,0,0 in RGB. Usa ad esempio 1,1,1 in modo che può essere disegnato un bordo quando le divisioni sono piazzate sulla mappa.mappa.

Tutti i nomi (capitali e divisioni) devono essere in inglese.

### File di mappa

Il file di una mappa è piuttosto semplice ma richiede un po' di lavoro. Deve essere nel formato PNG. Puoi trovare alcune mappe da trasformare presso le mappe di riferimento della Cia. Se nessuna mappa si adatta alle tue esigenze, puoi scaricare la mappa degli stati del mondo, fare un'istantanea di questa e lavorare a partire da quella. Ogni divisione nella mappa dovrebbe avere uno e un solo colore. Per far ciò, puoi usare programmi di modifica delle immagini come The Gimp e Kolourpaint.

### Bandiere

Se hai usato il tag flag, devi fornire anche i file delle bandiere. Devono essere nel formato PNG ed è meglio se sono grandi 300x200 pixel e se fornisci un file SVG per esse. Per avere bandiere SVG di quasi tutti i paesi nel mondo e di alcune altre divisioni, puoi consultare la collezione delle bandiere di Sodipodi.

### Come provare

Prima di inviare la tua mappa ad Albert &Albert.Astals.Cid.mail;, dovresti provare a vedere se non ci sono errori. Per far ciò, devi fare le seguenti cose:

- Metti i file di descrizione della mappa e di immagine della mappa in `$`KDEDIR`/share/apps/kgeography/`

- Metti i file PNG delle bandiere (se ve ne sono) in `$`KDEDIR`/share/apps/kgeography/flags/`

Una volta che è stato fatto, potrai aprire la tua mappa in &kgeography;.

Se non sai qual è la tua `$`KDEDIR``, scrivi ``kde4-config` `--prefix`` in una shell.

Usa lo strumento colorchecker.py per controllare se nella mappa sono rimasti colori non definiti nel file .kgm.

### Mappe non politiche

È possibile creare mappe non politiche? Certo! Esempio di come creare una mappa non politica

Esempio di come creare una mappa non politica

Ovviamente, il concetto di divisione può essere esteso ad un fiume o ad una montagna. Durante la creazione della mappa, dovresti tener presente che la maggior parte delle volte il fiume o la montagna sarà troppo piccolo e che dovresti fornire un'area aggiuntiva su cui fare clic. In questo esempio, il fiume avrà l'area marrone e il colore <20,76,34> come suo identificatore.

## Guida ai comandi

### La finestra principale di &kgeography;

#### Il menu File

&Ctrl;O File Apri mappa...

  Apre la finestra di dialogo di scelta della mappa. Se digiti velocemente le prime lettere della mappa che cerchi, sarà selezionata la prima mappa che corrisponde al testo che hai digitato.

&Ctrl;Q File Esci

  Esce da &kgeography;

#### Il menu Visualizza

Visualizza Ingrandisci

  Va in modalità di ingrandimento; quindi, basta disegnare un rettangolo per ingrandire quella parte della mappa

Visualizza Dimensione originale

  Reimposta la dimensione originale della mappa. Un clic con il &RMB; sulla mappa in modalità ingrandimento esegue la stessa azione.

Visualizza Ingrandimento automatico

  Imposta l'ingrandimento della mappa in modo da usare lo spazio disponibile il più possibile quando viene ridimensionata la finestra di &kgeography;

Visualizza Muovi

  Muove la mappa corrente. Questa voce è abilitata solo se la mappa è ingrandita.

#### Il menu Impostazioni

&kgeography; ha le voci comuni del menu Impostazioni di &kde;; per maggiori informazioni, consulta il capitolo sul menu Impostazioni dei «Fondamentali di &kde;».

#### Il menu Aiuto

&kgeography; ha il menu Aiuto predefinito di &kde;, come descritto nei Fondamentali di &kde;, con due voci in più:

Aiuto Note legali

  Mostra delle note sulla correttezza di mappe, bandiere e traduzioni usate da &kgeography;.

Aiuto Autore della mappa

  Mostra il nome dell'autore che ha creato la mappa corrente.

## Configurazione

Allineamento delle domande

  Determina la posizione delle domande nella finestra; la scelta predefinita è Alto a sinistra.

Attendi conferma

  Se abilitata, l'utente dovrà premente Accetta dopo aver scelto una risposta.

Il fuoco segue il mouse

  Se abilitata, premere Spazio attiverà il pulsante sotto il puntatore del mouse.

Colori delle divisioni delle mappe

  Puoi scegliere se vuoi sempre mantenere gli stessi colori (scelta predefinita), oppure se vuoi usare colori a caso: con questa opzioni, sono assegnati colori scelti a caso alle divisioni delle mappe. Ciò aiuta a focalizzare l'apprendimento sulle forme delle divisioni e non sui loro colori.

## Riconoscimenti e licenza

&kgeography;

Copyright del programma 2004-2008 Albert Astals Cid &Albert.Astals.Cid.mail;

Copyright della documentazione © 2005 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; 2008 Kushal Das kushaldas@gmail.com

Traduzione italiana di Pino Toscano toscano.pino@tiscali.it

&underFDL; &underGPL;

## Installazione

### Come ottenere &kgeography;

&install.intro.documentation;

### Compilazione e installazione

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