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

<book lang="&language;">

<bookinfo>
<title
>O Manual do &kmines;</title>

<authorgroup>
<author
><firstname
>Nicolas</firstname
> <surname
>Hadacek</surname
> <affiliation
> <address
><email
>hadacek@kde.org</email
></address>
</affiliation>
</author>
<author
><firstname
>Michael</firstname
> <surname
>McBride</surname
> <affiliation
><address
><email
>mmcbride@ematic.org</email
></address
></affiliation>
</author>
<othercredit role="developer"
><firstname
>Nicolas</firstname
> <surname
>Hadacek</surname
> <affiliation
> <address
><email
>hadacek@kde.org</email
></address>
</affiliation>
<contrib
>Desenvolvimento</contrib>
</othercredit>
<othercredit role="reviewer"
><firstname
>Lauri</firstname
> <surname
>Watts</surname
> <affiliation
><address
><email
>lauri@kde.org</email
></address
></affiliation>
<contrib
>Revisão</contrib>
</othercredit>
<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@netcabo.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2000</year>
<holder
>Nicolas Hadacek, Michael McBride</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2004-01-12</date>
<releaseinfo
>2.1.8</releaseinfo>

<abstract
><para
>O &kmines; é a versão para o &kde; do jogo clássico do Campo Minado.</para
></abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>jogo</keyword>
<keyword
>minas</keyword>
</keywordset>

</bookinfo>

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

<para
>&kmines; is the classic Minesweeper game. You must uncover all the empty squares without blowing up a mine.</para>

<para
>When you uncover a square, a number appears: it indicates how many mines surround this square. If there is no number the neighboring squares are automatically uncovered. When you find a square that you are sure contains a mine, it is <emphasis
>very</emphasis
> useful to put a flag on it (by right-clicking).</para>

</chapter>

<chapter id="how-to-play">
<title
>Como jogar</title>

<para
>You have to use the mouse and its three buttons to uncover or to flag the squares (with two-buttoned mice, clicking the <mousebutton
>middle</mousebutton
> button is generally achieved by simultaneously pressing the <mousebutton
>left</mousebutton
> and the <mousebutton
>right</mousebutton
> buttons). Here are the details:</para>

<itemizedlist>
<listitem
><para
>The <mousebutton
>left</mousebutton
> button will uncover a square. If there is a bomb below that square, the bomb will explode, and the game will be over.</para>
<para
>If there is not a bomb under the square, a number will appear. That is the number of neighboring squares that contain bombs. <quote
>Which ones?</quote
> you ask: That's the point of the game.</para>
<para
>For each square (excluding edge and corner squares), there are 8 neighboring squares.</para>
<para
>If none of the neighboring squares has a bomb, then a blank will be shown under the square, and all neighboring squares will be automatically uncovered.</para>
<note
><para
><mousebutton
>Left</mousebutton
> clicking a flagged square is safe and does nothing.</para
></note
></listitem>
<listitem
><para
>The <mousebutton
>right</mousebutton
> button will mark a square as containing a mine (by drawing a red flag on it) or, if the option is set, as being uncertain (by drawing a question mark on it). The uncertain tag can be useful when you are puzzled about the positions of mines.</para
></listitem>
<listitem
><para
>The <mousebutton
>middle</mousebutton
> button will clear the surrounding squares if the right number of squares is already flagged. It is very useful since it is much quicker than uncovering all individual squares.</para>
<warning
><para
>If your flags are not properly positioned, you will explode a bomb.</para
></warning
></listitem>
<listitem
><para
>Se carregar no <guiicon
>boneco amarelo</guiicon
> irá começar um novo jogo.</para
></listitem>
</itemizedlist>

<note
><para
>Estas são as configurações por omissão. Os botões do rato poderão ser reprogramado. Para mais informações, veja a secção chamada <link linkend="prefs"
>Opções do Jogo</link
>.</para
></note>

<sect1 id="screen"
><title
>O Ecrã do  &kmines;</title>

<screenshot>
<screeninfo
>O Ecrã do &kmines;</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="kmines1.png"
	     format="PNG"/></imageobject>
<textobject
><phrase
>O Ecrã do &kmines;</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>O ecrã do &kmines; consiste em:</para>

<itemizedlist>
<listitem
><para
>Uma zona que lhe mostra o número de minas ainda por marcar. De cada vez que você marca o local de uma bomba, este número irá diminuir uma unidade.</para>
<note
><para
>Este indicador não determina se você está certo ou errado, mas apenas quantas minas você tem ainda de marcar em teoria antes de terminar este jogo.</para
></note>
<para
>Neste exemplo, faltam marcar 10 minas.</para
></listitem>
<listitem
><para
>Um boneco com um Sorriso Amarelo ('Smiley'). Se carregar neste boneco irá começar um novo jogo. Se você perder a cara ficará triste.</para
></listitem>
<listitem
><para
>The box on the right shows how much time this round has taken. The shortest time for each level is listed as the high score.</para
></listitem>
<listitem
><para
>The playing area. This will vary in size depending on the difficulty level of the game. In this example, it consists of 64 squares. This is where you play the game.</para
></listitem>
<!-- This doesn't seem to be there any more.
<listitem
><para
>A status line at the bottom of the window.  In this example, it
simply says <guilabel
>Game stopped</guilabel
>.</para
></listitem>
-->
</itemizedlist>
</sect1>
</chapter>

<chapter id="prefs"
><title
>Opções do jogo</title>
<para
>As opções do &kmines; são configuradas ao seleccionar a opção <menuchoice
> <guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o &kmines;</guimenuitem
> </menuchoice
> no menu. Isto fará aparecer uma janela.</para>

<screenshot>
<screeninfo
>Preferências do &kmines;</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="kmines2.png" format="PNG"/></imageobject>
<textobject
><phrase
>Preferências do &kmines;</phrase
></textobject>
</mediaobject>
</screenshot>

<para
>Esta janela é dividida em três secções.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Jogo</guilabel
></term>
<listitem>
<para
>The first option, labeled <guilabel
>Enable ? Mark</guilabel
>, determines whether you can mark squares as <quote
>questionable</quote
>. If this option is checked, then right clicking the mouse will first cause a square to be flagged. If you right click again on the same square, the flag will change to a <guiicon
>?</guiicon
>, to indicate you don't know if there is a bomb there or not. If you click again, the square will change back to blank.</para>

<para
>If there is not a mark in front of this option, the first <mousebutton
>right</mousebutton
> mouse click will change the square to a red flag. The second will make it blank again, thus skipping the <guiicon
>?</guiicon
> symbol.</para>

<para
>The next option down, labeled <guilabel
>Enable keyboard</guilabel
>, determines if the keyboard shortcuts will work while playing the game. The default keyboard shortcuts are given in <xref linkend="keys"/>, and can be changed by selecting <menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Configure Shortcuts...</guimenuitem
></menuchoice
>.</para>

<note
><para
>The only keyboard shortcuts affected are those responsible for playing the game. Keyboard commands such as <guimenuitem
>New Game</guimenuitem
> and <guimenuitem
>Quit</guimenuitem
>, still work, regardless of this option.</para
></note>

<para
>The <guilabel
>Pause if windows lose focus</guilabel
> option will automatically pause the game if the &kmines; window loses focus. When the game is paused, the gameboard disappears, so you can't use pausing the game as a way to cheat!</para>

<para
>The <guilabel
>"Magic" reveal</guilabel
> option switches on <quote
>Magic reveal</quote
> mode. In this mode, &kmines; does most of the gameplay for you: If you have uncovered enough squares to be able to tell with certainty that a square contains a mine, &kmines; will automatically mark it as a mine, and perform an autoreveal on squares for which it has marked the correct number of mines. Note that when you have this mode switched on, your scores do not count as highscores.</para>


<para
>The last section of this tab allows you to change the action of each of the three mouse buttons. Your options are:</para>

<variablelist>
<varlistentry>
<term
>Mostrar</term>
<listitem
><para
>This will reveal the contents of the square. If there is no bomb, then a number will appear. If there is a bomb under that square, then the bomb will explode, and the game will be over.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Comutar a Marca</term>
<listitem
><para
>Clicking with this button on a square will mark/unmark with a red flag.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Auto-Mostrar</term>
<listitem
><para
>Clicking on a square with this button will automatically reveal all neighboring squares that are not marked with red flags. If one of those neighboring squares has a bomb under it, the bomb will explode, and the game will be over.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Alternar a bandeira</term>
<listitem
><para
>Clicking with this button on a square will cycle through blank, red flag, and question mark.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Alternar a bandeira ?</term>
<listitem
><para
>Clicking with this button on a square will mark/unmark with a question mark.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Aparência</guilabel
></term>
<listitem>
<para
>The top option, entitled <guilabel
>case size</guilabel
>, determines the size of each of the squares in the playing area. By default, they are set small. You may want to increase the size if you are working on a very high resolution monitor.</para>

<para
>O resto desta página diz respeito a cores. Para as ajustar, basta carregar no botão colorido ao lado de cada descrição e seleccionar a nova cor.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Jogo Personalizado</guilabel
></term>
<listitem>
<para
>Finalmente, se você não estiver a achar as configurações existentes suficientemente desafiantes, você poderá configurar um jogo personalizado aqui. Use as barras para alterar a <guilabel
>Largura</guilabel
>, a <guilabel
>Altura</guilabel
> e a percentagem do tabuleiro coberta com <guilabel
>Minas</guilabel
>. O jogo por omissão tem 20 por cento do tabuleiro coberto, por isso há muito espaço para tornar o jogo mais difícil.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Gravar as alterações</term>
<listitem
><para
>Once your changes are complete, click <guibutton
>OK</guibutton
> to make them permanent.</para>

<para
>Se quiser abandonar as suas alterações carregue em <guibutton
>Cancelar</guibutton
>.</para>

<para
>If you click on <guilabel
>Default</guilabel
>, the default settings will be restored. Click <guilabel
>OK</guilabel
> to make these default changes permanent, or edit the settings some more.</para>
</listitem>
</varlistentry>
</variablelist>

</chapter>

<chapter id="command">
<title
>Comandos/Atalhos do Teclado</title>

<para
>As seguintes secções descrevem brevemente cada uma das opções do menu.</para>

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

<para
>O menu <guimenu
>Jogo</guimenu
> consiste em 5 opções.</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
>Inicia um novo jogo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycap
>P</keycap
> </shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Pausa</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Põe o jogo em pausa. Isto irá esconder o tabuleiro (sem batota), e dar-lhe-á um botão para carregar logo que deseje continuar este jogo.</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
>Isto mostra-lhe o recorde (o tempo mais curto) para cada nível de dificuldade.</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 &kmines;</para
></listitem>
</varlistentry>
</variablelist>
</sect1>

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

<varlistentry>
<term
><menuchoice
><shortcut
> <keycap
>H</keycap
> </shortcut
> <guimenu
>Mover</guimenu
> <guimenuitem
>Dica</guimenuitem
> </menuchoice
></term>
<listitem
><para
>If you use this item, you will get a hint about where you should click next. If you do that your score will not be added to the high-scores.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Mover</guimenu
> <guimenuitem
>Resolver</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Este item tenta resolver o jogo actual.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Mover</guimenu
> <guimenuitem
>Rácio de Resolução...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Este item mostra uma janela que calcula a taxa de resolução do tipo de jogo actual.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Mover</guimenu
> <guimenuitem
>Ver Registo</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Este item mostra uma janela com o registo do último jogo.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Mover</guimenu
> <guimenuitem
>Reproduzir Registo</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Este item repete o registo actual.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Mover</guimenu
> <guimenuitem
>Gravar Registo...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Este item mostra uma janela onde gravar o registo actual.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Mover</guimenu
> <guimenuitem
>Carregar Registo...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Este item mostra uma janela para que possa carregar um registo.</para>
</listitem>
</varlistentry>

</variablelist>
</sect1>

<sect1 id="settings-menu"
><title
>O Menu <guimenu
>Configuração</guimenu
></title>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Mostrar o Menu</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Se esta opção estiver assinalada, então o menu estará visível. Se a seleccionar para desligar, o menu ficará escondido.</para>
<note
><para
>Para repor um menu escondido, carregue fora da área de jogo com o botão direito do rato. Isto fará aparecer um pequeno sub-menu. Basta seleccionar a opção <guimenuitem
>Mostrar o Menu</guimenuitem
> neste sub-menu para que o menu da aplicação volte a ficar visível.</para
></note
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guisubmenu
>Escolher o Tipo de Jogo</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Permite-lhe definir o nível de dificuldade a partir de um sub-menu.</para>
<para
>There are three default levels of difficulty: <guimenuitem
>Easy</guimenuitem
> (64 squares, 10 mines), <guimenuitem
>Normal</guimenuitem
> (256 squares, 40 mines), and <guimenuitem
>Expert</guimenuitem
> (480 squares, 99 mines). There is also a <guimenuitem
>Custom...</guimenuitem
> level settings.</para>
<para
>Se você seleccionar o <guimenuitem
>Personalizado...</guimenuitem
>, então a configuração feita por si na janela de <guimenuitem
>Configurar o &kmines;</guimenuitem
> será usada.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar os Atalhos...</guimenuitem
></menuchoice
></term>
<listitem
><para
>This item lets you change the keyboard shortcuts used by &kmines;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar as Notificações...</guimenuitem
></menuchoice
></term>
<listitem
><para
>This item displays a standard &kde; notifications configuration dialog, where you can change the notifications (sounds, visible messages, &etc;) used by &kmines;.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar as Melhores Pontuações...</guimenuitem
></menuchoice
></term>
<listitem
><para
>Aqui você poderá alterar a sua <guilabel
>Alcunha</guilabel
> e adicionar um <guilabel
>Comentário</guilabel
> giro acerca de si, para mostrar na tabela dos recordes. Você também poderá activar a opção dos <guilabel
>Recordes mundiais activos</guilabel
> para que possa partilhar a sua perícia no &kmines; com um servidor de recordes 'online'.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o &kmines;</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Permite-lhe ajustar as opções do jogo. Para mais informações detalhadas, veja a secção chamada <link linkend="prefs"
>Opções do Jogo</link
>.</para
></listitem>
</varlistentry>

</variablelist>
</sect1>

<sect1 id="help-menu">
<title
>O Menu <guimenu
>Ajuda</guimenu
></title>
&help.menu.documentation; </sect1>

<sect1 id="keys"
><title
>Default Keyboard Shortcuts</title>
<para
>The following table shows you the default keyboard shortcuts.</para>


<table>
<title
>Keyboard Shortcuts</title>
<tgroup cols="2">
<thead
><row
><entry
>Combinação de Teclas</entry
><entry
>Acção</entry
></row
></thead>
<tbody>
<row
><entry
><keycap
>Setas</keycap
></entry
><entry
>Move o cursor na área de jogo.</entry
></row>
<row
><entry
><keycap
>PageDown</keycap
></entry
><entry
>Move to bottom edge</entry
></row>
<row
><entry
><keycap
>PageUp</keycap
></entry
><entry
>Move to top edge</entry
></row>
<row
><entry
><keycap
>Home</keycap
></entry
><entry
>Move to left edge</entry
></row>
<row
><entry
><keycap
>End</keycap
></entry
><entry
>Move to right edge</entry
></row>
<row
><entry
><keycap
>Espaço</keycap
></entry
><entry
>Reveal square.</entry
></row>
<row
><entry
><keycap
>W</keycap
></entry
><entry
>Mark square as mine</entry
></row>
<row
><entry
><keycap
>Return</keycap
></entry
><entry
>Automatically reveal all surrounding squares not marked by a flag.</entry
></row>
<row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
></entry
><entry
>Novo Jogo</entry
></row>
<row
><entry
><keycap
>P</keycap
></entry
><entry
>Jogo Personalizado</entry
></row>
<row
><entry
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></entry
><entry
>Sai do &kmines;</entry
></row>
<row
><entry
><keycombo action="simul"
>&Shift;<keycap
>F1</keycap
></keycombo
></entry
><entry
>What's This Help</entry
></row>

</tbody>
</tgroup>
</table>

<para
>Estas configurações de teclas podem ser alteradas se seleccionar a opção <menuchoice
> <guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar os Atalhos de Teclado</guimenuitem
> </menuchoice
> no menu.</para>

</sect1>

</chapter>

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

<para
>&kmines; </para>
<para
>Program copyright 1996-2000 &Nicolas.Hadacek; &Nicolas.Hadacek.mail;</para>
<para
>Documentation copyright 2000 &Nicolas.Hadacek; &Nicolas.Hadacek.mail;</para>
<para
>Documentation updated for &kde; 2.0 by &Mike.McBride; &Mike.McBride.mail;</para>
<para
>Some changes for &kde; 3.2 by &Philip.Rodrigues; &Philip.Rodrigues.mail;</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-kmines">
<title
>Como obter o &kmines;</title>
&install.intro.documentation; </sect1>

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


</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->


