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

<book lang="&language;">

<bookinfo>
<title
>De handboek van &kblocks;</title>

<authorgroup>
<author
><firstname
>Mauricio</firstname
> <surname
>Piacentini</surname
> <affiliation
> <address
>&Mauricio.Piacentini.mail;</address>
</affiliation>
</author>
&Freek.de.Kruijf; 
</authorgroup>

<copyright>
<year
>2008</year>
<holder
>&Mauricio.Piacentini;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2008-04-01</date>
<releaseinfo
>1.0</releaseinfo>

<abstract
><para
>&kblocks; is de &kde;-versie van het klassieke vallende blokken spel.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>spel</keyword>
<keyword
>blokken</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Inleiding</title>
<note
><title
>Speltype:</title
><para
>Logisch, Arcade</para
></note
><!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
<note
><title
>Aantal mogelijke spelers:</title
><para
>One</para
></note
><!--Number of possible players. It can be: One, Two,..., Multiplayer-->

<para
>&kblocks; is the classic falling blocks game. The idea is stack the falling blocks in a way that lines are completely filled. When a line is completed it is removed, and more space is available in the play area. When there is not enough space for blocks to fall, the game is over. </para>

</chapter>

<chapter id="how-to-play">
<title
>How to Play</title>
<note
><title
>Objective:</title
><para
>Rotate the falling blocks, and fit them together to complete lines and clear the playfield.</para
></note
><!--Describe the objective of the game.-->

<para
>By default, falling blocks can be moved left or right using the <keycap
>Left</keycap
> or <keycap
>Right</keycap
> arrow keys. The <keycap
>Down</keycap
> arrow key makes the block drop faster, and the <keycap
>Up</keycap
> key is used to rotate the block. The keys used for each game action can be configured in <menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Configure Shortcuts...</guimenuitem
></menuchoice
> </para>

</chapter>

<chapter id="rulestips">
<title
>Game Rules, Strategies and Tips</title>
<sect1 id="rules">
<title
>Regels</title>
<itemizedlist>
<listitem
><para
>The rules are simple: just keep space for the blocks to fall!</para
></listitem>
<listitem
><para
>When a new block cannot fall, the game is over.</para
></listitem>
</itemizedlist>
</sect1>

<sect1 id="strattips">
<title
>Strategies and Tips</title>
<itemizedlist>
<listitem
><para
>Do not forget to check the preview area: it shows the next piece that will be released.</para
></listitem>
<listitem
><para
>For additional points, try to remove several lines at once.</para
></listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="command">
<title
>Commands/Keyboard Shortcuts</title>

<para
>The following sections briefly describes each menubar option.</para>

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

<para
>The <guimenu
>Game</guimenu
> menu consists of 4 options.</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Game</guimenu
> <guimenuitem
>New</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Starts a new game.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycap
>P</keycap
> </shortcut
> <guimenu
>Game</guimenu
> <guimenuitem
>Pause</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Pauses the game.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Game</guimenu
> <guimenuitem
>Show High Scores</guimenuitem
> </menuchoice
></term>
<listitem
><para
>This shows you the high score (the maximum number of points) for each difficulty level.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Game</guimenu
> <guimenuitem
>Quit</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Quits</action
> &kblocks;</para
></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="settings-menu"
><title
><guimenu
>Settings</guimenu
> Menu</title>
<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>Settings</guimenu
> <guimenuitem
>Show Toolbar</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Toggle on or off the display of the toolbar.</action
> The default is on. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Settings</guimenu
> <guimenuitem
>Show Statusbar</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Toggle on or off the display of the statusbar.</action
> The default is on. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Settings</guimenu
> <guisubmenu
>Difficulty</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Lets you set the difficulty level from a sub-menu.</para>
<para
>There are three default levels of difficulty: <guimenuitem
>Easy</guimenuitem
> (game starts at level 0), <guimenuitem
>Medium</guimenuitem
> (starts at level 5), and <guimenuitem
>Hard</guimenuitem
> (starts at level 10).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Configure Shortcuts...</guimenuitem
></menuchoice
></term>
<listitem
><para
>This item lets you change the keyboard shortcuts used by &kblocks;, including the keys used to rotate blocks clockwise and counter clockwise</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Settings</guimenu
> <guimenuitem
>Configure Toolbars...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
><action
>Configure</action
> the toolbars provided by &kblocks;. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Settings</guimenu
> <guimenuitem
>Configure &kblocks;...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Allows you to adjust game options. For more detailed information, see the section entitled <link linkend="settings"
>Game Options</link
>.</para
></listitem>
</varlistentry>

</variablelist>
</sect1>

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

<sect1 id="keys"
><title
>Default Keyboard Shortcuts</title>
<para
>The following table shows you the default keyboard shortcuts.</para>


<table>
<title
>Sneltoetsen</title>
<tgroup cols="2">
<thead
><row
><entry
>Key Combo</entry
><entry
>Actie</entry
></row
></thead>
<tbody>
<row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></entry
><entry
>Nieuw spel</entry
></row>
<row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></entry
><entry
>Quit &kblocks;</entry
></row>
<row
><entry
><keycap
>F1</keycap
></entry
><entry
>&kblocks; Handbook</entry
></row>
<row
><entry
><keycombo action="simul"
>&Shift;<keycap
>F1</keycap
></keycombo
></entry
><entry
>What's This Help</entry
></row>
<row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
></entry
><entry
>Topscores tonen</entry
></row>
<row
><entry
><keycap
>P</keycap
></entry
><entry
>Pauzeer het spel</entry
></row>
<row
><entry
><keycap
>Right arrow</keycap
></entry
><entry
>Move the block right</entry
></row>
<row
><entry
><keycap
>Left arrow</keycap
></entry
><entry
>Move the block left</entry
></row>
<row
><entry
><keycap
>Down arrow</keycap
></entry
><entry
>Move the block down</entry
></row>
<row
><entry
><keycap
>Z</keycap
></entry
><entry
>Rotate the block clockwise</entry
></row>
<row
><entry
><keycap
>Pijl omhoog</keycap
></entry
><entry
>Rotate the block counter clockwise</entry
></row>

</tbody>
</tgroup>
</table>

<para
>These shortcuts can be changed by selecting <menuchoice
> <guimenu
>Settings</guimenu
> <guimenuitem
>Configure Shortcuts...</guimenuitem
> </menuchoice
> from the menubar.</para>

</sect1>

</chapter>

<chapter id="faq">
<title
>Frequently Asked Questions</title>
<qandaset>

<qandaentry>
<question>
<para
>Can I change the way the game looks? </para>
</question>
<answer>
<para
>Yes, click on the <guimenu
>Settings</guimenu
> menu and select <guimenuitem
>Configure &kblocks;...</guimenuitem
>. </para>
</answer>
</qandaentry>

</qandaset>
</chapter>

<chapter id="settings">
<title
>Spelinstellingen</title>
<para
>The game settings can be configured by selecting <menuchoice
><guimenu
>Settings</guimenu
> <guimenuitem
>Configure &kblocks;...</guimenuitem
></menuchoice
> from the menubar. A dialog will appear. </para>

<para
>On the theme tab, you can set the theme. Select a theme from the list to see a preview of it on the right. You can set it by clicking <guibutton
>Apply</guibutton
> and <guibutton
>OK</guibutton
>. </para>

</chapter>

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

<para
>&kblocks; Copyright 2007-2008 </para>

<itemizedlist>
<title
>Auteur</title>
<listitem>
<para
>&Mauricio.Piacentini; &Mauricio.Piacentini.mail; </para>
</listitem>
</itemizedlist>

<para
>Documentation copyright 2008 &Mauricio.Piacentini; &Mauricio.Piacentini.mail;</para>
&meld.fouten;&vertaling.freek; 
&underFDL; &underGPL; </chapter>

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

<sect1 id="getting-kblocks">
<title
>How to obtain &kblocks;</title>
&install.intro.documentation; </sect1>

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

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