Warning, /games/skladnik/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 % English "INCLUDE" > <!-- change language only here -->
   <!ENTITY % addindex "IGNORE">
   <!ENTITY skladnik "<application>Skladnik</application>">
 ]>
         
 <book lang="&language;">
 <bookinfo>
 <title>The &skladnik; Handbook</title>
 
 <authorgroup>
 <author>
 <firstname>Anders</firstname>
 <surname>Widell</surname>
 <affiliation>
 <address>&Anders.Widell.mail;</address>
 </affiliation>
 </author>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
 <copyright>
 <year>2000</year>
 <holder>&Anders.Widell;</holder>
 </copyright>
 
 <legalnotice>&FDLNotice;</legalnotice>
 
 <date>2021-08-19</date>
 <releaseinfo>0.5.0</releaseinfo>
 
 <abstract>
 <para>
 &skladnik; is an implementation of the Japanese warehouse keeper game <quote>sokoban</quote>.
 </para>
 </abstract>
 
 <keywordset>
 <keyword>KDE</keyword>
 <keyword>kdegames</keyword>
 <keyword>game</keyword>
 <keyword>sokoban</keyword>
 <keyword>skladnik</keyword>
 </keywordset>
 </bookinfo>
 
 <chapter id="introduction">
 <title>Introduction</title>
 
 <para>
 The first sokoban game was created in 1982 by Hiroyuki Imabayashi at
 the Japanese company Thinking Rabbit, Inc.  <quote>Sokoban</quote> is
 Japanese for <quote>warehouse keeper</quote>.  The idea is that you
 are a warehouse keeper trying to push crates to their proper locations
 in a warehouse.
 </para>
 
 <para>
 The problem is that you cannot pull the crates or step over them. If
 you are not careful, some of the crates can get stuck in wrong places
 and/or block your way.
 </para>
 
 <para>
 It can be rather difficult just to solve a level. But if you want to
 make it even harder, you can try to minimize the number of moves
 and/or pushes you use to solve the level.
 </para>
 
 <para>
 To make the game more fun for small kids (below 10 years or so), some
 collections with easier levels are also included in &skladnik;. These
 are marked <emphasis>(easy)</emphasis> in the level collection menu.
 Of course, these levels can be fun for adults too, for example if you
 don't want to expose yourself to too much mental strain.
 </para>
 </chapter>
 
 <chapter id="how-to-play">
 <title>The Game</title>
 
 <para>
 The objective of the game is to push all the red gems to the goal
 squares, which are marked with green glassy round things on the floor.
 </para>
 
 <para>
 Use the cursor keys or the mouse to move about. If you move onto a gem
 using the cursor keys or the &MMB;, and there is nothing blocking it on the opposite side, then you
 will push the gem.  It isn't possible to pull the gems, so if you push
 a gem into a corner it will be stuck there. You cannot step over the
 gems either, so you can also get trapped in a part of the maze by
 blocking the way with gems.  Also note that it isn't possible to push
 more than one gem at a time.
 </para>
 
 <para>
 If you notice that you have moved the gems in such a way that the
 level is impossible to solve, then you can always use the undo feature
 to go back to a position where the mistake has not yet been made. You
 can of course also restart the level from the very beginning.
 </para>
 
 <sect1 id="controls">
 <title>Controls</title>
 
 <para>
 <informaltable>
 <tgroup cols="2">
 <thead>
 <row><entry>Key</entry><entry>Action</entry></row>
 </thead>
 
 <tbody>
 <row><entry>Cursor keys</entry><entry>Move one square in a direction</entry></row>
 <row><entry><keycombo action="simul">&Ctrl;<keycap>Cursor</keycap></keycombo> keys</entry><entry>Move as far as possible in a direction without pushing any gems</entry></row>
 <row><entry><keycombo action="simul">&Shift;<keycap>Cursor</keycap></keycombo> keys </entry><entry>Move as far as possible in a direction, pushing any gem in the way</entry></row>
 <row><entry><mousebutton>Left</mousebutton> mouse button</entry><entry>Move to any place in the maze that can be reached without pushing any gems&nbsp;</entry></row>
 <row><entry><mousebutton>Middle</mousebutton> mouse button or <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></entry><entry>Undo the last move</entry></row>
 <row><entry><mousebutton>Right</mousebutton> mouse button</entry><entry>Move up/down/left/right in a straight line, pushing any gem in the way</entry></row>
 <row><entry><mousebutton>Mouse wheel</mousebutton></entry><entry>Traverse the history</entry></row>
 <row><entry><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo>&nbsp;</entry><entry>Redo the last undone move</entry></row>
 <row><entry><keycap>N</keycap></entry><entry>Go to the next level in the current level collection</entry></row>
 <row><entry><keycap>P</keycap></entry><entry>Go to the previous level in the current level collection</entry></row>
 <row><entry>&Esc;</entry><entry>Restart the current level</entry></row>
 <row><entry><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></entry><entry>Quit the game</entry></row>
 </tbody>
 </tgroup>
 </informaltable>
 </para>
 </sect1>
 
 <sect1 id="loading-external-levels">
 <title>Loading external levels</title>
 
 <para>
 &skladnik; has the ability to load external sokoban levels from text
 files.  You can load levels using the <menuchoice><guimenu>Game</guimenu>
 <guimenuitem>Load Levels...</guimenuitem></menuchoice> menu item, or by
 specifying the level file &URL; as a command line argument when starting
 &skladnik; from a shell.
 </para>
 
 <para>
 The external levels must be defined using the standard characters
 shown in the table below. If the file contains more than one level,
 the levels should be separated by blank lines. The file may also
 contain text between the levels.
 </para>
 
 <informaltable>
 <tgroup cols="2">
 <thead>
 <row><entry>Character</entry><entry>Meaning</entry></row>
 </thead>
 
 <tbody>
 <row><entry><literal>#</literal></entry><entry>Wall</entry></row>
 <row><entry><emphasis>(space)</emphasis></entry><entry>Empty square</entry></row>
 <row><entry><literal>.</literal></entry><entry>Goal square</entry></row>
 <row><entry><literal>$</literal></entry><entry>Object on an empty square</entry></row>
 <row><entry><literal>*</literal></entry><entry>Object on a goal square</entry></row>
 <row><entry><literal>@</literal></entry><entry>Start position on an empty square&nbsp;</entry></row>
 <row><entry><literal>+</literal></entry><entry>Start position on a goal square</entry></row>
 </tbody>
 </tgroup>
 </informaltable>
 
 <para>
 As an example, below is a text representation of the first level in the
 <emphasis>Microban</emphasis> level collection:
 </para>
 
 <para>
 <screen>
 ####
 # .#
 #  ###
 #*@  #
 #  $ #
 #  ###
 ####
 </screen>
 </para>
 </sect1>
 </chapter>
 
 <chapter id="menu-reference">
 <title>Menu Reference</title>
 
 <para>This is a complete guide to the menus of &skladnik;.</para>
 
 <sect1 id="game-menu">
 <title>The Game Menu</title>
 
 <variablelist>
 <varlistentry>
 <term><menuchoice>
 <guimenu>Game</guimenu>
 <guimenuitem>Load Levels...</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para><action>Load an external level.</action> See the section <link
 linkend="loading-external-levels">Loading External Levels</link> for
 more information.</para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut><keycap>N</keycap></shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>Next Level</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para><action>Load the next level.</action></para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut><keycap>P</keycap></shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>Previous Level</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para><action>Go back to the previous level.</action></para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut>&Esc;</shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>Restart Level</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para><action>Restart the current level.</action></para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Game</guimenu>
 <guisubmenu>Level Collection</guisubmenu>
 </menuchoice></term>
 <listitem>
 <para><action>A submenu to switch to a different set of levels.</action> &skladnik;
 comes with several level sets, and you can load more that you can find
 on the internet.</para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>Undo</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para><action>Undo the last move.</action></para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut>
 <guimenu>Game</guimenu>
 <guimenuitem>Redo</guimenuitem>
 </menuchoice></term>
 <listitem>
 <para><action>Redo the last move you undid with the menu item above.</action></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>Exit</action> &skladnik;.</para>
 </listitem>
 </varlistentry>
 </variablelist>
 </sect1>
 
 <sect1 id="animation-menu">
 <title>The Animation Menu</title>
 
 <para>
 This menu offers menu items with check boxes that allow you to specify the speed to which the movement replay animations are shown at.
 </para>
 
 <variablelist>
 <varlistentry>
 <term><menuchoice>
 <guimenu>Animation</guimenu>
 <guisubmenu>Slow</guisubmenu>
 </menuchoice></term>
 <listitem>
 <para><action>Show replay animations at a slow pace.</action></para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Animation</guimenu>
 <guisubmenu>Medium</guisubmenu>
 </menuchoice></term>
 <listitem>
 <para>This is the default setting, and <action>shows replay animations at a slightly faster pace</action>.</para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Animation</guimenu>
 <guisubmenu>Fast</guisubmenu>
 </menuchoice></term>
 <listitem>
 <para><action>Show replay animations at the fastest pace.</action></para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Animation</guimenu>
 <guisubmenu>Off</guisubmenu>
 </menuchoice></term>
 <listitem>
 <para><action>Do not animate replay animations.</action></para>
 </listitem>
 </varlistentry>
 </variablelist>
 
 </sect1>
 
 
 <sect1 id="bookmarks">
 <title>The Bookmarks Menu</title>
 
 <variablelist>
 <varlistentry>
 <term><menuchoice>
 <guimenu>Bookmarks</guimenu>
 <guisubmenu>Set Bookmark</guisubmenu>
 </menuchoice></term>
 <listitem>
 <para>&skladnik; allows you to <action>set bookmarks with a level at a
 particular state.</action> You might use this to save yourself
 repeating the same initial steps in a level.</para>
 <para>You can have up to ten bookmarks at a time, and access them via the
 <keycombo action="simul">&Ctrl;<keycap><replaceable>X</replaceable></keycap></keycombo>
 shortcut, where <replaceable>X</replaceable> is any digit between 0 and 9.</para>
 </listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Bookmarks</guimenu>
 <guisubmenu>Go to Bookmark</guisubmenu>
 </menuchoice></term>
 <listitem>
 <para><action>Jump to a state you have previously saved as a bookmark.</action></para>
 </listitem>
 </varlistentry>
 </variablelist>
 
 </sect1>
 
 <sect1 id="help-menu">
 <title>The Help Menu</title>
 
 <para>
 &skladnik; has the common &kde; <guimenu>Help</guimenu> menu item, for more information read the section about the <ulink url="help:/fundamentals/menus.html#menus-help">Help Menu</ulink> of the &kde; Fundamentals.
 </para>
 
 </sect1>
 </chapter>
 
 <chapter id="credits">
 <title>Credits and License</title>
 
 <para>
 &skladnik; is copyright &copy; 1998-2000 by &Anders.Widell;
 &Anders.Widell.mail;.<!-- TODO: For
 the latest info on &skladnik;, see the &skladnik; home page at
 <ulink url="http://hem.passagen.se/awl/ksokoban/">
 http://hem.passagen.se/awl/ksokoban/</ulink>-->
 </para>
 
 <para>
 The background graphics <quote>starfield</quote> was taken from the
 <ulink url="https://www.gimp.org/">Gimp</ulink>. All other graphics
 were created by &Anders.Widell; &Anders.Widell.mail; using
 the <ulink url="https://www.povray.org/">Povray</ulink> ray tracer.
 </para>
 
 <para>
 All the currently included sokoban levels were created by David W.
 Skinner <email>sasquatch@bentonrea.com</email>. See
 <ulink url="https://www.sokobanonline.com/play/web-archive/david-w-skinner">his sokoban page</ulink>.
 </para>
 
 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
 &underFDL;
 &underGPL;
 </chapter>
 
 &documentation.index;
 </book>