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

<book lang="&language;">
<bookinfo>
<title
>Das &kpoker;-Handbuch</title>
<authorgroup>
<author
> <firstname
>Jochen</firstname
> <surname
>Tuchbreiter</surname
> <affiliation
><address
><email
>whynot@mabi.de</email
></address
></affiliation
> </author>
<author
> <firstname
>Andreas</firstname
> <surname
>Beckermann</surname
> <affiliation
> <address
><email
>b_mann@gmx.de</email
></address
> </affiliation
> </author>
</authorgroup>

<othercredit role="translator"
><firstname
>Maren</firstname
><surname
>Pakura</surname
><affiliation
><address
><email
>maren@kde.org</email
></address
></affiliation
><contrib
>Deutsche Übersetzung</contrib
></othercredit>

<copyright>
<year
>1997</year
><year
>2001</year>
<holder
>Jochen Tuchbreiter, Andreas Beckermann</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-06-08</date>
<releaseinfo
>0.07.00</releaseinfo>
<abstract>

<para
>Das ist die Dokumentation von &kpoker;, einem kleinen Pokerspiel.</para>

</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kpoker</keyword>
<keyword
>kdegames</keyword>
<keyword
>Spiele</keyword>
<keyword
>Spiel</keyword>
<keyword
>Poker</keyword>
<keyword
>Karten spielen</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title
>Einführung</title>

<sect1 id="what-is-kpoker">
<title
>Was ist &kpoker;?</title>

<para
>&kpoker; ist ein <ulink url="http://www.kde.org"
>KDE</ulink
>-konformer Klon dieser höchst süchtigmachenden Taschen-Poker-Videospielen, die manchmal auch "Videopoker" genannt werden.</para>
</sect1>

<sect1 id="where-do-i-get-the-latest-version-of-kpoker">
<title
>Wo erhalte ich die neueste Version von &kpoker;?</title>

<para
>Die neueste Version von &kpoker; ist immer erhältlich unter</para>
<itemizedlist
> <listitem
> <para
>Die &kpoker; Homepage: <ulink url="http://www.mabi.de/~whynot/kpoker/"
> http://www.mabi.de/~whynot/kpoker/</ulink
></para
> </listitem
> <listitem
> <para
>Die &kde;-Internetseite: &kde-http;</para
> </listitem
> </itemizedlist>

</sect1>
</chapter>


<chapter id="new-game">
<title
>Starte ein neues Spiel.</title>

<para
>Sie können ein neues Spiel auf zwei unterschiedliche Weisen starten:</para>

<orderedlist
> <listitem
><para
>Durch die Auswahl von <menuchoice
> <guimenu
>Spiel</guimenu
> <guimenuitem
>Neu</guimenuitem
> </menuchoice
> in der Menüleiste.</para
></listitem
> <listitem
><para
>Oder: <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></para
></listitem
> </orderedlist>

<para
>In beiden Fällen wird dann ein Dialogfenster erscheinen.</para>

<screenshot
> <screeninfo
>Konfigurations-Dialog für <acronym
>KI</acronym
></screeninfo
> <mediaobject
> <imageobject
><imagedata fileref="kpoker2.png" format="PNG"/></imageobject
> <textobject
><phrase
>Konfigurations-Dialog für <acronym
>KI</acronym
></phrase
></textobject
> </mediaobject
> </screenshot
>  

<variablelist
> <varlistentry
> <term
><guilabel
>Wieviele Spieler wünschen Sie?</guilabel
></term
> <listitem
><para
>Hier entscheiden Sie, ob Sie ein <link linkend="one-player-game"
>Spiel mit einem Spieler</link
> (gegen das Haus) oder ein <link linkend="two-player-game"
>Spiel mit zwei Spielern</link
> spielen.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Ihr Name</guilabel
></term
> <listitem
><para
>Hier können Sie einen Namen angeben, so dass &kpoker; Sie persönlich ansprechen kann (anstelle von <guilabel
>Sie</guilabel
>).</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Startguthaben der Spieler</guilabel
></term
> <listitem
><para
>Hier können Sie das Guthaben angeben, mit dem Sie jedes Spiel beginnen.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Die Namen Ihrer Gegner</guilabel
></term
> <listitem
><para
> Hier können Sie den Namen des anderen Spielers angeben.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><guilabel
>Diesen Dialog bei jedem Spielstart anzeigen</guilabel
></term
> <listitem
><para
>Wenn es angekreuzt ist, dann wird das erste Spiel das Sie nach &kpoker; starten dieses Menü zeigen. Wenn es nicht angekreuzt ist, dann wird dieses Menü für das erste Spiel nicht angezeigt.</para
></listitem
> </varlistentry
> </variablelist>

<para
>Wenn Sie mit Ihren Einstellungen zufrieden sind, dann klicken Sie <guibutton
>OK</guibutton
>, um das Spiel zu starten. Ein klicken auf <guibutton
>Abbrechen</guibutton
> wird das starten eines neuen Spiels abbrechen.</para>

</chapter>

<chapter id="one-player-game">
<title
>Spiel mit einem Spieler</title>

<sect1 id="how-do-i-play">
<title
>Wie spielt man?</title>

<para
>Zu Beginn erhalten Sie $100. Sie ziehen fünf Karten und entscheiden, welche Sie behalten wollen. Um anzuzeigen welche Karten Sie behalten wollen klicken Sie auf diese. Das Wort <guilabel
>Behalten</guilabel
> wird über der Karte erscheinen.</para>

<para
>Anschließend ziehen Sie neue Karten für die, die Sie nicht behalten wollen. Das wird durch ein Klick auf <guibutton
>Ziehen</guibutton
> erreicht.</para>

<para
> Das Spiel sieht nun nach, ob Sie eine <link linkend="hands"
>Poker Hand</link
>haben und gibt Ihnen entsprechend der Hand Ihren Gewinn. Eine genaue Beschreibung finden Sie unter <link linkend="scoring"
>Punktvergabe</link
>. </para>

<para
>Nun beginnen Sie erneut fünf Karten zu ziehen und entscheiden sich erneut, welche Sie behalten wollen ...</para>

<para
>Das Spiel endet, wenn Sie keine weitere Runde spielen können oder wenn Sie das &kpoker;-Fenster schließen.</para>

</sect1>

<sect1 id="hands">
<title
>Was sind mögliche Poker Hands?</title>

<para
>Mögliche Poker Hands sind:</para>

<variablelist
> <varlistentry
> <term
>Buben oder höher</term
> <listitem
><para
>Zwei Karten der gleichen Wertigkeit, beide Buben oder höher</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Zwei Paare</term
> <listitem
><para
>Zwei Karten der selben Wertigkeit und zwei Karten einer anderen Wertigkeit</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Drei einer Art</term
> <listitem
><para
>Drei Karten der selben Wertigkeit</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Vier einer Art</term
> <listitem
><para
>Vier Karten der selben Wertigkeit</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Full House</term
> <listitem
><para
>Drei Karten einer Wertigkeit und zwei Karten einer anderen</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Straight</term
> <listitem
><para
>Fünf Karten einer aufeinanderfolgenden Wertigkeit</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Flush</term
> <listitem
><para
>Fünf Karten der gleichen Farbe</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Straight Flush</term
> <listitem
><para
>Fünf Karten mit aufeinanderfolgender Wertigkeit und der gleichen Farbe</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Royal Flush</term
> <listitem
><para
>Ass, König, Dame, Bube und Zehn der gleichen Farbe</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="scoring">

<title
>Wieviel Gewinn kriege ich für was? </title>

<informaltable>
<tgroup cols="2">
<tbody
> <row
> <entry
>Ein Paar Buben oder höher</entry
><entry
>$5</entry
></row
> <row
><entry
> Zwei Paare</entry
><entry
>$10</entry
></row
> <row
><entry
> Drei einer Art</entry
><entry
>$15</entry
></row
> <row
><entry
> Straight</entry
><entry
>$20</entry
></row
> <row
><entry
> Flush</entry
><entry
>$25</entry
></row
> <row
><entry
> Full House</entry
><entry
>$40</entry
></row
> <row
><entry
> Vier einer Art</entry
><entry
> $125</entry
></row
> <row
><entry
> Straight Flush</entry
><entry
> $250</entry
></row
> <row
><entry
> Royal Flush</entry
><entry
>$2000</entry
></row
> </tbody>
</tgroup>
</informaltable>

</sect1>
</chapter>

<chapter id="two-player-game">
<title
>Spiel mit zwei Spielern</title>

<para
>Das Spiel mit zwei Spielern ist anders als das <link linkend="one-player-game"
>Spiel mit einem Spieler</link
>.</para>

<sect1 id="two-player">
<title
>Ein Spiel mit zwei Spielern starten</title>

<para
>Um ein Spiel mit zwei Spielern zu starten, wählen Sie <menuchoice
><guimenu
>Spiel</guimenu
> <guimenuitem
>neues Spiel</guimenuitem
> </menuchoice
> in der Menü-Leiste. Ein Dialogfenster erscheint. Wählen Sie einfach <guilabel
>2</guilabel
> unter der Frage <guilabel
>Wieviele Spieler?</guilabel
>. Dann klicken Sie <guibutton
>OK</guibutton
>.</para>
</sect1>

<sect1 id="two-player-play">
<title
>Ein Spiel mit zwei Spielern spielen</title>

<para
>Es gibt vier Phasen in einem Spiel mit zwei Spielern.</para
> 

<procedure
> <step
><para
>Sie beginnen mit dem ziehen von Karten</para
></step
> <step
><para
>dann setzen Sie Geld</para
></step
> <step
><para
>nachdem Sie Ihre Karten ausgetauscht haben</para
></step
> <step
><para
>erhöhen Sie und zum Schluss sehen Sie die Karten des anderen Spielers und der Gewinner erhält das gesamte Geld.</para
></step
></procedure>

<variablelist
> <varlistentry
> <term
>Ziehen</term
> <listitem
><para
>Sie beginnen das Spiel mit $100. Nach dem klicken auf Ziehen erhalten Sie fünf Karten.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Einsatz</term
> <listitem
><para
>Nun entscheiden Sie, ob die Karten gut sind oder nicht. Wenn ja, dann setzen Sie etwas Geld - mindestens $5 und höchstens $20. Klicken Sie einfach auf <guibutton
>+$5</guibutton
> und ähnliche Tasten.</para
></listitem
> </varlistentry
> <varlistentry
><term
>Tauschen</term
> <listitem
><para
>Nun entscheiden Sie welche Karten Sie behalten wollen. Klicken Sie auf diese. (Wenn Sie einen Royal Flush haben, dann tauschen Sie bitte keine Karte.) Wenn Sie fertig sind klicken Sie abermals auf die <guibutton
>Ziehen</guibutton
>-Taste, dann erhalten Sie wahrscheinlich neue Karten. </para
> <para
>Wenn Sie keine neuen Karten erhalten, hat der Computergegner sehr gute Karten (oder zumindest keine schlechten Karten) und er hat erhöht. Sie müssen sich dann entscheiden, ob Sie mit dem Einsatz mithalten oder die Runde beenden. Standardmäßig halten Sie mit dem Einsatz mit. Klicken Sie nochmals auf <guibutton
>Ziehen</guibutton
>, wenn Sie fertig sind.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Erhöhen</term
> <listitem
> <para
>Nachdem Sie neue Karten erhalten haben können Sie Ihren Einsatz ein wenig erhöhen. Das geht genauso, wie in der Einsatz-Phase, daher erkläre ich es nicht nocheinmal. Klicken Sie auf die Ziehen-Taste (die nun mit <guilabel
>Sehen!</guilabel
>beschriftet ist ), wenn Sie fertig sind. </para
></listitem
> </varlistentry
> <varlistentry
> <term
>Sehen / Ziehen</term
> <listitem
><para
>Ich weiß ich habe von vier Phasen gesprochen und das ist die fünfte. Aber sie funktioniert im wesentlichen wie die Ziehen-Phase. Sie werden die Karten das Computergegners sehen und die Karten des Gewinner werden blinken. Der Sieger erhält das gesamte Geld. Klicken Sie auf Ziehen, um eine neue Runde zu beginnen!</para
> <note
><para
>Die blinkenden Karten sind nicht notwendigerweise die besten Karten des Spielers. Nur die Karten blinken, denen der Gewinn zu verdanken ist. Wenn Sie also zwei Paare haben (z.B. 2 * 2 und 2 * 3) und ein As, aber nur das As blinkt, dann hat der Computerauch diese Paare (2 * 2 und 2 * 3), aber kein As.</para
></note
></listitem
> </varlistentry
> </variablelist>

</sect1>

</chapter>

<chapter id="command">
<title
>Befehle und Tastaturkürzel</title>

<para
>Hier werden die Menüeinträge kurz beschrieben.</para>

<sect1 id="game-menu">
<title
>Das <guimenu
>Spiel</guimenu
>-Menü</title>

<para
>Das <guimenu
>Spiel</guimenu
>-Menü besteht aus 3 Optionen.</para>

<variablelist
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Spiel</guimenu
> <guimenuitem
>Neu</guimenuitem
> </menuchoice
></term
> <listitem
><para
><action
>Startet ein neues &kpoker;-Spiel</action
>. Weitere Informationen finden Sie im Abschnitt <link linkend="new-game"
>Starte ein neues Spiel.</link
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Spiel</guimenu
> <guimenuitem
>Speichern</guimenuitem
> </menuchoice
></term
> <listitem
><para
><action
>Speichert Ihr aktuelles Spiel</action
>. Es wird jedes vorher gespeicherte Spiel ersetzen.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Spiel</guimenu
> <guimenuitem
>Beenden</guimenuitem
> </menuchoice
></term
> <listitem
><para
><action
>Beendet</action
> &kpoker;.</para
></listitem
> </varlistentry
> </variablelist>
</sect1>

<sect1 id="settings-menu">
<title
><guimenu
>Einstellungen</guimenu
>-Menü</title>

<para
>Das Einstellungen-Menü kann zum Einstellen der Klänge und dem Aussehen von &kpoker; verwendet werden.</para>

<variablelist
> <varlistentry
> <term
><menuchoice
> <guimenu
>Einstellungen</guimenu
> <guimenuitem
>Statusleiste anzeigen</guimenuitem
></menuchoice
></term
> <listitem
><para
>Das blendet die Menüleiste ein oder aus. Ist sie ausgeblendet und Sie wollen sie dennoch nutzten, klicken Sie mit der rechten Maustaste in das Spielfeld von &kpoker; denn erscheint ein Menü. Hier wählen Sie <guilabel
>Menüleiste anzeigen</guilabel
> und die Menüleiste wird wieder eingeblendet.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Einstellungen</guimenu
> <guimenuitem
>Statusleiste anzeigen</guimenuitem
></menuchoice
></term
> <listitem
><para
>Das wird <action
>die Statusleiste ein- oder ausblenden</action
>. Die Statusleiste befindet sich unten im &kpoker;-Fenster. Sie enthält Spielanweisungen und den Gewinn der Vorrunde.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Einstellungen</guimenu
> <guimenuitem
>Klänge</guimenuitem
></menuchoice
></term
> <listitem
><para
>Diese Einstellung <action
>schaltet den Ton an oder aus</action
>.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Einstellungen</guimenu
> <guisubmenu
>Blinkende Karten</guisubmenu
></menuchoice
></term
> <listitem
><para
>Ist diese Einstellung angekreuzt, dann <action
>blinken die Karten, die für den Gewinn verantwortlich sind</action
>. Ist sie nicht angekreuzt, dann blinken keine Karten.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Einstellungen</guimenu
> <guimenuitem
>Einsatz bestimmen ist Standard</guimenuitem
></menuchoice
></term
> <listitem
><para
>Ist diese Einstellung nicht angekreuzt und Sie spielen ein Spiel für zwei Spieler, müssen Sie auf <guibutton
>Einsatz anpassen</guibutton
> klicken, wenn Ihr Gegner den Einsatz erhöht. Andernfalls würdn &kpoker; glauben Sie geben auf!</para
> <para
>Andernfalls, wenn diese Einstellung angekreuzt ist und Sie in der selben Situation sind, wird das Spiel standardmäßig Ihren Einsatz erhöhen und Sie müssen darauf achten, wenn Sie aufgeben wollen.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Einstellungen</guimenu
><guimenuitem
>Einstellungen speichern</guimenuitem
></menuchoice
></term
> <listitem
><para
>Dies speichert alle Einstellungen, die Sie vorgenommen haben. Diese werden automatisch widerhergestellt, wenn Sie das nächste Mal &kpoker; starten.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Einstellungen</guimenu
> <guimenuitem
>Sielkarten festlegen</guimenuitem
></menuchoice
></term
> <listitem
><para
>Das öffnet ein Fenster, in dem Sie die Vor-und Rückseite der Karten in &kpoker; bestimmen können.</para
></listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
> <guimenu
>Einstellungen</guimenu
> <guimenuitem
>KPoker einrichten...</guimenuitem
></menuchoice
></term
> <listitem
><para
>Das öffnet ein Dialogfenster.</para
> <screenshot
> <screeninfo
>KI einrichten</screeninfo
> <mediaobject
> <imageobject
><imagedata fileref="kpoker1.png" format="PNG"/></imageobject
> </mediaobject
> </screenshot
> <para
>Dort sind eine oder drei Optionen zu bestimmen:</para
> <para
>Im ersten Textfeld können Sie in Millisekunden festlegen, wie lange es dauert, bis Sie die nächsten Karten sehen. Hier können Sie das austeilen der Karten beschleunigen, wenn Ihnen die realistische Standard-Geschwindigkeit nicht gefällt.</para
> <para
>Im Textfeld mit der Bezeichnung <guilabel
>Maximaler Einsatz</guilabel
>, legen Sie den maximalen Einsatz für jede Hand fest.</para
> <para
>Im Textfeld mit der Bezeichnung <guilabel
>Minimaler Einsatz</guilabel
>, legen Sie den minimalen Einsatz für jede Hand fest.</para
> <note
><para
>Die Felder für <guilabel
>Maximaler Einsatz</guilabel
> und <guilabel
>Minimaler Einsatz</guilabel
> werden im Einzelspielermodus nicht gezeigt. Im Einzelspielermodus kann nur die Karten-Verzögerung verändert werden.</para
></note
> <para
>Wie Sie sehen können, werden alle Änderungen in der nächsten Runde aktiviert.</para
> </listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="help-menu">
<title
><guimenu
>Hilfe</guimenu
>-Menü</title>

&help.menu.documentation;

</sect1>

<sect1 id="keys">
<title
>Standard-Tastenbelegungen</title>

<informaltable>
<tgroup cols="2">
<thead
><row
><entry
>Tastenkombination</entry
><entry
>Aktion</entry
></row
></thead>
<tbody
> <row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></entry
><entry
>&kpoker; beenden</entry
></row
> <row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></entry
><entry
>Neues Spiel</entry
></row
> <row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
></entry
><entry
>Spiel speichern</entry
></row
> <row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>M</keycap
></keycombo
></entry
><entry
>Menüleiste anzeigen</entry
></row
> <row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>F1</keycap
></keycombo
></entry
><entry
><quote
>Was ist das?</quote
> Hilfe</entry
></row
> <row
><entry
><keycombo action="simul"
><keycap
>F1</keycap
></keycombo
></entry
><entry
>Inhalt der Hilfe</entry
></row
> </tbody>
</tgroup>
</informaltable>
</sect1>
</chapter>
<chapter id="credits"
><title
>Mitwirkende und Lizenz</title>
 
<para
>&kpoker;</para>

<para
> Programm Copyright 1997-2000 Jochen Tuchbreiter <email
>whynot@mabi.de</email
>, Andreas Beckermann <email
>b_mann@gmx.de</email
></para>
<para
>Die folgenden Personen halfen mir:</para>
<itemizedlist
> <listitem
><para
>Chris Holmes - Idee, das Spiel zu schreiben und Teile des Aussehens</para
></listitem
> <listitem
><para
>John Fitzgibbon - stellte die Kartenbilder zur Verfügung</para
></listitem
> <listitem
><para
>Nico Schirwing - malte die Rückseiten der Karten</para
></listitem
> <listitem
><para
>Andreas Beckermann - betreut zu Zeit das Spiel</para
></listitem
> </itemizedlist>

<para
>Dokumentation für &kde; 2.0 von Michael McBride <email
>mpmcbride7@yahoo.com</email
> überarbeitet</para>

<para
>Deutsche Übersetzung von Maren Pakura <email
>maren@kde.org</email
></para>

&underFDL;
&underGPL;

</chapter
>                  

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

<sect1 id="getting-kpoker">
<title
>Woher Sie &kpoker; erhalten?</title>

&install.intro.documentation;

</sect1>

<sect1 id="compilation">
<title
>Übersetzung und Installation</title>

&install.compile.documentation;

</sect1>
</appendix>

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

