<!-- 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; on &kde; õpiprogramm. See lubab tundma õppida mõningate riikide poliitilist struktuuri (poliitilised üksused, nende pealinnad ja lipud). </para>
<para
>Praegu on saadaval järgmised kaardid: Aafrika, Aasia, Austria, Brasiilia, Euroopa, Hiina, Hispaania, Itaalia, Itaalia provintsid, Kanada, Lõuna-Ameerika, Norra, Poola, Prantsusmaa, Põhja- ja Kesk-Ameerika, Saksamaa, USA ja maailm. </para>
</chapter>
<chapter id="quick-start">
<title
>&kgeography; kiirtutvustus</title>
<para
>Kui käivitad &kgeography; esimest korda, palutakse sul valida mõne riigi kaart. <screenshot>
>Arva pealinn haldusüksuse põhjal: sulle antakse ette poliitiline üksus ja neli linnanime, mille seast tuleb valida õige. Testi lõppemisel näidatakse tulemusi. </para>
<para
>Arva haldusüksus lipu põhjal: sulle näidatakse lippu ja sa pead arvama, millisele poliitilisele üksusele see kuulub. <screenshot>
> leiab Yann Verley loodud tööriista, mille abil ta valmistas Prantsusmaa kaardi. Kasutamiseks käivita see ja loe abiteadet. Põhimõtteliselt tekitab see klaartekstifailist <literal role="extension"
>.kgm</literal
>-faili ning omistab igale poliitilisele üksusele erineva värvi, millega saad siis kaardi värviliseks muuta.</para>
</sect1>
<sect1 id="description-file">
<title
>Kirjeldusfail</title>
<para
>Kirjeldusfail on nõutav ja selle laiend on <literal role="extension"
>.kgm</literal
>. Selle alguses peab seisma <sgmltag class="starttag"
>map</sgmltag
> ja lõpus <sgmltag class="endtag"
>map</sgmltag
>. </para>
<para
>Nende siltide vahel peab asuma: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>mapFile</sgmltag
> ja <sgmltag class="endtag"
>mapFile</sgmltag
>: kaardi pilti sisaldava faili nimi, ⪚ <quote
>europe.png</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> ja <sgmltag class="endtag"
>name</sgmltag
>: kaardi nimi, ⪚ <quote
>Europe</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>division</sgmltag
> ja <sgmltag class="endtag"
>division</sgmltag
> iga kaardi poliitilise üksuse kohta.</para>
</listitem>
</itemizedlist>
</para>
<para
>Igal poliitilisel üksusel peavad olema järgmised sildid: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> ja <sgmltag class="endtag"
>name</sgmltag
>: haldusüksuse nimi, ⪚ <quote
>Albania</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>capital</sgmltag
> ja <sgmltag class="endtag"
>capital</sgmltag
>: poliitilise üksuse pealinna nimi, ⪚ <quote
>Tirana</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>ignore</sgmltag
> ja <sgmltag class="endtag"
>ignore</sgmltag
>: võib olla <userinput
>yes</userinput
>, <userinput
>allowClickMode</userinput
> ja <userinput
>no</userinput
>. Kui silt on <userinput
>yes</userinput
>, ignoreeritakse poliitilist üksust antud kaardi üksuste näitamisel. Sel juhul paistab, nagu poleks seda üksust &kgeography; viktoriinirežiimides üldse olemas. Kui see on <userinput
>allowClickMode</userinput
>, küsib &kgeography; haldusüksust ainult režiimis <guibutton
>Klõpsa kaardil haldusüksusel...</guibutton
>, mitte aga teiste viktoriinide korral. Kui see on <userinput
>no</userinput
>, on üksus näha kõigis režiimides (nii viktoriinides kui ka lihtsal sirvimisel). See ei ole kohustuslik silt ja kui silt <sgmltag class="starttag"
>ignore</sgmltag
> puudub, arvestatakse automaatselt selle väärtuseks <userinput
>no</userinput
>. Näiteks <quote
>Algeria</quote
> korral on sellele sildile määratud väärtuseks <userinput
>yes</userinput
> <quote
>Europe</quote
> kaardi kohta, mis tähendab, et <quote
>Algeria</quote
> on nähtamatu kõigis viktoriinides, mis korraldatakse kaardiga <quote
>Europe</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>flag</sgmltag
> ja <sgmltag class="endtag"
>flag</sgmltag
>: poliitilise üksuse lippu sisaldav fail, ⪚ <quote
>albania.png</quote
>. See ei ole kohustuslik silt. Pole vaja üksuste korral, mille ignoreerimissildi (<sgmltag class="starttag"
>ignore</sgmltag
>) väärtuseks on <userinput
>yes</userinput
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>color</sgmltag
> ja <sgmltag class="endtag"
>color</sgmltag
>: värv, millega poliitilist üksust kaardil näidatakse.</para>
</listitem>
</itemizedlist>
</para>
<para
>Värv määratakse kolme sildiga: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>red</sgmltag
> ja <sgmltag class="endtag"
>red</sgmltag
>: värvi punane komponent. Sobivad väärtused vahemikus 0 kuni 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>green</sgmltag
> ja <sgmltag class="endtag"
>green</sgmltag
>: värvi roheline komponent. Sobivad väärtused vahemikus 0 kuni 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>blue</sgmltag
> ja <sgmltag class="endtag"
>blue</sgmltag
>: värvi sinine komponent. Sobivad väärtused vahemikus 0 kuni 255.</para>
</listitem>
</itemizedlist>
</para>
<tip>
<para
>Mõistlik on luua kaks-kolm libaüksust, näiteks vesi (<quote
>Water</quote
>), piir (<quote
>Frontier</quote
>) ja rannik (<quote
>Coast</quote
>), ning anda nende sildile <sgmltag class="starttag"
>ignore</sgmltag
> väärtuseks <userinput
>yes</userinput
>. </para>
</tip>
<important>
<para
>Kõik nimed (pealinnad ja üksused) peavad olema inglise keeles.</para>
</important>
</sect1>
<sect1 id="map-file">
<title
>Kaardifail</title>
<para
>Kaardifail on õieti päris lihtne, aga selle loomine nõuab omajagu vaeva. See peab olema <acronym
>PNG</acronym
>-vormingus. Mõned kaardid eeskujuks leiab <ulink url="https://www.cia.gov/cia/publications/factbook/docs/refmaps.html"
>CIA kaardikogust</ulink
>. Kui ükski kaart sulle ei sobi, võid alla laadida <ulink url="https://www.cia.gov/cia/publications/factbook/reference_maps/pdf/political_world.pdf"
>maailma PDF-faili</ulink
>, teha sellest ekraanipildi ja asuda seda töötlema. Kõik poliitilised üksused kaardil peavad olema ühe konkreetse värviga. Selleks on kõige parem kasutada pilditöötlemisrakendusi, näiteks <application
>The Gimp</application
> ja <application
>Kolourpaint</application
>. </para>
</sect1>
<sect1 id="flags">
<title
>Lipud</title>
<para
>Kui kasutad lipusilti (<sgmltag class="starttag"
>flag</sgmltag
>), pead pakkuma ka lipufaili. Need peavad olema <acronym
>PNG</acronym
>-vormingus ning parem oleks, kui need oleks mõõtmetes 300x200 pikslit ja sa saaksid pakkuda ka <acronym
>SVG</acronym
>-faili. Peaaegu kõigi maailma riikide ja mõningate riikide poliitiliste üksuste <acronym
>SVG</acronym
>-lipud leiab <ulink url="http://www.sodipodi.com/index.php3?section=clipart/flags"
>Sodipodi lipukogust</ulink
>. </para>
</sect1>
<sect1 id="how-to-test">
<title
>Testimine</title>
<para
>Enne seda, kui saadad kaardi Albertile <email
>tsdgeos@terra.es</email
>, peaksid seda testima, et selles poleks vigu. Selleks talita järgmiselt: <itemizedlist
> <listitem
> <para
>Aseta kaardi kirjelduse ja kaardi pildi fail kataloogi <filename class="directory"
>Kas mittepoliitilisi kaarte võib ka teha? Jah, muidugi! <screenshot>
<screeninfo
>Näide mittepoliitilise kaardi loomise kohta</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="river.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Näide mittepoliitilise kaardi loomise kohta</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para
>Mõistagi võib üksuse mõistet laiendada jõgedele või mägedele. Sellise kaardi loomisel tuleks silmas pidada, et enamasti on jõgi või mägi liiga pisike, nii et tuleks luua mõnevõrra avaram klõpsamisala. Toodud näites ongi jõel laiem ala ning seda tuvastab värv <20,76,34>. </para>
</sect1>
</chapter>
<chapter id="commands">
<title
>Käskude seletused</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
>&kgeography; peaaken</title>
<sect2>
<title
>Menüü <guimenu
>Fail</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Ava kaart...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Avab kaardi valimise dialoogi</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Välju</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Lõpetab</action
> &kgeography; töö</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Menüü <guimenu
>Vaade</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Suurendus</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Kehtestab suurendusrežiimi</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Originaalsuurus</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Kehtestab</action
> kaardi esialgse suuruse</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Liiguta</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Liigutab</action
> kaarti</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Menüü <guimenu
>Seadistused</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Tööriistariba näitamine/peitmine</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Näitab või peidab &kgeography; tööriistariba.</action