# El manual de &kgeography;

## Introducción

&kgeography; es una herramienta de geografía de KDE. Este 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, Brazil, Canadá, China, Europa, Francia, Alemania, Italia, Italia por provincias,Norte y Centro América, Noruega, Polonia, Sudamérica, España, USA y el planisferio.

## 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ú a la derecha: menú de &kgeography; menú de &kgeography;

Busque el mapa con un clic &LMB; sobre un área del mapa mostrará información acerca del área: Busque el mapa Busque el mapa

Click en una división en el mapa: primero se le pregunta ¿Cuántas preguntas desea? ¿Cuantas preguntas? ¿Cuantas preguntas?

Luego le pedirá que de un clic sobre una provincia específica: Clic sobre una provincia Clic sobre una provincia

Cuando finalice todas las preguntas, un diálogo de resultado es mostrado 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 que división política pertenece.

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

Determine la bandera de una división: un nombre de provincia es dado y usted debe buscar la bandera correcta a través de cuatro opciones. Empareje la bandera con la provincia Empareje la bandera con la provincia

## Usando &kgeography;

&kgeography; muestra información acerca algunos países y evaluarse acerca esta información. He aquí algunos pantallazos de &kgeography; Pantallazos

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

&kgeography; también ofrece la posibilidad de ver una ampliación del mapa. Ampliación Ampliación Simpre es posible presionar &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

Se encuentra disponible una herramienta confeccionada por Yann Verley here 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 es 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` and `name`: el nombre de la división, ⪚ Albania.

- `capital` and `capital`: el nombre de la capital de la división, ⪚ Tirana.

- `ignore` y `ignore`: deben estar marcadas como `yes` si la división debe ser ignorada al consultar divisiones en el mapa. Si esta etiqueta esta marcada 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` and `green`: color verde entre 0 y 255.

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

Es conveniente crear algunas falsas divisiones como Water, Frontera o Costa y marcarlas 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 hacerlo,

- Se debe por el mapa y su descripción enimage file in `$`KDEDIR`/share/apps/kgeography/`

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

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

En caso de no saber cual es nuestro `$`KDEDIR``. Debemos escribir: ``kde-config` `--prefix`` in a 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 rio. 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 Comandos

### La ventana principal de &kgeography;

#### El menú Archivo

&Ctrl;O Archivo Abrir mapa...

- Abrir el diálogo para escoger un mapa

&Ctrl;Q Archivo Salir

- Salir &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

- Mover el mapa actual

#### El menú Preferencias

Preferencias Mostrar/Ocultar barra de herramientas

- Mostrar/Ocultar la barra de herramientas de &kgeography;

Preferencias Configurar accesos rápidos...

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

Preferencias Configurar barras de herramientas...

- Configurar las barras de herramientas de &kgeography;

#### El Menú Ayuda

&help.menu.documentation;

## Créditos y Licencia

&kgeography;

Copyright del programa 2004-2005 Albert Astals Cid tsdgeos@terra.es

Copyright de Documentación © 2005 Anne-Marie Mahfouf annma@kde.org

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;