# O Manual do &kgeography;

Anne-Marie Mahfouf &Anne-Marie.Mahfouf.mail;
Kushal Das kushaldas@gmail.com
José Pires

    zepires@gmail.com

Tradução
2005 &Anne-Marie.Mahfouf;
2008 Kushal Das
&FDLNotice;
2016-05-08
0.9 (Aplicações 16.04)

O &kgeography; é uma ferramenta de aprendizagem de geografia do &kde;. De momento, tem sete modos de utilização:

- Navegar nos mapas, carregando numa divisão do mapa, para ver o seu nome, a capital e a bandeira

- O jogo diz-lhe o nome de uma divisão do mapa e você terá de carregar nela

- O jogo diz-lhe o nome de uma capital e você terá de adivinhar a divisão a que pertence

- O jogo indica-lhe uma divisão e você terá de adivinhar a sua capital

- O jogo mostra-lhe a bandeira de uma divisão do mapa e você terá de adivinhar o seu nome

- O jogo indica-lhe o nome de uma divisão do mapa e terá de adivinhar a sua bandeira

- O jogo mostra um mapa vazio e você terá de colocar as divisões nele, uma a uma

KDE kdeedu KGeography geografia mapas países

## Introdução

O &kgeography; é uma ferramenta de aprendizagem de geografia do &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).

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

Quando iniciar o &kgeography; pela primeira vez, ele perguntar-lhe-á para escolher um mapa com o qual iniciar.

Poderá filtrar a lista de mapas com o campo de texto Filtrar os Mapas. Basta escrever algumas letras no nome do mapa para restringir a lista a apenas algumas ocorrências.

Aqui está uma imagem do &kgeography; no primeiro arranque
Aqui está uma imagem do &kgeography; no primeiro arranque

Aqui foi escolhido o Canadá Foi escolhido o Canadá

Foi escolhido o 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;

Explorar o Mapa: se carregar com o &LMB; numa área do mapa, irá mostrar informações acerca dessa área; se carregar no pequeno ícone de informação do mapa, irá abrir a página do Wikipédia para essa divisão no navegador por omissão do sistema: Navegar no mapa

Navegar no mapa

Localização das Províncias ou Territórios: terá de indicar primeiro 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

Colocar as Províncias ou Territórios no Mapa: o cursor fica com a forma de uma província e você terá de o colocar no mapa: Colocar uma divisão no mapa

Colocar uma divisão no mapa

Províncias ou Territórios por 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

Capitais das Províncias ou Territórios: 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.

Províncias ou Territórios por Bandeira: é mostrada uma bandeira e terá de adivinhar a província a que pertence. a pergunta da bandeira

a pergunta da bandeira

Bandeiras das Províncias ou Territórios: é 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;. A funcionalidade de Ampliação Automática tornará o mapa o maior possível.

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

Existe outra ferramenta colorchecker.py, escrita por Albert Astals Cid. É necessário o PyQt4 para a executar. Basta corrê-la com o ficheiro .kgm como argumento (também necessita do ficheiro PNG do mapa na mesma pasta). Isto dir-lhe-á se algum pixel do mapa tem uma cor diferente que não esteja definida no ficheiro .kgm (descrição).

Por favor, leia também o tutorial para Adicionar mapas da página Web do &kgeography;.

### Ficheiro de descrição

O ficheiro da descrição é necessário e a sua extensão de ficheiro é `.kgm`. Deverá começar por !DOCTYPE kgeographyMap, seguida de 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.

- divisionsName e divisionsName: o nome geral das divisões deste mapa, isto é, Províncias, Estados, Países, etc.

- 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`, `allowClickFlagMode` 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 esta marca for igual a `allowClickFlagMode`, o &kgeography; irá perguntar a divisão no modo Carregar a Divisão no Mapa... e nos questionários relacionados com bandeiras, mas não nos outros modos de questionários. 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.

- falseCapital e falseCapital: Poderão existir vários pares de 'falseCapital', sendo usados para conter uma lista de respostas falsas para a questão da capital, em vez de escolher as respostas falsas entre as capitais de outras divisões.

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`. Não se esqueça de `não definir` a cor para qualquer Fronteira como sendo 0, 0, 0 em RGB. Torne-a algo do tipo 1, 1, 1 para que apareça um contorno da fronteira e coloca uma divisão no mapa.

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 &Albert.Astals.Cid.mail;, 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 `$`XDG_DATA_HOME`/share/apps/kgeography/`

- Colocar os ficheiros PNG da bandeira (se existirem) em `$`XDG_DATA_HOME`/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 `$`XDG_DATA_HOME``, escreva ``qtpaths` `--paths HomeLocation`` numa consola.

Use a ferramenta colorchecker.py das ferramentas auxiliares para verificar se alguma cor extra está definida no mapa e não está definida no ficheiro .kgm.

### 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 de selecção do mapa. Se escrever rapidamente as primeiras letras do mapa que procura, irá seleccionar a primeira correspondência.

&Ctrl;Q Ficheiro Sair

  Sai do &kgeography;

#### O Menu Ver

Ver Ampliação

  Vai para o modo de ampliação, desenhando depois um rectângulo para ampliar essa área do mapa

Ver Tamanho Original

  Repõe o mapa de volta no seu tamanho original, tal como definido no ficheiro do mapa. Se carregar com o &RMB; no modo ampliado, irá efectuar a mesma acção

Ver Ampliação Automática

  Coloca o mapa num modo de ampliação automático que ocupe o máximo de espaço possível ao dimensionar a janela do &kgeography;

Ver Mover

  Move o ecrã actual. Este item só estará activo se tiver efectuado uma ampliação no mapa.

#### O Menu Configuração

O &kgeography; tem o menu de Configuração normal do &kde;; para mais informações, leia a secção sobre o menu de Configuração dos Fundamentos do &kde;.

#### O Menu Ajuda

O &kgeography; tem um menu de Ajuda do &kde; predefinido, tal como se encontra descrito nos Fundamentos do &kde;, com dois itens adicionais:

Ajuda Aviso

  Mostra um aviso sobre a precisão dos mapas, bandeiras e traduções usadas no &kgeography;.

Ajuda Autor do Mapa

  Mostra o nome do autor que criou o mapa actual.

## Configuração

Alinhamento das Perguntas

  Define a posição das perguntas na janela; por omissão é Cima-esquerda.

Esperar pela Validação

  Se estiver activo, o utilizador terá de carregar em Aceitar depois de escolher uma resposta.

O Foco Segue o Rato

  Se estiver activo, ao carregar em Espaço, irá activar o botão sob o cursor do rato.

Cores das divisões do mapa

  Poderá escolher se deseja manter sempre as mesmas cores (por omissão) ou se deseja usar cores aleatórias: com esta opção, são atribuídas cores aleatórias às divisões no mapa. Isto ajuda o utilizador a focar-se e a aprender as formas da divisão e não as cores da divisão.

## Créditos e Licença

&kgeography;

Programa com 'copyright' 2004-2008 de Albert Astals Cid &Albert.Astals.Cid.mail;

Documentação com 'copyright' © 2005 de &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; 2008 Kushal Das kushaldas@gmail.com

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;
&documentation.index;