# El manual de &kgeography;

Anne-Marie
Mahfouf
&Anne-Marie.Mahfouf.mail;
Kushal
Das
kushaldas@gmail.com
Daniel
Fortuny Anguera

    dfortuny@xtec.cat

&traductor.Antoni.Bella;
2005
&Anne-Marie.Mahfouf;
2008
Kushal Das
&FDLNotice;
25-01-2009
0.5.9-10

&kgeography; és una eina d'aprenentatge pel &kde;. En aquests moments hi ha set maneres diferents d'usar l'aplicació:

- Busqueu en el mapes fent clic a sobre d'una zona del mapa per a veure el seu nom, capital i bandera

- El joc us mostra el nom d'una zona del mapa i heu de fer clic sobre el lloc on està

- El joc us mostra una capital i heu d'esbrinar el país a la que pertany

- El joc us mostra un país i heu d'esbrinar la seva capital

- El joc us mostra la bandera d'un país i heu d'esbrinar el seu nom

- El joc us mostra el nom d'un país i heu d'esbrinar la seva bandera

- El joc us mostra un mapa buit i heu de situar les divisions una a una

KDE
kdeedu
KGeography
geografia
mapes
països

## Introducció

&kgeography; és una eina per aprendre geografia al &kde;. Aquesta aplicació us permetrà 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 a &kgeography;

Quan inicieu &kgeography; la primera vegada, us preguntarà amb quin mapa voleu començar el joc. Aquí teniu una captura de pantalla de &kgeography; quan l'inicieu per primera vegada Aquí teniu una captura de pantalla de &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 de &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ú de &kgeography; Menú de &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 pla 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ó).

### Fitxer de descripció

El fitxer de descripció és necessari i la seva extensió de fitxer serà `.kgm`. Haurà de començar amb `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 convenient 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 bora 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 processat 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 aacid@kde.org, 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 `$`KDEDIR`/share/apps/kgeography/`

- Posar els fitxers de la bandera PNG (si n'hi ha cap) al directori `$`KDEDIR`/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 `$`KDEDIR``, escriviu ``kde4-config` `--prefix`` 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...

  Obre el diàleg per escollir un mapa.

&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

  Canvia el mapa tornant-lo a la seva grandària original.

Visualitza Zoom automàtic

  Canvia el mapa tornant-lo a tota la grandària possible per a omplir l'espai disponible.

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

Arranjament Mostra barra d'eines

  Mostra o amaga la barra d'eines del &kgeography;.

Arranjament Configura dreceres...

  Configura les dreceres pel &kgeography;.

Arranjament Configura barres d'eines...

  Configura la barra d'eines del &kgeography;.

#### El menú Ajuda

&kgeography; empra l'Ajuda per omissió del &kde; com es descriu a continuació, 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.

Les entrades per omissió del &kde; pel menú Ajuda són:

&help.menu.documentation;

## Crèdits i llicència

&kgeography;

Copyright del programa 2004-2008 Albert Astals Cid aacid@kde.org

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;

## Instal·lació

### Com obtenir &kgeography;

&install.intro.documentation;

### Compilació i instal·lació

&install.compile.documentation;

&documentation.index;