<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
 <!ENTITY kappname "&kblackbox;">
 <!ENTITY package "kdegames">
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % Danish "INCLUDE"
> <!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title
>&kblackbox;-håndbogen</title>
    
<authorgroup>
<author
>&Robert.Cimrman; &Robert.Cimrman.mail; </author>

<author
>&Philip.Rodrigues; &Philip.Rodrigues.mail; </author>

<othercredit role="developer"
>&Robert.Cimrman; &Robert.Cimrman.mail; </othercredit>

<othercredit role="reviewer"
>&Lauri.Watts; &Lauri.Watts.mail; </othercredit>

&erik.kjaer.pedersen.role; 

</authorgroup>

<copyright>
<year
>1998</year
><year
>2000</year>
<holder
>&Robert.Cimrman;</holder>
</copyright>

<copyright>
<year
>2001-2003</year>
<holder
>&Philip.Rodrigues;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2005-12-10</date>
<releaseinfo
>0.3.0</releaseinfo>

<abstract
><para
>&kblackbox; er et vidunderligt grafisk logisk spil, inspireret af <application
>emacs</application
> blackbox-spillet</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KBlackBox</keyword>
<keyword
>kdegames</keyword>
<keyword
>blackbox</keyword>
<keyword
>spil</keyword>
</keywordset>

</bookinfo>

<chapter id="what-is-kblackbox">
<title
>Hvad er &kblackbox;?</title>

<para
>K&kblackbox; er et superbt :-) grafisk logisk spil, inspireret af emacs' blackbox-spil. En stor del af denne hjælpefil er baseret på den oprindelige <application
>emacs</application
>'s hjælp. </para>

<para
>K&kblackbox; er et spil hvor man gemmer og søger, spillet på et gitter af felter. Din modstander (I dette tilfælde en tilfældige tal generator) har skjult adskillige bolde inden i dettefelt. Ved at skyde stråler ind i feltet og se hvor de kommer ud er det muligt at deducere de skjulte boldes placering. Jo færre stråler man bruger for at finde boldene, jo bedre (lavere) er din scoring.</para>

</chapter>

<chapter id="game-description">
<title
>Spilbeskrivelse</title>

<para
>I den første del af dette afsnit vil vi give en beskrivelse af brættet. Den anden del drejer sig om hvordan brugeren bruger brættet, og endelig i det tredje afsnit forklares de egentlige spilleregler.</para>

<sect1 id="game-board-descritpion">
<title
>Spillebræt beskrivelse</title>

<para
>Der er følgende typer felter på spillebrættet: </para>

<variablelist>
<varlistentry>
<term
><interface
>Sorte kvadrater</interface
></term>
<listitem
><para
>Det sorte felt. Her markerer du de felter, hvor boldene formodentlig er.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Grønne kvadrater</interface
></term>
<listitem
><para
>Dette er dine laser-skydende stråler af lys, når de er slået til.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Lysegrå kvadrater</interface
></term>
<listitem
><para
>Intet af interesse, - det er bare en kant :-)</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Blå bolde</interface
></term>
<listitem
><para
><quote
>Der må være en der!</quote
>, tror du. Disse markerer hvor du formoder er placeret i et sort felt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Cyan bolde</interface
></term>
<listitem
><para
>Viser hvor boldene rent faktisk er.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Røde bolde</interface
></term>
<listitem
><para
>Forkert placerede bolde som du har markeret vises med rødt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><interface
>Brune kvadrater</interface
></term>
<listitem
><para
>Markeringsfarve</para
></listitem>
</varlistentry>
</variablelist>

<note
><para
>Farvernes navne er blot brugt for at identificere de forskellige typer af felter i denne tekst De <emphasis
>behøver ikke</emphasis
> at være de samme som de aktuelle farver på felterne. Simpelt sagt: det sorte felt er i midten, der er lasere omkring og udenom er der kant. Du kan selv vælge at lave farverne om :-). </para
></note>

</sect1>

<sect1 id="user-interaction">
<title
>Brugerinteraktion</title>

<para
>Markøren kan flyttes rundt i feltet med standard markørtaster. Ændring af lasere eller markering af sorte kasser gøres med &LMB;, eller ved at trykke på <keycap
>Return</keycap
> eller &Enter;-tasterne.</para>

<para
>Man kan også markere felterne hvor du tror en bold ikke kan være. Tryk blot på &RMB;. Dette hjælper ofte til at finde et område hvor en bold muligvis kunne være. For at fjerne mærker (blå eller brune) trykker man på &LMB;. Brune mærker kan ikke overskrive blå markeringer. Derfor kan man ikke slette blå markeringer (gættede bolde) ved et tilfælde når man leger med &RMB;. </para>

<para
>Når du tror konfigurationen af bolde du har placeret er korrekt trykker du på den &MMB;. Du vil få at vide om du havde ret eller ej og du får at vide hvor mange points du fik. Dine points er antal bogstaver og tal rundt om ydersiden af feltet plus fem for hver forkert placeret bold. Hvis du har placeret bolde forkert bliver det vist med røde felter, og deres rigtige placering bliver vist med cyan felter.</para>

</sect1>

<sect1 id="game-rules">
<title
>Spilleregler</title>

<para
>Du skal finde boldene gemt i den sorte kasse. Dine metoder er begrænsede - du kan blot affyre lasere som er omkring kassen. Der er tre mulige resultater for hver stråle du sender ind i feltet: </para>

<anchor id="detour"/>
<variablelist>

<varlistentry>
<term
>Detour</term
> 
<listitem
><para
>Strålen afbøjes og kommer ud et andet sted end der hvor du sendte den ind. På spillefeltet vises dette med et par tal - et hvor strålen gik ind, og et hvor den kom ud.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Refleksion</term>
<listitem
><para
>Strålen reflekteres og kommer ud samme sted som der hvor den kom ind. På spillefeltet er refleksioner vist med bogstavet <guilabel
>R</guilabel
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Træf</term>
<listitem
><para
>Strålen rammer en bold og absorberes. Den kommer ikke ud af feltet igen. På spillefeltet vises dette med bogstavet <guilabel
>H</guilabel
>.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Reglerne for hvordan en stråle afbøjes er simple og bedst vist ved et eksempel.</para>

<para
>Når en stråle nærmer sig en bold afbøjes den halvfems grader. Stråler kan afbøjes flere gange. I diagrammerne nedenfor, repræsenterer tomme kasser og bogstavet <guilabel
>O</guilabel
> bolde. Indgang og udgang af hver stråle er markerede med tal som vist under <link linkend="detour"
>Detour</link
> ovenfor. Bemærk at indgangspunkt og udgangspunkt altid kan byttes om. <guilabel
>*</guilabel
> viser den sti strålen tager.</para>

<para
>Bemærk omhyggeligt de relative positioner af bolden og den 90 graders afbøjning det forårsager.</para>

<screen
>1                                            
  - * - - - - - -         - - - - - - - -         - - - - - - - -       
  - * - - - - - -         - - - - - - - -         - - - - - - - -       
1 * * - - - - - -         - - - - - - - -         - O - - - - O -       
  - - O - - - - -         - - O - - - - -         - - * * * * - -
  - - - - - - - -         - - - * * * * * 2     3 * * * - - * - -
  - - - - - - - -         - - - * - - - -         - - - O - * - -      
  - - - - - - - -         - - - * - - - -         - - - - * * - -       
  - - - - - - - -         - - - * - - - -         - - - - * - O -       
                                2                         3
</screen>

<para
>Som nævnt ovenfor forekommer en refleksion når en stråle kommer ud fra samme sted som den kommer ind. Dette kan ske på adskillige måder: </para>

<screen
>- - - - - - - -         - - - - - - - -          - - - - - - - -
  - - - - O - - -         - - O - O - - -          - - - - - - - -
R * * * * - - - -         - - - * - - - -          O - - - - - - -
  - - - - O - - -         - - - * - - - -        R - - - - - - - -
  - - - - - - - -         - - - * - - - -          - - - - - - - -
  - - - - - - - -         - - - * - - - -          - - - - - - - -
  - - - - - - - -       R * * * * - - - -          - - - - - - - -
  - - - - - - - -         - - - - O - - -          - - - - - - - -

</screen>

<para
>I første eksempel afbøjes strålen nedad af den øverste bold, så til venstre af den nederste bold og går derefter ud hvor den kom ind. Det andet eksempel er lignende. Det tredje eksempel er lidt usædvanligt men kan forklares ved at erkende at strålen aldrig får en chance for at komme ind i kassen. Alternativt kan man tænke på det som at strålen afbøjes nedad og straks går ud af kassen.</para>

<para
>Et træf er når stråler rammer lige ind i en bold:</para>

<screen
>- - - - - - - -         - - - - - - - -          - - - - - - - -
  - - - - - - - -         - - - - - - - -          - - - - O - - -
  - - - - - - - -         - - - - O - - -        H * * * * - - - -
  - - - - - - - -       H * * * * O - - -          - - - * - - - -
  - - - - - - - -         - - - - O - - -          - - - O - - - -
H * * * O - - - -         - - - - - - - -          - - - - - - - -
  - - - - - - - -         - - - - - - - -          - - - - - - - -
  - - - - - - - -         - - - - - - - -          - - - - - - - -

</screen>

<para
>Sørg for at sammenligne det andet eksempel hvor man rammer med det første hvor der er en refleksion</para>

</sect1>
</chapter>
<chapter id="gui-description">
<title
>&GUI;-beskrivelse</title>

<sect1 id="game-menu">
<title
><guimenu
>Spil</guimenu
>menuen</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></shortcut
><guimenu
>Spil</guimenu
><guimenuitem
>Nyt</guimenuitem
></menuchoice
></term>
<listitem
><para
>Starter et nyt spil (og afbryder det nuværende hvis der er et.)</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Spil</guimenu
> <guimenuitem
>Opgiv</guimenuitem
></menuchoice
></term>
<listitem
><para
>Viser dig boldenes placering.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Spil</guimenu
> <guimenuitem
>Færdig</guimenuitem
></menuchoice
></term>
<listitem
><para
>Tjekker om alle bolde er placerede. Hvis ja, afsluttes det aktuelle spil, pointtallet beregnes og de rigtige placeringer af boldene vises. Den <mousebutton
>mellemste</mousebutton
> museknap har samme funktion. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Spil</guimenu
> <guimenuitem
>Ændr størrelse</guimenuitem
></menuchoice
></term>
<listitem
><para
>Ændrer størrelse på hovedvinduet, så dets indhold passer perfekt. Dette er nyttigt hvis du tilfældigt ændrer størrelsen på vinduet...</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Spil</guimenu
> <guimenuitem
>Afslut</guimenuitem
></menuchoice
></term>
<listitem
><para
>Afslutter &kblackbox;</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="settings-menu">
<title
><guimenu
>Opsætnings</guimenu
>menuen</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Vis/Skjul værktøjslinje</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Viser eller skjuler &kblackbox;'s værktøjslinje.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Vis/Skjul statuslinje</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Viser eller skjuler statuslinje for &kblackbox; længst nede på skærmen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Opsætning</guimenu
> <guisubmenu
>Størrelse</guisubmenu
></menuchoice
></term>
<listitem
><para
>Sætter størrelsen på spillefeltet (sort kasse). Man kan vælge mellem <guimenuitem
>8 x 8</guimenuitem
>, <guimenuitem
>10 x 10</guimenuitem
> og <guimenuitem
>12 x 12</guimenuitem
>. Standard er <guimenuitem
>8 x 8</guimenuitem
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Opsætning</guimenu
> <guisubmenu
>Bolde</guisubmenu
></menuchoice
></term>
<listitem
><para
>Sætter antal bolde i det sorte felt. Man kan vælge mellem <guimenuitem
>4</guimenuitem
> (standard) <guimenuitem
>6</guimenuitem
> eller <guimenuitem
>8</guimenuitem
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Gennemgang</guimenuitem
></menuchoice
></term>
<listitem
><para
>Slår gennemgang tilstand til/fra. Her kan du altså se hvor boldene rent faktisk er. Bemærk at du skal starte et nyt spil for at få denne ændring til at betyde noget.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil genveje...</guimenuitem
></menuchoice
></term>
<listitem
><para
>Viser en standard &kde; genvejsindstillingsdialog, i hvilken du kan ændre tastaturets genveje der bruges af &kblackbox;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Opsætning</guimenu
><guimenuitem
>Indstil værktøjslinjer...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Viser &kde;'s standardindstillingsdialog for værktøjslinjer for at indstille &kblackbox;' værktøjslinje.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="help">
<title
><guimenu
>Hjælpe</guimenu
>menuen</title>
&help.menu.documentation; </sect1>

<sect1 id="toolbar">
<title
>Værktøjslinjen</title>

<screenshot>
<screeninfo
>&kblackbox;'s værktøjslinje</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="kblackboxtbar.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>

<para
>&kblackbox; værktøjslinje tilbyder hurtig adgang til de mest almindeligt brugte &kblackbox; funktioner. Fra venstre til højre er ikonerne:</para>

<variablelist>

<varlistentry>
<term
><guiicon
>Ny</guiicon
></term>
<listitem
><para
>Starter et nyt spil.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Giv op</guiicon
></term>
<listitem
><para
>Viser dig boldenes placering.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Færdig</guiicon
></term>
<listitem
><para
>Tjekker om alle bolde er placerede. Hvis ja, afsluttes det aktuelle spil, pointtallet beregnes og de rigtige placeringer af boldene vises. Den <mousebutton
>mellemste</mousebutton
> museknap har samme funktion. </para
></listitem>
</varlistentry>

</variablelist>
</sect1>
</chapter>

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

<para
>&kblackbox;</para>

<para
>Programmets ophavsret 1998-2000 &Robert.Cimrman; &Robert.Cimrman.mail;</para>

<para
>Dokumentation ved &Robert.Cimrman;. Opdateret oh konverteret til Docbook for &kde; 2.0 af &Lauri.Watts; &Lauri.Watts.mail;</para>

<para
>Nuværende vedligeholder &Philip.Rodrigues; &Philip.Rodrigues.mail; </para>

&erik.kjaer.pedersen.credit; 
&underFDL; &underGPL; </chapter>


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

&install.intro.documentation;

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

</book>

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

