# Підручник з &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`.

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

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

Потрібен файл опису, суфіксом якого має бути сполучення літер `.kgm`. Його вміст має розпочинатися з `?xml version="1.0" encoding="utf-8"`, продовжуватися `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`. Наприклад, `Algeria` має цей тег зі значенням `yes` на карті `Europe`, це означає, що `Algeria` не буде частиною жодного тесту, пов’язаного з картою `Europe` map.

- `flag` і `flag`: файл (без шляху до нього), у якому міститься зображення прапору території, наприклад `albania.png`. Цей тег є необов’язковим. Не потрібен для територій, чий тег `ignore` встановлено у значення `yes`.

- `blurredflag` і `blurredflag`: файл (без шляху до нього), у якому міститься зображення розмитого прапору території, наприклад `blurred_albania.png`. Цей теґ є необов’язковим. Ним слід користуватися у випадках, коли на прапорі є напис із назвою території. Такі написи роблять вгадування надто простим. Для таких прапорів варто робити розмиту версію, де не можна розібрати текст.

- `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.

Як ми вже зазначали вище, ми будемо раді наданим вами файлам розмитих прапорів для прапорів, на яких написано назву частини карти. Файлів розмитих прапорів стосуються ті самі вимоги, що і файлів звичайних прапорів. Хоча немає загальноприйнятих умов щодо назв файлів розмитих зображень, ми рекомендуємо зберігати їх із назвою початкового файла з префіксом `blurred_`, наприклад `blurred_albania.png`

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

Перш ніж надсилати вашу карту Альбертові за адресою &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`` з командної оболонки.

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

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

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

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

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

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

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

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

- Відкрити діалогове вікно вибору карти. Якщо ви достатньо швидко введете початкові літери назви карти, буде вибрано першу з відповідних карт.

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

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

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

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

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

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

- Встановлює початковий розмір карти, встановлений у файлі карти. Клацання правою кнопкою миші у режимі змінено масштабу призначено для виконання тієї самої дії.

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

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

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

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

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

У &kgeography; передбачено типові пункти меню Параметри &kde;. Щоб дізнатися більше, ознайомтеся з розділом, присвяченим меню «Параметри» підручника з основ роботи у &kde;.

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

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

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

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

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

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

## Налаштування

Вирівнювання питання

- Визначає розташування панелі питання у вікні. Типовим розташуванням є Вгору і ліворуч.

Очікувати на підтвердження

- Якщо позначено, користувачеві доведеться натискати кнопку Прийняти після вибору відповіді.

Фокус слідує за вказівником

- Якщо позначено, натискання клавіші Пробіл перемикатиме стан кнопки під вказівником миші.

Кольори областей на карті

- Ви можете вибрати між декількома варіантами: завжди використовувати ті самі кольори (типовий) або використати випадкові кольори. За допомогою цього пункту можна призначити різним областям на карті випадкові кольори. Це допомагає користувачеві зосередитися на вивченні форм областей, а не їхніх кольорів.

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

&kgeography;

Авторські права на програму Albert Astals Cid &Albert.Astals.Cid.mail;, 2004–2008

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

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

&underFDL; &underGPL;
&documentation.index;