# Manual do &kgeography;

## Introdución

O &kgeography; é unha ferramenta para aprender xeografía do &kde;. Permite aprender as divisións políticas dalgúns países (divisións, capitais desas divisións e as bandeiras, de térenas).

## Guía rápida do &kgeography;

Cando inicies &kgeography; por primeira vez, hache pedir que escollas un mapa co que comezar. Esta é unha captura de pantalla de &kgeography; no primeiro inicio Esta é unha captura de pantalla de &kgeography; no primeiro inicio

Escollamos o Canadá Escolleuse o Canadá Escolleuse o Canadá

E aparece a xanela principal de &kgeography; co mapa do Canadá: A xanela principal do &kgeography; A xanela principal do &kgeography;

Entón podes escoller no menú da esquerda o tipo de aprendizaxe ou proba que queres facer: Menú do &kgeography; Menú do &kgeography;

Examinar o mapa: ao premer co &LMB; nunha zona do mapa aparecen informacións acerca desa área. Ao premer a iconiña de información do mapa emerxente, ábrese a páxina da Wikipedia desa división no navegador por omisión do sistema: Examinando o mapa Examinando o mapa

Localización de provincias ou territorios: primeiro pregunta cantas preguntas se queren Cantas preguntas Cantas preguntas

Entón pídeche que premas unha provincia específica: Preme unha provincia Preme unha provincia

Cando remates todas as preguntas, mostra un diálogo de resultados coas respostas atinadas e as erradas: Os teus resultados Os teus resultados

Localizar provincias ou territorios no mapa: o cursor toma a forma dunha provincia e haina que colocar no mapa: Colocar unha división no mapa Colocar unha división no mapa

Provincias ou territorios por capital: hai que acertar o nome dunha provincia de entre catro opcións, dada a súa capital. Adiviñar unha división a partir da súa capital Adiviñar unha división a partir da súa capital

E os resultados aparecen ao rematar a proba: Os teus resultados Os teus resultados

Capitais de provincias ou territorios: aparecen unha capital e catro nomes de provincias e hai que escoller a correcta. Como antes, ao final móstrase un diálogo cos resultados.

Provincias ou territorios por bandeira: aparece unha bandeira e hai que adiviñar a provincia á que pertence. a pregunta da bandeira a pregunta da bandeira

Bandeiras de provincias ou territorios: dase o nome dunha provincia e hai que adiviñar a bandeira correcta de entre catro. adiviñar a bandeira da provincia adiviñar a bandeira da provincia

## Uso do &kgeography;

&kgeography; mostra información acerca dalgúns países e fai preguntas sobre esa información. Esta é unha captura de pantalla do &kgeography; Captura de pantalla

### Mais funcionalidades do &kgeography;

Outra funcionalidade do &kgeography; é a posibilidade de ampliar un mapa. Ampliar Ampliar . Pódese premer o botón Ampliar e despois deseñar un rectángulo para ampliar unha parte do mapa. No modo de ampliación pódese premer o &RMB; para volver ao tamaño orixinal do mapa (a acción Tamaño orixinal ten o mesmo efecto). Emprega as barras de desprazamento, as frechas do cursor ou a rodiña do rato para te moveres polo mapa ampliado ou emprega a acción Mover, que permite arrastrar o mapa co &LMB;. A funcionalidade de Ampliación automática fai que o mapa se agrande o máximo posíbel.

## Como facer mapas

Un mapa de &kgeography; está composto de dous ficheiros, un é a imaxe do mapa e o outro é a súa descrición.

### Ferramenta auxiliar

Podes achar aquí unha ferramenta (feita por Yann Verley) que o axudou co mapa da Franza. Para aprender como se usa, simplemente execútao e le a mensaxe de axuda. En esencia crea o ficheiro `.kgm` e crea un ficheiro coas cores que asignases a cada división para que poidas preencher o mapa segundo elas.

Hai outra ferramenta, colorchecker,py, escrita por Albert Astals Cid. Hai que ter PyQt4 para executala. Simplemente se executa co nome de ficheiro .kgm como argumento (o ficheiro .png do mapa ha de estar no mesmo cartafol). Esta ferramenta indica se calquer píxel do mapa ten unha cor diferente que non estea definida no ficheiro (de descrición) .kgm.

### Ficheiro de descrición

O ficheiro de descrición é preciso e a súa extensión é `.kgm`. Debe comezar con `map` e rematar con `map`.

Dentro desas etiquetas debera haber:

- `mapFile` e `mapFile`: o nome do ficheiro (sen rota) que contén a imaxe do mapa, ⪚ europe.png.

- `name` e `name`: o nome do mapa, ⪚ Europe.

- `divisionsName` e `divisionsName`: o nome xeral das divisións neste mapa, ou sexa, provincias, estados, países, etc.

- Unha `division` e `division` para cada división do mapa.

Cada división ten estas etiquetas:

- `name` e `name`: o nome da división, ⪚ Albania.

- `capital` e `capital`: o nome da capital da división, ⪚ Tirana.

- `ignore` e `ignore`: pódese configurar como `yes`, `allowClickMode`, `allowClickFlagMode` e `no`. Se esta etiqueta se configura como `yes`, a división ignórase ao preguntar sobre as divisións dese mapa. É, polo tanto, como se esa división non existise nos modos de cuestionario do &kgeography;. Se esta etiqueta se configura como `allowClickMode`, o &kgeography; pregunta sobre a división no modo Localización de... mais non nos outros modos de cuestionario. Se esta etiqueta se configura como `allowClickFlagMode`, o &kgeography; pregunta sobre a división no modo Localización de... e nos cuestionarios relacionados con bandeiras mais non no resto dos modos de cuestionario. Configurar esta etiqueta como `no` significa que a división aparece en todos os modos (exploración e cuestionarios). Esta etiqueta é opcional e cando non hai etiquetas `ignore` significa que está configurado como `no`. Por exemplo Alxeria ten a etiqueta configurada como `yes` no mapa de Europa, o que significa que Alxeria non fará parte de ningún cuestionario sobre o mapa de Europa.

- `flag` e `flag`: o ficheiro (sen rota) que contén a bandeira da división, ⪚ albania.png. Esta marca é opcional. Non é precisa para as división que teñan a marca `ignore` posta a `yes`.

- `color` e `color`: a cor da división no mapa.

- `falseCapital` e `falseCapital`: Pode haber calquera cantidade de pares de falseCapital; empréganse para fornecer unha listaxe de respostas falsas á pregunta sobre a capital no canto de escoller as respostas falsas de entre as demais capitais de división.

A cor defínese mediante tres etiquetas:

- `red` e `red`: a componente vermella da cor. Só serven valores entre 0 e 255.

- `green` e `green`: a componente verde da cor. Só serven valores entre 0 e 255.

- `blue` e `blue`: a componente azul da cor. Só serven valores entre 0 e 255.

É conveniente crear dúas ou tres divisións falsas, como Water, Frontier e Coast e configuralas coa etiqueta `ignore` configurada como `yes`. Non esquezas `non configurar` a cor de ningunha Frontier 0,0,0 en RGB. Fai que sexa 1,1,1 ou parecido, para que o bordo da fronteira apareza cando se coloque calquera división no mapa.

Todos os nomes (de capitais e divisións) deben estar en inglés.

### Ficheiro do mapa

O ficheiro de mapa é bastante simple, ainda que laborioso de crear. Ha de estar no formato PNG. Pódense atopar mapas para transformalos entre os mapas de referencia da CIA. Se non hai mapas que se axusten ás túas necesidades, pódense transferir do mapa político do mundo: colle unha captura de pantalla e traballa a partir dela. Cada división do mapa debería ter unha e só unha cor. Para conseguilo podes utilizar programas de procesamento de imaxes como O Gimp e Kolourpaint.

### Bandeiras

De ter empregado a etiqueta `flag` hai que fornecer os ficheiros de bandeiras. Han de estar no formato PNG e mellor se teñen 300x200 píxeles e se fornece un ficheiro SVG. Para obter bandeiras SVG de case todos os países do mundo e algunhas outras división, pódese consultar a colectánea de bandeiras do Sodipodi.

### Como probalo

Antes de enviarlle o mapa a Albert tsdgeos@terra.es, débeloprobar para verificar que non haxa erros. Para acadar isto, tes que facer o seguinte:

- Pór a descrición do mapa e o ficheiro de imaxe do mapa en `$`KDEDIR`/share/apps/kgeography/`

- Pór os ficheiros PNG das bandeiras (se as hai) en `$`KDEDIR`/share/apps/kgeography/flags/`

Canto teñas feito isto deberías poder abrir o mapa desde &kgeography;.

Se non sabes cal é o `$`KDEDIR``, escribe ``kde4-config` `--prefix`` nunha terminal.

Emprega a ferramenta colorchecker.py das ferramentas de axuda para comprobar se fican cores extra no mapa que non estean definidas no ficheiro .kgm.

### Mapas non políticos

É posíbel confeccionar mapas non políticos? Si, éo! Exemplo de como crear un mapa non político Exemplo de como crear un mapa non político

Por suposto, o conceito de división pode ser ampliado a un río ou montaña. Durante a criación do mapa, debes lembrar que a maioría das veces o río ou montaña será pequeno de mais e que por ende debe ter unha área adicional para premer. Neste exemplo o río ha ter unha área marrón e a cor <20,76,34> como identificador.

## Referencia de comandos

### A xanela principal do &kgeography;

#### O menú Ficheiro

&Ctrl;O Ficheiro Abrir un mapa...

- Abre o diálogo de escolla de mapas

&Ctrl;Q Ficheiro Saír

- Sae do &kgeography;

#### O menú Vista

Vista Ampliación

- Vai ao modo de ampliación e deseña un rectángulo para achegarse a unha parte do mapa

Vista Tamaño orixinal

- Amplía para o tamaño orixinal do mapa

Vista Ampliación automática

- Coloca o mapa na ampliación automática, ocupando tanto espazo como for posíbel

Vista Mover

- Move o mapa actual. Este elemento só está activado se se ampliou o mapa.

#### O menú Configuración

Configuración Mostrar a barra de ferramentas

- Mostra/Acocha a barra de ferramentas do &kgeography;.

Configuración Configurar os atallos de teclado...

- Configura os atallos de teclado do &kgeography;.

Configuración Configurar as barras de ferramentas...

- Configura as barras de ferramentas do &kgeography;.

#### O menú Axuda

O &kgeography; ten unha Axuda normal do &kde;, como se describe embaixo, con dúas entradas adicionais:

Axuda Precaución

- Mostra un descargo de responsabilidade sobre a exactitude dos mapas, bandeiras e traducións empregados no &kgeography;.

Axuda Autor do mapa

- Mostra o nome do autor que creou o mapa actual.

As entradas do menú Axuda do &kde; son:

&help.menu.documentation;

## Créditos e licenza

&kgeography;

Copyright do programa 2004-2008 Albert Astals Cid tsdgeos@terra.es

Copyright da documentacion, © 2005 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; 2008 Kushal Das kushaldas@gmail.com

mvillarino mvillarino@users.sourceforge.net

Tradución da documentación: Xosé Calvo - http://trasno.net/

&underFDL; &underGPL;

## Instalación

### Como obter o &kgeography;

&install.intro.documentation;

### Compilación e instalación

&install.compile.documentation;
&documentation.index;