<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY ksirk '<application
>KsirK</application
>'>
  <!ENTITY kapp "&ksirk;"
><!-- replace ksirk here -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Swedish "INCLUDE">
]>

<book lang="&language;">

<bookinfo>
<title
>Handbok &kapp;</title>

<authorgroup>
<author
><firstname
>Gael</firstname
> <othername
>Kleag</othername
> <surname
>de Chalendar</surname
> <affiliation
> <address
><email
>Kleag@free.fr</email
></address>
</affiliation>
</author>
<othercredit role="translator"
> <firstname
>Stefan</firstname
> <surname
>Asserhäll</surname
> <affiliation
><address
><email
>stefan.asserhall@comhem.se</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 
</authorgroup>


<copyright>
<year
>2002-2008</year>
<holder
>Gael de Chalendar</holder>
</copyright>
<!-- Translators: put here the copyright notice of the translation -->
<!-- Put here the FDL notice.  Read the explanation in fdl-notice.docbook
     and in the FDL itself on how to use it. -->
<legalnotice
>&FDLNotice;</legalnotice>

<!-- Date and version information of the documentation
Don't forget to include this last date and this last revision number, we
need them for translation coordination !
Please respect the format of the date (DD/MM/YYYY) and of the version
(V.MM.LL), it could be used by automation scripts.
Do NOT change these in the translation. -->

<date
>18/08/2005</date>
<releaseinfo
>1.03.00</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para
>&kapp; är en datorversion av ett välkänt strategispel. Det finns kommersiella och andra versioner med fri programvara, men jag (Gaël de Chalendar) skapade ursprungligen spelet som en övning för att lära mig C++, och utvecklade det till nuvarande status (se README för detaljinformation). </para>
<para
>I sin nuvarande version är &kapp; ett nätverksspel för flera spelare med en grundläggande AI. (Se TODO för detaljinformation). </para>
<para
>Dokumentationen ger den huvudsakliga informationen du behöver för att börja spela. Läs verktygstipsen och statusradens meddelanden för att komplettera informationen här. Ett kapitel förklarar hur nya skal skapas för &kapp;. </para>
<para
>Spelets mål är helt enkelt att erövra världen ... Det görs genom att anfalla grannländer med arméer. Fredligt, inte sant? </para>
</abstract>

<!-- This is a set of Keywords for indexing by search engines.
Please at least include KDE, the KDE package it is in, the name
 of your application, and a few relevant keywords. -->

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdegames</keyword>
<keyword
>spel</keyword>
<keyword
>strategi</keyword>
<keyword
>Risk</keyword>
<keyword
>fri</keyword>
<keyword
>GPL</keyword>
<keyword
>Nätverk</keyword>
<keyword
>AI</keyword>
</keywordset>

</bookinfo>

<!-- The contents of the documentation begin here.  Label
each chapter so with the id attribute. This is necessary for two reasons: it
allows you to easily reference the chapter from other chapters of your
document, and if there is no ID, the name of the generated HTML files will vary
from time to time making it hard to manage for maintainers and for the CVS
system. Any chapter labelled (OPTIONAL) may be left out at the author's
discretion. Other chapters should not be left out in order to maintain a
consistent documentation style across all KDE apps. -->

<chapter id="introduction">
<title
>Inledning</title>

<!-- 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
>&kapp; är en datorversion av ett välkänt strategispel. Det finns kommersiella och andra versioner med fri programvara, men jag (Gaël de Chalendar) skapade ursprungligen spelet som en övning för att lära mig C++, och utvecklade det till nuvarande status (se README för detaljinformation). </para>
<para>
<screenshot>
  <screeninfo
>Här är en skärmbild av &kapp;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="firing-screenshot.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Skärmbild</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>I sin nuvarande version är &kapp; ett nätverksspel för flera spelare med en grundläggande AI. (Se TODO för detaljinformation). </para>
<para
>Dokumentationen ger bara den huvudsakliga informationen du behöver för att börja spela. Läs verktygstipsen och statusradens meddelanden för att komplettera informationen här. </para>
<para
>Spelets mål är helt enkelt att erövra världen ... Det görs genom att anfalla grannländer med arméer. Fredligt, inte sant? </para>
</chapter>

<chapter id="using-kapp">
<title
>Använda &kapp;</title>

<!-- This chapter should tell the user how to use your app. You should use as
many sections (Chapter, Sect1, Sect3, etc...) as is necessary to fully document
your application. -->



<sect1 id="playing-ksirk">
<title
>Spela &kapp;</title>
<para
>Preliminär anmärkning: Kartan kan panoreras på tre sätt. För det första kan musen placeras när en fönsterkant så panoreras kartan i den riktningen. För det andra kan mushjulet användas. Utan någon väljartangent panorerar det vertikalt, när Meta-tangenten trycks ner panorerar det horisontellt. Till sist kan du använda tangentbordets piltangenter. </para>
<sect2 id="mainmenu">
<title
>Att starta ett spel</title>
<para
>När &kapp; startas, presenteras en huvudmeny. <screenshot>
  <screeninfo
>Huvudmenyn i &kapp;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="introscreen.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Huvudmeny</phrase>
    </textobject>
  </mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term>
  <menuchoice>
    <guimenu
>Nytt spel</guimenu>
  </menuchoice>
</term>
<listitem>
  <para>
  <action
>Startar ett nytt spel</action>
  </para>
</listitem>
</varlistentry>
<varlistentry>
  <term>
    <menuchoice>
      <guimenu
>Gå med</guimenu>
    </menuchoice>
  </term>
  <listitem>
    <para>
      <action
>Tillåt att gå med i ett nätverksspel som en klient</action>
    </para>
  </listitem>
</varlistentry>
<varlistentry>
  <term>
    <menuchoice>
      <guimenu
>Ladda</guimenu>
    </menuchoice>
  </term>
  <listitem>
    <para>
      <action
>Använd det här för att ladda ett tidigare sparat spel.</action>
    </para>
  </listitem>
</varlistentry>
<varlistentry>
  <term>
    <menuchoice>
      <guimenu
>Avsluta</guimenu>
    </menuchoice>
  </term>
  <listitem>
    <para>
      <action
>Kanske du till sist inte vill spela mer?</action>
    </para>
  </listitem>
</varlistentry>
</variablelist>
</para>
<para
>Om du klickar på Nytt spel, visas dialogrutan Nytt spel där du kan välja antal spelare, skalet (eller temat) att använda, speltypen (erövra målet eller ha ett specifikt mål), och slutligen om spelet kommer att spelas med nätspelare eller om det är helt lokalt. <screenshot>
  <screeninfo
>Dialogrutan Nytt spel</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="newgamedialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Dialogrutan Nytt spel</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>Markera kryssrutan "Nätverksspel" till höger om nummerrutan med antal spelare, för att starta ett nätverksspel. Efter att ha klickat på Ok, kommer du att kunna välja nätverksparametrar: antal nätverksspelare och TCP-port att använda för att vänta på anslutningar. <screenshot>
  <screeninfo
>Dialogrutan med parametrar för nätverksspel</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="numnetplayersdialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Dialogrutan med parametrar för nätverksspel</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>Därefter kommer nätverksspelare att kunna ansluta genom att välja att gå med på inledningsskärmen och ange värddatorns IP-adress eller värddatornamn och portnummer du just ställde in. <screenshot>
  <screeninfo
>Dialogrutan för att deltaga i nätverksspel</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="joinnetgame.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Dialogrutan för att deltaga i nätverksspel</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>Varje anslutning indikeras av meddelandet nedanför i statusraden. <screenshot>
  <screeninfo
>Anslutningsmeddelande</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="justjoined.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Anslutningsmeddelande</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</para>
<para
>Låt oss anta att du behåller förvalda inställningar, och klickar på Ok. Då ställer du in två spelare, en i taget. För var och en väljer du namn, nationalitet, och om du vill kan du ställa in ett lösenord så att ingen annan än du kan återanvända spelaren när det sparade spelet laddas igen. Till sist anger du här om spelaren är datorn eller en människa. <screenshot>
  <screeninfo
>Dialogrutan Spelarinställning</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="playersetupdialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Dialogrutan Spelarinställning</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>Om du väljer att spela med ett mål, visas målet för varje lokal spelare, föregånget av en varning så att andra spelare som tittar på samma dator kan diskret titta bort medan målet visas. <screenshot>
  <screeninfo
>Dialogrutan Visa mål</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="displaygoalmessage.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Dialogrutan Visa mål</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<screenshot>
  <screeninfo
>Varningsmeddelandet Visa mål</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="displaygoalwarningmessage.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Varningsmeddelandet Visa mål</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>

<sect2 id="distribution">
<title
>Fördelning</title>
<para
>När spelet börjar fördelas länder till alla spelare. Varje land innehåller från början en armé (representerad av en infanterist). Varje spelare har ett antal arméer att fördela mellan sina länder när det är deras tur (vilket anges av att deras namn och flagga visas i statusraden). Observera att fem arméer representeras av en kavallerist och tio av en kanon. </para>
<para
>Klicka på ett av dina länder med vänster musknapp för att placera en armé i det. Klicka med höger musknapp för att ta bort en armé. Observera, som en allmän regel, kommer du aldrig att kunna ta bort fler arméer än du redan har placerat ut. <screenshot>
  <screeninfo
>Placera arméer</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="placingarmies.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Placera arméer</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</para>
<para
>När en spelare har fördelat alla sina arméer, får nästa spelare automatiskt fortsätta att göra samma sak. När alla spelare är klara med att fördela sina arméer, finns två möjligheter som kan väljas med två knappar som visas i rutan till höger: <variablelist>
<varlistentry>
<term>
  <menuchoice>
    <guimenu>
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="distributionArmees.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Omfördelning</phrase>
        </textobject>
      </inlinemediaobject
> : Omfördelning </guimenu>
  </menuchoice>
</term>
<listitem>
  <para>
  <action
>En spelare vill ändra några av sina val. Den första spelaren kan då ta bort en armé som just placerades i ett land med höger musknapp, och placera den i ett annat med vänster musknapp. När spelaren är klar, överlämnar han kontrollen till nästa spelare med knappen 'Validera'. När alla spelare är klara med sin omfördelning, visas de två knapparna igen. </action>
  </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
  <menuchoice>
    <guimenu>
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="distributionArmeesFinie.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Slut på omfördelning</phrase>
        </textobject>
      </inlinemediaobject
> : Slut på omfördelning </guimenu>
  </menuchoice>
</term>
<listitem
><para
><action
>Omfördelningen är slut och spelet kan fortsätta. </action
></para
></listitem>
</varlistentry>
</variablelist>

</para>
</sect2>

<sect2 id="fight">
<title
>Strid</title>
<para
>Efter omfördelningen startar en omgång. Varje spelare spelar när det är hans tur. Han har då möjlighet att välja: <variablelist>
  <varlistentry>
    <term>
      <menuchoice>
        <guimenu>
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="joueurSuivant.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Nästa spelare</phrase>
            </textobject>
          </inlinemediaobject
> : Ge turen till nästa spelare (knapp på verktygsraden) </guimenu>
      </menuchoice>
    </term>
    <listitem>
      <para>
        <action
>Den nuvarande spelarens tur avslutas, och det är nästa spelares tur. </action>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term>
      <menuchoice>
        <guimenu>
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="attackOne.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Anfall 1</phrase>
            </textobject>
          </inlinemediaobject>
&nbsp;<inlinemediaobject
> <imageobject
> <imagedata fileref="attackTwo.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Attack 2</phrase
> </textobject
> </inlinemediaobject
> &nbsp;<inlinemediaobject
> <imageobject
> <imagedata fileref="attackThree.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Anfall 3</phrase
> </textobject
> </inlinemediaobject
> : Anfall med en, två eller tre arméer &nbsp;<inlinemediaobject>
            <imageobject>
              <imagedata fileref="autoattack.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Anfall automatiskt</phrase>
            </textobject>
          </inlinemediaobject>
        </guimenu>
      </menuchoice>
    </term>
    <listitem>
      <para
>Dra med musen från det anfallande landet och släpp på det anfallna, för att göra ett anfall. Då visas en sammanhangsberoende meny med ovanstående alternativ. <screenshot
> <screeninfo
>Anfallsmeny</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="attackmenu.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Anfallsmeny</phrase
> </textobject
> </mediaobject
> </screenshot
> För att landet X ska kunna anfalla landet Y med x arméer, måste två villkor vara uppfyllda: 1 - de två länderna måste vara grannar, 2 - land X måste ha minst x+1 arméer innan anfallet. Om anfallet är riktigt, visas en dialogruta om det är nödvändigt för försvararen att välja om han vill försvara med en eller två arméer, eller vill låta datorn bestämma. </para>
      <para
>När försvararens val är gjort, sker striden till den är genomförd. Det beskrivs nedan. <screenshot>
            <screeninfo
>Försvarsdialogruta</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="defensedialog.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Försvarsdialogruta</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term>
      <menuchoice>
        <guimenu>
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="moveArmies.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Flytta arméer</phrase>
            </textobject>
          </inlinemediaobject
> : Flytta arméer från ett land till ett annat </guimenu>
      </menuchoice>
    </term>
    <listitem>
      <para>
        <action
>Detta är den sista åtgärden under en spelares tur. Den ger möjlighet att flytta vissa arméer från ett land till ett annat, som är grannland till det första. För att välja länderna, drag och släpp precis som vid ett anfall. När båda länder har valts, visas ett skjutreglage där man kan välja hur många arméer ska finnas i varje land efteråt. </action>
      </para>
    </listitem>
  </varlistentry>
</variablelist>
</para>
</sect2>
<sect2  id="fight-solution">
  <title
>Stridens upplösning</title>
  <para
>För varje armé inblandad i striden kastas en motsvarande tärning. Spelaren som slår högst nummer på tärningen, vare sig han anfaller eller försvarar, vinner och den som slår ett lägre nummer på tärningen förlorar arméer enligt antal kastade tärningar. <screenshot>
            <screeninfo
>Visade anfallsresultat</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="shownumberofarmies.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Visade anfallsresultat</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
  </para>
  <para
>Om antalet arméer i försvararens land når 0, byter landet ägare till angriparen: Hans flagga hissas, och en av hans anfallande arméer installeras i det nya landet. Skjutreglaget för att flytta arméer visas liksom vid förflyttningarna i slutet på omgången. <screenshot>
            <screeninfo
>Invasionsreglage</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="invasionslider.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Invasionsreglage</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
  </para>
</sect2>
<sect2  id="end_of_turn">
  <title
>Turens slut</title>
  <para
>För att avsluta din nuvarande tur, om du inte vill flytta arméer, kan du klicka på knappen "Nästa spelare" i verktygsraden. </para>
  <para
>När alla har spelat, är omgången slut. Vissa arméer fördelas till spelarna, i förhållande till antal länder de äger; 1 för varje grupp med tre länder, med minimalt tre. En bonus lämnas också för spelare som äger en hel kontinent, olika för var och en. För standardskalet är denna bonus: <table>
      <title
>Bonus på grund av kontinenter</title>
      <tgroup cols="2">
        <thead>
          <row
><entry
>Kontinent</entry
><entry
>Bonus</entry
></row>
        </thead>
        <tbody>
          <row
><entry
>Nordamerika</entry
><entry
>5</entry
></row>
          <row
><entry
>Sydamerika</entry
><entry
>2</entry
></row>
          <row
><entry
>Europa</entry
><entry
>5</entry
></row>
          <row
><entry
>Afrika</entry
><entry
>3</entry
></row>
          <row
><entry
>Asien</entry
><entry
>7</entry
></row>
          <row
><entry
>Stilla havsområdet</entry
><entry
>2</entry
></row>
        </tbody>
      </tgroup>
    </table>
  </para>
  <para
>När en spelare är klar med att fördela sina arméer, klickar han på knappen "Validera" för att låta nästa spelare fördela sina bonusarméer. Liksom vid den ursprungliga fördelningen, när alla spelare har placerat sina arméer kan de påbörja en ny omfördelningscykel eller börja en ny omgång ... </para>
</sect2>
<sect2 id="sending-messages">
<title
>Skicka meddelanden till andra spelare</title>
<para
>Om du spelar ett lokalt spel och vill kommunicera med övriga spelare, prata med dem som vanligt (under förutsättning att du inte har något handikapp). Men om du spelare ett nätverksspel, kan du använda chattrutan längst ner i fönstret (den kan visas eller döljas med pilarna). Skriv bara in meddelandet och tryck på returtangenten. <screenshot>
            <screeninfo
>Skicka meddelanden</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="messagesent.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Skicka meddelanden</phrase>
              </textobject>
            </mediaobject>
          </screenshot>

</para>
</sect2>
</sect1>
</chapter>

<chapter id="commands">
<title
>Kommandoreferens</title>

<sect1 id="kapp-mainwindow">
<title
>Huvudfönstret i &kapp;</title>
<sect2>
<title
>Knapparna</title>
<para>
<variablelist>
<varlistentry>
<term>
  <menuchoice>
    <guimenu>
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="quit.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Avsluta spelet</phrase>
        </textobject>
      </inlinemediaobject
> : Avsluta spelet </guimenu>
  </menuchoice>
</term>
<listitem
><para
><action
>Gör att programmet avslutas. </action
></para
></listitem>
</varlistentry>
<varlistentry>
<term>
  <menuchoice>
    <guimenu>
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="newGame.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Nytt spel</phrase>
        </textobject>
      </inlinemediaobject
> : Nytt spel </guimenu>
  </menuchoice>
</term>
<listitem
><para
><action
>Startar ett nytt spel. Det gör att en dialogruta som frågar efter antal spelare visas. Därefter blir varje spelare tillfrågad om sitt namn med en annan dialogruta. </action
></para
></listitem>
</varlistentry>
</variablelist>
</para>

</sect2>

</sect1>
</chapter>

<chapter id="developers">
  <title
>Utvecklingsguide för &kapp;</title>
  
  <para
>Titta i KDoc-dokumentation för att se programmeringsgränssnittet. Den var ganska fullständig, men är för närvarande lite föråldrad. Däremot är kommentarer obefintliga i <filename
>.cpp</filename
>-implementeringsfilerna. </para>
  <para
>Observera att spelet utvecklades ursprungligen under Windoz med Borland C++ och WinG. Jag överförde det till &Java; innan det konverterades tillbaka till C++ och &kde;. Från början använde jag franska eller en blanding av franska och engelska för att namnge identifierare (klassnamn, metoder, medlemmar, etc.). Jag använde också franska för kommentarerna. När jag bestämde mig för att distribuera spelet, bestämde jag mig också för att översätta allt till engelska ... men det är uppenbart att engelska inte är mitt modersmål: föreslå eller utför gärna in förbättringar av kommentarerna i koden eller av den här dokumentationen. </para>
  
</chapter>

<chapter id="skins">
  <title
>Skapa nya skal</title>
  <para
>&kapp; är helt anpassningsbart med olika skal. För alla som kan hantera grafik, är det mycket enkelt att skapa ett nytt skal genom att kopiera ett befintligt, redigera eller ändra grafiken och uppdatera data i en .desktop-inställningsfil. Det sista steget är att redigera filen som beskriver vad som ska installeras. </para>
  <para
>Alla exempel (text och bilder) kommer från standardskalet i &kapp;.</para>
  <sect1 id="sdf">
    <title
>Katalog- och filstruktur</title>
    <para>
      <itemizedlist>
        <listitem>
          <para
>Data/ : Data använt av programmet för att hantera skalets bilder. <itemizedlist>
              <listitem
><para
>CMakeLists.txt : Beskriver vad som ska installeras.</para
></listitem>
              <listitem
><para
>onu.desktop : Huvudfil för beskrivning av skalet. Se beskrivningen nedan.</para
></listitem>
            </itemizedlist>
          </para>
        </listitem>
        <listitem>
          <para
>Images/ : Skalets bilder (karta, figurer, etc.) <itemizedlist>
              <listitem
><para
>CMakeLists.txt : Beskriver vad som ska installeras.</para
></listitem>
              <listitem
><para
>pool.svg : kartan och alla figurer som används av skalet.</para
></listitem>
              <listitem
><para
>map-mask.png : bilden som gör det möjligt för programmet att ta reda på vilket land musen finns över under spelet (se nedan).</para
></listitem>
              <listitem
><para
>*.png : övriga bilder här är knapparnas ikoner.</para
></listitem>
            </itemizedlist>
          </para>
        </listitem>
        <listitem
><para
>CMakeLists.txt/ : Beskriver vad som ska installeras.</para
></listitem>
        <listitem
><para
>Sounds/ : ljudfiler för skalet.</para
></listitem>
      </itemizedlist>
    </para>
  </sect1>
  <sect1 id="tdd">
    <title
>Katalogen Data</title>
    <sect2>
      <title
>Filen onu.desktop</title>
      <para
>Filen är en beskrivning av skalets innehåll. Den används för att beskriva hur världen är organiserad, och hur den ska visas. Den har följande struktur: </para>
      <para
>En onu-grupp innehåller ett antal landsposter, ett antal nationalitetsposter och till sist ett antal kontinentposter. Därefter innehåller diverse grupper beskrivningen av de olika figurerna, beskrivningen av de olika länderna, kontinenterna, nationaliteterna och målen. </para>
      <para
>Följande avsnitt beskriver innehållet i varje grupp. </para>
      <sect3>
        <title
>onu-gruppen</title>
        <para>
          <table>
            <title
>Posterna i onu-gruppen</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Postnamn</entry
><entry
>Betydelse</entry
></row
></thead>
              <tbody>
                <row
><entry
>width</entry
><entry
>Bredden på skalets karta</entry
></row>
                <row
><entry
>height</entry
><entry
>Höjden på skalets karta</entry
></row>
                <row
><entry
>skinpath</entry
><entry
>Sökvägen till skalet i förhållande till programmets datasökväg (t.ex. det förvalda skins/)</entry
></row>
                <row
><entry
>nb-countries</entry
><entry
>Antal länder (42 i standardskalet). Det ska finnas lika många landsgrupper nedan</entry
></row>
                <row
><entry
>nb-nationalities</entry
><entry
>Antal nationaliteter (6 i standardskalet). Det ska finnas lika många nationalitetsgrupper nedan</entry
></row>
                <row
><entry
>nb-continents</entry
><entry
>Antal kontinenter (6 i standardskalet). Det ska finnas lika många kontinentgrupper nedan</entry
></row>
                <row
><entry
>pool</entry
><entry
>Sökväg och namn på pool-filen i förhållande till skalets sökväg (t.ex. Images/pool.svg)</entry
></row>
                <row
><entry
>map-mask</entry
><entry
>Sökväg och namn på kartmaskfilen i förhållande till skalets sökväg (t.ex. Images/map-mask.png)</entry
></row>
                <row
><entry
>format-version</entry
><entry
>Skalfilformatets version (2.0)</entry
></row>
                <row
><entry
>name</entry
><entry
>Namnet på skalet som visas</entry
></row>
                <row
><entry
>desc</entry
><entry
>Den långa beskrivningen av skalet</entry
></row>
                <row
><entry
>fighters-flag-y-diff</entry
><entry
>Höjdskillnaden mellan flaggor och kanonfigurer</entry
></row>
                <row
><entry
>width-between-flag-and-fighter</entry
><entry
>Antal bildpunkter mellan flaggans vänstra bildpunkt och den vanliga kanonens högra bildpunkt (när den inte skjuter eller exploderar)</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>Beskrivningsgrupperna för figurer</title>
        <para
>Varje typ av figur (flagga, infanterist, kavalleri, kannon, skjutande kanon och exploderande kanon) definieras av en grupp. Bara vissa figurer har breddinformation. Den används för relativ placering vid animering: när kanonerna skjuter eller exploderar ska de inte "flyttas" runt landets flagga under en strid. <table>
            <title
>Grupposter för figurbeskrivning</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Post</entry
><entry
>Betydelse</entry
></row
></thead>
              <tbody>
                <row
><entry
>width</entry
><entry
>Referensbredden på flaggfigurernas ramar</entry
></row>
                <row
><entry
>height</entry
><entry
>Referenshöjden på flaggfigurernas ramar</entry
></row>
                <row
><entry
>frames</entry
><entry
>Antal ramar i flaggfiguren</entry
></row>
                <row
><entry
>versions</entry
><entry
>Antal versioner av flaggfigurerna</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>Beskrivningsgrupper för länder</title>
        <para
>Varje land som listas i onu-gruppens landspost har sin egen grupp, vars beteckning är landets namn. Tabellen nedan listar posterna i dessa grupper. </para>
        <para>
          <table>
            <title
>Landsposter</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Postnamn</entry
><entry
>Betydelse</entry
></row
></thead>
              <tbody>
                <row
><entry
>id</entry
><entry
>Heltalet med landets unika identifikationsnummer, måste börja från noll (0)</entry
></row>
                <row
><entry
>name</entry
><entry
>Landets visade namn</entry
></row>
                <row
><entry
>&lt;sprite&gt;-point</entry
><entry
>Varje sorts figur (flagga, infanterist, etc.) i landet visas på en viss plats definierat av den här posten skapad av två heltal åtskilda av ett kommatecken</entry
></row>
                <row
><entry
>neighbours</entry
><entry
>Listan av identifierare för grannarna till det aktuella landet</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>Beskrivningsgrupper för nationaliteter</title>
        <para
>Varje nationalitet som listas i onu-gruppens nationalitetspost har sin egen grupp, vars beteckning är nationalitetens namn. Tabellen nedan listar posterna i dessa grupper. </para>
        <para>
          <table>
            <title
>Nationalitetsposter</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Postnamn</entry
><entry
>Betydelse</entry
></row
></thead>
              <tbody>
                <row
><entry
>name</entry
><entry
>Nationalitetens namn (t.ex. Japan)</entry
></row>
                <row
><entry
>leader</entry
><entry
>Namnet som föreslås för spelaren som väljer nationaliteten</entry
></row>
                <row
><entry
>flag</entry
><entry
>Namnet på landets flaggfigurelement i onu SVG-filen</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>Beskrivningsgrupper för kontinenter</title>
        <para
>Varje kontinent som listas i onu-gruppens kontinentpost har sin egen grupp, vars beteckning är kontinentens namn. Tabellen nedan listar posterna i dessa grupper. </para>
        <para>
          <table>
            <title
>Kontinentposter</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Postnamn</entry
><entry
>Betydelse</entry
></row
></thead>
              <tbody>
                <row
><entry
>name</entry
><entry
>Kontinentens namn (t.ex. Afrika)</entry
></row>
                <row
><entry
>id</entry
><entry
>Kontinentens unika heltals-identifikationsnummer</entry
></row>
                <row
><entry
>bonus</entry
><entry
>Antal arméer som erhålls i slutet på omgången av spelaren som äger kontinentens alla länder</entry
></row>
                <row
><entry
>continent-countries</entry
><entry
>Listan över identifierare för länderna på den aktuella kontinenten</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>Beskrivningsgrupper för mål</title>
        <para
>Varje mål som listas i onu-gruppens målpost har sin egen grupp, vars beteckning är målets namn. Tabellen nedan listar posterna i dessa grupper. </para>
        <para>
          <table>
            <title
>Målposter</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Postnamn</entry
><entry
>Betydelse</entry
></row
></thead>
              <tbody>
                <row
><entry
>type</entry
><entry
>Målets typ. Kan vara kontinenter, länder eller spelare</entry
></row>
                <row
><entry
>nbArmiesByCountry</entry
><entry
>ställer in minimalt antal arméer spelaren måste placera på varje land</entry
></row>
                <row
><entry
>nbCountries</entry
><entry
>ställer in antal länder som spelaren måste äga</entry
></row>
                <row
><entry
>nbCountriesFallback</entry
><entry
>För måltypen spelare, om målets spelare dödas av någon annan, ställer det här in antal länder som spelaren måste erövra istället</entry
></row>
                <row
><entry
>desc</entry
><entry
>En fullständig textbeskrivning av målet med lämpliga platsmarkörer (ytterligare dokumentation behövs här)</entry
></row>
                <row
><entry
>continents</entry
><entry
>Listan med kontinent-identifierare som spelaren måste erövra</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

    </sect2>
  </sect1>
  <sect1 id="tid">
    <title
>Katalogen Images</title>
    <para
>Katalogen innehåller knappar specifika för &kapp;, och SVG-filen pool som innehåller kartan och alla figurer. </para>
    <sect2>
      <title
>Filen pool.svg</title>
      <para
>SVG-filen innehåller kartan och alla spelets figurer. Varje element namnges så att spelet kan välja och återge var och en av dem separat. </para>
      <para
>Med standardskalet är figurerna flaggor, infanterister, kavalleri och kanoner. En infanterist representerar en armé, kavalleri är fem och kanoner är tio. Kanoner används också för att visa stridande arméer. Därför finns det tre olika sorters kanonfigurer: normala stillastående eller förflyttade, skjutande och exploderande kanoner. </para>
      <para
>Varje figurbild är sammanslagningen av objektets diverse olika vyer, och för varje vy, dess ramar. Vyerna organiseras vertikalt, och ramarna horisontellt. Var bilden ska delas i enskilda ramar beräknas genom att dela bildens höjd med antal vyer och dess bredd med antal ramar. Denna information hittas i filen onu.desktop. <mediaobject
><imageobject
><imagedata fileref="cannon.png" format="PNG"/></imageobject
><caption
><para
>Ett exempel på en figurbild: cannon.png</para
></caption
></mediaobject>
      </para>
      <para
>För arméfigurer finns det tre olika versioner, uppifrån och ner: vända åt höger, vända åt vänster och vända framåt. För flaggor finns bara en version. Alla figurernas bakgrunder ska vara genomskinliga. <mediaobject
><imageobject
><imagedata fileref="italy.png" format="PNG"/></imageobject
><caption
><para
>Ett exempel på en flaggfigurbild: italy.png</para
></caption
></mediaobject>
      </para>
      <para>
      <table>
      <title
>Elementen i pool</title>
      <tgroup cols="3">
      <thead
><row
><entry
>Elementnamn</entry
><entry
>Exempelbild</entry
><entry
>Betydelse</entry
></row
></thead>
      <tbody>
        <row>
          <entry
>map</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="map.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>Karta över skalets värld. Länder kan ha godtyckliga former, men bör grupperas i kontinenter som kan kännas igen med blotta ögat, enligt plats eller färg.</entry>
  </row>
        <row>
          <entry
>italy</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="italy.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>Flaggan för nationen italy. Det finns en sådan post för varje nation</entry>
  </row>
        <row>
          <entry
>infantry</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>cavalry</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>cannon</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>firing</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>exploding</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>Alaska</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>reddices</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>mark1</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
        </row>
      </tbody>
      </tgroup>
      </table>
      </para>
    </sect2>
    <sect2>
      <title
>Filen map-mask.png</title>
      <para
>Detta är en png-fil som också representerar skalets världskarta, men med kodade färger som gör det möjligt att unikt identifiera varje land. Länder måste åtminstone ha samma form som motsvarande länder i filen map.png, så att användare kan klicka var som helst i ett synligt land och markera det på ett bra sätt. Länder som består av små öar, som Indonesien på standardkartan, kan vara större än motsvarigheten i filen map.png för att förenkla markering av landet. <mediaobject>
          <imageobject
><imagedata fileref="map-mask.png" format="PNG"/></imageobject>
          <textobject
><phrase
>Ett exempel på en kartmask</phrase
></textobject>
        </mediaobject>
      </para>
      <para
>Ett lands blåa komponent (med RGB-modellen) identifierar landet: index 0 är land 0 i filen onu.xml,, index 1 är land 1, etc. Vitt (0xFFFFFF med RGB) identifierar frånvaro av ett land (hav eller, varför inte, ingenmansland). </para>
    </sect2>
    <sect2>
      <title
>Knappbilderna</title>
      <para
>Filnamnen är hårdkodade i källkoden, så de får inte ändras. Tabellen nedan visar alla knappar som måste tillhandahållas.</para>
      <table>
      <title
>Knapparna i det grafiska gränssnittet</title>
      <tgroup cols="3">
      <thead
><row
><entry
>Bild</entry
><entry
>Filnamn</entry
><entry
>Betydelse</entry
></row
></thead>
      <tbody>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="newNetGame.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>newNetGame.png</entry
><entry
>Försöker gå med i ett nätverksspel</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="recycling.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>distributionArmees.png</entry
><entry
>När alla spelare har placerat ut sina arméer är det möjligt att ändra fördelningen (betecknat omfördela). Knappen begär att utföra en sådan omfördelning.</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="recyclingFinished.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>distributionArmeesFinie.png</entry
><entry
>Väljer att inte omfördela. För att omfördelningen verkligen ska avslutas måste knappen klickas i alla klientfönster.</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="nextPlayer.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>joueurSuivant.png</entry
><entry
>Avslutar den nuvarande spelarens tur och byter till nästa, eller går till nästa omgång om den nuvarande spelaren var sist</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="attackOne.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>attackOne.png</entry
><entry
>Väljer att börja ett anfall med en armé</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="attackTwo.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>attackTwo.png</entry
><entry
>Väljer att börja ett anfall med två arméer</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="attackThree.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>attackThree.png</entry
><entry
>Väljer att börja ett anfall med tre arméer</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="defendOne.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>defendOne.png</entry
><entry
>Väljer att försvara ett anfallet land med en armé</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="defendTwo.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>defendTwo.png</entry
><entry
>Väljer att försvara ett anfallet land med två arméer</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="moveArmies.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>moveArmies.png</entry
><entry
>Väljer att börja flytta arméer mellan två länder (sista åtgärden i turen)</entry>
        </row>
      </tbody>
      </tgroup>
      </table>
    </sect2>
  </sect1>
  <sect1 id="tsd">
    <title
>Katalogen Sounds</title>
    <para
>Katalogen innehåller tre ljudfiler: roll.wav spelas när arméer flyttas, canon.wav spelas vid eldgivning och crash.wav spelas när en kanon exploderar.</para>
  </sect1>
</chapter>

<chapter id="faq">
<title
>Vanliga frågor</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist"
> <qandaentry>
<question>
<para
>Vad kommer att bli den första frågan rörande &kapp;?</para>
</question>
 
</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
>&kapp; </para>
<para
>Program copyright 2002-2008 Gael de Chalendar <email
>kleag@free.fr</email
> </para>
<para
>Bidragsgivare: Robin Doer, Albert Astals Cid, Michal Golunski (översättning till Polska). </para>

<para
>Dokumentation copyright 2002-2008 Gael de Chalendar <email
>kleag@free.fr</email
> </para>

<para
>Översättning Stefan Asserhäll <email
>stefan.asserhall@comhem.se</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installation</title>

<sect1 id="getting-ksirk">
<title
>Hur man skaffar &kapp;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Kompilering och installation</title>
&install.compile.documentation; </sect1>

<sect1 id="configuration">
<title
>Inställning</title>

<para
>Inställningsmenyns alternativ visar en dialogruta som låter dig: <screenshot>
            <screeninfo
>Inställningsdialogruta</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="preferences.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Inställningsdialogruta</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
</para>
      <itemizedlist>
        <listitem>
          <para
>aktivera eller inaktivera ljud, </para>
        </listitem>
        <listitem>
          <para
>ställa in figurernas hastighet (från långsamt till omedelbart), </para>
        </listitem>
        <listitem>
          <para
>aktivera eller inaktivera sammanhangsberoende hjälp som visas i meddelanderutor, </para>
        </listitem>
        <listitem>
          <para
>visa eller dölja antal arméer i varje land. Följande skärmbild visar kartan när antal arméer visas. <screenshot>
              <screeninfo
>Visning av antalet arméer</screeninfo>
              <mediaobject>
                <imageobject>
                  <imagedata fileref="shownumberofarmies.png" format="PNG"/>
                </imageobject>
                <textobject>
                  <phrase
>Visning av antalet arméer</phrase>
                </textobject>
              </mediaobject>
            </screenshot>

          </para>
        </listitem>
      </itemizedlist>

</sect1>

</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->













