<!-- 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
>Kgeografi är ett inlärningsverktyg av geografi för &kde;. Det låter dig lära in politiska uppdelningen av vissa länder (landsdelar, huvudstäder i dessa landsdelar och deras tillhörande flaggor om det finns några). </para>
<para
>Tillgängliga kartor i nuvarande utgåva är: Afrika, Asien, Brasilien, Europa, Frankrike, Italien, Italiens regioner, Kanada, Kina, Nord- och Centralamerika, Norge, Polen, Spanien, Sydamerika, Tyskland, U.S.A., Österrike och världen. </para>
</chapter>
<chapter id="quick-start">
<title
>Snabbstart av Kgeografi</title>
<para
>När du kör Kgeografi för första gången, ombeds du först välja en karta att börja med. <screenshot>
<screeninfo
>Här är en skärmbild av Kgeografi vid första start</screeninfo>
>Gissa en del av kartan från huvudstaden: Du blir tillfrågad om att hitta namnet på en landsdel från ett urval av fyra given dess huvudstad: <screenshot>
<screeninfo
>Gissa en del av kartan från huvudstaden</screeninfo>
>Gissa huvudstad för en del av kartan: Du har en huvudstad och fyra namn på landsdelar och du måste välja den rätta. Som tidigare visas en resultatdialogruta i slutet. </para>
<para
>Gissa vilken del av kartan från flaggan: En flagga visas och du måste hitta landsdelen den hör till. <screenshot>
> I zoomläget kan du klicka med höger musknapp för att gå tillbaka till ursprunglig kartstorlek (alternativet <guimenuitem
>Originalstorlek</guimenuitem
> har samma effekt). Använd rullningslisterna för att flytta omkring i den zoomade kartan eller använd alternativet <guimenuitem
>Flytta</guimenuitem
> som låter dig dra kartan med vänster musknapp. </para>
</sect1>
</chapter>
<!--<chapter id="teachers-parents">
<title
>Teachers/Parents guide to &kgeography; </title>
This chapter should emphasize the educational aims of your app and
guide the parent/teacher on how to help the child using it.
</chapter
>-->
<chapter id="how-to-maps">
<title
>Hur man skapar kartor</title>
<para
>En karta i Kgeografi består av två filer, en är kartbilden och den andra är dess beskrivning. </para>
<sect1 id="helper-tool">
<title
>Hjälpverktyg</title>
<para
>Du hittar ett verktyg (skapat av Yann Verley) <ulink url="http://kgeography.berlios.de/gen_map.pl"
>här</ulink
> som hjälpte honom med Frankrikes karta. För att ta reda på hur det fungerar, kör det helt enkelt och läs hjälpmeddelandet. Det skapar i huvudsak <literal role="extension"
>.kgm</literal
>-filen från en vanlig textfil och skapar en fil med färgerna det har tilldelat varje del av kartan, så att du kan fylla kartan i enlighet med dem.</para>
</sect1>
<sect1 id="description-file">
<title
>Beskrivningsfil</title>
<para
>Beskrivningsfilen behövs, och dess filändelse är <literal role="extension"
>.kgm</literal
>. Den ska börja med <sgmltag class="starttag"
>map</sgmltag
> och sluta med <sgmltag class="endtag"
>map</sgmltag
>. </para>
<para
>Inne i dessa taggar ska finnas: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>mapFile</sgmltag
> och <sgmltag class="endtag"
>mapFile</sgmltag
>: Namnet på filen (utan sökväg) som innehåller kartbilden, t.ex. <quote
>europe.png</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> och <sgmltag class="endtag"
>name</sgmltag
>: Kartans namn, t.ex. <quote
>Europe</quote
>.</para>
</listitem>
<listitem>
<para
>En <sgmltag class="starttag"
>division</sgmltag
> och <sgmltag class="endtag"
>division</sgmltag
> för varje del av kartan.</para>
</listitem>
</itemizedlist>
</para>
<para
>Varje del har dessa taggar: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> och <sgmltag class="endtag"
>name</sgmltag
>: Namnet på kartdelen, t.ex. <quote
>Albania</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>capital</sgmltag
> och <sgmltag class="endtag"
>capital</sgmltag
>: Namnet på delens huvudstad, t.ex. <quote
>Tirana</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>ignore</sgmltag
> och <sgmltag class="endtag"
>ignore</sgmltag
> kan ställas in till <userinput
>yes</userinput
>, <userinput
> allowClickMode</userinput
> och <userinput
>no</userinput
>. Om taggen ställs in till <userinput
>yes</userinput
> ignoreras delen när delar på den kartan efterfrågas. Det är då som om delen inte finns i Kgeografis testlägen. Om taggen ställs in till <userinput
>allowClickMode</userinput
> frågar Kgeografi efter delen i läget <guibutton
>Klicka på del av kartan...</guibutton
> men inte i andra testlägen. Ställs taggen in till <userinput
>no</userinput
> betyder det att delen syns i alla lägen (bläddring och tester). Taggen är valfri, och om det inte finns någon <sgmltag class="starttag"
>ignore</sgmltag
>-tagg betyder det att den är inställd till <userinput
>no</userinput
>. <quote
>Algeriet</quote
> har till exempel taggen inställt till <userinput
>yes</userinput
>, vilket betyder att <quote
>Algeriet</quote
> inte är en del av någon test för kartan över <quote
>Europa</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>flag</sgmltag
> och <sgmltag class="endtag"
>flag</sgmltag
>: Filen (utan någon sökväg) som innehåller delens flagga, t.ex. <quote
>albania.png</quote
>. Taggen är valfri. Den behövs inte för delar som har taggen <sgmltag class="starttag"
>ignore</sgmltag
> inställd till <userinput
>yes</userinput
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>color</sgmltag
> och <sgmltag class="endtag"
>color</sgmltag
>: Färgen som delen har på kartan.</para>
</listitem>
</itemizedlist>
</para>
<para
>Färgen definieras genom att använda tre taggar: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>red</sgmltag
> och <sgmltag class="endtag"
>red</sgmltag
>: Färgens röda del. Giltiga värden är mellan 0 och 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>green</sgmltag
> och <sgmltag class="endtag"
>green</sgmltag
>: Färgens gröna del. Giltiga värden är mellan 0 och 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>blue</sgmltag
> och <sgmltag class="endtag"
>blue</sgmltag
>: Färgens blåa del. Giltiga värden är mellan 0 och 255.</para>
</listitem>
</itemizedlist>
</para>
<tip>
<para
>Det är bekvämt att skapa två eller tre falska delar som <quote
>Water</quote
>, <quote
>Frontier</quote
> och <quote
>Coast</quote
> och ge dem taggen <sgmltag class="starttag"
>ignore</sgmltag
> med värdet <userinput
>yes</userinput
>. </para>
</tip>
<important>
<para
>Alla namn (huvudstäder och landsdelar) måste vara på engelska.</para>
</important>
</sect1>
<sect1 id="map-file">
<title
>Kartfil</title>
<para
>Kartfilen är mycket enkel, men arbetsam att skapa. Den måste vara på <acronym
>PNG</acronym
>-format. Du kan hitta några kartor att omvandla på <ulink url="https://www.cia.gov/cia/publications/factbook/docs/refmaps.html"
>Cia Reference Maps</ulink
>. Om ingen karta passar ditt behov kan du ladda ner <ulink url="https://www.cia.gov/cia/publications/factbook/reference_maps/pdf/political_world.pdf"
>world.pdf</ulink
>, ta en skärmbild och fortsätta därifrån. Varje del av kartan ska ha en och endast en färg. För att åstadkomma det kan du använda bildbehandlingsprogram som <application
>Gimp</application
> och <application
>Kolourpaint</application
>. </para>
</sect1>
<sect1 id="flags">
<title
>Flaggor</title>
<para
>Om du har använt taggen <sgmltag class="starttag"
>flag</sgmltag
> måste du tillhandahålla flaggfilerna. De måste vara på <acronym
>PNG</acronym
>-format och bättre om de är 300 x 200 bildpunkter och du tillhandahåller en <acronym
>SVG</acronym
>-fil för dem. För att skaffa <acronym
>SVG</acronym
>-flaggor för nästan alla länder i världen och för vissa andra delar, kan du rådfråga <ulink url="http://www.sodipodi.com/index.php3?section=clipart/flags"
>Sodipodis flaggsamling</ulink
>. </para>
</sect1>
<sect1 id="how-to-test">
<title
>Hur man testar</title>
<para
>Innan du skickar din karta till Albert <email
>tsdgeos@terra.es</email
>, bör du testa den för att se att den inte har några fel. För att åstadkomma det, måste du göra följande: <itemizedlist
> <listitem
> <para
>Placera kartbeskrivningen och kartans bildfil i <filename class="directory"
>Är det möjligt att skapa icke-politiska kartor? Ja, det är det! <screenshot>
<screeninfo
>Exempel på att skapa en icke-politisk karta</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="river.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Exempel på att skapa en icke-politisk karta</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para
>Naturligtvis kan delkonceptet utökas till en flod eller ett berg. När kartan skapas, bör du hålla i minnet att oftast är floden eller berget för litet och att du måste tillhandahålla ett extra område att klicka. I exemplet skulle floden ha det mörkgröna området med färgen <20,76,34> som identifiering. </para>
</sect1>
</chapter>
<chapter id="commands">
<title
>Kommandoreferens</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
>Kgeografis huvudfönster</title>
<sect2>
<title
>Menyn <guimenu
>Arkiv</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Arkiv</guimenu
> <guimenuitem
>Öppna karta...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Öppnar dialogrutan för att välja karta</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Arkiv</guimenu
> <guimenuitem
>Avsluta</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Avslutar</action
> Kgeografi</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Menyn <guimenu
>Visa</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Visa</guimenu
> <guimenuitem
>Zooma</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Går till zoomläge</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Visa</guimenu
> <guimenuitem
>Originalstorlek</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Ställer in</action
> kartan till dess originalstorlek</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Visa</guimenu
> <guimenuitem
>Flytta</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Flyttar</action
> nuvarande karta</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Menyn <guimenu
>Inställningar</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Visa/Dölj verktygsrad</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Visa/dölj verktygsraden i Kgeografi.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa genvägar...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Anpassa snabbtangenterna i Kgeografi.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa verktygsrader...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Anpassa verktygsraden i Kgeografi.</action
></para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Menyn <guimenu
>Hjälp</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
distribution. -->
<title
>Tack till och licens</title>
<para
>Kgeografi </para>
<para
>Program copyright 2004-2005 Albert Astals Cid <email