# Підручник з &kgeography;

Anne-Marie
Mahfouf
&Anne-Marie.Mahfouf.mail;
Kushal
Das
kushaldas@gmail.com
Юрій
Чорноіван

    yurchor@ukr.net

Переклад українською
2005
&Anne-Marie.Mahfouf;
2008
Kushal Das
&FDLNotice;
25 січня 2009 року
0.5.9-10

&kgeography; — це інструмент для вивчення географії у &kde;. У поточній версії він має сім режимів використання:

- Перегляд карти з натисканням на територіях, щоб побачити їх назви, столиці і прапори

- Гра з вгадування за назвою території на карті

- Гра з вгадування за столицею території на карті

- Гра з вгадування за територією на карті столиці цієї території

- Гра з вгадування назви території на карті за її прапором

- Гра з вгадування прапору території на карті за її назвою

- Гра у заповнення порожньої карти територіями одна за одною

KDE
kdeedu
KGeography
географія
карти
країни

## Вступ

&kgeography; — інструмент з вивчення географії для &kde;. Ця програма надасть вам змогу вивчити адміністративний устрій деяких країн (території, столиці цих територій і відповідні прапори, якщо такі є).

## Початок роботи з &kgeography;

Коли ви запускаєте &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.

### Файл опису

Потрібен файл опису, суфіксом якого має бути сполучення літер `.kgm`. Його вміст має розпочинатися з `map` і завершуватися на `map`.

Між цими тегами у файлі мають бути:

- `mapFile` і `mapFile`: назва файла (без шляху до нього), у якому міститься зображення карти, наприклад europe.png.

- `name` і `name`: назва карти, наприклад Europe.

- `divisionsName` і `divisionsName`: загальна назва територій на цій карті, тобто, Provinces, States, Countries тощо.

- A `division` і `division` для кожної території на карті.

Кожна територія має такі теги:

- `name` і `name`: назва території, наприклад Albania.

- `capital` і `capital`: назва столиці території, наприклад Tirana.

- `ignore` і `ignore`: можна встановити у значення `yes`, `allowClickMode`, `allowClickFlagMode` і `no`. Якщо цей тег встановлено у значення `yes`, територію буде проігноровано під час тестів з територіями на карті. Тобто ця територія не існуватиме для режимів тестів у &kgeography;. Якщо цей тег встановлено у значення `allowClickMode`, &kgeography; питатиме про цю територію у режимі Розташування..., але не у інших режимах тестів. Якщо цей тег встановлено у значення `allowClickFlagMode`, &kgeography; запитуватиме про територію у режимі Розташування... і у режимах, пов’язаних з запитаннями про прапори, але не у інших режимах. Якщо встановити значення `no`, територія з’являтиметься у всіх режимах (перегляду і тестів). Це тег є допоміжним, якщо немає тегу `ignore`, буде вважатися, що його встановлено у значення `no`. Наприклад, Алжир має цей тег зі значенням `yes` на карті Європи, це означає, що Алжир не буде частиною жодного тесту, пов’язаного з картою Європи map.

- `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 псевдотериторії на зразок Water, Frontier і Coast і встановити для них тег `ignore` у значення `yes`. Не забудьте, що `не можна встановлювати` колір для Frontier у значення 0,0,0 палітри RGB. Будь ласка, виберіть для цього щось на зразок 1,1,1, щоб контури кордону завжди відображалися у тестах на розташування територій на карті.

Всі назви (столиць та регіонів) слід писати англійською.

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

Файл карти є простим, але його створення досить трудомістке. Його слід записувати у форматі PNG. Деякі карти для такого перетворення можна знайти у Довідкових картах ЦРУ. Якщо жоден з цих файлів не відповідає вашим потребам, ви можете звантажити політичну карту світу, зробити її знімок і працювати з ним. Кожній території на карті має відповідати один і лише один колір. Щоб досягти цього, ви можете скористатися програмами для обробки зображень на зразок The Gimp і Kolourpaint.

### Прапори

Якщо ви використовувати тег `flag`, вам слід додати і файли прапорів. Їх слід перевести у формат PNG, найкраще якщо вони будуть розміром 300x200 пікселів і для кожного з них існуватиме SVG-відповідник. Прапори майже всіх країн і деяких інших територій у форматі SVG ви зможете знайти у Колекції прапорів Sodipodi.

### Як перевірити

Перш ніж надсилати вашу карту Альбертові за адресою tsdgeos@terra.es, вам слід перевірити її на відсутність помилок. Щоб виконати перевірку, зробіть так:

- Розмістіть опис карти і файл зображення карти у `$`KDEDIR`/share/apps/kgeography/`

- Розмістіть файли прапорів (якщо такі є) у форматі PNG у `$`KDEDIR`/share/apps/kgeography/flags/`

Після цього ви повинні мати змогу відкрити вашу карту за допомогою &kgeography;.

Якщо ви не знаєте де знаходиться ваша тека `$`KDEDIR``, виконайте команду ``kde4-config` `--prefix`` з командної оболонки.

Для того, щоб перевірити чи не залишилося на карті додаткових кольорів, які не визначено у файлі .kgm, скористайтеся інструментом colorchecker.py з допоміжних інструментів.

### Не політичні карти

Чи можна створювати не політичні карти? Звичайно, так! Приклад створення не політичної карти Приклад створення не політичної карти

Звичайно, концепцію територій можна поширити на річку або гору. Під час створення карти пам’ятайте, що зазвичай річка і гора на картах замалі для простого наведення на них вказівника миші, отже, вам доведеться їх трохи розширити. У цьому прикладі річка має брунатний колір з компонентами<20,76,34>.

## Довідка щодо команд

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

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

&Ctrl;O Файл Відкрити карту...

  Відкрити діалогове вікно вибору карти

&Ctrl;Q Файл Вийти

  Завершує роботу &kgeography;

#### Меню Перегляд

Перегляд Збільшити

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

Перегляд Початковий розмір

  Встановлює початковий розмір карти

Перегляд Автоматичний Масштаб

  Встановлює масштаб карти автоматично, щоб використати якомога більше простору

Перегляд Пересунути

  Пересуває поточну карту. Цей пункт буде увімкнено лише за достатнього збільшення карти.

#### Меню Параметри

Параметри Показати пенал

  Показати/Сховати панель інструментів &kgeography;.

Параметри Налаштувати скорочення...

  Налаштувати прив’язку клавіш до дій у &kgeography;.

Параметри Налаштувати пенали...

  Налаштувати панель інструментів &kgeography;.

#### Меню Довідка

&kgeography; має типову Довідку &kde;, як це описано нижче, з двома додатковими елементами:

Довідка Достовірність

  Показує повідомлення про точність карт, прапорів та перекладів, використаних у &kgeography;.

Довідка Автор карти

  Показує ім’я автора, який створив поточну карту.

Серед типових пунктів Довідки &kde;:

&help.menu.documentation;

## Подяки і ліцензія

&kgeography;

Авторські права на програму Albert Astals Cid tsdgeos@terra.es, ©2004–2008

Авторські права на документацію Copyright © 2005 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; 2008 Kushal Das kushaldas@gmail.com

Юрій Чорноіванyurchor@ukr.net

&underFDL; &underGPL;

## Встановлення

### Як отримати &kgeography;

&install.intro.documentation;

### Збирання і встановлення

&install.compile.documentation;

&documentation.index;