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

<book lang="&language;">
<bookinfo>
<title
>O Manual do &kshisen;</title>

<authorgroup>
<author
><firstname
>Dirk</firstname
> <surname
>Doerflinger</surname
> <affiliation
> <address
><email
>ddoerflinger@web.de</email
></address>
</affiliation>
</author>
<othercredit role="reviewer"
><firstname
>Frerich</firstname
><surname
>Raabe</surname
> <contrib
>Revisão</contrib>
<affiliation
><address
><email
>raabe@kde.org</email
></address
></affiliation>
</othercredit>
</authorgroup>

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

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

<abstract>
<para
>Este Manual descreve o &kshisen; Versão 1.4.90</para>
</abstract>

<keywordset>
      <keyword
>KDE</keyword>
      <keyword
>kdegames</keyword>
      <keyword
>kshisen</keyword>
      <keyword
>jogo</keyword>
      <keyword
>shisen-Sho</keyword>
</keywordset>

</bookinfo>


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

<para
>O &kshisen; é um jogo para um único jogador semelhante ao Mahjongg e que usa o mesmo conjunto de peças que esse jogo.</para
> 

<para
>O objectivo do jogo é remover todas as peças do campo.</para>

</chapter>

<chapter id="playing-kshisen">
<title
>Jogar o &kshisen;</title>

<sect1 id="rules">
<title
>Regras</title>

<para
>O objectivo do jogo é remover todas as peças do tabuleiro. Só poderão ser removidas duas peças correspondentes de cada vez. Duas peças só poderão ser removidas com se puderem estar ligadas com um máximo de três linhas ligadas. Essas linhas poderão ser horizontais ou verticais, mas não diagonais. </para>

<para
>Você não tem que desenhar as linhas em si, o jogo faz isso por si. Basta marcar duas peças correspondentes no tabuleiro para que, se elas puderem ser ligadas com um máximo de três linhas, estas sejam desenhadas e as peças sejam removidas. </para>

<para
>Lembre-se qye as linhas só poderão passar por campo já desprovido de peças. Se estiver atrapalhado, poderá usar a funcionalidade da Dica para descobrir duas peças que possam ser removidas. Se carregar numa peça com o &RMB; irão realçar-se todas as peças correspondente, independentemente do facto de elas poderem ser removidas no momento ou não.</para>

<para
>O jogo termina se não for possível efectuar mais jogadas e se ainda existirem peças no tabuleiro (isto não deveria acontecer se a opção de <guimenuitem
>Não Permitir Jogos Impossíveis</guimenuitem
> no menu <guimenu
>Configuração</guimenu
> estiver assinalada, dado que para esses jogos existe pelo menos uma forma de o resolver, ainda que possa acontecer que você faça as jogadas erradas).</para>

<para
>A pontuação resultante <quote
>P</quote
> é calculada com base na seguinte fórmula, assumindo que o <quote
>n</quote
> representa o número de peças presentes quando jogo começou e o <quote
>t</quote
> corresponda ao tempo em segundos que levou a limpar o jogo:</para>

<mediaobject
><imageobject>
<imagedata fileref="score-formula.png" format="PNG"/>
</imageobject
><textobject>
<phrase
>S=(n/t)*sqrt(n/84)/0.0014</phrase>
</textobject
></mediaobject>

<para
>Se você jogar com a opção de <guilabel
>Gravidade</guilabel
> ligada, esta pontuação será posteriormente multiplicada por dois.</para>
</sect1>

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

<para
>O menu <guimenu
>Jogo</guimenu
> permite-lhe controlar o estado do jogo actual:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl; <keycap
>N</keycap
></keycombo
></shortcut
> <guimenu
>Jogo</guimenu
><guimenuitem
>Novo</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Termina o jogo actual</action
> e inicia uma nova sessão com peças novas. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>F5</keycap
></keycombo
></shortcut
> <guimenu
>Jogo</guimenu
><guimenuitem
>Reiniciar o Jogo</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Reinicia o jogo actual com as mesmas peças.</action
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>P</keycap
></keycombo
></shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Pausa</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Põe o jogo inteiro em pausa</action
>, principalmente o cronómetro que afecta a pontuação. O item de menu em questão irá então mudar para <guimenuitem
>Continuar o Jogo</guimenuitem
>, para que o jogo possa ser retomado mais tarde.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Jogo</guimenu
><guimenuitem
>Mostrar os Recordes</guimenuitem
></menuchoice
></term>
<listitem
><para
>Mostra o Top-10 (local) do &kshisen;.</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
>Sai</action
> do &kshisen;. </para
></listitem>
</varlistentry>


</variablelist>

<para
>Alguns dos itens do menu também podem ser controlados através de combinações de teclas. Veja em <xref linkend="key-bindings"/> a lista.</para
> 

</sect1>

<sect1 id="move-menu">
<title
>O Menu <guimenu
>Mover</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Movimento</guimenu
> <guimenuitem
>Desfazer</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Anula a última jogada</action
>. É o mesmo que o botão <guibutton
>Desfazer</guibutton
> da barra de ferramentas.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></shortcut
> <guimenu
>Movimento</guimenu
> <guimenuitem
>Refazer</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Repete a última jogada anulada</action
>. É o mesmo que o botão <guibutton
>Refazer</guibutton
> da barra de ferramentas.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo
><keycap
>H</keycap
></keycombo
></shortcut
> <guimenu
>Movimento</guimenu
> <guimenuitem
>Sugestão</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Dá uma sugestão</action
> de duas peças que poderão ser removidas a seguir.</para
></listitem>
</varlistentry>

</variablelist>
</sect1>
</chapter>

<chapter id="configuration">
<title
>Configuração</title>

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

<para
>O &kshisen; tem várias possibilidades para alterar o seu comportamento. Todas as opções podem ser alteradas no menu <guimenu
>Configuração</guimenu
>.</para>

<para
>As opções serão gravadas automaticamente.</para>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>Configuração</guimenu
> <guisubmenu
>Tamanho</guisubmenu
></menuchoice
></term>
<listitem
><para
>No sub-menu <guisubmenu
>Tabuleiro</guisubmenu
> você poderá alterar o número de peças do tabuleiro. Quanto mais peças tiver, mais difícil (e mais demorado) será o jogo. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guisubmenu
>Velocidade</guisubmenu
></menuchoice
></term>
<listitem
><para
>O sub-menu <guisubmenu
>Velocidade</guisubmenu
> define o tempo que as peças levam a desaparecer quando ligadas correctamente. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guisubmenu
>Nível</guisubmenu
></menuchoice
></term>
<listitem
><para
>Escolha o seu grau de dificuldade no sub-menu <guisubmenu
>Nível</guisubmenu
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Gravidade</guimenuitem
></menuchoice
></term>
<listitem
><para
>Se assinalar este item tornará o jogo ainda mais difícil: Se uma peça for removida, todas as peças que estão por cima dela descerão uma posição. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Não Permitir Jogos Impossíveis</guimenuitem
></menuchoice
></term>
<listitem
><para
>Se este item do menu estiver assinalado, só os jogos que tenham solução é que serão criados quando for iniciado um novo jogo. Nota: Você poderá à mesma escolher as opções erradas e ter de tentar de novo se não conseguir resolver o jogo, mas se a opção estiver assinalada, o jogo <emphasis
>terá</emphasis
> solução.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Preferir Peças Não Escaladas</guimenuitem
></menuchoice
></term>
<listitem
><para
>Se redimensionar a janela, as peças do tabuleiro serão redimensionadas para corresponder ao tamanho da janela. Quando esta opção estiver assinalada, é a janela que é redimensionada para o tamanho natural das peças. Você poderá à mesma ajustar o tamanho da janela. Ao fazê-lo, fará com que este modo fique desactivado.</para
></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="key-bindings">
<title
>Associações de Teclas</title>

<para
>As teclas predefinidas são: </para>
<simplelist>
<member
>Novo: <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></member>
<member
>Reiniciar o Jogo: <keycombo
><keycap
>F5</keycap
></keycombo
></member>
<member
>Pausa: <keycombo
><keycap
>P</keycap
></keycombo
></member>
<member
>Mostrar os Recordes: <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
></member>
<member
>Sair: <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></member>

<member
>Desfazer: <keycombo action="simul"
>&Ctrl;<keycap
>Z</keycap
></keycombo
></member>
<member
>Refazer: <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
></member>
<member
>Dica: <keycombo
><keycap
>H</keycap
></keycombo
></member>

<member
>Preferir as Peças Não Escaladas: <keycombo
><keycap
>S</keycap
></keycombo
></member>

<member
>O Que É Isto?: <keycombo action="simul"
>&Shift;<keycap
>F1</keycap
></keycombo
></member>
</simplelist>
</sect1>
</chapter>


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

<para
>&kshisen; Copyright 1999 Mario Weilguni <email
>mweilguni@sime.com</email
> </para>


<para
>Documentação Copyright 2000 Dirk Doerflinger <email
>ddoerflinger@gmx.net</email
> </para>

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

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

<sect1 id="getting-kshisen">
<title
>Como obter o &kshisen;</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Requisitos</title>

<para
>Para poder compilar com sucesso o &kshisen;, você irá necessitar do &kde; 3.x. Todas as bibliotecas necessárias, assim como o próprio &kshisen; podem ser encontrados em &kde-ftp;.</para>
</sect1>


<sect1 id="compilation">
<title
>Compilação e Instalação</title>
&install.compile.documentation; </sect1>
</appendix>

</book>

