# Руководство пользователя &kgeography;

## Введение

&kgeography; — это инструмент &kde; для изучения географии. Он позволяет пополнять и проверять знания о политических границах некоторых стран (и также столицы и флаги при их наличии).

## Начало работы

При первом запуске &kgeography; спросит, с какой карты начать.

Чтобы отфильтровать список карт, воспользуйтесь текстовым полем Фильтр карт. Введите несколько первых букв названия карты, чтобы уменьшить список до нескольких совпадений.

Это снимок экрана &kgeography; при первом запуске Это снимок экрана &kgeography; при первом запуске

Выбор Канады: Выбрана Канада Выбрана Канада

Главное окно &kgeography; откроется с картой Канады: Главное окно &kgeography; Главное окно &kgeography;

В меню слева возможно выбрать, каким видом тестирования или обучения следует заняться: Меню &kgeography; Меню &kgeography;

«Исследовать карту»: при щелчке левой кнопки мыши в любом месте на карте будет показано описание этой области карты; если в появившейся подписи нажать на маленький значок информации, то откроется статья из Википедии об этой области в веб-браузере по умолчанию: Карта Карта

«Местоположение регионов»: сначала введите количество вопросов, на которые нужно будет ответить. Сколько вопросов Сколько вопросов

Затем потребуется нажимать на определённые регионы: Покажите регион на карте Покажите регион на карте

После того, как на все вопросы будут даны ответы, отобразятся результаты, в которых будут показаны правильные и неправильные ответы: Результаты Результаты

«Расположите регион на карте»: курсор мыши будет принимать форму одного из регионов, и его необходимо будет расположить на карте: Расположите регион на карте Расположите регион на карте

Угадать страну или регион по столице: Будет предлагаться 4 варианта ответа: Угадайте страну или регион по столице Угадайте страну или регион по столице

Результаты будут отображены после окончания теста: Результаты Результаты

Столицы: Угадайте столицу страны или региона. Даётся четыре варианта ответа и необходимо выбрать правильный. Как и в предыдущем случае, в конце будут показаны результаты.

«Регионы по флагу»: будет показан флаг, а пользователь должен найти на карте соответствующую ему страну или регион. Флаг страны Флаг страны

«Флаги регионов»: будет указано название страны или региона, а пользователь должен будет выбрать правильный флаг из четырёх предложенных. Сопоставьте флаг и область Сопоставьте флаг и область

## Использование &kgeography;

&kgeography; отображает информацию о некоторых странах и позволяет пользователю проверить свой уровень знания географии. Снимок экрана &kgeography; Снимок экрана

### Дополнительные возможности &kgeography;

Ещё одна особенность &kgeography; — это возможность масштабирования карты. Масштаб Масштаб Нажмите кнопку Масштаб и нарисуйте прямоугольник для масштабирования части карты. В режиме масштабирования щёлкните правой кнопкой мыши для возврата к оригинальному размеру карты (команда Оригинальный размер делает то же самое). Для перемещения по масштабированной карте используйте полосы прокрутки, клавиши со стрелками или колесо мыши, либо воспользуйтесь командой Перетащить, которая позволит сдвигать карту левой кнопкой мыши. Возможность Автоматическое масштабирование увеличит карту настолько, насколько возможно.

## Создание карт

Карта в &kgeography; состоит из двух файлов: один — это изображение с картой и второй — это её описание.

### Инструмент «Помощник»

Здесь находится инструмент (созданный Yann Verley), который помог создать карту Франции. Чтобы понять, как его использовать, запустите программу и ознакомьтесь со справочной информацией. Основное, что он делает — создаёт файл `.kgm` из обычного текстового файла и записывает файл с цветами, ассоциированными с каждой страной, позволяя пользователю заполнить карту.

Другой инструмент — colorchecker.py, автором которого является Albert Astals Cid. Для его работы требуется PyQt4. Запустите этот инструмент с именем файла `.kgm` в качестве аргумента (также потребуется файл карты в формате `.png`, расположенный в той же папке). Это позволит определить, имеет ли какой-либо пиксел на карте другой цвет, не определённый в файле (с описанием) `.kgm`.

Также обратитесь к обучающим материалам «Как добавлять карты» на сайте &kgeography;.

### Файл с описанием

Файл с описанием является обязательным, он имеет расширение `.kgm`. Файл должен начинаться с «`?xml version="1.0" encoding="utf-8"`», затем «`!DOCTYPE kgeographyMap`», далее иметь «`map`» и заканчиваться на «`map`».

Между этими тегами должны быть:

- `mapFile` и `mapFile`: имя файла (без пути к нему), содержащее изображение карты, например, `europe.png`.

- `name` и `name`: название карты, например, `Европа`.

- `divisionsName` и `divisionsName`: общее имя для всех стран и регионов на карте.

- `division` и `division` для всех стран и регионов на карте.

Для каждой страны или региона должны быть указаны следующие теги:

- `name` и `name`: название страны или региона, например, `Албания`.

- `capital` и `capital`: столица, например, `Тирана`.

- `ignore` и `ignore`: могут быть указаны значения `yes`, `allowClickMode`, `allowClickFlagMode` и `no`. Если этот тег имеет значение `yes`, то такая область будет проигнорирована при запросе областей на карте. Например, такая область не будет учитываться в упражнениях &kgeography;. Если тег имеет значение `allowClickMode`, &kgeography; будет запрашивать область в режиме Местоположение ..., а в других типах упражнений — нет. Установка значения `no` означает, что область будет представлена во всех режимах (просмотр и упражнения). Тег яаляется необязательным, поэтому если тега `ignore` нет, подразумевается, что он указан в режиме `no`. Например, `Алжир` имеет тег со значением `yes` для карты `Европа`, что означает, что `Алжир` не будет включён в состав упражнений для карты `Европа`.

- `flag` и `flag`: файл (без указания пути), содержащий флаг страны или региона, например, `albania.png`. Этот тег не нужен для областей, для которых тег `ignore` установлен в значении `yes`.

- `color` и `color`: цвет, которым будет закрашена страна или регион на карте.

- `falseCapital` и `falseCapital`: может быть любое количество пар `falseCapital`, они используются для создания списка неправильных ответов к вопросу о столицах.

Цвет задаётся с помощью трёх тегов:

- `red` и `red`: красный компонент цвета. Допустимы значения между 0 и 255.

- `green` и `green`: зелёный компонент цвета. Допустимы значения между 0 и 255.

- `blue` и `blue`: синий компонент цвета. Допустимы значения между 0 и 255.

Иногда бывает полезно создать 2 или 3 ложных страны или региона, таких как `Вода`, `Граница` и `Побережье` и присвоить им тег `ignore` со значением `yes`. Не устанавливайте параметр цвета 0,0,0 в RGB для `Границы`. Укажите значение, например, 1,1,1, чтобы граница отображалась при помещении любого объекта на карту.

Все названия (столицы, страны и регионы) должны быть на английском.

### Файл карты

Файл карты очень прост, но его создание — это трудоёмкий процесс. Он должен быть в формате PNG. Несколько карт для преобразования находятся на сайте Cia Reference Maps. Если ни одна из карт не подойдёт, загрузите политическую карту мира, сделайте снимок экрана и работайте дальше со снимком. Каждая область на карте должна иметь один и только один цвет. Для этого используйте программы для обработки изображений, такие как The Gimp и &kolourpaint;.

### Флаги

Если был использован тег `flag`, необходимо загрузить файл с флагом. Он должен быть в формате PNG и желательно также загрузить для него &SVG;-файл в разрешении 300x200. Флаги в таком формате почти для всех стран возможно найти в коллекции флагов Sodipodi.

### Проверка созданной карты

Перед отправкой карты Альберту на &Albert.Astals.Cid.mail; необходимо проверить её на отсутствие ошибок. Для этого сделайте следующее:

- Поместите описание карты и файлы изображений с картой в `$`XDG_DATA_HOME`/share/apps/kgeography/`

- Поместите файлы флагов в формате PNG(при их наличии) в `$`XDG_DATA_HOME`/share/apps/kgeography/flags/`

После этого удастся открыть карту в &kgeography;.

Если неизвестно, где находится `$`XDG_DATA_HOME``, введите ``qtpaths` `--paths HomeLocation`` в командной строке.

Используйте инструмент colorchecker.py из вспомогательных инструментов, чтобы проверить, не осталось ли на карте дополнительных цветов, не указанных в файле `.kgm`.

### Неполитические карты

Возможно ли создавать неполитические карты? Да. Пример создания неполитической карты Пример создания неполитической карты

Разумеется, концепция стран и регионов может быть расширена и на реки и горы. При создании карты имейте в виду, что в большинстве случаев река или гора будет меньше, чем область для нажатия, которую возможно задать. В данном примере река будет иметь такую область и цвет <20,76,34> в качестве идентификатора.

## Список команд

### Главное окно &kgeography;

#### Меню «Файл»

&Ctrl;O Файл Открыть карту...

- Открывает диалог выбора карты. При достаточно быстрой печати первых букв искомой карты приложение откроет первую же совпавшую карту.

&Ctrl;Q Файл Выход

- Закрывает &kgeography;.

#### Меню «Вид»

Вид Масштаб

- Переводит приложение в режим масштабирования, позволяя нарисовать прямоугольник для масштабирования части карты.

Вид Обычный размер

- Возвращает карту к оригинальному размеру, указанному в файле карты. Щелчок правой кнопки мыши в режиме масштабирования выполняет ту же функцию.

Вид Автоматический масштаб

- Включает автоматическое масштабирование карты, используя как можно больше свободного места при изменении размера окна &kgeography;.

Вид Перетащить

- Перетаскивает текущую карту. Эта функция включена только если карта масштабирована.

#### Меню «Настройка»

&kgeography; имеет стандартное для всех приложений &kde; меню Настройка. Более подробная информация о пунктах меню содержится в разделе Меню «Настройка» Основ &kde;.

#### Меню «Справка»

&kgeography; имеет стандартное для всех приложений &kde; меню Справка, как описано в Основах &kde; с двумя дополнительными пунктами:

Справка Оговорки

- Отображает оговорки о точности карт, флагов и переводов, используемых в &kgeography;.

Справка Автор карты

- Отображает имя автора, создвшего текущую карту.

## Настройка

Выравнивание вопросов

- Определяет расположение вопросов в окне, по умолчанию — Верхний левый угол.

Ждать подтверждения ответа

- Если эта функция включена, пользователю потребуется нажать кнопку Принять после выбора ответа.

Фокус следует за мышью

- Если эта функция включена, нажатие клавиши &Space; выберет вариант ответа, находящийся под указателем мыши.

Цвета областей

- Возможно выбрать, следует ли всегда сохранять одни и те же цвета (по умолчанию) или следует использовать случайные цвета: эта функция присваивает объектам на карте случайные цвета. Это помогает пользователю сосредоточиться на форме страны или штата, а не на цвете.

## Авторские права и лицензия

&kgeography;

Права на программу 2004-2008 Albert Astals Cid &Albert.Astals.Cid.mail;

Права на документацию © 2005 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; 2008 Kushal Das kushaldas@gmail.com

Перевод на русский — Владимир Давыдовtrotski@inbox.ru, Мария Шикуноваtranslation-team@basealt.ru

&underFDL; &underGPL;
&documentation.index;