# Manual de &kgeography;

Anne-Marie
Mahfouf
&Anne-Marie.Mahfouf.mail;
Kushal
Das
kushaldas@gmail.com
Marce
Villarino

    mvillarino@users.sourceforge.net

Tradutor do proxecto Trasno
Xosé
Calvo

Tradutor do proxecto Trasno
2005
&Anne-Marie.Mahfouf;
2008
Kushal Das
&FDLNotice;
2008-08-23
0.5.9

O &kgeography; é unha ferramenta para aprender xeografía para o &kde;. Neste momento dispón de sete modos de uso:

- Examina os mapas premendo unha división do mapa para ver o nome, capital e bandeira

- O xogo diche un nome de división do mapa e tela que premer

- O xogo diche unha capital e debes adiviñar a división á que pertence

- O xogo diche unha división e debes adiviñar a súa capital

- O xogo móstrache a bandeira dunha división do mapa e tes que adiviñar o seu nome

- O xogo diche o nome dunha división do mapa e tes que adiviñar a súa bandeira

- O xogo mostra un mapa baleiro e hai que colocar as divisións unha a unha

KDE
kdeedu
KGeography
xeografía
mapas
países

## 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 de &kgeography; A xanela principal de &kgeography;

Entón podes escoller no menú da esquerda o tipo de aprendizaxe ou proba que queres facer: Menú de &kgeography; Menú de &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 perguntas Cantas perguntas

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

Cando remates todas as perguntas, mostra un diálogo de resultados coas respostas atinadas e 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 pergunta da bandeira a pergunta 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 de &kgeography;

&kgeography; mostra información acerca dalgúns países e faiche probas acerca desa información. Esta é unha captura de pantalla de &kgeography; Captura de pantalla

### Mais funcionalidades de &kgeography;

Outra funcionalidade do &kgeography; é a posibilidade de ampliar un mapa. Ampliar Ampliar . Pódese premer 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 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 fará 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, simplesmente execútao le a mensaxe de axuda. En esencia crea o ficheiro `.kgm` e crea un ficheiro coas cores que asinases a cada división, para que poida preenche o mapa de 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`. Debera 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, &eg; europe.png.

- `name` e `name`: o nome do mapa, &eg; 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, &eg; Albania.

- `capital` e `capital`: o nome da capital da división, &eg; 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, &eg; 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` ``kde-config` `--prefix`` nunha shell.

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 de &kgeography;

#### O menú Ficheiro

&Ctrl;O Ficheiro Abrir Mapa...

  Abre o diálogo de escolla de mapas

&Ctrl;Q Ficheiro Sair

  Sai de &kgeography;

#### O menú Vista

Vista Ampliación

  Vai para o modo ampliación

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

#### O menú Configuración

Configuración Mostrar a barra de ferramentas

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

Configuración Configurar os atallos de teclado...

  Configura os atallos de teclado de &kgeography;.

Configuración Configurar as barras de ferramentas...

  Configura as barras de ferramentas de &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 &kgeography;

&install.intro.documentation;

### Compilación e instalación

&install.compile.documentation;

&documentation.index;