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

<book lang="&language;">
<bookinfo>
<title
>De handboek van &kdiamond;</title>

<authorgroup>
<author
><firstname
>Stefan</firstname
> <surname
>Majewsky</surname
> <affiliation
><address
><email
>majewsky@gmx.net</email
></address
></affiliation>
</author>
&ged.vertaald;&Freek.de.Kruijf; 
</authorgroup>

<copyright>
<year
>2008, 2009, 2010</year>
<holder
>Stefan Majewsky</holder>
</copyright>
    
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2010-01-21</date>
<releaseinfo
>1.3.1</releaseinfo>

<abstract>
<para
>&kdiamond;, een drie-op-een-rij spel.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdegames</keyword>
<keyword
>spel</keyword>
<keyword
>puzzel</keyword>
<keyword
>kdiamond</keyword>
</keywordset>
</bookinfo>

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

<para
>&kdiamond; is een spel voor één speler. </para>

<para
>The object of the game is to build lines of three similar diamonds. </para>
</chapter>

<chapter id="how-to-play">
<title
>Hoe te spelen</title>

<para
>The player is presented with a rectangular grid containing several types of diamonds. The object of the game is to swap neighbored diamonds to assemble a line of three similar diamonds. These lines will vanish and the board will be refilled with new diamonds. The game time is limited, try to build as much lines as possible to earn a high score. </para>

<para
>Click on one diamond, then on one of its neighbors. The diamonds will then be swapped. (You may also click and drag a diamond upon one of its neighbors to invoke the swap.) If no line of at least three diamonds is formed by the swap, it will be reverted. The status bar displays the game time left, the number of points you have earned, and the number of possible moves. </para>

</chapter>

<chapter id="rules-strategies-tips">
<title
>Spelregels, strategieën en tips</title>

<sect1 id="rules">
<title
>Regels</title>
<itemizedlist>
<listitem
><para
>When a line was removed and the diamonds fall down to fill gaps, it may be that then new lines are composed. Try to achieve such cascades when selecting a diamond pair as you will earn extra points: You get 1 point for the line you build, 2 points for the first cascade, 3 points for a possible next cascade, and so on.</para
></listitem>
<listitem
><para
>Try to build lines with more than 3 diamonds: You will earn an extra second for each two extra diamonds removed.</para
></listitem>
<listitem
><para
>The number of diamond types increases when choosing <guilabel
>Hard</guilabel
> difficulty levels, thus making it harder to build lines. In contrast, the board size will grow on the <guilabel
>Easy</guilabel
> difficulty levels to make it easier to find a move.</para
></listitem>
<listitem
><para
>The game will stop once there are no possible moves left. Especially on <guilabel
>Hard</guilabel
> difficulty levels, you should keep this in mind when choosing your next move.</para
></listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="interface-overview">
<title
>Overzicht van het interface</title>

<sect1 id="game-menu">
 <title
>Menu <guimenu
>Spel</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Nieuw</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Starts a new game. It creates a random board using the current difficulty level. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>P</keycap
></shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Pauze</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Pauses the game time. Click on the menu item again to make the game resume. Note that the board disappears when the game is paused as it would be unfair if you could search for good moves without the time pressure. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Topscores tonen</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Shows a dialog containing the High Scores for the various difficulty levels. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Spel</guimenu
> <guimenuitem
>Afsluiten</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Sluit het programma. </para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="move-menu">
<title
>Menu <guimenu
>Zet</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>H</keycap
></shortcut
><guimenu
>Zet</guimenu
><guimenuitem
>Tip</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Highlight a diamond which can be moved. </para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

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

<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Werkbalk tonen</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Toggles on and off the display of the toolbar. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Statusbalk tonen</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Toont of verbergt de statusbalk. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guisubmenu
>Moeilijkheidsgraad</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Hier kunt u de moeilijkheidsgraad in een submenu selecteren.</para>
<para
>There are five levels of difficulty: <itemizedlist>
<listitem
><para
><guimenuitem
>Very easy</guimenuitem
>: 12 rows, 12 columns, 5 types of diamonds.</para
></listitem>
<listitem
><para
><guimenuitem
>Easy</guimenuitem
>: 10 rows, 10 columns, 5 types of diamonds.</para
></listitem>
<listitem
><para
><guimenuitem
>Medium</guimenuitem
>: 8 rows, 8 columns, 5 types of diamonds.</para
></listitem>
<listitem
><para
><guimenuitem
>Hard</guimenuitem
>: 8 rows, 8 columns, 6 types of diamonds.</para
></listitem>
<listitem
><para
><guimenuitem
>Very hard</guimenuitem
>: 8 rows, 8 columns, 7 types of diamonds.</para
></listitem>
</itemizedlist>
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Sneltoetsen instellen...</guimenuitem
> </menuchoice
></term>
<listitem
><para>
<action
>Opent een dialoogvenster waarin u alle sneltoetsen opnieuw kunt definiëren.</action>
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>Werkbalken instellen...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Laat een standaard &kde;-dialoog zien waarmee u de knoppen op de werkbalk kunt instellen.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Instellingen</guimenu
><guimenuitem
>Notificaties instellen...</guimenuitem
></menuchoice
></term>
<listitem
><para
>This item displays a standard &kde; notifications configuration dialog, where you can change the notifications (sounds, visible messages, &etc;) used by &kdiamond;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Settings</guimenu
> <guimenuitem
>Configure &kdiamond;...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Choose a graphical theme for the game. Which themes are available depends on the current installation. You may also download new themes which have been created by third-party designers.</para
></listitem>
</varlistentry>

</variablelist>
</sect1>

<sect1 id="help">
<title
>Het menu <guimenu
>Help</guimenu
></title>
&help.menu.documentation; </sect1>

<sect1 id="keybindings">
<title id="keybindings-title"
>Sneltoetsen</title>

<para
>The default shortcuts are:</para>

<table>
<title
>Sneltoetsen</title>
<tgroup cols="2">
<tbody>
<row>
<entry
>Start een nieuw spel</entry>
<entry>
<keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo>
</entry>
</row>
<row>
<entry
>Pauze</entry>
<entry>
<keycombo action="simul"
><keysym
>P</keysym
></keycombo>
</entry>
</row>
<row>
<entry
>Topscores tonen</entry>
<entry>
<keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo>
</entry>
</row>
<row>
<entry
>Tip</entry>
<entry
><keycap
>H</keycap
></entry>
</row>
<row>
<entry
>Afsluiten</entry>
<entry>
<keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo>
</entry>
</row>
<row>
<entry
>Help</entry>
<entry
><keycap
>F1</keycap
></entry>
</row>
<row>
<entry
>Wat is dit?</entry>
<entry>
<keycombo action="simul"
>&Shift;<keycap
>F1</keycap
></keycombo>
</entry>
</row>
</tbody>
</tgroup>
</table>

</sect1>
</chapter>


<chapter id="credits">
<title
>Dankbetuiging en licentie</title>

<para
>&kdiamond; </para>
<para
>Programma copyright 2008, 2009 bij Stefan Majewsky <email
>majewsky@gmx.net</email
> </para>
<para
>Documentatie copyright 2008, 2009, 2010 bij Stefan Majewsky <email
>majewsky@gmx.net</email
> </para>

&meld.fouten;&vertaling.freek; 
&underFDL; &underGPL; </chapter>

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

<sect1 id="getting-kdiamond">
<title
>Hoe &kdiamond; te verkrijgen</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Compilatie en installatie</title>
&install.compile.documentation; </sect1>
</appendix>


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