<para>&ksokoban; is een &kde;-versie van het Japanse magazijnmeesterspel <quote>sokoban</quote>. Dit document beschrijft &ksokoban; versie 0.4.2. </para>
<para>Het eerste sokoban-spel is gemaakt in 1982 door Hiroyuki Imabayashi bij het Japanse bedrijf Thinking Rabbit, Inc. <quote>sokoban</quote> is Japans voor <quote>magazijnmeester</quote>. Het idee is dat u een magazijnmeester bent en probeert kratten naar hun plek in een magazijn te duwen. </para>
<para>Het probleem is dat u niet aan de kratten kunt trekken of eroverheen klimmen. Als u niet voorzichtig bent dan kunnen enkele kratten vast komen te staan op de verkeerde plek en/of uw doorgang blokkeren. </para>
<para>Het oplossen van een niveau kan vrij lastig zijn. Maar als u het uzelf nog moeilijker wilt maken, probeer dan het aantal zetten en/of duwen die u gebruikt om het niveau op te lossen te beperken. </para>
<para>Om het spel toegankelijker te maken voor kinderen (jonger dan 10 jaar) zijn er collecties met eenvoudigere niveaus toegevoegd aan &ksokoban;. Deze zijn gemarkeerd als <emphasis>(eenvoudig)</emphasis>. Deze niveaus zijn natuurlijk ook geschikt voor volwassen, bijvoorbeeld als u het uzelf niet te moeilijk wilt maken. </para>
<para>Gebruik de pijltoetsen of de muis om de magazijnmeester voort te bewegen. Als u naar een diamant toegaat met de cursortoetsen of de <mousebutton>middelste</mousebutton> muisknop, en er niets dat de overzijde blokkeert, dan duwt u de diamant naar voren. U kunt niet aan de diamanten trekken, dus als u de diamant in een hoek duwt krijgt u die daar niet meer weg. U kunt ook niet over diamanten heen klimmen, dus u kunt vast komen te zitten in een deel van het doolhof doordat de weg door diamanten wordt geblokkeerd. U kunt bovendien niet meer dan 1 diamant tegelijk wegduwen. </para>
<para>Als u merkt dat u de diamanten zodanig hebt verplaatst dat u het niveau niet kunt oplossen, dan kunt u uw zetten ongedaan maken, net zo lang totdat u terug bent op een positie waar de fout nog niet gemaakt is. U kunt ook het niveau herstarten en opnieuw beginnen. </para>
<row><entry>Pijltoetsen </entry><entry>Één stap in een bepaalde richting zetten </entry></row>
<row><entry><keycombo action="simul">&Ctrl;<keycap>pijltoetsen</keycap></keycombo> </entry><entry>Zover als mogelijk in een bepaalde richting lopen zonder een diamant te verplaatsen </entry></row>
<row><entry><keycombo action="simul">&Shift;<keycap>Pijltoetsen</keycap></keycombo> </entry><entry>Zover als mogelijk in een bepaalde richting lopen en een diamant die op het pad ligt verplaatsen </entry></row>
<row><entry><mousebutton>Linker</mousebutton> muisknop </entry><entry>Ga naar een plek in het doolhof dat kan worden bereikt zonder een diamant te verplaatsen </entry></row>
<row><entry><mousebutton>Middelste</mousebutton> muisknop of <keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></entry><entry>Maak de laatste zet ongedaan </entry></row>
<row><entry><mousebutton>Rechter</mousebutton> muisknop </entry><entry>Ga in een rechte lijn een bepaalde richting op, waarbij een op het pad liggende diamant wordt weggeduwd </entry></row>
<row><entry><mousebutton>Muiswiel</mousebutton></entry><entry>Loop door de uitgevoerde zetten </entry></row>
<row><entry><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></entry><entry>Voer de laatst ongedaan gemaakte zet opnieuw uit </entry></row>
<row><entry><keycap>N</keycap> </entry><entry>Ga naar het volgende niveau in de huidige niveaucollectie </entry></row>
<row><entry><keycap>P</keycap> </entry><entry>Ga naar het vorige niveau in de huidige niveaucollectie </entry></row>
<row><entry>&Esc; </entry><entry>Herstart het huidige niveau </entry></row>
<row><entry><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></entry><entry>Beëindigt het spel </entry></row>
<para>&ksokoban; kan externe sokoban-niveaus uit tekstbestanden laden. U kunt niveaus laden via menuoptie <menuchoice><guimenu>Spel</guimenu><guimenuitem>Niveaus laden...</guimenuitem></menuchoice>, of door het URL-adres van een niveaubestand op te geven als commandoregelargument tijdens het opstarten van &URL; vanuit een terminal. </para>
<para>De externe bestanden dienen te zijn opgemaakt met behulp van de standaard tekens die in onderstaande tabel staan. Als het bestand meer dan één niveau bevat, dan dienen de niveaus van elkaar gescheiden te worden met lege regels. Het bestand mag tekst tussen de niveaus bevatten. </para>
<para><action>Opent een extern niveau</action>. Zie de sectie <link linkend="loading-external-levels">Externe niveaus laden</link> voor meer informatie.</para>
<para>U kunt in &ksokoban; <action>bladwijzers zetten op een bepaalde positie in een niveau</action>. U kunt dit gebruiken om uzelf het telkens opnieuw uitvoeren van de eerste zetten in een niveau te besparen.</para>
<para>U kunt tot tien bladwijzers per keer instellen en ze bereiken via de sneltoets <keycombo action="simul">&Ctrl;<keycap><replaceable>X</replaceable></keycap></keycombo>, waarbij de <replaceable>X</replaceable> een cijfer is tussen de 0 en 9.</para>
<listitem><para><action>Opent een dialoog waarmee u een bug kunt rapporteren</action>, ook kunt u zo een wens op de <quote>wishlist</quote> plaatsen. Bugs zijn fouten in het programma.</para></listitem>
<para>De achtergrondafbeeldingen <quote>starfield</quote> zijn genomen uit <ulink url="http://www.gimp.org/">The Gimp</ulink>. Alle andere illustraties zijn gemaakt door Anders Widell <email>awl@passagen.se</email>, met behulp van de <ulink url="http://www.povray.org/">Povray</ulink> ray tracer. </para>
<para>Alle huidige meegeleverde sokoban-niveaus zijn gemaakt door David W. Skinner <email>sasquatch@bentonrea.com</email>. Kijk voor meer informatie op zijn sokoban-pagina op <ulink url="http://users.bentonrea.com/~sasquatch/sokoban/">http://users.bentonrea.com/~sasquatch/sokoban/</ulink> </para>