# Podręcznik &kgeography;

## Wprowadzenie

&kgeography; to program do uczenia się geografii, pracujący w KDE. Pomoże Ci nauczyć się podziałów terytorialnych niektórych ziem (obszarów, stolic tych obszarów i ich flag, jeśli jakieś posiadają).

## Szybki start

Po pierwszym uruchomieniu, &kgeography; poprosi Cię o wybranie mapy do wyświetlenia. &kgeography; po pierwszym uruchomieniu &kgeography; po pierwszym uruchomieniu

W naszym przykładzie wybraliśmy Kanadę Kanada została wybrana Kanada została wybrana

Następnie zostało wyświetlone główne okno &kgeography; z mapą Kanady: Okno główne &kgeography; Okno główne &kgeography;

Możesz wybrać sposób nauki lub testu z menu po lewej stronie: Menu &kgeography; Menu &kgeography;

Przeglądaj mapę: kliknięcie lewym przyciskiem na obszar mapy wyświetli informacje na temat klikniętego obszaru. Kliknięcie małej ikonki w dymku otworzy stronę Wikipedii o wybranym obszarze w domyślnej przeglądarce: Przeglądaj mapę Przeglądaj mapę

Położenie prowincji lub terytoriów - program zapyta, na ile pytań chcesz odpowiedzieć Ile pytań sobie życzysz? Ile pytań sobie życzysz?

Następnie jesteś proszony o kliknięcie na odpowiednim miejscu: Kliknij na Kliknij na

Gdy odpowiesz na wszystkie pytania, wyświetlony zostanie rezultat, zawierający informacje o Twoich poprawnych i błędnych odpowiedziach: Twoje odpowiedzi Twoje odpowiedzi

Prowincje lub terytoria na mapie - kursor myszy zostaje podmieniony na kształt obiektu, który musisz odpowiednio umieścić na mapie: Umieść obszar na mapie Umieść obszar na mapie

Prowincje lub terytoria na podstawie stolicy - jesteś proszony/proszona o wybór nazwy obszaru z 4 podanych możliwości na podstawie nazwy jego stolicy: Podaj nazwę obszaru, znając jego stolicę Podaj nazwę obszaru, znając jego stolicę

Po zakończeniu testu, wyświetlone zostaną Twoje rezultaty: Twoje odpowiedzi Twoje odpowiedzi

Stolice prowincji lub terytoriów - na podstawie nazwy stolicy musisz wybrać z czterech propozycji właściwy obszar. Na końcu oczywiście wyświetlony zostanie rezultat Twoich odpowiedzi.

Prowincje lub terytoria na podstawie flag - zostaje wyświetlona flaga, którą musisz przyporządkować do odpowiedniego obszaru. pytanie o flagę pytanie o flagę

Flagi prowincji lub terytoriów - podana zostaje nazwa obszaru, a Ty musisz wskazać jego flagę, wybierając z czterech możliwości. zaznacz flagę obszaru zaznacz flagę obszaru

## Użytkowanie &kgeography;

&kgeography; wyświetla informacje o niektórych terenach i odpytuje Cię z tych informacji. Oto zrzut ekranu &kgeography; Zrzut ekranu

### Więcej funkcji &kgeography;

Inną funkcją &kgeography; jest możliwość przybliżenia mapy. Przybliżenie Przybliżenie Możesz wcisnąć przycisk Zoom po czym narysować prostokąt, aby przybliżyć wybrany obszar. Gdy mapa jest przybliżona, możesz nacisnąć prawy przycisk myszy, aby powrócić do poprzedniego rozmiaru (polecenie Pierwotny rozmiar powoduje to samo). Użyj pasków przewijania, przycisków strzałek lub kółka myszy w celu poruszania się po zbliżonej mapie lub użyj polecenia Przemieść, które pozwoli na poruszanie mapą przy użyciu lewego przycisku myszy. Polecenie Automatyczne powiększenie powiększy mapę na tyle, na ile pozwala na to okno programu.

## Jak tworzyć mapy

Mapa w &kgeography; jest wykonana z dwóch plików, jeden jest obrazkiem, zawierającym mapę, a drugi jej opisem.

### Narzędzie pomocnicze

Tutaj możesz znaleźć narzędzie (autorstwa Yanna Verleya), które przydało mu się do stworzenia mapy Francji. Żeby nauczyć się jego obsługi, uruchom go i przeczytaj komunikat pomocy. Podstawową zasadą działania jest utworzenie pliku `.kgm` ze zwykłego pliku tekstowego, a także pliku z kolorami przyporządkowanymi do każdego obszaru. Stosując się do nich, możesz utworzyć mapę.

Istnieje także inny program colorchecker.py napisany przez Alberta Astalsa Cida. Do działania potrzebuje PyQt4. Jako argument uruchomienia podaj nazwę pliku .kgm (mapa w formacie PNG musi się znajdować w tym samym katalogu). Program sprawdzi, czy któryś z kolorów na mapie różni się od tych zdefiniowanych w pliku opisu (kgm).

### Plik opisu

Plik opisu jest niezbędny, posiada rozszerzenie `.kgm` i powinien zaczynać się od `map`, a kończyć na `map`.

W wymienionych wyżej znacznikach powinno być wpisane:

- `mapFile` i `mapFile`: nazwa pliku (bez ścieżek dostępowych), zawierającego obrazek mapy, ⪚ europe.png.

- `name` i `name`: nazwa mapy, ⪚ Europe (w j. angielskim).

- `divisionsName` i `divisionsName`: nazwa dla każdego obszaru na mapie, do obszarów zaliczają się prowincje, stany, kraje, itd.

- `division` i `division` dla każdego obszaru na mapie.

Każdy obszar posiada następujące znaczniki:

- `name` i `name`: nazwa obszaru, ⪚ Albania.

- `capital` i `capital`: nazwa stolicy obszaru, ⪚ Tirana.

- `ignore` i `ignore`: mogą zostać ustawione na `yes`, `allowClickMode`, `allowClickFlagMode` i `no`. Jeśli ten tag zostanie ustawiony na `yes`, obszar zostanie zignorowany podczas pytania użytkownika o obszary na mapie, czyli tak jakby nie istniał w quizach &kgeography;. Jeśli tag zostanie ustawiony na `allowClickMode`, &kgeography; zapyta o obszar w trybie odgadywania położenia, ale nie w trybach quizu. Jeśli tag zostanie ustawiony na `allowClickFlagMode`, &kgeography; zapyta o obszar w trybie odgadywania położenia i w quizach związanych z flagami, ale nie w innych. Ustawienie tego tagu na `no` oznacza, że obszar pojawi się w każdym trybie (przeglądania mapy i quizów). Tag `ignore` jest opcjonalny i gdy go nie ma to tak, jakby był ustawiony na `no`. Na przykład Algeria ma ten tag ustawiony na `yes` na mapie Europy, co oznacza, że Algeria nie będzie przedmiotem w quizach dotyczących mapy Europy.

- `flag` i `flag`: plik (bez ścieżki dostępu), zawierający flagę obszaru, np. albania.png. Ten znacznik jest opcjonalny. Niepotrzebny dla obszarów, których znacznik `ignore` jest ustawiony na `yes`.

- `color` i `color`: kolor obszaru na mapie

- `falseCapital` i `falseCapital`: możesz wpisać dowolną liczbę tagów falseCapital, służą one do wypisania listy fałszywych odpowiedzi do pytania o stolicę, zamiast podania stolic innych obszarów.

Kolor jest zdefiniowany przy użyciu trzech znaczników:

- `red` i `red`: czerwona składowa koloru. Poprawne wartości zawierają się od 0 do 255.

- `green` i `green`: zielona składowa koloru. Poprawne wartości zawierają się od 0 do 255.

- `blue` i `blue`: niebieska składowa koloru. Poprawne wartości zawierają się od 0 do 255.

Można także utworzyć 2 lub 3 fałszywe obszary, jak np. Water (woda), Frontier (granica) i Coast (wybrzeże) i ustawić dla nich znacznik `ignore` na `yes`. Pamiętaj, aby `nie ustawiać` koloru dla Frontier (zewnętrznej granicy) na 0,0,0 (w notacji RGB). Użyj raczej podobnego koloru np. 1,1,1, tak aby wewnętrzne granice obszarów różniły się od zewnętrznej granicy.

Wszystkie nazwy obszarów i stolic muszą być napisane w języku angielskim.

### Plik mapy

Stworzenie pliku mapy jest zadaniem całkiem prostym, ale mozolnym. Mapa musi być w formacie PNG. Możesz znaleźć kilka map na Cia Reference Maps. Jeśli nie znajdziesz tam odpowiedniej, możesz ściągnąć mapę polityczną świata, zrobić jej zrzut i tworzyć na jego podstawie. Każdy obszar na mapie powinien posiadać jeden i tylko jeden kolor. Aby to osiągnąć, możesz użyć programów do obróbki zdjęć, jak np. The Gimp czy Kolourpaint.

### Flagi

Jeśli użyłeś(aś) znacznika `flag`, musisz dostarczyć odpowiednie pliki z flagami. Muszą być one w formacie PNG. Najlepiej w rozdzielczości 300x200 pikseli, wraz z odpowiednim plikiem SVG. Flagi prawie wszystkich krajów i niektórych obszarów możesz ściągnąć w formacie SVG z kolekcji flag programu Sodipodi.

### Procedura sprawdzania

Zanim wyślesz swoją mapę do Alberta tsdgeos@terra.es, musisz ją przetestować na okoliczność występowania błędów. Aby to zrobić,

- skopiuj plik opisu i plik obrazu mapy do `$`KDEDIR`/share/apps/kgeography/`

- skopiuj pliki flag w formacie PNG (o ile musisz) do `$`KDEDIR`/share/apps/kgeography/flags/`

Po wykonaniu tych czynności, w &kgeography; powinna pojawić się Twoja mapa.

Jeśli nie wiesz, gdzie znajduje się katalog `$`KDEDIR``, wpisz w powłoce ``kde4-config` `--prefix``.

Aby sprawdzić, czy na mapie nie ma jeszcze jakichś kolorów niezdefiniowanych w pliku .kgm, użyj narzędzia colorchecker.py.

### Mapy niepolityczne

Czy możliwe jest tworzenie map, które nie pokazują podziału politycznego? Tak! Przykład, jak utworzyć niepolityczną mapę Przykład, jak utworzyć niepolityczną mapę

Oczywiście koncepcja obszarów może być rozszerzony do rzek czy gór. Podczas tworzenia mapy pamiętaj, że w większości przypadków rzeka czy góra będą zbyt małymi obiektami, żeby na nie klikać. Musisz więc dodać dodatkowy obszar dookoła obiektu, który będzie reagował na kliknięcia. W tym przykładzie rzeka będzie miała obszar koloru kasztanowego i kolor <20,76,34> jako jej identyfikator.

## Opis poleceń w menu

### Okno główne &kgeography;

#### Menu Plik

&Ctrl;O Plik Otwórz mapę...

- Wyświetla okno dialogowe wyboru map

&Ctrl;Q Plik Zakończ

- Zamyka &kgeography;

#### Menu Widok

Widok Powiększenie

- Włącza tryb powiększania, możesz teraz narysować prostokąt na fragmencie mapy celem powiększenia tego miejsca.

Widok Pierwotny rozmiar

- Ustawia rozmiar mapy na oryginalny

Widok Automatyczne powiększenie

- Dynamicznie dopasowuje mapę do wielkości okna

Widok Przemieść

- Przemieszcza bieżącą mapę. Opcja aktywna tylko wtedy, gdy mapa została przybliżona.

#### Menu Ustawienia

Ustawienia Wyświetlaj pasek narzędzi

- Wyświetla lub ukrywa pasek narzędzi &kgeography;.

Ustawienia Konfiguracja skrótów...

- Konfiguracja skrótów klawiszowych dla &kgeography;.

Ustawienia Konfiguracja pasków narzędzi...

- Pozwala na ustawienie ikon dostępnych na pasku narzędzi &kgeography;.

#### Menu Pomoc

&kgeography; posiada domyślne menu Pomoc w stylu &kde; jak opisano poniżej wraz z dwoma dodatkowymi pozycjami:

Pomoc Zastrzeżenie

- Wyświetla zastrzeżenie o możliwych błędach w mapach, flagach i tłumaczeniach w &kgeography;.

Pomoc Autor mapy

- Wyświetla nazwę autora mapy.

Domyślne pozycje menu Pomoc w &kde; to:

&help.menu.documentation;

## Autorzy i licencja

&kgeography;

Program: © 2004-2008 Albert Astals Cid tsdgeos@terra.es

Prawa autorskie do dokumentacji © 2005 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; 2008 Kushal Das kushaldas@gmail.com

Marcin Kocurmarcin2006@gmail.com

&underFDL; &underGPL;

## Instalacja

### Jak zdobyć &kgeography;

&install.intro.documentation;

### Kompilacja i instalacja

&install.compile.documentation;
&documentation.index;