El manual de KGeography

# El manual de KGeography

Anne-Marie Mahfouf `<annma@kde.org>`

Kushal Das `<kushaldas@gmail.com>`

Traducción: Rocío Gallego
: Jeffrey Borbón Sanabria
revisión Aplicaciones 20.12 (2020-12-22)

Copyright © 2005 Anne-Marie Mahfouf

Copyright © 2008 Kushal Das

Aviso Legal

KGeography es una herramienta de aprendizaje de geografía para KDE. En la actualidad cuenta con siete modos de uso:

- Navegar por el mapa pulsando sobre las divisiones para ver su nombre, capital y bandera

- El juego le mostrará el nombre de un mapa de división y tendrá que pulsar sobre él.

- El juego le muestra una capital y debe adivinar la división a la que pertenece.

- El juego le muestra una división y debe adivinar su capital.

- El juego muestra una bandera de un mapa de división y debe adivinar su nombre.

- El juego le indica el nombre de un mapa de división y debe adivinar su bandera.

- El juego le muestra un mapa vacío y deberá colocar las divisiones una a una

Capítulo 1. Introducción
Introducción

# Capítulo 1. 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).

Capítulo 2. Inicio Rápido con KGeography
Inicio Rápido con KGeography

# Capítulo 2. Inicio Rápido con KGeography

Cuando iniciamos KGeography por primera vez, nos pide que escojamos un mapa para comenzar.

### Sugerencia

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.

Vamos a escoger a Canadá

Y la ventana principal de KGeography aparece con el mapa de Canadá:

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

Explorar mapa: al pulsar el botón izquierdo del ratón 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:

Localización de provincias o territorios: primero se le preguntará sobre cuántas preguntas desee.

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

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

Colocar provincias o territorios en el mapa: el cursor toma la forma de una provincia y debe situarla 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:

Y los resultados son mostrados cuando la prueba finaliza:

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.

Banderas de provincias y territorios: se da un nombre de provincia es, debiendo encontrar la bandera correcta a través de cuatro opciones.

Capítulo 3. Usar KGeography
Usar KGeography

# Capítulo 3. Usar KGeography

KGeography muestra información acerca algunos países y evalúa sus conocimientos sobre esta información.

## Más características de KGeography

Otra funcionalidad de KGeography es la posibilidad de ver una ampliación del mapa.

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 botón derecho del ratón 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 botón izquierdo del ratón. La funcionalidad Ampliación automática hará el mapa tan grande como sea posible

Capítulo 4. Como hacer mapas
Como hacer mapas

# Capítulo 4. 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`.

### Sugerencia

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

Archivo de descripción
Archivo de descripción

## 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, por ejemplo «`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.

### Sugerencia

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.

### Importante

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

Imagen del mapa
Imagen del mapa

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

## 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?
¿Como probar si funciona?

## ¿Como probar si funciona?

Antes de enviar el mapa a Albert `(aacid AT kde.org)`, 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.

### Sugerencia

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
Mapa no político

## Mapa no político

¿Es posible confeccionar mapas físicos? Si, de alguna forma lo es:

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.

Capítulo 5. Referencia de órdenes
Referencia de órdenes

# Capítulo 5. Referencia de órdenes

## La ventana principal de KGeography

### Menú Archivo

Archivo → Abrir mapa… (Ctrl+O)

  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.

Archivo → Salir (Ctrl+Q)

  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 botón derecho del ratón 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.

Capítulo 6. Configuración
Configuración

# Capítulo 6. 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 Espacio, 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.

Capítulo 7. Créditos y licencia
Créditos y licencia

# Capítulo 7. Créditos y licencia

KGeography

Copyright del programa 2004-2008: Albert Astals Cid `(aacid AT kde.org)`.

Copyright de la documentación (c) 2005 Anne-Marie Mahfouf `(annma AT kde.org)` 2008 Kushal Das `(kushaldas AT gmail.com)`

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

Esta documentación está sujeta a los términos de la Licencia de Documentación Libre GNU.

Este programa está sujeto a los términos de la Licencia Pública General GNU.