<!-- The introduction chapter contains a brief introduction for the
application that explains what it does and where to report
problems. Basically a long version of the abstract. Don't include a
revision history. (see installation appendix comment) -->
<para
>&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ą). </para>
<para
>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. </para>
</chapter>
<chapter id="quick-start">
<title
>Szybki start</title>
<para
>Po pierwszym uruchomieniu, &kgeography; poprosi Cię o wybranie mapy na początek. <screenshot>
<screeninfo
>To zdjęcie &kgeography; po pierwszym uruchomieniu</screeninfo>
>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: <screenshot>
<screeninfo
>Podaj nazwę obszaru, znając jego stolicę</screeninfo>
>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. </para>
<para
>Podaj obszar, znając jego flagę...: zostaje wyświetlona flaga, którą musisz przyporządkować do odpowiedniego obszaru. <screenshot>
> 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 <literal role="extension"
>.kgm</literal
> 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ę.</para>
</sect1>
<sect1 id="description-file">
<title
>Plik opisu</title>
<para
>Potrzebny jest plik opisu, który posiada rozszerzenie <literal role="extension"
>.kgm</literal
> i powinien zaczynać się od <sgmltag class="starttag"
>map</sgmltag
>, a kończyć na <sgmltag class="endtag"
>map</sgmltag
>. </para>
<para
>W wymienionych wyżej znacznikach powinno być wpisane: <itemizedlist>
>Każdy obszar posiada następujące znaczniki: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> i <sgmltag class="endtag"
>name</sgmltag
>: nazwa obszaru, ⪚ <quote
>Albania</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>capital</sgmltag
> i <sgmltag class="endtag"
>capital</sgmltag
>: nazwa stolicy obszaru, ⪚ <quote
>Tirana</quote
>.</para>
</listitem>
<listitem>
<para
>Znaczniki <sgmltag class="starttag"
>ignore</sgmltag
> i <sgmltag class="endtag"
>ignore</sgmltag
>: mogą być ustawione na <userinput
>yes</userinput
>, <userinput
>allowClickMode</userinput
> lub <userinput
>no</userinput
>. Jeśli znacznik jest ustawiony na <userinput
>yes</userinput
>, 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 <userinput
>allowClickMode</userinput
>, to &kgeography; zapyta o ten obszar w trybie <guibutton
>Wskaż obszar na mapie...</guibutton
>, ale nie w trybach odgadywania. Ustawienie tego znacznika na <userinput
>no</userinput
> oznacza, że obszar będzie widoczny we wszystkich trybach (zgadywania i przeglądania). Ten znacznik jest opcjonalny i kiedy nie ma znacznika <sgmltag class="starttag"
>ignore</sgmltag
>, jest to równoważne ustawieniu go na <userinput
>no</userinput
>. Na przykład, <quote
>Algeria</quote
> ma ustawiony ten znacznik na <userinput
>yes</userinput
> w mapie <quote
>Europa</quote
>, co oznacza, że <quote
>Algeria</quote
> nie będzie występowała w odgadywaniu na mapie <quote
>Europa</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>flag</sgmltag
> i <sgmltag class="endtag"
>flag</sgmltag
>: plik (bez ścieżki dostępu), zawierający flagę obszaru, np. <quote
>albania.png</quote
>. Ten znacznik jest opcjonalny. Niepotrzebny dla obszarów, których znacznik <sgmltag class="starttag"
>ignore</sgmltag
> jest ustawiony na <userinput
>yes</userinput
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>color</sgmltag
> i <sgmltag class="endtag"
>color</sgmltag
>: kolor obszaru na mapie</para>
</listitem>
</itemizedlist>
</para>
<para
>Kolor jest zdefiniowany przy użyciu trzech znaczników: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>red</sgmltag
> i <sgmltag class="endtag"
>red</sgmltag
>: czerwona składowa koloru. Poprawne wartości zawierają się od 0 do 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>green</sgmltag
> i <sgmltag class="endtag"
>green</sgmltag
>: zielona składowa koloru. Poprawne wartości zawierają się od 0 do 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>blue</sgmltag
> i <sgmltag class="endtag"
>blue</sgmltag
>: niebieska składowa koloru. Poprawne wartości zawierają się od 0 do 255.</para>
</listitem>
</itemizedlist>
</para>
<tip>
<para
>Można także utworzyć 2 lub 3 fałszywe obszary, jak np. <quote
>Water</quote
> (woda), <quote
>Frontier</quote
> (granica) i <quote
>Coast</quote
> (wybrzeże) i ustawić dla nich znacznik <sgmltag class="starttag"
>ignore</sgmltag
> na <userinput
>yes</userinput
>. </para>
</tip>
<important>
<para
>Wszystkie nazwy obszarów i stolic muszą być napisane w języku angielskim.</para>
</important>
</sect1>
<sect1 id="map-file">
<title
>Plik mapy</title>
<para
>Stworzenie pliku mapy jest zadaniem całkiem prostym, ale mozolnym. Mapa musi być w formacie <acronym
>PNG</acronym
>. Możesz znaleźć kilka map na <ulink url="https://www.cia.gov/cia/publications/factbook/docs/refmaps.html"
>Cia Reference Maps</ulink
>. Jeśli nie znajdziesz tam odpowiedniej, możesz ściągnąć <ulink url="https://www.cia.gov/cia/publications/factbook/reference_maps/pdf/political_world.pdf"
>polityczną mapę świata</ulink
>, 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. <application
>Czy możliwe jest tworzenie map, które nie pokazują podziału politycznego? Tak! <screenshot>
<screeninfo
>Przykład, jak utworzyć niepolityczną mapę</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="river.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Przykład, jak utworzyć niepolityczną mapę</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para
>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. </para>
</sect1>
</chapter>
<chapter id="commands">
<title
>Opis poleceń w menu</title>
<!-- (OPTIONAL, BUT RECOMMENDED) This chapter should list all of the
application windows and their menubar and toolbar commands for easy reference.
Also include any keys that have a special function but have no equivalent in the
menus or toolbars. This may not be necessary for small apps or apps with no tool
or menu bars. -->
<sect1 id="kapp-mainwindow">
<title
>Okno główne &kgeography;</title>
<sect2>
<title
>Menu <guimenu
>Plik</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Plik</guimenu
> <guimenuitem
>Otwórz mapę...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Wyświetla okno dialogowe wyboru map</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Plik</guimenu
> <guimenuitem
>Zakończ</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Zamyka</action
> &kgeography;</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Menu <guimenu
>Widok</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Widok</guimenu
> <guimenuitem
>Powiększ</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Pozwala na powiększanie mapy</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Widok</guimenu
> <guimenuitem
>Pierwotny rozmiar</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Ustawia rozmiar mapy</action
> na oryginalny</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Widok</guimenu
> <guimenuitem
>Przemieść</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Pozwala na przemieszczanie</action
> aktualnej mapy</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Menu <guimenu
>Ustawienia</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Ustawienia</guimenu
> <guimenuitem
>Wyświetlaj/Ukryj pasek narzędzi</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Wyświetla lub ukrywa pasek narzędzi &kgeography;.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Ustawienia</guimenu
> <guimenuitem
>Konfiguracja skrótów...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Konfiguracja skrótów klawiszowych dla &kgeography;.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Ustawienia</guimenu
> <guimenuitem
>Konfiguracja pasków narzędzi...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Pozwala na ustawienie ikon dostępnych na pasku narzędzi &kgeography;.</action
></para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Menu <guimenu
>Pomoc</guimenu
></title>
&help.menu.documentation; </sect2>
</sect1>
</chapter>
<!--<chapter id="faq">
<title
>Questions and Answers</title>
&reporting.bugs;
&updating.documentation;
<qandaset id="faqlist">
<qandaentry>
<question>
<para
>My Mouse doesn't work. How do I quit &kgeography;?</para>
</question>
<answer>
<para
>You silly goose! Check out the <link linkend="commands"
>Commands
Section</link
> for the answer.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Why am I not able to twiddle my documents?</para>
</question>
<answer>
<para
>You can only twiddle your documents if you have the foobar.lib
installed.</para>
</answer>
</qandaentry>
</qandaset>
</chapter
>-->
<chapter id="credits">
<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE