# El manual del &kgeography;

## Introducció

El &kgeography; és una eina per a aprendre geografia per al &kde;. Aquesta aplicació permet aprendre les divisions polítiques d'alguns països (fronteres, capitals d'aquestes divisions i les seves banderes associades, si n'hi ha alguna).

## Inici ràpid al &kgeography;

Quan inicieu el &kgeography; per primera vegada, us preguntarà amb quin mapa voleu començar el joc.

Podeu filtrar la llista de mapes utilitzant el camp de text Filtre de mapes. Només cal introduir unes quantes lletres del nom del mapa per a reduir la llista a unes poques coincidències.

Aquí teniu una captura de pantalla del &kgeography; quan l'inicieu per primera vegada Aquí teniu una captura de pantalla del &kgeography; quan l'inicieu per primera vegada

A on hem escollit el Canadà S'ha escollit el Canadà S'ha escollit el Canadà

I la finestra principal del &kgeography; s'inicia amb el mapa del Canadà: La finestra principal del &kgeography; La finestra principal del &kgeography;

També podeu triar quin mode o prova desitgeu fer amb el menú que hi ha a l'esquerra: Menú del &kgeography; Menú del &kgeography;

Explorar el mapa: un clic amb el &BER; en una àrea del mapa mostrarà informació sobre aquesta, si feu clic a la petita icona Informació sobre l'emergent, s'obrirà la pàgina de la Viquipèdia per a aquesta zona en el navegador predeterminat del sistema: Navega pel mapa Navega pel mapa

Ubicació de províncies o territoris: primer us demana quantes preguntes voleu. Quantes preguntes voleu? Quantes preguntes voleu?

Després us demanarà que feu clic sobre una província: Clic sobre una província Clic sobre una província

Quan finalitzeu totes les preguntes, un diàleg de resultats us dirà les vostres respostes correctes i incorrectes: Els vostres resultats Els vostres resultats

Situeu províncies o territoris en el mapa: el cursor prendrà la figura d'una província i l'haureu de situar al seu lloc en el mapa: Situar una zona en el mapa Situar una zona en el mapa

Províncies o territoris a partir de la capital: se us demanarà cercar el nom d'una capital d'una província entre quatre opcions: Endevineu una zona a partir de la seva capital Endevineu una zona a partir de la seva capital

I els resultats són els que es mostren quan es finalitza la prova: Els vostres resultats Els vostres resultats

Capitals de províncies i territoris: teniu una capital i quatre noms de província com a opcions. Com abans, al final se us mostrarà el diàleg de resultats.

Províncies o territoris a partir de la bandera: mostra una bandera i heu de cercar la província a la qual pertany. La pregunta de bandera La pregunta de bandera

Banderes de províncies i territoris: mostra un nom de província i heu de cercar la bandera correcta entre quatre opcions. Aparelleu la bandera amb la província Aparelleu la bandera amb la província

## Usar el &kgeography;

El &kgeography; mostra informació sobre alguns països i us avaluarà sobre el coneixement d'aquesta informació. Aquí teniu una captura de pantalla del &kgeography; Captura de pantalla

### Més característiques del &kgeography;

Una altra característica del &kgeography; és la possibilitat de fer zoom en el mapa. Zoom Zoom Mentre estigui actiu el mode de zoom, podeu prémer el &BDR; per a tornar a la mida original del mapa (l'acció Mida original és equivalent). Empreu les barres de desplaçament, les tecles de cursor o la roda del ratolí per a moure-us pel mapa augmentat desmesuradament o feu ús de l'acció Mou que us permetrà arrossegar el mapa emprant el &BER;. La característica Zoom automàtic farà el mapa el més gran possible.

## Com crear mapes

Els mapes al &kgeography; estan fets amb dos fitxers, un és la imatge del mapa i l'altre conté la seva descripció.

### Eina d'ajuda

Trobareu l'eina aquí (creada per en Yann Verley) la qual us ajudarà amb el mapa de França. Per a utilitzar-la, només cal executar i llegir el missatge d'ajuda. Us crearà un fitxer amb extensió `.kgm` de tipus de text net i un altre fitxer amb els colors assignats per a cada zona, de manera que podreu omplir el mapa correctament.

Hi ha una altra eina colorchecker.py escrita per l'Albert Astals Cid. Necessitareu PyQt4 per a executar-la. Simplement s'executa amb el nom del fitxer `.kgm` com a argument (també necessitareu el fitxer `.png` del mapa a la mateixa carpeta). Aquesta us dirà si un píxel al mapa té un color diferent que no es defineix al fitxer `.kgm` (descripció).

Llegiu la guia d'aprenentatge Com afegir mapes al lloc web del &kgeography;.

### Fitxer de descripció

El fitxer de descripció és necessari i la seva extensió de fitxer serà `.kgm`. Haurà de començar amb `?xml version="1.0" encoding="utf-8"`, després `!DOCTYPE kgeographyMap`, seguit per `map` i finalitzar amb `map`.

Incloure les etiquetes en el seu lloc:

- `mapFile` i `mapFile`: el nom de fitxer (sense el camí) que conté la imatge del mapa, &pex; «`europe.png`».

- `name` i `name`: el nom del mapa, &pex; «`Europe`».

- `divisionsName` i `divisionsName`: els noms en general de les xones en aquest mapa, que són, províncies, estats, països, &etc;

- Una `division` i `division` per a cada zona en el mapa.

Cada zona té aquestes etiquetes:

- `name` i `name`: el nom de la zona, &pex; «`Albania`».

- `capital` i `capital`: el nom de la capital de la zona, &pex; «`Tirana`».

- `ignore` i `ignore`: es poden establir a `yes`, `allowClickMode`, `allowClickFlagMode` i `no`. Si s'estableix a `yes` aleshores seran ignorades quan es preguntin zones en el mapa. Després serà com si aquesta zona no existís en el &kgeography; en el mode qüestionari. Si s'estableix a `allowClickMode`, aleshores el &kgeography; demanarà per la zona en el mode Ubicació de «...» però no en els altres modes de qüestionari. Si s'estableix a `allowClickFlagMode`, aleshores el &kgeography; demanarà per la zona en el mode Ubicació de «...» i la bandera relacionada, però no en els altres modes de qüestionari. Si s'estableix a `no`, significarà que les zones apareixeran en tots els modes (navegació i qüestionari). Aquesta etiqueta és opcional, sempre que no hi hagi l'etiqueta `ignore` voldrà dir que s'estableix l'etiqueta `no`. Per exemple, «`Algèria`» té aquesta etiqueta establerta a `yes` en el mapa «`Europe`», vol dir que «`Algèria`» no formarà part de cap qüestionari en el mapa «`Europe`».

- `flag` i `flag`: el fitxer (sense el camí) conté l'etiqueta de la zona, &pex;, «`albania.png`». Aquesta etiqueta és opcional. No és necessària per a les zones mentre l'etiqueta `ignore` estigui establerta a `yes`.

- `blurredflag` i `blurredflag`: el fitxer (sense el camí) que conté la bandera borrosa de la divisió, &pex;, «`blurred_albania.png`». Aquesta etiqueta és opcional. S'hauria d'utilitzar en situacions en les quals la bandera tingui el nom escrit de la divisió a la qual pertany. Això pot fer que els jocs d'endevinar la bandera esdevinguin massa fàcil, i com a tal, es fomenta l'enviament de banderes amb el text borrós.

- `color` i `color`: el color de la zona en el mapa.

- `falseCapital` i `falseCapital`: a on podrà ser qualsevol número de `falseCapital` parella, aquestes s'usaran per a proveir una llista de falses respostes al qüestionari de capital en comptes d'escollir-les entres les altres capitals de zona.

El color està definit emprant tres etiquetes:

- `red` i `red`: component de color vermell. Té com a valors entre 0 i 255.

- `green` i `green`: component de color verd. Té com a valors entre 0 i 255.

- `blue` i `blue`: component de color blau. Té com a valors entre 0 i 255.

És útil crear 2 o 3 zones falses amb el «`Water`» (mar), «`Frontier`» (frontera) i «`Coast`» (costa) establint l'etiqueta `ignore` a `yes`. No oblideu `de no establir` el color per a qualsevol «`Frontier`» 0,0,0 en RGB. Si us plau, que sigui alguna cosa com 1,1,1 de manera que un contorn de frontera situï qualsevol divisió en el mapa.

Tots els noms (capitals i zones) hauran d'estar en anglès.

### Fitxer de mapa

El fitxer de mapa és molt senzill però laboriós de crear. Es troba en el format PNG. Trobareu alguns mapes per a transformar a Cia Reference Maps. Si no trobeu el mapa que necessiteu, haureu de descarregar el mapa polític del món, agafeu una captura de pantalla d'aquest mapa i treballeu des d'aquesta. Cada zona en el mapa haurà de tenir un únic color. Per a aconseguir-ho, podeu utilitzar programes de processament d'imatges com The Gimp i &kolourpaint;.

### Banderes

Si heu emprat l'etiqueta `flag`, haureu de proveir els fitxers de bandera. Aquests estaran en el format PNG i a 300x200 píxels, i proveïu un fitxer &SVG; per a aquesta. Per a obtenir les banderes &SVG; de la majoria de països en el món i d'algunes altres zones, podeu consultar la Col·lecció de banderes de Sodipodi.

Com s'ha assenyalat anteriorment, us animem a proporcionar fitxers de bandera borrosa per a les banderes que tenen la divisió escrita sobre elles. Els mateixos requisits s'apliquen als fitxers de bandera borrosa quant als fitxers de bandera normals. Encara que no hi ha una notació de nomenclatura prescrita per als fitxers borrosos, recomanem desar-los amb el nom de la bandera original prefixada amb `blurred_`, &pex; «`blurred_albania.png`»

### Comprovar si funciona?

Abans d'enviar el vostre mapa a l'Albert &Albert.Astals.Cid.mail;, comproveu que aquest no tingui errades. Per a desar-lo, heu de fer el següent:

- Posar la descripció del mapa i el fitxer de la imatge del mapa a la carpeta `$`XDG_DATA_HOME`/share/apps/kgeography/`

- Posar els fitxers de la bandera en PNG (si n'hi ha cap) a la carpeta `$`XDG_DATA_HOME`/share/apps/kgeography/flags/`

Una vegada que tot això ha estat fet hauríeu de poder obrir el vostre mapa des del &kgeography;.

Si no coneixeu quina és la vostra carpeta `$`XDG_DATA_HOME``, escriviu ``qtpaths` `--paths HomeLocation`` en un intèrpret d'ordres.

Utilitzeu l'eina colorchecker.py de les eines d'ajuda per a comprovar si qualsevol color que estigui en el mapa no està definit al fitxer `.kgm`.

### Mapes no polítics

És possible fer mapes no polítics? Sí, es pot! Exemple de com crear un mapa no polític Exemple de com crear un mapa no polític

De moment, el concepte de zona pot ser extensiu a un riu o una muntanya. Durant la creació del mapa, podeu mantenir en la vostra ment quina muntanya o riu serà objecte del treball. En aquest exemple el riu tindrà el color <20,76,34> com a identificador.

## Referència d'ordres

### La finestra principal del &kgeography;

#### El menú Fitxer

&Ctrl;O Fitxer Obre un Mapa...

- Obriu el diàleg per a escollir el mapa. Si escriviu amb prou rapidesa les primeres lletres del mapa se cercarà i seleccionarà el primer mapa coincident.

&Ctrl;Q Fitxer Surt

- Surt del &kgeography;.

#### El menú Visualitza

Visualitza Zoom

- Entreu en el mode de zoom, tot seguit dibuixeu un rectangle en una part del mapa per a fer-lo augmentar.

Visualitza Mida original

- Estableix el mapa de nou a la mida original com es defineix al fitxer de mapa. Un clic del &BDR; en el mode zoom realitzarà la mateixa acció.

Visualitza Zoom automàtic

- Estableix el mapa a zoom automàtic amb l'espai més gran possible en canviar la mida de la finestra del &kgeography;.

Visualitza Mou

- Mou el mapa actual. Aquest element només estarà habilitat si heu fet zoom en el mapa per sobre de l'espai disponible.

#### El menú Arranjament

El &kgeography; té els elements comuns del &kde; i els elements del menú Arranjament. Per a obtenir més informació, llegiu la secció El menú Arranjament en els Fonaments del &kde;.

#### El menú Ajuda

El &kgeography; té un menú Ajuda predeterminat del &kde;, com es descriu en els Fonaments del &kde; amb dues entrades addicionals:

Ajuda Exempció de responsabilitat

- Mostra una exempció de responsabilitat sobre l'exactitud dels mapes, banderes i traduccions utilitzades pel &kgeography;.

Ajuda Autor del mapa

- Mostra el nom de l'autor que va crear el mapa actual.

## Configuració

Alineació de les preguntes

- Determina la posició de les preguntes a la finestra, de manera predeterminada és Superior esquerra.

Espera la validació

- Si està activada, l'usuari haurà de prémer Accepta després de triar una resposta.

El focus segueix el ratolí

- Activarà prémer &Space; per a activar el botó que es trobi sota el punter del ratolí.

Colors de les divisions en el mapa

- Podeu escollir si voleu mantenir els mateixos colors (predeterminat) o si voleu utilitzar colors a l'atzar: amb aquesta opció s'assignaran colors a l'atzar a les divisions en el mapa. Això ajuda l'usuari a concentrar-se i aprendre les formes de divisió i no els colors de la divisió.

## Crèdits i llicència

&kgeography;

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

Copyright de la documentació © 2005 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; 2008 Kushal Das kushaldas@gmail.com

Traductor de la documentació: Daniel Fortuny Anguera dfortuny@xtec.cat

Traductor/Revisor de la documentació: &credits.Antoni.Bella;

&underFDL; &underGPL;
&documentation.index;