# 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ą).

W bieżącej wersji programu dostępne są mapy: Afryki, Azji, Austrii, Brazylii, Kanady, Chin, Europy, Francji, Niemiec, Włoch, Prowincji Włoch, Północnej i Środkowej Ameryki, Norwegii, Polski, Południowej Ameryki, Hiszpanii, USA i świata.

## Szybki start

Po pierwszym uruchomieniu, &kgeography; poprosi Cię o wybranie mapy na początek. To zdjęcie &kgeography; po pierwszym uruchomieniu To zdjęcie &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ę: kliknij lewym przyciskiem myszy na obszarze, żeby zobaczyć informacje o nim: Przeglądaj mapę Przeglądaj mapę

Wskaż obszar na mapie...: program zapyta się, 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

Podaj nazwę obszaru, znając stolicę: 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

Podaj stolicę obszaru...: na podstawie nazwy obszaru, musisz wybrać z czterech propozycji właściwą stolicę. Na końcu oczywiście wyświetlony zostanie rezultat Twoich odpowiedzi.

Podaj obszar, znając jego flagę...: zostaje wyświetlona flaga, którą musisz przyporządkować do odpowiedniego obszaru. pytanie o flagę pytanie o flagę

Wskaż flagę obszaru...: 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 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 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.

## 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ę.

### Plik opisu

Potrzebny jest plik opisu, który 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).

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

- Znaczniki `ignore` i `ignore`: mogą być ustawione na `yes`, `allowClickMode` lub `no`. Jeśli znacznik jest ustawiony na `yes`, wówczas obszar zostanie zignorowany podczas pytania o obszary na tej mapie. To oznacza, że obszar nie istnieje gdy &kgeography; jest w trybach odgadywania. Jeśli znacznik jest ustawiony na `allowClickMode`, to &kgeography; zapyta o ten obszar w trybie Wskaż obszar na mapie..., ale nie w trybach odgadywania. Ustawienie tego znacznika na `no` oznacza, że obszar będzie widoczny we wszystkich trybach (zgadywania i przeglądania). Ten znacznik jest opcjonalny i kiedy nie ma znacznika `ignore`, jest to równoważne ustawieniu go na `no`. Na przykład, Algeria ma ustawiony ten znacznik na `yes` w mapie Europa, co oznacza, że Algeria nie będzie występowała w odgadywaniu na mapie Europa.

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

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

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ąć polityczną mapę ś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ęć, takich 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. Mapy prawie wszystkich krajów i niektórych obszarów możesz ściągnąć 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 `$`TDEDIR`/share/apps/kgeography/`

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

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

Jeśli nie wiesz, gdzie znajduje się katalog `$`TDEDIR``, wpisz w &konsole-miejscownik; ``tde-config` `--prefix``.

### 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ększ

- Pozwala na powiększanie mapy

Widok Pierwotny rozmiar

- Ustawia rozmiar mapy na oryginalny

Widok Przemieść

- Pozwala na przemieszczanie aktualnej mapy

#### Menu Ustawienia

Ustawienia Wyświetlaj/Ukryj 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

&help.menu.documentation;

## Autorzy i licencja

&kgeography;

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

Prawa autorskie do dokumentacji: © 2005 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;

Marcin Kocurmarcinkocur@op.pl

&underFDL; &underGPL;

## Instalacja

### Jak zdobyć &kgeography;

&install.intro.documentation;

### Kompilacja i instalacja

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