<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!-- Define an entity for your application if it is not part of KDE
       SVN -->
  <!ENTITY mancala "Mancala">
  <!ENTITY kappname "&mancala;">
  <!ENTITY package "kdegames"
><!-- kdebase, kdeadmin, etc.  Leave
                                     this unchanged if your
                                     application is not maintained in KDE CVS -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Portuguese "INCLUDE">
]>
<!-- ................................................................ -->

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

<authorgroup>
	<author
><firstname
>A.H.M. Mahfuzur</firstname
> <surname
>Rahman</surname
> <affiliation
> <address
>65mahfuz90@gmail.com</address>
		</affiliation>
	</author>
	<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>zepires@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

<copyright>
	<year
>2009-2010</year>
	<holder
>A.H.M. Mahfuzur Rahman</holder>
</copyright>

<!--<legalnotice
>&FDLNotice;</legalnotice
>-->

<date
>2010-04-05</date>
<releaseinfo
>0.2</releaseinfo>

<abstract>
	<para
>O &mancala; é uma implementação em 'software' livre de uma família de jogos de tabuleiro jogados por todo o mundo, chamado <quote
>&mancala;</quote
> (da palavra Árabe <quote
>naqala</quote
>, que significa <quote
>mover</quote
>).</para>
</abstract>
<keywordset>
	<keyword
>KDE</keyword>
	<keyword
>kdegames</keyword
> <!-- do not change this! -->
	<keyword
>jogo</keyword
> <!-- do not change this! -->
	<keyword
>mancala</keyword
><!--Application name goes here-->
<!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<keyword
>lógica</keyword>
	<keyword
>tabuleiro</keyword>
<!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<keyword
>um jogador</keyword>
</keywordset>
</bookinfo>

<!-- The contents of the documentation begin here.  Label
each chapter so with the id attribute. This is necessary for two reasons: it
allows you to easily reference the chapter from other chapters of your
document, and if there is no ID, the name of the generated HTML files will vary
from time to time making it hard to manage for maintainers and for the CVS
system. Any chapter labelled (OPTIONAL) may be left out at the author's
discretion. Other chapters should not be left out in order to maintain a
consistent documentation style across all KDE apps. -->

<chapter id="introduction">
    <title
>Introdução</title>
	<note
><title
>Tipo de jogo:</title
><para
>Lógica, Tabuleiro</para
></note
><!-- Game genre. Use as many as necessary. Available game types are: Arcade, Board, Card, Dice, Toys, Logic, Strategy.-->
	<note
><title
>Número de jogadores possíveis:</title
><para
>Um</para
></note
><!--Number of possible players. It can be: One, Two,..., Multiplayer-->
	<para
>O Mancala é um jogo de tabuleiro para um único jogador. Não é um único jogo, mas sim uma colecção de jogos.</para>
	<para
>O Mancala necessita de um tabuleiro, alguns copos e pedras (peças) para jogar. O número de copos e pedras em cada copo poderá variar de jogo para jogo. Se não estiver disponível uma tabuleiro, poderá usar o chão ou uma mesa como substituto. Do mesmo modo, em alguns locais, as pessoas jogam com conchas ou escavando buracos em vez de ter copos. As peças (pedras) poderão ser qualquer coisa. </para>
	<para
>O Mancala tem uma enorme variedade. Foi adoptado o jogo de duas filas de Mancala com 2 jogadores (um é o humano, e o outro é o computador, neste momento). </para>
<!-- The introduction chapter contains a brief introduction for the
application that explains what it does and where to report
problems. Basically a long version of the abstract.  Don't include a
revision history. (see installation appendix comment) -->
</chapter>

<chapter id="howto">
    <title
>Como Jogar</title
> <!-- do not change this! -->
<!--IMPORTANT: If the game has no defined objective, please remove the below line.-->
	<note
><title
>Objectivo:</title>
	<para
>Capturar mais pedras que o seu adversário.</para
></note
><!--Describe the objective of the game.-->
    <sect1 id="starting">
    <title
>Começar um Jogo</title>
<!--How to play description. Don't be to specific on rules as they have a separate section in this document-->
      <screenshot>
        <screeninfo
>Interface do &mancala;</screeninfo>
        <mediaobject>
          <imageobject
><imagedata format="PNG" fileref="main_window.png"/></imageobject>
          <textobject
><phrase
>Interface do &mancala;.</phrase
></textobject>
        </mediaobject>
      </screenshot>
   <para
>Esta é a imagem do que as pessoas irão ver, caso o &mancala; esteja em execução. Tem uma interface bastante simples.</para>
   
   <para
>Na imagem, poderá ver o jogo Kalah. Poderá escolher outros jogos na lista ou em <menuchoice
><guimenu
>Ficheiro</guimenu
><guisubmenu
>Novo Jogo</guisubmenu
><guimenuitem
><replaceable
>Nome do Jogo</replaceable
></guimenuitem
></menuchoice
>.</para>
   
   <note
><title
>Nota:</title
><para
>A descrição detalhada das regras dos jogos poderá ser encontrada nas secções de <link linkend="basic_concept"
>Conceitos Básicos</link
> e <link linkend="game_specific_rules"
>Regras Específicas dos Jogos</link
> deste manual.</para
></note>
   
   <para
>Se quiser reiniciar o jogo em qualquer altura, podê-lo-á fazer se carregar em <menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>Reiniciar o Jogo</guimenuitem
></menuchoice
> ou na barra de ferramentas.</para>
   
   <para
>Qualquer pessoa poderá também escolher a dificuldade do jogo. Neste momento, existem três níveis de dificuldade: fácil, moderado e difícil. Poderá escolher o nível a partir da barra de estado ou simplesmente ir para <menuchoice
><guimenu
>Configuração</guimenu
><guisubmenu
>Dificuldade</guisubmenu
><guimenuitem
><replaceable
>Nível de dificuldade</replaceable
></guimenuitem
></menuchoice
>.</para>
   
   <para
>Para além disso, se quiser fazer algo que seja inválido no jogo, será apresentada alguma mensagem na barra de estado. Por exemplo, se algum copo estiver vazio e se quiser fazer à mesma um movimento a partir dele, irá aparecer uma mensagem do tipo <quote
>Infelizmente, não existem pedras suficientes para mover</quote
>.</para>
   </sect1>
  
    <sect1 id="basic_concept">
    <title
>Conceito Básico</title>
      <para
>O &mancala; inclui neste momento sete jogos. Estes são: kalah, oware, barbados_warri, bechi, dakon, sungka e chungka.</para>
   
      <para
>Antes de passar às regras detalhadas de cada um deles, convém indicar as regras básicas dos jogos de Mancala disponíveis. A discussão de cada um dos jogos está fora do âmbito. Só será feita a explicação dos jogos incluídos nesta aplicação.</para>
      
      <para
>Todos os jogos de duas filas consistem numa quantidade diferente de copos e de pedras em cada um desses copos. O número de copos poderá variar de jogo para jogo. Um jogador tem alguns copos e tem um copo grande para armazenamento. As pedras movem-se de copo para copo mas, se alguma vez forem postas no armazenamento, não voltarão mais ao jogo. Serão suas para sempre.</para>
      <para
>Serão definidos alguns critérios em primeiro lugar:</para>
      <variablelist>
       <varlistentry>
          <term
><emphasis
>Número mínimo de pedras a semear</emphasis
></term>
          <listitem>
             <para
>O número necessário de pedras num copo para uma jogada válida, que varia de jogo para jogo. Por exemplo, no Kalah é uma, enquanto no Bechi são 2.</para>
          </listitem>
       </varlistentry>
       <varlistentry>
          <term
><emphasis
>Número de peças que permanece após semear</emphasis
></term>
          <listitem>
             <para
>Depois de efectuar a jogada, em alguns jogos, o copo fica vazio, mas noutros necessita de deixar algumas pedras nele. No Kalah, o copo fica vazio, enquanto no Bechi se deixa 1 pedra.</para>
          </listitem>
       </varlistentry>
       <varlistentry>
          <term
><emphasis
>Direcção dos movimentos</emphasis
></term>
          <listitem>
             <para
>Em alguns jogos, o jogador move-se no sentido dos ponteiros do relógio e noutros move-se no sentido inverso. Também é permitida a direcção condicional (no Bechi).</para>
          </listitem>
       </varlistentry>
       <varlistentry>
          <term
><emphasis
>Semear</emphasis
></term>
          <listitem>
             <para
>Ao mover-se um jogador, diz-se que está a 'semear'. Quando chegar a vez de um dado jogador, terá de seleccionar um copo, o qual irá mover/semear. Existem dois tipos deste movimento nos nossos jogos:</para>
             <itemizedlist>
               <listitem>
                 <para
>Volta Simples: No caso dos jogos como o Kalah, quando um jogador optar por se mover, o copo contém a quantidade de pedras   que é necessário deixar e quantos copos (na direcção do movimento) ou armazenamentos recebem uma pedra, até que a pedra termine. Se a última pedra estiver no armazenamento, é possível uma jogada de bónus (caso o jogo a permita). Poderá ser possível uma captura se a última peça estiver no copo do jogador (Captura Cruzada, se for permitida) ou no do adversário (Captura por Quantidade e por Séries).</para>
               </listitem>
               <listitem>
                 <para
>Volta Múltipla: Se a última pedra do último movimento estiver em qualquer copo que faça com que o número de pedras no copo permita uma jogada válida, então fica completo outro movimento. Este processo repete-se até que a pedra esteja em qualquer copo, a partir do qual o movimento se torne inválido.</para>
               </listitem>
              </itemizedlist>
          </listitem>
       </varlistentry>
       <varlistentry>
          <term
><emphasis
>Jogada de Bónus</emphasis
></term>
          <listitem>
             <para
>Em alguns jogos, é permitida uma jogada de bónus, caso a última pedra seja armazenada. Exemplo: Kalah.</para>
          </listitem>
       </varlistentry>
       <varlistentry>
          <term
><emphasis
>Captura</emphasis
></term>
          <listitem>
             <para
>Estão disponíveis vários tipos de captura nos diferentes jogos. Será dada agora uma descrição precisa sobre eles em baixo:</para>
             <itemizedlist>
               <listitem>
                 <para
>Captura Cruzada: Se a última pedra de um jogador estiver num copo (do lado do jogador) anteriormente vazio, então poderá capturar todas as pedras (se existirem) no copo do lado do adversário que se encontre no caminho. Exemplo: Kalah.</para>
               </listitem>
               <listitem>
                 <para
>Captura por Quantidade: Se a última pedra posta num copo do adversário fizer com que o número de pedras no copo atinja um valor específico, então as pedras no copo poderão ser capturadas. Exemplo: no Oware, se o número for 2 ou 3, é possível a captura.</para>
               </listitem>
               <listitem>
                 <para
>Captura por Séries: Se for possível a captura por quantidade e os copos seguintes ou anteriores (depende do jogo) do adversário também tiverem o mesmo número de pedras, então também serão capturas até que a lei deixe de ser válida. Exemplo: Oware, Barbados Warri, Bechi.</para>
               </listitem>
              </itemizedlist>
          </listitem>
       </varlistentry>
    </variablelist>
   <para
>Neste jogo jogo, a primeira jogada pertence ao humano (o jogador). O lado do jogador é o inferior. Quando chega a vez de um jogador, o mesmo terá de semear. Se a captura for possível após semear, então esta será feita. Depois, o adversário joga a sua ronda ou, caso o jogador tenha tido uma jogada de bónus (se tal for permitido), passa a ser ele a jogar. O jogo continua desta forma então. Quando todas as pedras tiverem terminado, o jogo acaba. O objectivo do jogo é maximizar o número de pedras no seu armazém.</para>
   </sect1>

      <sect1 id="game_specific_rules">
      <title
>Regras Específicas dos Jogos</title>
         <para
>Os jogos variam em alguns detalhes. As diferenças são indicadas em baixo.</para>
   <para
><emphasis
>Kalah</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Região</segtitle>
       <segtitle
>Semear</segtitle>
       <segtitle
>Movimento</segtitle>
       <segtitle
>Número mínimo de pedras a semear</segtitle>
       <segtitle
>Tamanho do Tabuleiro</segtitle>
       <segtitle
>Pedras por Copo</segtitle>
       <segtitle
>Captura</segtitle>
       <segtitle
>Jogada de Bónus</segtitle>
       <seglistitem
><seg
>Médio-Oriente</seg
><seg
>único</seg
><seg
>anti-horário</seg
><seg
>1</seg
><seg
>2 x 6 (2 filas, 6 copos em cada fila)</seg
><seg
>4</seg
><seg
>cruzada</seg
><seg
>permitida</seg>
       </seglistitem>
   </segmentedlist>
   <para
><emphasis
>Oware</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Região</segtitle>
       <segtitle
>Semear</segtitle>
       <segtitle
>Movimento</segtitle>
       <segtitle
>Número mínimo de pedras a semear</segtitle>
       <segtitle
>Tamanho do Tabuleiro</segtitle>
       <segtitle
>Pedras por Copo</segtitle>
       <segtitle
>Captura</segtitle>
       <segtitle
>Jogada de Bónus</segtitle>
       <seglistitem
><seg
>Gana</seg
><seg
>único</seg
><seg
>anti-horário</seg
><seg
>1</seg
><seg
>2 x 6</seg
><seg
>4</seg
><seg
>quantidade e séries (2 ou 3)</seg
><seg
>não permitida</seg>
       </seglistitem>
   </segmentedlist>
   <para
><emphasis
>Barbados Warri</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Região</segtitle>
       <segtitle
>Semear</segtitle>
       <segtitle
>Movimento</segtitle>
       <segtitle
>Número mínimo de pedras a semear</segtitle>
       <segtitle
>Tamanho do Tabuleiro</segtitle>
       <segtitle
>Pedras por Copo</segtitle>
       <segtitle
>Captura</segtitle>
       <segtitle
>Jogada de Bónus</segtitle>
       <seglistitem
><seg
>Barbados</seg
><seg
>único</seg
><seg
>anti-horário</seg
><seg
>1</seg
><seg
>2 x 6</seg
><seg
>4</seg
><seg
>quantidade e séries (2 ou 3)</seg
><seg
>não permitida</seg>
       </seglistitem>
   </segmentedlist>
   <para
><emphasis
>Bechi</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Região</segtitle>
       <segtitle
>Semear</segtitle>
       <segtitle
>Movimento</segtitle>
       <segtitle
>Número mínimo de pedras a semear</segtitle>
       <segtitle
>Tamanho do Tabuleiro</segtitle>
       <segtitle
>Pedras por Copo</segtitle>
       <segtitle
>Captura</segtitle>
       <segtitle
>Jogada de Bónus</segtitle>
       <seglistitem
><seg
>Eritreia (jogado pelos Kunama)</seg
><seg
>único</seg
><seg
>condicional (movimento do lado direito para os buracos do jogador -> anti-horário, outros -> horário)</seg
><seg
>2</seg
><seg
>2 x 4 </seg
><seg
>6 (inicialmente)</seg
><seg
>quantidade, séries (se o número de pedras for par)</seg
><seg
>não permitida</seg>
       </seglistitem>
   </segmentedlist>
   <para
><emphasis
>Dakon</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Região</segtitle>
       <segtitle
>Semear</segtitle>
       <segtitle
>Movimento</segtitle>
       <segtitle
>Número mínimo de pedras a semear</segtitle>
       <segtitle
>Tamanho do Tabuleiro</segtitle>
       <segtitle
>Pedras por Copo</segtitle>
       <segtitle
>Captura</segtitle>
       <segtitle
>Jogada de Bónus</segtitle>
       <seglistitem
><seg
>Ilha de Java</seg
><seg
>múltiplas</seg
><seg
>anti-horário</seg
><seg
>2</seg
><seg
>2 x 7</seg
><seg
>7 (inicialmente)</seg
><seg
>cruzada</seg
><seg
>não permitida</seg>
       </seglistitem>
   </segmentedlist>
   <para
><emphasis
>Chungka</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Região</segtitle>
       <segtitle
>Semear</segtitle>
       <segtitle
>Movimento</segtitle>
       <segtitle
>Número mínimo de pedras a semear</segtitle>
       <segtitle
>Tamanho do Tabuleiro</segtitle>
       <segtitle
>Pedras por Copo</segtitle>
       <segtitle
>Captura</segtitle>
       <segtitle
>Jogada de Bónus</segtitle>
       <seglistitem
><seg
>Ilha das Marianas (Oceânia)</seg
><seg
>múltiplas</seg
><seg
>horário</seg
><seg
>2</seg
><seg
>2 x 7</seg
><seg
>7</seg
><seg
>cruzada</seg
><seg
>não permitida</seg>
       </seglistitem>
   </segmentedlist>
   <para
><emphasis
>Sungka</emphasis
>:</para>
   <segmentedlist>
       <segtitle
>Região</segtitle>
       <segtitle
>Semear</segtitle>
       <segtitle
>Movimento</segtitle>
       <segtitle
>Número mínimo de pedras a semear</segtitle>
       <segtitle
>Tamanho do Tabuleiro</segtitle>
       <segtitle
>Pedras por Copo</segtitle>
       <segtitle
>Captura</segtitle>
       <segtitle
>Jogada de Bónus</segtitle>
       <seglistitem
><seg
>Filipinas</seg
><seg
>múltiplas</seg
><seg
>horário</seg
><seg
>2</seg
><seg
>2 x 7</seg
><seg
>7</seg
><seg
>cruzada</seg
><seg
>permitida</seg>
       </seglistitem>
   </segmentedlist>
   </sect1>
   
   <sect1 id="tipstricks">
      <title
>Truques e dicas</title>
      <para
>Alguns truques poderão ser úteis para os jogadores novos:</para>
      
      <itemizedlist>
      <listitem
><para
>Tente obter uma jogada de bónus, se tal for permitido. Do mesmo modo, impeça que o seu adversário obtenha uma jogada de bónus. Cuidado com as capturas; uma boa captura do seu adversário podê-lo-á atirar completamente para fora do jogo.</para
></listitem>
      <listitem
><para
>Este jogo está a contar. Por isso, se fizer uma boa contagem também, estará em melhor posição.</para
></listitem>
      </itemizedlist>
      <para
>Sinta-se à vontade para experimentar e assimilar os truques. Tenha um bom jogo...</para>
      </sect1>
</chapter>


<chapter id="credits">

<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE
distribution. -->

<title
>Créditos e Licença</title>

<para
>&mancala; </para>
<para
>Programa com 'copyright' 2009-2010 de A.H.M. Mahfuzur Rahman <email
>65mahfuz90@gmail.com</email
> </para>

<para
>Documentação com 'copyright' &copy; 2010 de A.H.M. Mahfuzur Rahman <email
>65mahfuz90@gmail.com</email
> </para>

<para
>Tradução de José Nuno Pires <email
>zepires@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>

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

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

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

</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->

