# O Manual do &kgeography;

## Introdução

O &kgeography; é uma ferramenta de aprendizagem de geografia para o &kde;. Permite-lhe aprender sobre as divisões políticas de alguns países (divisões, capitais dessas divisões e as bandeiras associadas a elas, se existirem).

Os mapas disponíveis na versão actual são: África, Ásia, Áustria, Brasil, Canadá, China, Europa, França, Alemanha, Itália, Itália por províncias, América do Norte e Central, Noruega, Polónia, América do Sul, Espanha, EUA e o mundo.

## Introdução Rápida ao &kgeography;

Quando iniciar o &kgeography; pela primeira vez, ele perguntar-lhe-á para escolher um mapa com o qual iniciar. Aqui está uma imagem do &kgeography; no primeiro arranque Aqui está uma imagem do &kgeography; no primeiro arranque

Aqui foi escolhido o Canadá Foi feita a selecção do Canadá Foi feita a selecção do Canadá

Para que a janela principal do &kgeography; apareça com o mapa do Canadá: Janela principal do &kgeography; Janela principal do &kgeography;

Poderá então escolher o tipo de aprendizagem ou teste que deseja fazer, olhando para o menu à esquerda: Menu do &kgeography; Menu do &kgeography;

Navegar no mapa: se carregar com o &LMB; numa área do mapa, irá aparecer alguma informação acerca dessa área: Navegar no mapa Navegar no mapa

Carregar numa divisão do mapa: terá de indicar quantas perguntas deseja Quantas perguntas Quantas perguntas

Depois, poderá então carregar numa dada província: Carregar numa província Carregar numa província

Quando terminar todas as perguntas, irá aparecer uma janela de resultado com as suas respostas certas e erradas: Os seus resultados Os seus resultados

Adivinhar uma divisão a partir da sua capital: ser-lhe-á pedido o nome de uma província, a partir de 4 opções, dada a sua capital: Adivinhar uma divisão a partir da sua capital Adivinhar uma divisão a partir da sua capital

Para que os resultados sejam apresentados quando o teste terminar: Os seus resultados Os seus resultados

Adivinhar a capital a partir de uma divisão: recebe o nome de uma capital e de quatro províncias, e terá de escolher a correcta. Como anteriormente, no fim aparece uma janela de resultado.

Adivinhar uma divisão a partir da sua bandeira: é mostrada uma bandeira e terá de adivinhar a província a que pertence. a pergunta da bandeira a pergunta da bandeira

Adivinhar a bandeira de uma divisão: é dado o nome de uma província e você terá de adivinhar a bandeira correcta entre 4 opções. corresponder a bandeira à província corresponder a bandeira à província

## Usar o &kgeography;

O &kgeography; mostra informações sobre alguns países e testa-o com base nesses dados. Aqui está uma imagem do &kgeography; Imagem

### Mais funcionalidades do &kgeography;

Outra funcionalidade do &kgeography; é a possibilidade de ampliar um mapa. Ampliação Ampliação Enquanto estiver no modo de ampliação, poderá carregar com o &RMB; para voltar ao tamanho do mapa origina (a opção Tamanho Original tem o mesmo efeito). Use as barras de posicionamento para circular pelo mapa ampliado ou use a acção Mover que lhe permitirá arrastar o mapa com o &LMB;.

## Como criar mapas

Um mapa no &kgeography; é composto por dois ficheiros, sendo um a imagem do mapa e o outro a sua descrição.

### Ferramenta auxiliar

Poderá encontrar aqui uma ferramenta (feita por Yann Verley) que o ajudou com o mapa de França. Para descobrir como funciona, basta executá-la e ler a mensagem de ajuda. Basicamente, cria o ficheiro `.kgm` a partir de um ficheiro de texto simples e cria um ficheiro com as cores que atribuiu a cada divisão, para que possa preencher o mapa de acordo com ele.

### Ficheiro de descrição

O ficheiro da descrição é necessário e a sua extensão de ficheiro é `.kgm`. Deverá começar por `map` e terminar em `map`.

Dentro destas marcas, deverá existir:

- `mapFile` e `mapFile`: o nome do ficheiro (sem o local completo) que contém a imagem do mapa, ⪚ europa.png.

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

- Um `division` e `division` para cada divisão do mapa.

Cada divisão tem estas marcas:

- `name` e `name`: o nome da divisão, ⪚ Albania.

- `capital` e `capital`: o nome da capital da divisão, ⪚ Tirana.

- O `ignore` e `ignore`: poderão ser configurados como `yes`, `allowClickMode` e `no`. Se esta marca for igual a `yes`, a divisão será ignorada ao pedir divisões nesse mapa. É como se esta divisão não existisse nos modos de questionário do &kgeography;. Se esta marca for igual a `allowClickMode`, então o &kgeography; irá perguntar a divisão no modo Carregar a Divisão no Mapa... mas não nos outros modos de questionário. Se configurar esta marca como `no`, significa que a divisão irá aparecer em todos os modos (navegação e questionários). Esta marca é opcional e, quando não existir qualquer marca `ignore`, significa que é iguala `no`. Por exemplo, a Argélia tem esta marca como `yes` no mapa da Europa, o que significa que a Argélia não fará parte de qualquer questionário sobre o mapa da Europa.

- `flag` e `flag`: o ficheiro (sem qualquer informação da sua localização) que contém a bandeira da divisão, ⪚ albania.png. Esta marca é opcional. Não é necessário para as divisões cuja marca `ignore` seja igual a `yes`.

- `color` e `color`: a cor que a divisão tem no mapa.

A cor é definida com três marcas:

- `red` e `red`: a componente vermelha da cor. Os valores válidos encontram-se entre 0 e 255.

- `green` e `green`: a componente verde da cor. Os valores válidos encontram-se entre 0 e 255.

- `blue` e `blue`: a componente azul da cor. Os valores válidos encontram-se entre 0 e 255.

É conveniente criar 2 ou 3 divisões falsas, como a Água, Fronteira e Costa e configurá-las com a marca `ignore` igual a `yes`.

Todos os nomes (capitais e divisões) deverão estar em Inglês.

### Ficheiro do mapa

O ficheiro do mapa é bastante simples mas é difícil de criar. Terá de estar no formato PNG. Poderá encontrar alguns mapas para transformar nos Mapas de Referência da CIA. Se nenhum dos mapas corresponder às suas necessidades, poderá obter o ficheiro world pdf, tirar uma imagem dele e trabalhar a partir daí. Cada divisão do mapa deverá ter uma e só uma cor. Para o fazer, poderá usar programas de processamento de imagem como o The Gimp e o Kolourpaint.

### Opções

Se tiver usado a marca `flag`, deverá indicar aos ficheiros das bandeiras. Terão de estar no formato PNG e o melhor será que tenham 300x200 pixels e exista um ficheiro SVG para ele. Para obter bandeiras em SVG de quase todos os países do mundo e de algumas divisões, poderá consultar a colecção de bandeiras do Sodipodi.

### Como testar

Antes de enviar o seu mapa para o Albert tsdgeos@terra.es, deverá testá-lo para ver se não tem erros. Para o fazer, terá de efectuar o seguinte:

- Colocar a descrição e o ficheiro de imagem do mapa em `$`KDEDIR`/share/apps/kgeography/`

- Colocar os ficheiros PNG da bandeira (se existirem) em `$`KDEDIR`/share/apps/kgeography/flags/`

Logo que tenha feito isto, deverá ser capaz de abrir o seu mapa dentro do &kgeography;.

Se não souber qual é a sua `$`KDEDIR``, escreva ``kde-config` `--prefix`` numa consola.

### Mapas não-políticos

É possível criar mapas não-políticos? Sim, é! Exemplo de como criar um mapa não-político Exemplo de como criar um mapa não-político

Obviamente, o conceito da divisão poderá ser extendido a um rio ou montanha. Durante a criação do mapa, deverá ter em mente que, na maior parte dos casos, o rio ou a montanha serão demasiado pequenos, pelo que deverá oferecer uma área adicional onde carregar. Neste exemplo, o rio teria a zona acastanhada e a cor <20,76,34> como identificação.

## Referência de Comandos

### A janela principal do &kgeography;

#### O Menu Ficheiro

&Ctrl;O Ficheiro Abrir um Mapa...

- Abre a janela para seleccionar o mapa a abrir

&Ctrl;Q Ficheiro Sair

- Sai do &kgeography;

#### O Menu Ver

Ver Ampliação

- Vai para o modo de ampliação

Ver Tamanho Original

- Volta a colocar o mapa no seu tamanho original

Ver Mover

- Pode posicionar-se no mapa actual

#### O Menu Configuração

Configuração Mostrar/Esconder a Barra de Ferramentas

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

Configuração Configurar os Atalhos...

- Configura os atalhos de teclado do &kgeography;.

Configuração Configurar as Barras de Ferramentas...

- Configura a barra de ferramentas do &kgeography;.

#### O Menu Ajuda

&help.menu.documentation;

## Créditos e Licença

&kgeography;

Programa com 'copyright' 2004-2005 de Albert Astals Cid tsdgeos@terra.es

Documentação com 'copyright' © 2005 de &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;

Tradução de José Nuno Pires jncp@netcabo.pt

&underFDL; &underGPL;

## Instalação

### Como obter o &kgeography;

&install.intro.documentation;

### Compilação e Instalação

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