<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
<!ENTITY kappname "&kabalone;">
<!ENTITY % Danish "INCLUDE">
<!ENTITY % addindex "IGNORE">
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
  %ents;
]>
<book lang="&language;">
<bookinfo>
<title>&kabalone; håndbog</title>
<authorgroup>
<author>
<firstname>Josef</firstname>
<surname>Weidendorfer</surname>
<affiliation><address><email>weidendo@informatik.tu-muenchen.de</email></address>
</affiliation>
</author>

<author>
<firstname>Philip</firstname>
<surname>Rodrigues</surname>
<affiliation><address><email>philip.rodrigues@libertysurf.co.uk</email></address>
</affiliation></author>

<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<affiliation><address><email>vampyr@atconnex.net</email></address></affiliation>
<contrib>Tester</contrib>
</othercredit>

</authorgroup>

<copyright>
<year>2000</year>
<holder>J Weidendorfer</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>15/09/2000</date>
<releaseinfo>1.06.00</releaseinfo>

<abstract><para>&kabalone; er et brætspil for KDE der kan bruges som netspil.</para></abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>spil</keyword>
<keyword>abalone</keyword>
<keyword>linux</keyword>
</keywordset>
</bookinfo>

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

<para>&kabalone; er et simpelt bræt strategispil der spilles af to spillere. Der
er røde og gule brikker for hver spiller. Fra en startposition hvor hver
spiller har 14 brikker trækkes der, indtil en spiller har skubbet 6 af
modstanderens brikker af brættet.</para>

<para>Det oprindelige program blev udviklet i 1993 for DOS for ren Xlib. For KDE
var der en større omskrivning.</para>  

<note><para> Spillets idé er ikke min. Det er
et rigtigt brætspil forhandlet af en tysk spilproducent (tror jeg).</para></note>

</chapter>

<chapter id="rules-of-the-game">
<title>Spillets regler</title>

<para>Rød trækker altid først.</para>
<para>To typer træk er tilladt:</para>

<variablelist>
<varlistentry>
<term>Normal</term>
<listitem><para>Én, to eller tre af dine brikker i en række kan flyttes i en af
6 retninger.
Sidebevægelser er også tilladte.</para>

<para>Tryk med <mousebutton>venstre</mousebutton> museknap på den første brik
du ønsker at flytte. Brikken
bliver nu markeret. Træk så musen i den ønskede retning. Hvis trækket er
gyldigt, vil markøren forvandle sig til en pil i den retning og alle brikker i
trækket vil blive markerede. Hvis du ønsker at udføre trækket, så giv slip på
museknappen.  </para>

<para>Sidelæns træk behandles på en anden måde: For to brikker ved siden af
hinanden, klik mellem dem og træk; hvis der er tre, så tryk på den midterste
knap på den midterste brik - hvis en sidelæns bevægelse er tilladt, så vil
brikkerne blive markerede. Ellers vil kun den midterste blive markeret og man
kan lave et normalt træk.</para></listitem>
</varlistentry>

<varlistentry>
<term>Skubning</term>
<listitem><para>Man kan skubbe op til to af modstanderens brikker på brættet
hvis de er foran
ens egne brikker og der er flere af ens egne end af modstanderens. Det vil sige
med tre kan man skubbe to ud, og med to kan man skubbe en ud.</para>

<para>Særlige skubbetræk er de der skubber modstanderens brikker af brættet.
Når man har seks af disse har man vundet.  </para></listitem>
</varlistentry>
</variablelist>

<para>Hvis du stadig ikke ved hvad &kabalone; drejer sig om, så kig på et spil
hvor maskinen spiller begge sider. Efter at have startet &kabalone;, vælg <menuchoice>
<guimenu>Indstillinger</guimenu> <guisubmenu>Maskinen spiller</guisubmenu>
<guimenuitem>Begge</guimenuitem> </menuchoice> og start et nyt spil. </para>

</chapter>

<chapter id="the-user-interface">
<title>Brugerfladen</title>

<para>Trækkene er forklaret  under <link linkend="rules-of-the-game">Spillets
regler</link>. Knapperne i redskabslinien har samme betydning som indgangene i 
i <guimenu>Spil</guimenu> menuen.</para> 


<sect1 id="game-menu">
<title>Spilmenuen</title>

<variablelist>
<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></shortcut>
<guimenu>Spil</guimenu><guimenuitem>Nyt spil</guimenuitem>
</menuchoice>
</term>
<listitem><para>Start et nyt spil selv om der er et spil igang.
</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo><keycap>S</keycap></keycombo></shortcut>
<guimenu>Spil</guimenu><guimenuitem>Stop søgning</guimenuitem>
</menuchoice>
</term>
<listitem><para>Når maskinen tænker, afbrudes dens dybe tænkning og den bruger
det bedst træk fundet indtil nu.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo><keycap>Pg Up</keycap></keycombo></shortcut>
<guimenu>Spil</guimenu><guimenuitem>Tag tilbage</guimenuitem>
</menuchoice></term>
<listitem><para>Tag dit tidligere træk tilbage. To (!) træk gøres om:
modstanderens træk og dit sidste træk. Så det er din tur igen. 100 træk huskes; 
så tøv ikke med at gå tilbage indtil du er ved begyndelsen af spillet
of the game (hurtigere med <keycap>Pg Up</keycap> tasten). I ændringtilstand
(se Menu <menuchoice><guimenu>Redigér</guimenu> <guimenuitem>Ændr</guimenuitem>
</menuchoice> nedenfor), går træknummeret for stillingen ned.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo><keycap>Pg Down</keycap></keycombo></shortcut>
<guimenu>Spil</guimenu><guimenuitem>Fremad</guimenuitem>
</menuchoice>
</term>
<listitem><para>Kun nyttigt i ændringstilstand: Øg træk nummer for denne
stilling.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut><keycap>H</keycap></shortcut>
<guimenu>Spil</guimenu><guimenuitem>Vink</guimenuitem>
</menuchoice>
</term>
<listitem><para>Et vink for dit næste træk vises. Kun muligt hvis du spiller på
normalt niveau
eller over, trækket er over 2 og du ikke har omgjort træk.</para> </listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut><keycap>N</keycap></shortcut>
<guimenu>Spil</guimenu><guimenuitem>Netværk</guimenuitem>
</menuchoice>
</term>
<listitem><para>Hvis dette er aktiveret er anvendelsen i netværkstilstand. Alle
kørende &kabalone;
programmer der er i netværkstilstand sender ændrede stillinger til hinanden. På
denne måde kan to mennesker spille mod hinanden på to forskellige computere
eller man kan observere spillet fra et andet &kabalone; program.</para>

<para>For at udveksle positioner skal &kabalone; programmerne kende til hinanden.
Hvis de kører på den samme maskine behøves intet (udover at skifte til
netværkstilstand). Hvis de kører på forskellige computere skal man angive de
andre maskiner med <option>-h</option> kommandolinievalget.</para>

<para>For kendere: Når &kabalone; er i netværkstilstand lytter den til en Tcp
sokkel for ændrede stillinger i det andet &kabalone; program. Man kan angive
portnummeret ved hjælp af <option>-p</option> kommandolinievalge.
Dette bliver man nødt til hvis flere vil spille på to forskellige maskiner.
</para>

<para>Eksempler:</para>
<itemizedlist>
<listitem><para>Peter på <systemitem class="systemname">maskine1</systemitem>
og Marie på <systemitem class="systemname">maskine2</systemitem> vilspille mod
hinanden. Marie starter simpelthen &kabalone;, sætter menupunktet
<menuchoice><guimenu>Indstillinger</guimenu> <guisubmenu>Maskinen spiller</guisubmenu>
</menuchoice> til <guimenuitem>Ingen</guimenuitem> og skifter til
netværkstilstand. Peter starter &kabalone; med <command>kabalone <option>-h
<replaceable>maskine2</replaceable></option></command>, og gør i øvrigt det
samme. Nu kan én af dem starte et spil og trække som rød.
Hver gang stillingen ændres hos den ene ændres den hos den anden også.
</para> </listitem>

<listitem><para>Søren vil gerne kigge på spillet: Han gør det samme som Peter,
men han trækker ikke selv.</para></listitem>

<listitem><para>To forskellige &kabalone;  netværksspil skal køre mellem maskinerne
<systemitem class="systemname">m1</systemitem> og <systemitem
class="systemname">m2</systemitem>.  For at
skelne mellem spillene, vælger vi port nummer 12345 for den ene.
På <systemitem class="systemname">m1</systemitem> starter vi som sædvanlig
<command>kabalone</command> og (ikke som sædvanlig) <command>kabalone
<option>-p <replaceable>12345</replaceable></option></command>. På <systemitem
class="systemname">m2</systemitem> starter vi <command>kabalone <option>-h
<replaceable>m1</replaceable></option></command> og <command>kabalone
<option>-h <replaceable>m1:12345</replaceable></option></command> (Kolon
adskiller vært og port som i en <abbrev>url</abbrev>).</para></listitem>

</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo> </shortcut>
<guimenu>Spil</guimenu><guimenuitem>Afslut</guimenuitem>
</menuchoice>
</term>
<listitem><para>Afslutter spillet.</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="edit-menu">
<title><guimenu>Redigeringsmenu</guimenu></title>

<variablelist>
<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>Ins</keycap></keycombo></shortcut>
<guimenu>Redigér</guimenu><guimenuitem>Ændr</guimenuitem>
</menuchoice>
</term>
<listitem><para>Sætter &kabalone; i ændringstilstand. Nu kan man redigere det
aktuelle bræt ved at
tilføje røde og gule brikker og slette dem. Statuslinien viser antal røde og
gule brikker, træknummeret, hvis tur det er, og om stillingen er gyldig:
Et udråbstegn betyder nej, et tjeksymbol ja. Hvis stillingen er ugyldig og du
skifter tilbage til normal spilletilstand kan du ikke spille! Kun gyldige
stillinger kan bruges som udgangspunkt for et spil. Bemærkning: i
netværkstilstand sendes startpositionen når man skifter tilbage til
spilletilstand.   
<guimenuitem>Tag tilbage</guimenuitem> og
<literal remap="tt">Fremad</literal> (i <guimenu>Spil</guimenu> menuen,
 formindsker og øger simpelthen træknummeret, men
ændrer ingen brikker.  </para>
<para>Ved at trykke på <mousebutton>venstre</mousebutton> museknap på et tomt
eller et gult felt "Tilføj rød brik" tilstand; ved at trykke på
<mousebutton>mellem</mousebutton> knappen på et tomt eller et rødt felt kommer
man i "Tilføj gul brik" tilstand. Endelig ved at trykke på
<mousebutton>venstre</mousebutton> museknap på en rød brik eller den 
<mousebutton>mellemste</mousebutton> museknap på en gul brik, kommer man i 
"Slet brik" tilstand.  Mens man holder museknappen nede og trækker
den rundt vil den virke på hvert felt musen går over. Man afslutter ved at give
slip på museknappen.</para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>C</keycap></keycombo></shortcut>
<guimenu>Redigér</guimenu><guimenuitem>Kopiér</guimenuitem>
</menuchoice>
</term>
<listitem><para>Kopiér en ascii repræsentation af den aktuelle brætstilling til
X klippebordet.
Nu kan du indsætte det i et vilkårligt redigeringsprogram ved at trykke på den
midterste knap der.  </para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>V</keycap></keycombo></shortcut>
<guimenu>Redigér</guimenu><guimenuitem>Indsæt</guimenuitem>
</menuchoice>
</term>
<listitem><para>Fortolk indholdet af X klippebordet som en ascii repræsentation
af &kabalone; brættet svarende til en vis brætstilling. En gyldig
ASCII repræsentation kan genereres af
<guimenuitem>Kopiér</guimenuitem>.</para>
<para>På denne måde kan man udveksle brætstillinger fra to &kabalone; programmer
ved at trykke på <guimenuitem>Kopiér</guimenuitem> i et program
<guimenuitem>Indsæt</guimenuitem> i det andet,  men dette gøres bedre i
netværkstilstand (se ovenfor). En anden brug er at gemme stillinger i en
tekstfil (ved brug af <guimenuitem>Kopiér</guimenuitem>  og dit favorit
redigeringsprogram, og hente stillingen senere ved at vælge teksten i
redigeringsprogrammet og trykke på <guimenuitem>Indsæt</guimenuitem> i
&kabalone;
programmet.</para> </listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo></shortcut>
<guimenu>Redigér</guimenu><guimenuitem>Gem stilling</guimenuitem>
</menuchoice></term>
<listitem><para>Man kan gemme den aktuelle stilling og hente den senere med 
<guimenuitem>Gemopret stilling</guimenuitem>.</para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></shortcut>
<guimenu>Redigér</guimenu><guimenuitem>Genopret stilling</guimenuitem>
</menuchoice></term>
<listitem><para>Stillingen gemmes i abalone indstillingsfilen.
file.</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="settings-menu">
<title><guimenu>Indstillingsmenuen</guimenu></title>

<variablelist>
<varlistentry>
<term>
<menuchoice>
<guimenu>Indstillinger</guimenu><guimenuitem>Vis menubjælke</guimenuitem>
</menuchoice></term>
<listitem><para>Vis eller skjul menubjælken.  Menubjælken kan fås frem igen ved
at klikke på <mousebutton>højre</mousebutton> museknap i spillevinduet,
og vælge <guisubmenu>Indstillinger</guisubmenu>.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Indstillinger</guimenu><guimenuitem>Vis
redskabslinie</guimenuitem></menuchoice></term>
<listitem><para>Vis eller skjul ikon redskabslinien</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Indstillinger</guimenu><guimenuitem>Vis
Statusbjælke</guimenuitem></menuchoice></term>
<listitem><para>Vis eller skjul statusbjælken</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Indstillinger</guimenu><guimenuitem>Gem
indstillinger</guimenuitem></menuchoice></term>
<listitem><para>Gem alle indstillinger som de er nu</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Indstillinger</guimenu><guimenuitem>Indstil 
tastebindinger</guimenuitem></menuchoice></term>
<listitem><para>Åbner en standard KDE dialogboks der tillader dig at ændre
&kabalone;'s
tastebindinger</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Indstillinger</guimenu><guimenuitem>Indstil
redskabsbjælker</guimenuitem></menuchoice></term>
<listitem><para>Åbner en standard KDE dialogboks der tillader dig at ændre
&kabalone;'s redskabslinie. </para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Indstillinger</guimenu><guisubmenu>Niveau</guisubmenu></menuchoice>
</term>
<listitem><para>Maskinen kan spille på fire forskellige niveauer. Dette
influerer hvor mange
træk den gennemsøger for at beregne det bedste træk. Man kan afbryde denne
søgning ved at trykke på <keycombo><keycap>S</keycap></keycombo> tasten. </para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Indstillinger</guimenu><guisubmenu>Maskinen spiller</guisubmenu></menuchoice>
</term>
<listitem><para>Man kan lade maskinen spille rød, gul eller begge sider. Vælg
mellem disse
indstillinger før du starter et nyt spil. Dette virker naturligvis også i et
spil hvis du ønsker at skifte sider. Vælg <guimenuitem>Ingen</guimenuitem> for 
 at spille mod et andet
menneske. Dette er meget nyttigt i netværkstilstand.  </para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu>Indstillinger</guimenu><guimenuitem>Flyt langsomt</guimenuitem></menuchoice>
</term>
<listitem><para>Et af maskinens træk vises normalt (når dette er afkrydset) ved
blinkning og
markering af de brikker der bruges i trækket. Tjek ikke her hvis du ønsker at
undgå denne animering: så vil der kun være en hurtig markering.  </para> 
</listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice><guimenu>Indstillinger</guimenu><guimenuitem>Fordel bolde</guimenuitem>
</menuchoice></term>
<listitem><para>Hvis dette er markeret vil brikkerne blive placeret på linie
ved hjælp af en
simpel mekanisme når det behøves ( <abbrev>f. eks. </abbrev> når vinduet ændrer størrelse).
</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Indstillinger</guimenu><guimenuitem>Spionér</guimenuitem>
</menuchoice></term>
<listitem><para>Hvis dette er afkrydset kan du se hvor godt dit træk er efter
maskinens
mening. Når det er maskinens tur  kan du se hvilket træk den mener er bedst for
øjeblikket. Dette ændres naturligvis mens der søges efter bedste træk.
</para> </listitem>
</varlistentry>
</variablelist>
</sect1>
</chapter>

<chapter id="command-line-options">
<title>Kommandolinie muligheder</title>

    <cmdsynopsis>
      <command>kabalone</command>
      <arg>-p MyPortNumber</arg>
      <arg>-h host<arg>:Port</arg></arg>
    </cmdsynopsis>

<para>Med <option>-p</option>  angiver du portnummeret på den
lyttende TCP sokkel i netværkstilstand.
</para> 
<para>Med <option>-h</option>  Angiver man en fjern &kabalone; proces
(det er også muligt at tilføje portnummer hvis man ikke bruger standard porten
på den fjerne maskine) til at kommunikere i netværkstilstand. Man kan angive
flere fjerne porcesser.  </para>

</chapter>

<chapter id="credits-and-licenses">
<title>Medvirkende og licens</title>

<para>&kabalone;</para>

<para>Program ophavsret 1997-2000 Josef Weidendorfer
<email>weidendo@informatik.tu-muenchen.de</email></para>

<para>Oprindelig dokumentation ved Robert Williams
<email>rwilliams@kde.org</email> and Josef Weidendorfer</para>

<para>Dokumentation updateret for KDE 2.0 ved Philip Rodrigues <email>philip.rodrigues@libertysurf.co.uk</email></para>
<para>Dansk oversættelse ved Erik Kjær Pedersen <email>erik@binghamton.edu</email></para>

&underFDL;
&underGPL;

</chapter>

<appendix id="installation"> 
<title>Installation</title>
 
<sect1 id="getting-kabalone">
<title>Hvordan får man fat på &kabalone;</title>
 
<para>
&kabalone; er en del af KDE Projektet <ulink
url="http://www.kde.org">http://www.kde.org</ulink>.  &kabalone; findes i
kdegames pakken på <ulink
url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, hoved
ftp stedet for KDE projektet. </para>
<para>
Alle nødvendige biblioteker findes også på <ulink
url="ftp://ftp.kde.org">KDE FTP stedet</ulink>.
</para>
</sect1>
 
<sect1 id="compilation">
<title>Kompilering og installation</title>
 
<para>For at kompilerer og  installere &kabalone; på dit system, skriv
følgende i  &kabalone; mappen i  kdegames distributionen:</para>
 
<screen width="40">
<prompt>%</prompt> <command>./configure</command>
<prompt>%</prompt> <command>make</command>
<prompt>%</prompt> <command>make <option>install</option></command> </screen>
 
<para>Da &kabalone; bruger <application>autoconf</application> og
<application>automake</application> skulle du ikke have problemer med at
kompilere den. Hvis du løber ind i problemer så rapportér dem venligst til
<ulink
url="mailto:weidendo@informatik.tu-muenchen.de">forfatteren</ulink>.</para>
 
</sect1>
</appendix>

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
