Warning, /games/kblocks/doc/index.docbook is written in an unsupported language. File is not indexed.

 <?xml version="1.0" ?>
 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
   <!ENTITY % addindex "IGNORE">
   <!ENTITY % English "INCLUDE" > <!-- change language only here -->
 ]>
 
 <book id="kblocks" lang="&language;">
 
 <bookinfo>
 <title>The &kblocks; Handbook</title>
 
 <authorgroup>
 <author>
 <firstname>Mauricio</firstname>
 <surname>Piacentini</surname>
 <affiliation>
 <address>&Mauricio.Piacentini.mail;</address>
 </affiliation>
 </author>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
 <copyright>
 <year>2008</year>
 <holder>&Mauricio.Piacentini;</holder>
 </copyright>
 
 <legalnotice>&FDLNotice;</legalnotice>
 
 <date>2021-06-04</date>
 <releaseinfo>KDE Gear 21.04</releaseinfo>
 
 <abstract><para>&kblocks; is the &kde; version of the classic falling blocks
 game.</para></abstract>
 
 <keywordset>
 <keyword>KDE</keyword>
 <keyword>game</keyword>
 <keyword>blocks</keyword>
 </keywordset>
 
 </bookinfo>
 
 <chapter id="introduction">
 <title>Introduction</title>
 <note><title>Gametype:</title><para>Logic, Arcade</para></note><!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
 <note><title>Number of possible players:</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>
 
 <screenshot>
 <mediaobject>
 <imageobject>
 <imagedata fileref="gameboard.png" format="PNG"/>
 </imageobject>
 <textobject>
 <phrase>&kblocks; gameboard</phrase>
 </textobject>
 </mediaobject>
 </screenshot>
 
 <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 &Left; or &Right; arrow keys. The &Down; arrow key makes the block drop faster, and the &Up; arrow key is used to rotate the block. The keys used for each game action can be configured in the <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure Shortcuts...</guimenuitem></menuchoice> menu item.
 </para>
 
 </chapter>
 
 <chapter id="rulestips">
 <title>Game Rules, Strategies and Tips</title>
 <sect1 id="rules">
 <title>Rules</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="menu">
 <title>Menu Items</title>
 
 <variablelist>
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
 </shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>Single Game</guimenuitem> </menuchoice></term>
 <listitem><para>Starts a new single player game.</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Game</guimenu>
 <guimenuitem>Human vs AI</guimenuitem> </menuchoice></term>
 <listitem><para>Compare your skills with the AI and play against the computer 
 using the same sequence of falling blocks, where you have the first turn.</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>
 
 <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>
 
 </variablelist>
 
 <para>
 Additionally &kblocks; has the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
 menu items, for more information read the sections about the <ulink url="help:/fundamentals/menus.html#menus-settings"
 >Settings Menu</ulink> and <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink>
 of the &kde; Fundamentals.
 </para>
 
 </sect1>
 
 <sect1 id="keys"><title>Default Keyboard Shortcuts</title>
 <para>The following table shows you the default keyboard shortcuts.</para>
 
 <table>
 <title>Keyboard Shortcuts</title>
 <tgroup cols="2">
 <thead><row><entry>Key Combo</entry><entry>Action</entry></row></thead>
 <tbody>
 <row><entry><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></entry><entry>Single Game</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>Show High Scores</entry></row>
 <row><entry><keycap>P</keycap></entry><entry>Pause the game</entry></row>
 <row><entry>&Right; arrow</entry><entry>Move the block right</entry></row>
 <row><entry>&Left; arrow</entry><entry>Move the block left</entry></row>
 <row><entry>&Down; arrow</entry><entry>Move the block down</entry></row>
 <row><entry><keycap>Z</keycap></entry><entry>Rotate the block clockwise</entry></row>
 <row><entry>&Up; arrow</entry><entry>Rotate the block counter clockwise</entry></row>
 <row><entry>&Space;</entry><entry>Drop the block</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 <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure &kblocks;...</guimenuitem></menuchoice> menu item.
 </para>
 </answer>
 </qandaentry>
 
 </qandaset>
 </chapter>
 
 <chapter id="settings">
 <title>Game Settings</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>
                         To select a new theme simply choose the theme from
                         the selection list. Each item in the list shows a small
                         preview left to the theme name. A selection is immediately applied.
                 </para>
                 <para>
                         Once you are satisfied with the theme you have selected you
                         can click the <guibutton>Close</guibutton>
                         button, located at the bottom part of this dialog.
                 </para>
 </chapter>
 
 <chapter id="credits"><title>Credits and License</title>
 
 <para>
 &kblocks; Copyright 2007-2008
 </para>
 
 <itemizedlist>
 <title>Author</title>
 <listitem>
 <para>
 &Mauricio.Piacentini; &Mauricio.Piacentini.mail;
 </para>
 </listitem>
 </itemizedlist>
 
 <para>Documentation copyright 2008 &Mauricio.Piacentini; &Mauricio.Piacentini.mail;</para>
 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
 
 &underFDL;
 &underGPL;
 
 </chapter>
 
 </book>
 <!--
 Local Variables:
 mode: sgml
 sgml-omittag: nil
 sgml-shorttag: t
 End:
 -->