El manual del KGeography

# El manual del KGeography

Mahfouf, Anne-Marie `<annma@kde.org>`

Das, Kushal `<kushaldas@gmail.com>`

Traductor: Daniel Fortuny Anguera
Traductor: Antoni Bella
revisió Aplicacions 20.12 (22 de desembre de 2020)

Dret de reproducció © 2005 Mahfouf, Anne-Marie

Dret de reproducció © 2008 Kushal Das

Avís legal

El KGeography és una eina d'aprenentatge per al KDE. En aquests moments hi ha set maneres diferents d'emprar l'aplicació:

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

- El joc mostra el nom d'una divisió en el mapa i heu de fer clic sobre el lloc on està

- El joc mostra una capital i heu d'esbrinar la divisió a la qual pertany

- El joc mostra una divisió i heu d'esbrinar la seva capital

- El joc mostra la bandera d'una divisió en el mapa i heu d'esbrinar el seu nom

- El joc mostra el nom d'una divisió en el mapa i heu d'esbrinar la seva bandera

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

Capítol 1. Introducció
Introducció

# Capítol 1. 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).

Capítol 2. Inici ràpid al KGeography
Inici ràpid al KGeography

# Capítol 2. Inici ràpid al KGeography

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

### Suggeriment

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.

A on hem escollit el Canadà

I la finestra principal del KGeography s'inicia amb el mapa del Canadà:

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

Explorar el mapa: un clic amb el botó esquerre del ratolí 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:

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

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

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

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:

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:

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

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.

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

Capítol 3. Usar el KGeography
Usar el KGeography

# Capítol 3. Usar el KGeography

El KGeography mostra informació sobre alguns països i us avaluarà sobre el coneixement d'aquesta informació.

## Més característiques del KGeography

Una altra característica del KGeography és la possibilitat de fer zoom en el mapa.

Mentre estigui actiu el mode de zoom, podeu prémer el botó dret del ratolí 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 botó esquerre del ratolí. La característica Zoom automàtic farà el mapa el més gran possible.

Capítol 4. Com crear mapes
Com crear mapes

# Capítol 4. 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ó).

### Suggeriment

Llegiu la guia d'aprenentatge Com afegir mapes al lloc web del KGeography.

Fitxer de descripció
Fitxer de descripció

## 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, p. ex. «`europe.png`».

- `<name>` i `</name>`: el nom del mapa, p. ex. «`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, p. ex. «`Albania`».

- `<capital>` i `</capital>`: el nom de la capital de la zona, p. ex. «`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, p. ex., «`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ó, p. ex., «`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.

### Suggeriment

É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.

### Important

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

Fitxer de mapa
Fitxer de mapa

## 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
Banderes

## 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_`, p. ex. «`blurred_albania.png`»

Comprovar si funciona?
Comprovar si funciona?

## Comprovar si funciona?

Abans d'enviar el vostre mapa a l'Albert `(aacid AT 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 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.

### Suggeriment

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
Mapes no polítics

## Mapes no polítics

És possible fer mapes no polítics? Sí, es pot!

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.

Capítol 5. Referència d'ordres
Referència d'ordres

# Capítol 5. Referència d'ordres

## La finestra principal del KGeography

### El menú Fitxer

Fitxer → Obre un Mapa... (Ctrl+O)

  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.

Fitxer → Surt (Ctrl+Q)

  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 botó dret del ratolí 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.

Capítol 6. Configuració
Configuració

# Capítol 6. 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 Espai 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ó.

Capítol 7. Crèdits i llicència
Crèdits i llicència

# Capítol 7. Crèdits i llicència

KGeography

Copyright del programa 2004-2008 Albert Astals Cid `(aacid AT kde.org)`

Copyright de la documentació (c) 2005 Mahfouf, Anne-Marie `(annma AT kde.org)` 2008 Kushal Das `(kushaldas AT gmail.com)`

Traductor de la documentació: Daniel Fortuny Anguera `(dfortuny AT xtec.cat)`

Traductor/Revisor de la documentació: Antoni Bella `(antonibella5 AT yahoo.com)`

Aquesta documentació està llicenciada d'acord amb les clàusules de la Llicència de Documentació Lliure de GNU.

Aquest programa està llicenciat d'acord amb les clàusules de la Llicència Pública General de GNU.