# El manual de &kgeography;

## Introducció

El &kgeography; és una eina per aprendre geografia pel &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; la primera vegada, us preguntarà amb quin mapa voleu començar el joc.

Podeu filtrar la llista de mapes utilitzant el camp de text Filtra els mapes. Simplement introduïu 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 d'informació sobre l'emergent, s'obrirà la pàgina de la viquipèdia per a aquesta zona en el navegador per omissió 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 al mapa: El cursor pren 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: Se us mostra una bandera i haureu de cercar la província a la qual pertany. La pregunta de bandera La pregunta de bandera

Banderes de províncies i territoris: Se us mostra un nom de província i haureu de cercar la bandera correcta entre quatre opcions. Emparelleu la bandera amb la província Emparelleu la bandera amb la província

## Emprant &kgeography;

&kgeography; us mostra informació sobre alguns països i us avaluarà sobre el coneixement d'aquesta informació. Aquí teniu una captura de pantalla de &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 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ó Moure que us permetrà arrossegar el mapa emprant el &BER;. La característica Zoom automàtic farà al mapa el més gran possible.

## Com crear mapes

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

### Eina d'ajuda

Podeu trobar l'eina aquí (de Yann Verley) la qual us podrà ajudar amb el mapa de França. Per a usar-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 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 de &kgeography;.

### Fitxer de descripció

El fitxer de descripció és necessari i la seva extensió de fitxer serà `.kgm`. Haurà de començar amb `!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é el mapa de la imatge, &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; «Albània».

- `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 &kgeography; en el mode qüestionari. Si s'estableix a `allowClickMode` aleshores &kgeography; demanarà per la zona en el mode Fer clic en la zona del mapa... però no en els altres modes de qüestionari. Si s'estableix a `allowClickFlagMode` aleshores &kgeography; demanarà per la zona en el mode Fer clic en la zona del mapa... 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 «Algeria» té aquesta etiqueta establerta a `yes` en el mapa «Europe» vol dir que «Algeria» 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`.

- `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 qualsevol «Frontera» 0,0,0 en RGB. Si us plau, que sigui alguna cosa com 1,1,1 de manera que una vora situï qualsevol divisió en el mapa.

Tots els noms (capitals i zones) estaran en anglès.

### Fitxer de mapa

El fitxer de mapa és simple però laboriós de crear. Es troba en el format PNG. Podreu trobar alguns mapes per transformar a Cia Reference Maps. Si no trobeu el mapa que necessiteu haureu de descarregar la political world map, 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 aconseguir-ho podeu usar programes de processament d'imatges com The Gimp i Kolourpaint.

### Banderes

Si heu usat 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 obtenir banderes SVG de la majoria de països en el món i algunes altres zones, podeu consultar la Sodipodi flags collection.

### 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 al directori `$`XDG_DATA_HOME`/share/apps/kgeography/`

- Posar els fitxers de la bandera PNG (si n'hi ha cap) al directori `$`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 quin és el vostre directori `$`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 de &kgeography;

#### El menú Fitxer

&Ctrl;O Fitxer Obre un Mapa...

- Obriu el diàleg per 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 de &kgeography;.

#### El menú Visualitza

Visualitza Zoom

- Entra en el mode de zoom, tot seguit dibuixeu un rectangle en una part del mapa per augmentar-la.

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 per zoom automàtic amb l'espai més gran possible en canviar la mida de la finestra de &kgeography;.

Visualitza Mou

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

#### El menú Arranjament

&kgeography; té els elements comuns del &kde; pel menú Arranjament, per obtenir més informació llegiu la secció El menú Arranjament dels Fonaments del &kde;.

#### El menú Ajuda

&kgeography; disposa del menú Ajuda per omissió del &kde; com es descriu als Fonaments del &kde;, amb dues entrades addicionals:

Ajuda Renúncia

- Mostra una renúncia sobre l'exactitud dels mapes, banderes i traduccions utilitzades per &kgeography;.

Ajuda Autor del mapa

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

## Configuració

Alineació de preguntes

- Determina la posició de les preguntes a la finestra, per omissió é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à el prémer espai per activar el botó que es trobi sota el punter del ratolí.

Colors de les divisions del mapa

- Podeu escollir si voleu mantenir els mateixos colors (per omissió) 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;