# El manual de &kgeography;

## Introducción

&kgeography; es una herramienta de geografía para &kde;. Le permitirá aprender acerca de las divisiones políticas de algunos países (divisiones, capitales o aquellas divisiones y sus banderas asociadas si hay alguna).

Los mapas disponibles en la versión actual son: África, Asia, Austria, Brasil, Canadá, China, Europa, Francia, Alemania, Italia, Italia por provincias, Norte y Centro América, Noruega, Polonia, Sudamérica, España, Estados Unidos y el mundo.

## Inicio Rápido con &kgeography;

Cuando iniciamos &kgeography; por primera vez, nos pide que escojamos un mapa para comenzar. He aquí un pantallazo de &kgeography; cuando arranca por primera vez He aquí una captura de pantalla de &kgeography; cuando arranca por primera vez

Vamos a escoger a Canadá Se ha escogido a Canadá Se ha escogido a Canadá

Y la ventana principal de &kgeography; aparece con el mapa de Canadá: ventana principal &kgeography; ventana principal &kgeography;

Usted puede entonces escoger que tipo de aprendizaje o prueba desea hacer a través del menú de la derecha: menú de &kgeography; menú de &kgeography;

Navegue por el mapa: si pulsa el &LMB; sobre un área del mapa mostrará información acerca de la misma: Busque el mapa Busque el mapa

Pulse en una división en el mapa: primero se le preguntará sobre cuántas preguntas desea. ¿Cuantas preguntas? ¿Cuantas preguntas?

Luego le pedirá que pulse sobre una provincia específica: Clic sobre una provincia Clic sobre una provincia

Cuando finalice todas las preguntas, se mostrará un diálogo de resultado con sus respuestas correctas e incorrectas: Sus resultados Sus resultados

Determine una división desde su capital: se le indica que busque el nombre de una provincia a lo largo de 4 opciones dando su capital: Determine una división a partir de su capital Determine una división a partir de su capital

Y los resultados son mostrados cuando la prueba finaliza: Sus resultados Sus resultados

Determinar la capital de una división política: Se da una capital y cuatro opciones para determinar a qué división política pertenece.

Determine la división a partir de una bandera: se muestra una bandera y debe buscar la provincia a la que pertenece. La pregunta de bandera La pregunta de bandera

Determine la bandera de una división: se da un nombre de provincia es, debiendo buscar la bandera correcta a través de cuatro opciones. Empareje la bandera con la provincia Empareje la bandera con la provincia

## Usar &kgeography;

&kgeography; muestra información acerca algunos países y evalúa sus conocimientos sobre esta información. Veamos una captura de pantalla de &kgeography; Captura de pantalla

### Más características de &kgeography;

&kgeography; también ofrece la posibilidad de ver una ampliación del mapa. Ampliación Ampliación Siempre es posible pulsar el &RMB; para volver al tamaño original (menú Tamaño original). Para movernos a lo largo y ancho del mapa podemos utilizar las barras de desplazamiento o el menú Mover que nos permitirá movernos utilizando el &LMB;.

## Como hacer mapas

En &kgeography;, un mapa tiene dos componentes: Uno es la imagen, mientras que el otro está formado por los datos correspondientes.

### Herramienta Ayudante

Aquí puede encontrar una herramienta confeccionada por Yann Verley que nos ayuda en la tarea de colorear los mapas para kgeography. En pocas palabras, este guión crea un archivo con extensión `.kgm` y un archivo con una lista de pares cada uno de los cuales consta de un color y una división. La idea es que, luego, creemos el mapa de acuerdo a la lista dada.

### Archivo de descrición

La extensión del archivo debe ser `.kgm`. En cuanto al formato XML, debe comenzar con `map` y terminar con `map`.

Cada etiqueta debería contener:

- `mapFile` y `mapFile`: el nombre del archivo (sin la ruta) correspondiente a la imagen del mapa, ⪚ «europe.png».

- `name` y `name`: el nombre del mapa, ⪚ «Europa».

- Una `division` y `division` para cada división en el mapa.

Cada división tiene estas etiquetas:

- `name` y `name`: el nombre de la división, ⪚ «Albania».

- `capital` y `capital`: el nombre de la capital de la división, ⪚ «Tirana».

- `ignore` y `ignore`: deben estar etiquetadas con `yes` si la división debe ser ignorada al consultar divisiones en el mapa. Si esta etiqueta está definida como `allowClickMode`, &kgeography; preguntará por la división solo en el modo «Pulsar división política en el mapa».

- `flag` y `flag`: el nombre archivo (sin ninguna ruta) que contiene la imagen de la bandera. ⪚ «albania.png». Esta etiqueta es opcional y no es necesaria para las divisiones que tengan la etiqueta `ignore` en `yes`.

- `color` y `color`: el color que la división tiene en el mapa.

El color está definido usando tres etiquetas:

- `red` y `red`: color rojo entre 0 y 255.

- `green` y `green`: color verde entre 0 y 255.

- `blue` y `blue`: color azul entre 0 y 255.

Es conveniente crear algunas falsas divisiones como «Water», «Frontera» o «Costa» y etiquetarlas de este modo: `ignore`; `yes`.

Todos los nombres (capitales y divisiones) se indican según se los denomine en inglés.

### Imagen del mapa

El proceso de creación del mapa es laborioso. El formato a utilizar es PNG. Pueden encontrarse algunos mapas en Cia Reference Maps. Para modificar los mapas deberemos utilizar una aplicación para la edición de imágenes. Por ejemplo, The Gimp o Kolourpaint.

### Banderas

Si utilizamos la etiqueta `flag`, se deben proporcionar los archivos correspondientes a las banderas en formato PNG y/o SVG y preferentemente a 300x200 pixels. Se pueden obtener banderas SVG en Sodipodi flags collection.

### ¿Como probar si funciona?

Antes de enviar el mapa a Albert tsdgeos@terra.es, debería confirmarse que no posee errores. Para conseguirlo debe hacer lo siguiente:

- Sitúe el archivo de imagen del mapa y su descripción en `$`TDEDIR`/share/apps/kgeography/`.

- Situar las imágenes PNG con las banderas (si es que las hay) en `$`TDEDIR`/share/apps/kgeography/flags/`.

Una vez hecho esto, debería ser posible abrir nuestro nuevo mapa desde &kgeography;.

En caso de no saber cuál es nuestro `$`TDEDIR``. Debemos escribir: ``tde-config` `--prefix`` en una consola.

### Mapa no político

¿Es posible confeccionar mapas físicos? Si, de alguna forma lo es: Ejemplo de como crear un mapa físico Ejemplo de como crear un mapa físico

El concepto de división puede ser extendido a una montaña o un río. Si bien muchas veces, estos elementos son demasiado pequeños como para poderlos marcar en el mapa, es posible crear marcas adicionales que funcionen como área de selección. En este ejemplo, el río tendría el área marrón y el color <20,76,34> como identificador.

## Referencia de órdenes

### La ventana principal de &kgeography;

#### El menú Archivo

&Ctrl;O Archivo Abrir mapa...

- Abre el diálogo para escoger un mapa.

&Ctrl;Q Archivo Salir

- Sale &kgeography;.

#### El menú Ver

Ver Ampliación

- Modo de ampliación.

Vista Tamaño Original

- Configura el mapa en su tamaño original.

Ver Mover

- Mueve el mapa actual.

#### El menú Preferencias

Preferencias Mostrar/ocultar barra de herramientas

- Muestra y oculta la barra de herramientas de &kgeography;.

Preferencias Configurar accesos rápidos...

- Configura los accesos rápidos de teclado para &kgeography;.

Preferencias Configurar barras de herramientas...

- Configura las barras de herramientas de &kgeography;.

#### El Menú Ayuda

&help.menu.documentation;

## Créditos y licencia

&kgeography;

Derechos de autor del programa. 2004-2005. Albert Astals Cid tsdgeos@terra.es.

Derechos de autor de la documentación. © 2005. &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;.

Jeffrey Steve Borbón Sanabriajeff_kerokid@yahoo.com.

&underFDL; &underGPL;

## Instalación

### Cómo obtener &kgeography;

&install.intro.documentation;

### Compilación e instalación

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