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

<authorgroup>
<author
><firstname
>Anders</firstname
> <surname
>Widell</surname
> <affiliation
> <address
><email
>awl@passagen.se</email
></address>
</affiliation>
</author>
</authorgroup>

<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@netcabo.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 

<copyright>
<year
>2000</year>
<holder
>Anders Widell</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2003-09-17</date>
<releaseinfo
>0.4.2</releaseinfo>

<abstract>
<para
>O &ksokoban; é uma implementação para o &kde; do jogo japonês do arrumador de armazéns <quote
>sokoban</quote
>. Este documento descreve o &ksokoban; versão 0.4.2. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdegames</keyword>
<keyword
>jogo</keyword>
<keyword
>sokoban</keyword>
<keyword
>ksokoban</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>O primeiro jogo do Sokoban foi criado em 1982 por Hiroyuki Imabayashi na companhia japonesa Thinking Rabbit, Inc. <quote
>Sokoban</quote
> significa em japonês <quote
>arrumador de armazéns</quote
>. A ideia é que você é um arrumador que tenta empurrar caixotes para os seus locais correctos num armazém. </para>

<para
>O problema é que você não pode puxar os contentores ou passar por cima deles. Se você não tiver cuidado, alguns deles poderão ficar entalados nos sítios errados ou bloquearem a sua passagem. </para>

<para
>Às vezes já é difícil o suficiente resolver um nível. Mas se você quiser torná-lo ainda mais difícil, você poderá tentar minimizar o número de movimentos e/ou empurrões que usar para resolver o nível. </para>

<para
>Para tornar o jogo mais divertido para as crianças (com 10 anos ou menos), algumas colecções com níveis mais fáceis estão também incluídas no &ksokoban;. Estas estão marcadas como <emphasis
>(fácil)</emphasis
> no menu das colecções de níveis. Claro que estes níveis também podem ser divertidos para os adultos, por exemplo se você não se quiser expor a muito esforço mental. </para>
</chapter>

<chapter id="how-to-play">
<title
>O Jogo</title>

<para
>O objectivo do jogo é empurrar todas as pedras vermelhas para os quadrados dos objectivos, os quais estão marcados com coisas verdes envidraçadas no chão. </para>

<para
>Use as teclas dos cursores ou o rato para se mover. Se se mover para uma peça com as teclas dos cursores ou com o botão <mousebutton
>do meio</mousebutton
> do rato, e se não houver nada a bloqueá-lo no lado oposto, então começará a empurrar a peça. Não é possível puxar as peças, por isso se empurrar uma peça para um canto, ela ficará lá presa. Você também não poderá passar por cima das peças, por isso você também poderá ficar entalado numa parte do labirinto se tapar a passagem com as peças. Finalmente, tenha em atenção que não é possível empurrar mais do que uma peça de uma vez. </para>

<para
>Se reparar que moveu as peças de tal forma que um nível se torne impossível de resolver, você poderá sempre usar a funcionalidade do Desfazer para anular as últimas jogadas até que o erro não tenha sido cometido. Você poderá obviamente também reiniciar o nível desde o início. </para>

<sect1 id="controls">
<title
>Controlos</title>

<para>
<informaltable>
<tgroup cols="2">
<thead>
<row
><entry
>Tecla</entry
><entry
>Acção</entry
></row>
</thead>

<tbody>
<row
><entry
>Teclas do cursor </entry
><entry
>Move uma posição numa dada direcção </entry
></row>
<row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>Teclas cursor</keycap
></keycombo
> </entry
><entry
>Move o mais que conseguir numa direcção sem empurrar peças </entry
></row>
<row
><entry
><keycombo action="simul"
>&Shift;<keycap
>Teclas do cursor</keycap
></keycombo
> </entry
><entry
>Move o mais que conseguir numa dada direcção, empurrando as peças que apanhar pelo caminho </entry
></row>
<row
><entry
>Botão <mousebutton
>esquerdo</mousebutton
> do rato </entry
><entry
>Move para qualquer lado do labirinto que possa estar acessível sem empurrar nenhumas peças </entry
></row>
<row
><entry
>Botão do <mousebutton
>meio</mousebutton
> do rato ou <keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></entry
><entry
>Anula a última jogada </entry
></row>
<row
><entry
>Botão <mousebutton
>direito</mousebutton
> do rato </entry
><entry
>Move para cima/baixo/esquerda/direita numa linha a direito, empurrando a peça que apanhar pelo caminho </entry
></row>
<row
><entry
><mousebutton
>Roda do rato</mousebutton
></entry
><entry
>Percorre o histórico </entry
></row>
<row
><entry
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></entry
><entry
>Repete a última jogada anulada </entry
></row>
<row
><entry
><keycap
>N</keycap
> </entry
><entry
>Vai para o próximo nível da colecção actual de níveis </entry
></row>
<row
><entry
><keycap
>P</keycap
> </entry
><entry
>Vai para o nível anterior da colecção actual de níveis </entry
></row>
<row
><entry
>&Esc; </entry
><entry
>Reiniciar o nível actual </entry
></row>
<row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></entry
><entry
>Sai do jogo </entry
></row>
</tbody>
</tgroup>
</informaltable>
</para>
</sect1>

<sect1 id="loading-external-levels">
<title
>Carregar níveis externos</title>

<para
>O &ksokoban; tem a possibilidade de carregar níveis externos do 'sokoban' a partir de ficheiros de texto. Você poderá carregar os níveis com o item de menu <menuchoice
><guimenu
>Jogo</guimenu
> <guimenuitem
>Carregar os Níveis...</guimenuitem
> </menuchoice
>, ou indicando o &URL; do ficheiro do nível como argumento da linha de comandos ao iniciar o &ksokoban; nessa linha de comandos. </para>

<para
>Os níveis externos devem ser definidos usando os caracteres-padrão mostrados na tabela em baixo. Se o ficheiro contiver mais do que um nível, os níveis deverão estar separados por linhas em branco. O ficheiro também poderá conter texto entre os níveis. </para>

<informaltable>
<tgroup cols="2">
<thead>
<row
><entry
>Carácter</entry
><entry
>Significado</entry
></row>
</thead>

<tbody>
<row
><entry
><literal
>#</literal
></entry
><entry
>Parede</entry
></row>
<row
><entry
><emphasis
>(espaço)</emphasis
></entry
><entry
>Quadrado vazio</entry
></row>
<row
><entry
><literal
>.</literal
></entry
><entry
>Quadrado alvo</entry
></row>
<row
><entry
><literal
>$</literal
></entry
><entry
>Objecto em quadrado vazio</entry
></row>
<row
><entry
><literal
>*</literal
></entry
><entry
>Objecto em quadrado alvo</entry
></row>
<row
><entry
><literal
>@</literal
></entry
><entry
>Posição inicial em quadrado vazio</entry
></row>
<row
><entry
><literal
>+</literal
></entry
><entry
>Posição inicial em quadrado alvo</entry
></row>
</tbody>
</tgroup>
</informaltable>

<para
>Por exemplo, encontra-se em baixo uma representação em texto do primeiro nível da colecção <emphasis
>Microban</emphasis
>: </para>

<para>
<screen
>####
# .#
#  ###
#*@  #
#  $ #
#  ###
####
</screen>
</para>
</sect1>
</chapter>

<chapter id="menu-reference">
<title
>Referência do Menu</title>

<para
>Este é um guia completo para os menus do &ksokoban;.</para>

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

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Jogo</guimenu
> <guimenuitem
>Carregar Níveis...</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Carrega um nível externo.</action
> Veja a secção <link linkend="loading-external-levels"
>Carregar Níveis Externos</link
> para mais informações.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>N</keycap
></shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Próximo Nível</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Carrega o próximo nível.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycap
>P</keycap
></shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Nível Anterior</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Volta atrás ao nível anterior.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
>&Esc;</shortcut
> <guimenu
>Game</guimenu
> <guimenuitem
>Reiniciar o Nível</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Reinicia o nível actual.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Jogo</guimenu
> <guisubmenu
>Colecção de Níveis</guisubmenu
> </menuchoice
></term>
<listitem>
<para
><action
>Muda para um conjunto de níveis diferente.</action
> O &ksokoban; vem com vários conjuntos de níveis e você poderá carregar mais, se os encontrar algures na Internet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Desfazer</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Desfaz p último movimento/action
></action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Refazer</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Repete a última jogada que você tenha anulado com a opção do menu anterior.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Sair</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Saí</action
> do &ksokoban;.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1 id="animation-menu">
<title
>O Menu <guimenu
>Animação</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
> <guimenu
>Animações</guimenu
> <guimenuitem
>Lentas</guimenuitem
> </menuchoice
> <menuchoice
> <guimenu
>Animações</guimenu
> <guimenuitem
>Médias</guimenuitem
> </menuchoice
> <menuchoice
> <guimenu
>Animações</guimenu
> <guimenuitem
>Rápidas</guimenuitem
> </menuchoice
> <menuchoice
> <guimenu
>Animações</guimenu
> <guimenuitem
>Desligadas</guimenuitem
> </menuchoice
></term>
<listitem>
<para
><action
>Altera a velocidade das animações.</action
> A opção por omissão é a <guimenuitem
>Média</guimenuitem
>.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="bookmarks">
<title
>O Menu <guimenu
>Favoritos</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Favoritos</guimenu
> <guisubmenu
>Gravar a Posição</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>O &ksokoban; permite-lhe <action
>definir favoritos com um nível num determinado estado.</action
> Você poderá usar isto para gravar você próprio, repetindo os mesmos passos iniciais de um nível.</para>
<para
>Você poderá ter até dez favoritos de uma vez e acedê-los através da combinação de teclas <keycombo action="simul"
>&Ctrl;<keycap
><replaceable
>X</replaceable
></keycap
></keycombo
>, em que o <replaceable
>X</replaceable
> é qualquer algarismo entre 0 e 9.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Favoritos</guimenu
> <guisubmenu
>Ler a Posição</guisubmenu
> </menuchoice
></term>
<listitem>
<para
><action
>Salta para um estado que você tenha gravado anteriormente como favorito.</action
>.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="help-menu">
<title
>O Menu <guimenu
>Ajuda</guimenu
></title>
<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
><keycap
>F1</keycap
></keycombo
> </shortcut
> <guimenu
>Ajuda</guimenu
> <guimenuitem
>Manual do &kappname;...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
><action
>Invoca o sistema de Ajuda do KDE</action
> com início nas páginas de ajuda do &kappname; (este documento).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ajuda</guimenu
> <guimenuitem
>Comunicar um Erro...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Abre a janela de relatório de erros</action
> na qual você poderá comunicar um erro ou pedir um <quote
>desejo</quote
> de funcionalidade.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ajuda</guimenu
> <guimenuitem
>Acerca do &kappname;</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Isto irá mostrar a versão e a informação do autor.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ajuda</guimenu
> <guimenuitem
>Acerca do KDE</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Isto mostra a versão do KDE, bem como outras informações básicas.</action
></para
></listitem>
</varlistentry>
</variablelist>

</sect1>
</chapter>

<chapter id="credits">
<title
>Créditos e Licença</title>

<para
>O &ksokoban; tem o 'copyright' &copy; 1998-2000 de Anders Widell <email
>awl@passagen.se</email
>. Para as últimas informações sobre o &ksokoban;, veja a página pessoal do &ksokoban; em <ulink url="http://hem.passagen.se/awl/ksokoban/"
> http://hem.passagen.se/awl/ksokoban/</ulink
> </para>

<para
>As imagens de fundo <quote
>do campo celeste</quote
> foram retiradas do <ulink url="http://www.gimp.org/"
>Gimp</ulink
>. Todas as outras imagens foram criadas pelo Anders Widell <email
>awl@passagen.se</email
> usando o desenhador <ulink url="http://www.povray.org/"
>Povray</ulink
>. </para>

<para
>Todos os níveis incluídos nesta altura foram criados pelo David W. Skinner <email
>sasquatch@bentonrea.com</email
>. Veja a sua página do Sokoban em <ulink url="http://users.bentonrea.com/~sasquatch/sokoban/"
> http://users.bentonrea.com/~sasquatch/sokoban/</ulink
> </para>

<para
>Tradução de José Nuno Pires <email
>jncp@netcabo.pt</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalação</title>

&install.intro.documentation;

&install.compile.documentation;

</appendix>

&documentation.index; 
</book>

