# Manuale di &kgeography;

## Introduzione

&kgeography; è uno strumento di &kde; per l'apprendimento della geografia. Ti permette di apprendere le divisioni politiche di alcune nazioni (divisioni, le loro capitali e le rispettive 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.

Puoi filtrare la lista delle mappe usando il campo di testo Filtra mappe. Inserisci le prime lettere del nome della mappa per restringere la lista a pochi risultati.

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 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 ti mostrerà le informazioni su quell'area; se fai clic sulla piccola icona Informazioni 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 a cui vuoi rispodere. 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, ti viene mostrata una finestra con i risultati: vengono mostrate le risposte corrette e quelle no: I tuoi risultati I tuoi risultati

Piazza province o territori nella mappa: il puntatore prende la forma di una provincia, e tu 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, tu devi scegliere quello corretto. Come prima, alla fine ti viene mostrata una finestra 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 tu devi trovare la bandiera corretta tra le quattro proposte. fai corrispondere la bandiera alla provincia fai corrispondere la bandiera alla provincia

## Uso di &kgeography;

&kgeography; ti mostra le informazioni su alcune nazioni, e ti propone un 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 le mappe

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

### Strumento di supporto

Qui puoi trovare 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 (di descrizione) `.kgm`.

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 `?xml version="1.0" encoding="utf-8"`, seguito da `!DOCTYPE kgeographyMap`, poi `map`, e finire con `map`.

Dentro quelle etichette 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 queste etichette:

- `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` a `no`. Se questa etichetta è impostata 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 questa etichetta è impostata a `allowClickMode`, allora &kgeography; chiederà la divisione nella modalità Trova ... ma non in altri. Se questa etichetta è impostata a `allowClickFlagMode`, allora &kgeography; chiederà la divisione nella modalità Trova ... e nei quiz con bandiere, ma non in altri quiz. Impostare questa etichetta a `no` significa far sì che la divisione venga considerata in tutte le modalità (sfoglia e quiz). Questa etichetta è opzionale e se non ve ne è una `ignore`, allora è come se fosse impostato a `no`. Per esempio `Algeria` ha questa etichetta impostata a `yes` nella mappa `Europa`: ciò significa che `Algeria` non sarà inclusa nei quiz della mappa `Europa`.

- `flag` e `flag`: il file (senza alcun percorso) contenente la bandiera della divisione, ⪚ `albania.png`. Questa etichetta è opzionale. Non richiesta per divisioni la cui etichetta `ignore` è impostata 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.

Il colore è definito usando tre etichette:

- `red` e `red`: la componente di rosso del colore. Sono validi i valori compresi tra 0 e 255.

- `green` e `green`: la componente di verde del colore. Sono validi i valori compresi tra 0 e 255.

- `blue` e `blue`: la componente di blu del colore. Sono validi i valori compresi tra 0 e 255.

È conveniente creare 2 o 3 false divisioni come `Water`, `Frontier` and `Coast` e impostarle con l'etichetta `ignore` impostata 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.

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 in formato PNG. Puoi trovare alcune mappe da trasformare tra le mappe di riferimento della Cia. Se nessuna di queste 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 l'etichetta `flag`, devi fornire anche i file delle bandiere. Devono essere nel formato PNG, ed è meglio che siano grandi 300x200 pixel e dei file &SVG;. Per avere bandiere &SVG; di quasi tutti i paesi nel mondo e di alcune altre divisioni, consulta 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ò:

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

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

Quando hai fatto, potrai aprire la tua mappa in &kgeography;.

Se non sai qual è la tua `$`XDG_DATA_HOME``, scrivi ``qtpaths` `--paths HomeLocation`` 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 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; disegna quindi 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 il più possibile lo spazio disponibile 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 è In 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 &Space; attiverà il pulsante sotto il puntatore del mouse.

Colori delle divisioni delle mappe

- Puoi scegliere se vuoi sempre mantenere gli stessi colori (la scelta predefinita), oppure se vuoi usarne alcuni a caso: con questa opzioni, i colori delle divisioni delle mappe vengono assegnati a caso. Ciò aiuta a focalizzare l'apprendimento sulle forme delle divisioni piuttosto che 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;
&documentation.index;