# El manual de &kgeography;

## Introducción

&kgeography; es una herramienta de aprendizaje de geografía para &kde;. Le permite aprender las divisiones políticas de algunos países (divisiones, capitales de dichas divisiones y sus banderas asociadas, si existen).

## Inicio Rápido con &kgeography;

Cuando iniciamos &kgeography; por primera vez, nos pide que escojamos un mapa para comenzar.

Puede filtrar la lista de mapas usando el campo de texto Filtrar mapas. Solo necesita introducir las primeras letras del nombre del mapa para reducir el contenido de la lista a varias coincidencias.

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;

Explorar mapa: al pulsar el &LMB; sobre un área del mapa mostrará información sobre esta área; si pulsa en el icono pequeño Información de la ventana emergente, se abrirá la página de la Wikipedia para esta división en el navegador predeterminado del sistema: Busque el mapa Busque el mapa

Localización de provincias o territorios: primero se le preguntará sobre cuántas preguntas desee. ¿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

Colocar provincias o territorios en el mapa: el cursor toma la forma de una provincia y debe situarla en el mapa: Situar una división en el mapa Situar una división en el mapa

Provincias o territorios por capital: se le pedirá que encuentre el nombre de una provincia a elegirá a partir de 4 capitales dadas: 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

Capitales de provincias y territorios: Se da una capital y cuatro nombres de provincias y debe elegir la correcta. Al igual que antes, se muestra un diálogo con el resultado.

Provincias o territorios por bandera: se muestra una bandera y debe encontrar la provincia a la que pertenece. La pregunta de bandera La pregunta de bandera

Banderas de provincias y territorios: se da un nombre de provincia es, debiendo encontrar 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;

Otra funcionalidad de &kgeography; es la posibilidad de ver una ampliación del mapa. Ampliación Ampliación Puede pulsar Ampliar y a continuación dibujar un rectángulo para ampliar esta parte del mapa. En el modo de ampliación siempre puede pulsar el &RMB; para volver al tamaño original (la acción Tamaño original tiene el mismo efecto). Utilice las barras de desplazamiento, las teclas delas flechas o la rueda del ratón para moverse por todo el mapa ampliado o utilice la acción Mover que le permitirá arrastrar el mapa utilizando el &LMB;. La funcionalidad Ampliación automática hará el mapa tan grande como sea posible

## 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 (creada por Yann Verley) que le resultó de ayuda con el mapa de Francia. Para saber cómo se usa, ejecútela y lea el mensaje de ayuda. Básicamente, crea un archivo con extensión `.kgm` a partir de un archivo de texto sin formato, y un archivo con los colores que ha asignado a cada división, de forma que pueda rellenar el mapa según estos colores.

Existe otra herramienta, colorchecker.py, escrita por Albert Astals Cid. Necesita PyQt4 para ejecutarla. Solo tiene que ejecutarla con el nombre de archivo `.kgm` como argumento (también necesita que el archivo `.png` del mapa esté en la misma carpeta). Esta herramienta le indicará si algún píxel del mapa tiene un color diferente a los definidos en el archivo (de descripción) `.kgm`.

Lea también el tutorial Cómo añadir mapas en el sitio web de &kgeography;.

### Archivo de descripción

El archivo de descripción es necesario y su extensión debe ser `.kgm`. Debe comenzar con `?xml version="1.0" encoding="utf-8"`, y luego `!DOCTYPE kgeographyMap`, seguido de `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, como «`europe.png`».

- `name` y `name`: el nombre del mapa, como «`Europe`».

- `divisionsName` y `divisionsName`: el nombre general de las divisiones de este mapa; es decir, provincias, estados, países, etc.

- 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, como «`Tirana`».

- `ignore` y `ignore`: deben estar fijadas a `yes`, `allowClickMode`, `allowClickFlagMode` o `no`. Si esta etiqueta tiene el valor `yes`, la división será ignorada cuando se pregunten divisiones del mapa. Es como si la división no existiera en los modos de preguntas de &kgeography;. Si esta etiqueta vale `allowClickMode`, &kgeography; preguntará por la división en el modo Ubicación de…, pero no en otros modos de preguntas. Si la etiqueta vale `allowClickFlagMode`, &kgeography; preguntará por la división en el modo Ubicación de… y en las preguntas relacionadas con la bandera, pero no en otros modos de preguntas. Si fija el valor de esta etiqueta a `no`, se tendrá en cuenta la división en todos los modos (tanto de exploración como de preguntas). Esta etiqueta es opcional; cuando no existe la etiqueta `ignore` significa que tiene el valor `no`. Por ejemplo, «`Algeria`» tiene esta etiqueta con el valor `yes` en el mapa de «`Europe`», lo que significa que «`Algeria`» no formará parte de las preguntas del mapa de «`Europe`».

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

- `blurredflag` y `blurredflag`: el archivo (sin ruta) que contiene la bandera borrosa de la división, como «`blurred_albania.png`». Esta etiqueta es opcional. Se debe usar en situaciones donde la banderacontiene escrito el nombre de la división a la que pertenece. Esto puede hacer que el juego de adivinar la bandera sea demasiado fácil, por lo que se recomienda que exista una versión de la bandera con el texto borroso.

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

- `falseCapital` y `falseCapital`: puede existir cualquier número de parejas `falseCapital`, que se usan para proporcionar una lista de respuestas falsas a la pregunta sobre capital en lugar de escoger las respuestas falsas de entre el resto de capitales de divisiones.

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 dos o tres divisiones falsas como «`Water`», «`Frontier`» o «`Coast`» y fijar su etiqueta `ignore` con el valor `yes`. Recuerde `no fijar` el color de ninguna «`Frontier`» con el valor RGB 0,0,0. Use algún valor como 1,1,1 para que aparezca el contorno del borde al colocar cualquier división en el mapa.

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

### Imagen del mapa

El archivo del mapa es bastante sencillo, aunque laborioso de crear. Debe estar en formato PNG. Puede encontrar algunos mapas en los mapas de referencia de la Cia. Si no encuentra ningún mapa que se ajuste a sus necesidades, puede descargar el mapa político del mundo, hacer una captura de pantalla y trabajar sobre ella. Cada división del mapa debe tener un único color. Para ello puede usar programas de edición de imágenes como The Gimp o &kolourpaint;.

### Banderas

Si se utiliza la etiqueta `flag`, se deben proporcionar los archivos correspondientes a las banderas en formato PNG preferentemente a 300x200 pixels y mejor si se proporciona un archivo &SVG;. Se pueden obtener banderas &SVG; de la mayor parte de los paises del mundo y de algunas otras divisiones en las colecciones de banderas de Sodipodi.

Como se dijo con anterioridad, se recomienda que proporcione archivos de banderas borrosas para las que contienen el nombre escrito de la división. A los archivos de banderas borrosas se les aplican los mismos requisitos que a los de banderas normales. Aunque no existe ninguna convención para los archivos borrosos, recomendamos que se guarden con el mismo nombre que el de la bandera original usando el prefijo `blurred_`, como «`blurred_albania.png`».

### ¿Como probar si funciona?

Antes de enviar el mapa a Albert &Albert.Astals.Cid.mail;, debería confirmar que no contiene errores. Para ello debe hacer lo siguiente:

- Coloque el archivo de imagen del mapa y su descripción en `$`XDG_DATA_HOME`/share/apps/kgeography/`

- Coloque los archivos PNG de las banderas (si existieran) en `$`XDG_DATA_HOME`/share/apps/kgeography/flags/`

Una vez hecho esto, debería poder abrir el nuevo mapa en &kgeography;.

Si desconoce cuál es su `$`XDG_DATA_HOME``, escriba ``qtpaths` `--paths HomeLocation`` en una consola.

Use la herramienta colorchecker.py de las herramientas auxiliares para comprobar si existe algún color adicional en el mapa que no esté definido en el archivo `.kgm`.

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

#### Menú Archivo

&Ctrl;O Archivo Abrir mapa…

- Abra el diálogo para elegir el mapa. Si teclea suficientemente rápido las primeras letras del mapa que está buscando, se seleccionará el primer mapa que coincida.

&Ctrl;Q Archivo Salir

- Sale &kgeography;.

#### Menú Ver

Ver Ampliación

- Entra en el modo de ampliación, en el que puede dibujar un rectángulo para ampliar una parte del mapa.

Vista Tamaño original

- Establece el tamaño del mapa a su valor original, tal como está definido en el archivo del mapa. Un clic del &RMB; en una vista en la que se haya modificado el tamaño realiza la misma acción.

Ver Ampliación automática

- Configura el mapa con cambio de tamaño automático, usando tanto espacio como sea posible al cambiar el tamaño de la pantalla de &kgeography;.

Ver Mover

- Mueve el mapa actual. Este elemento solo está activado si ha ampliado el mapa.

#### El menú Preferencias

&kgeography; tiene las opciones de menú de Preferencias habituales en &kde;. Para obtener más información, consulte la sección sobre el Menú Preferencias de Aspectos básicos de &kde;.

#### Menú Ayuda

&kgeography; tiene un menú Ayuda predeterminado de &kde;, tal y como se describe en Aspectos básicos de &kde; con dos entradas adicionales:

Ayuda Renuncia

- Muestra una renuncia de responsabilidades sobre la precisión de los mapas, las banderas y las traducciones usadas en &kgeography;.

Ayuda Autor del mapa

- Muestra el nombre del autor que ha creado el mapa actual.

## Configuración

Alineación de preguntas

- Determina la posición de las preguntas en la pantalla. De manera predeterminada, es Arriba, a la izquierda.

Esperar validación

- Si esta opción está activada, el usuario tendrá que pulsar Aceptar después de seleccionar una respuesta

El foco sigue al ratón

- Si esta opción está activada, al pulsar &Space;, se activará el botón situado bajo el puntero del ratón.

Colores de las divisiones del mapa

- Puede elegir si desea mantener siempre los mismos colores (opción predeterminada) o si desea utilizar colores aleatorios: con esta opción, se asignan colores aleatorios a las divisiones del mapa. Esto ayuda al usuario a centrarse y a aprender las formas de las divisiones y no los colores.

## Créditos y licencia

&kgeography;

Copyright del programa 2004-2008: Albert Astals Cid &Albert.Astals.Cid.mail;.

Copyright de la documentación © 2005 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; 2008 Kushal Das kushaldas@gmail.com

Traducido por Rocío Gallego traducciones@rociogallego.com, Jeffrey Steve Borbón Sanabria jeff_kerokid@yahoo.com y Eloy Cuadra ecuadra@eloihr.net.

&underFDL; &underGPL;
&documentation.index;