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

<book lang="&language;">
<bookinfo>
<title
>&kshisen;-håndbogen</title>

<authorgroup>
<author
><firstname
>Dirk</firstname
> <surname
>Doerflinger</surname
> <affiliation
> <address
>&Dirk.Doerflinger.mail;</address>
</affiliation>
</author>
<othercredit role="reviewer"
><firstname
>Frerich</firstname
><surname
>Raabe</surname
> <contrib
>Tester</contrib>
<affiliation
><address
>&Frerich.Raabe.mail;</address
></affiliation>
</othercredit>
&erik.kjaer.pedersen.role; 
</authorgroup>


<date
>2006-06-17</date>
<releaseinfo
>1.5.1</releaseinfo>

<abstract>
<para
>&kshisen; er et spil som ligner Mahjongg for &kde;.</para>
</abstract>

<keywordset>
      <keyword
>KDE</keyword>
      <keyword
>kdegames</keyword>
      <keyword
>kshisen</keyword>
      <keyword
>spil</keyword>
      <keyword
>shisen-sho</keyword>
</keywordset>

</bookinfo>


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

<para
>&kshisen; er et enkeltspiller spil, der minder om Mahjongg og bruger de samme brikker som Mahjongg.</para
> 

<para
>Spillets formål er at fjerne alle fliserne fra feltet.</para>

</chapter>

<chapter id="playing-kshisen">
<title
>Spil &kshisen;</title>

<sect1 id="rules">
<title
>Regler</title>

<para
>Formålet med spillet er at fjerne alle fliser fra brættet. Kun to ens fliser kan fjernes af gangen. To ens fliser kan kun fjernes hvis de kan forbindes med maksimalt tre forbundne linjer. Linjer kan være vandrette eller lodrette men ikke diagonale. </para>

<para
>Man skal ikke selv tegne linjerne, spillet gør det for dig. Markér blot to ens fliser på brættet så vil de blive forbundet med maksimalt tre linjer hvis det er muligt og fliserne vil blive fjernet. </para>

<para
>Husk at linjerne ikke må krydse andre fliser. Hvis du ikke kan finde nogen kan du bruge "vink" til at finde to fliser der kan fjernes. Ved at klikke på en flise med &RMB; vises alle tilsvarende fliser hvad enten de kan forbindes eller ej.</para>

<para
>Spillet er slut når ingen træk er mulige. Dette kan forårsages af at alle brikker er væk fra spilleplanen, eller et punkt i spillet nås hvor ingen brikker som passer sammen kan sammenbindes med tre linjer. Visse spil er ikke løsbare. Hvis du vil undgå ikke løsbare spil, afmarkeres punktet  <guilabel
>Tillad uløsbare spil</guilabel
> i indstillingsdialogen.</para>

<para
>Resultatet <quote
>S</quote
> beregnes ved brug af følgende formel, hvor det antages at <quote
>n</quote
> repræsentere antallet af fliser til stede da spillet startede og <quote
>t</quote
> står for tiden (i sekunder) det tog at rydde feltet:</para>

<mediaobject
><imageobject>
<imagedata fileref="score-formula.png" format="PNG"/>
</imageobject
><textobject>
<phrase
>S=(n/t)*sqrt(n/84)/0.0014</phrase>
</textobject
></mediaobject>

<para
>Hvis du spillede med <guilabel
>Tyngdekraft</guilabel
>-indstillingen slået til vil denne score derudover blive ganget med to.</para>
</sect1>
</chapter>

<chapter id="menu-reference">
<title
>Menureference</title>

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

<para
><guimenu
>Spil</guimenu
>-menuen lader dig kontrollere status af det aktuelle spil:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>N</keycap
></keycombo
></shortcut
> <guimenu
>Spil</guimenu
><guimenuitem
>Nyt</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Afslut det nuværende spil</action
> og start en ny session med nye fliser. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>F5</keycap
></keycombo
></shortcut
> <guimenu
>Spil</guimenu
><guimenuitem
>Genstart spil</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Genstart det nuværende spil med de samme fliser.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>P</keycap
></keycombo
></shortcut
> <guimenu
>Spil</guimenu
> <guimenuitem
>Pause</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Hold pause i hele spillet</action
>, specielt i klokken der påvirker for scoringen. Menuindgangen bruges også til at genoptage spillet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Spil</guimenu
><guimenuitem
>Vis topresultater</guimenuitem
></menuchoice
></term>
<listitem
><para
>Viser den (lokale) Top-ti liste for &kshisen;.</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
><action
>Afslutter</action
> &kshisen;. </para
></listitem>
</varlistentry>

</variablelist>

<para
>Nogle af menupunkterne kan også kontrolleres med genvejstaster. Se <xref linkend="key-bindings"/> for en liste.</para
> 

</sect1>

<sect1 id="move-menu">
<title
><guimenu
>Flyt</guimenu
>-menuen</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Flyt</guimenu
> <guimenuitem
>Fortryd</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Fortryd det sidste træk</action
>. <guibutton
>Fortryd</guibutton
> knappen i værktøjslinjen gør det samme.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Flyt</guimenu
> <guimenuitem
>Annullér fortryd</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Omgør det sidste træk</action
>. <guibutton
>Annullér fortryd</guibutton
> knappen i værktøjslinjen gør det samme.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
> <keycap
>H</keycap
></keycombo
></shortcut
> <guimenu
>Flyt</guimenu
><guimenuitem
>Få vink</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Vis et vink</action
>, om hvilke to fliser der bør fjernes nu.</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 værktøjslinje</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Slå til eller fra for visning af værktøjslinjen. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Vis statuslinje</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Slå visning af statuslinje til og fra. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil genveje...</guimenuitem
> </menuchoice
></term>
<listitem
><para>
<action
>Åbner en dialog som lader dig omdefinere alle tastaturgenveje.</action>
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil værktøjslinjer...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Viser en &kde;-standarddialog hvor du kan indstille værktøjslinjens ikoner.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil &kshisen;...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Åbner <link linkend="configuration"
>indstillingsdialogen</link
> for at ændre indstillinger i &kshisen;. </para
></listitem>
</varlistentry>

</variablelist>
</sect1>

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

<sect1 id="key-bindings">
<title
>Genveje</title>

<para
>Standardgenveje er: </para>

<informaltable>
<tgroup cols="2">
<tbody>
<row
><entry
>Ny</entry
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></entry
></row>
<row
><entry
>Genstart spillet</entry
><entry
><keycap
>F5</keycap
></entry
></row>
<row
><entry
>Pause</entry
><entry
><keycap
>P</keycap
></entry
></row>
<row
><entry
>Vis topresultater</entry
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
></entry
></row>
<row
><entry
>Afslut</entry
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></entry
></row>
<row
><entry
>Fortryd</entry
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></entry
></row>
<row
><entry
>Annullér fortryd</entry
><entry
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></entry
></row>
<row
><entry
>Vink</entry
><entry
><keycap
>H</keycap
></entry
></row>
<row
><entry
>&kshisen;-håndbogen</entry
><entry
><keycap
>F1</keycap
></entry
></row>
<row
><entry
>Hvad er dette</entry
><entry
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>F1</keycap
></keycombo
></entry
></row>
</tbody>
</tgroup>
</informaltable>

</sect1>
</chapter>

<chapter id="configuration">
<title
>Indstilling</title>

<para
>At vælge menupunktet <menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil &kshisen;...</guimenuitem
></menuchoice
> viser en indstillingsdialog som lader dig ændre spillets opførsel.</para>

<screenshot>
<screeninfo
>Indstillingsdialogen i &kshisen;</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="kshisen-configuration.png" format="PNG"/></imageobject>
<textobject
><phrase
>Indstillingsdialogen i &kshisen;</phrase
></textobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
><guilabel
>Tyngdekraft</guilabel
></term>
<listitem
><para
>Hvis man afkrydser dette bliver spillet betydeligt sværere: Hvis en flise er fjernet, vil alle fliser der ligger over den falde nedad.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Tillad uløsbare spil</guilabel
></term>
<listitem
><para
>Hvis dette er afkrydset vil kun løsbare spil blive tilladt når et spil startes. Bemærk: Man kan stadig vælge en forkert måde og man bliver nødt til at prøve igen hvis man ikke løste spillet, men hvis det er afkrydset her <emphasis
>vil</emphasis
> spillet være løsbart.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Brættets sværhedsgrad</guilabel
></term>
<listitem
><para
>Syderen styrer brættets sværhedsgrad. Der er tre muligheder: <guilabel
>Let</guilabel
>, <guilabel
>Normal</guilabel
> og <guilabel
>Svær</guilabel
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Brikkernas fjernelseshastighed</guilabel
></term>
<listitem
><para
>Ved at justere skyderen ændres hastigheden som brikker fjernes fra skærmen efter at brikkerne er parret sammen.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Foretræk brikker uden skalering</guilabel
></term>
<listitem
><para
>Ændring af vinduesstørrelse får brikkerne på brættet til at blive skaleret til at passe med vinduesstørrelsen. Når dette er afkrydset vil vinduets størrelse blive ændret til at passe med brikkernes naturlige størrelse. Du kan stadig justere størrelsen af vinduet. Ved at gøre dette bliver denne tilstand sat ud af kraft.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Brikstørrelse</guilabel
></term>
<listitem
><para
>Denne skyder lader dig ændre antal brikker på brættet. Jo flere brikker du har, desto sværere (og længere) bliver spillet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Hjælp</guibutton
></term>
<listitem
><para
>Åbner hjælpesiderne for &kshisen; (dette dokument).</para
></listitem
></varlistentry>

<varlistentry>
<term
><guibutton
>Standard</guibutton
></term>
<listitem
><para
>Nulstiller alle indstillinger til standard.</para
></listitem
></varlistentry>

<varlistentry>
<term
><guibutton
>O.k.</guibutton
></term>
<listitem
><para
>Gemmer dine ændringer og lukker dialogen.</para
></listitem
></varlistentry>

<varlistentry>
<term
><guibutton
>Anvend</guibutton
></term>
<listitem
><para
>Gemmer dine ændringer men lukker ikke dialogen.</para
></listitem
></varlistentry>

<varlistentry>
<term
><guibutton
>Annullér</guibutton
></term>
<listitem
><para
>Annullerer alle dine ændringer og lukker dialogen.</para
></listitem
></varlistentry>

</variablelist>
</chapter>

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

<para
>&kshisen; Ophavsret 1999 &Mario.Weilguni; &Mario.Weilguni.mail; </para>


<para
>Dokumentation ophavsret 2000 &Dirk.Doerflinger; <email
>ddoerflinger@gmx.net</email
> </para>

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

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

<sect1 id="getting-kshisen">
<title
>Hvordan får man fat på &kshisen;</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Krav</title>

<para
>Man skal have &kde; 3.x for at kunne kompilere &kshisen; Alle nødvendige biblioteker så vel som &kshisen; selv kan findes på &kde-ftp;.</para>
</sect1>


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

</book>

