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

<book lang="&language;">
	<bookinfo>
		<title
>O Manual do &palapeli;</title>
		<authorgroup>
			<author
><firstname
>Stefan</firstname
> <surname
>Majewsky</surname
> <affiliation
><address
><email
>majewsky@gmx.net</email
></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
>Stefan Majewsky</holder>
		</copyright>
		<legalnotice
>&FDLNotice;</legalnotice>
		<date
>2010-05-24</date>
		<releaseinfo
>1.1</releaseinfo>

		<abstract>
			<para
>Este é o manual do &palapeli;, um jogo de 'puzzles' baseado na tecnologia do &kde;.</para>
		</abstract>
		<keywordset>
			<keyword
>KDE</keyword>
			<keyword
>kdegames</keyword>
			<keyword
>jogo</keyword>
			<keyword
>jogo de 'puzzle'</keyword>
			<keyword
>'puzzle'</keyword>
			<keyword
>palapeli</keyword>
		</keywordset>
	</bookinfo>

	<chapter id="introduction">
		<title
>Introdução</title>
		<para
>O &palapeli; é um jogo de 'puzzles' para um único jogador.</para>
		<para
>A janela do &palapeli; está dividida em duas áreas, a colecção e a mesa. Este manual irá prosseguir com a descrição destas duas áreas.</para>
	</chapter>

	<chapter id="collection">
		<title
>Navegar pela colecção de 'puzzles'</title>
		<para
>Quando lançar o &palapeli; pela primeira vez, a sua colecção de 'puzzles' é previamente carregada com alguns 'puzzles' que vêm com o &palapeli;. Carregue num dos 'puzzles' para começar a jogar imediatamente. O jogo toma lugar na mesa do 'puzzle'; veja a <link linkend="puzzletable"
>secção seguinte</link
> para saber como usar a mesa do 'puzzle'.</para>
		<para
>Para além de seleccionar um 'puzzle', a colecção de 'puzzles' poderá ser usada para as seguintes acções:</para>
		<itemizedlist>
			<listitem
><para
><emphasis
>criar</emphasis
> 'puzzles' novos, a partir de imagens no seu disco</para
></listitem>
			<listitem
><para
><emphasis
>importar</emphasis
> os 'puzzles' feitos por outros</para
></listitem>
			<listitem
><para
><emphasis
>exportar</emphasis
> os 'puzzles', de modo a partilhá-los com os seus amigos e com todo o mundo</para
></listitem>
			<listitem
><para
><emphasis
>apagar</emphasis
> os 'puzzles' que não necessita mais</para
></listitem>
		</itemizedlist>
		<para
>A secção seguinte mostra como efectuar estas tarefas com os botões da barra de ferramentas.</para>
		<sect1 id="toolbars-collection">
			<title
>Introdução à barra de ferramentas</title>
			<note
><para
>Poderá seleccionar os 'puzzles' na lista, carregando para tal no &Ctrl; e no &LMB; em conjunto. Se carregar no &LMB; ou no &RMB; sem o &Ctrl;, irá abrir o 'puzzle' em questão na mesa do 'puzzle'.</para
></note>
			<variablelist>
				<varlistentry>
					<term
><guiicon
>Criar um novo 'puzzle'</guiicon
></term>
					<listitem>
						<para
><action
>Abre uma janela que lhe permite criar um 'puzzle' a partir de uma imagem no seu disco.</action
> Certifique-se que introduz os meta-dados correctos para a imagem: Deverá atribuir o autor da imagem (&eg; o fotógrafo ou o pintor); respeite por favor os direitos de cópia do autor da imagem.</para>
						<para
>Do mesmo modo, terá de seleccionar o tipo de 'puzzle'. O &palapeli; não o restringe às peças clássicas dos 'puzzles', sendo que poderão ser adicionados outros tipos de 'puzzles' por terceiros. Cada tipo de 'puzzle' poderá oferecer um conjunto adicional de propriedades, como o número de peças.</para>
					</listitem>
				</varlistentry>
				<varlistentry>
					<term
><guiicon
>Apagar</guiicon
></term>
					<listitem
><para
><action
>Todos os 'puzzles' que tiver seleccionado na lista de 'puzzles' serão removidos permanentemente da sua biblioteca. </action
></para
><warning
><para
>Esta acção não poderá ser anulada.</para
></warning
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><guiicon
>Importar de ficheiro</guiicon
></term>
					<listitem
><para
><action
>Quando tiver recebido um ficheiro de 'puzzle' do &palapeli; (que poderá ser normalmente reconhecido pela extensão <literal role="extension"
>*.puzzle</literal
>), poderá usar esta acção para o importar para a sua colecção local.</action
> Também poderá montar um 'puzzle', carregando simplesmente num ficheiro de 'puzzle' a partir do seu gestor de ficheiros preferido só que, após a importação, o 'puzzle' irá aparecer na sua colecção local, pelo que poderá apagar em segurança o ficheiro do 'puzzle' obtido.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><guiicon
>Exportar para ficheiro</guiicon
></term>
					<listitem
><para
><action
>Isto irá exportar os 'puzzles' seleccionados de momento para ficheiros, de modo a poder dá-los aos seus amigos, publicá-los na Web ou criar cópias de segurança da sua colecção.</action
></para
></listitem>
				</varlistentry>
			</variablelist>
		</sect1>
	</chapter>

	<chapter id="puzzletable">
		<title
>Jogar na mesa do 'puzzles'</title>
		<screenshot
><mediaobject>
			<imageobject
><imagedata fileref="puzzletable1.png" format="PNG"/></imageobject>
			<textobject
><phrase
>A mesa do 'puzzle' (detalhe)</phrase
></textobject>
		</mediaobject
></screenshot>
		<para
>O objectivo do jogo é juntar as peças indicadas numa imagem.</para>
		<para
>As peças podem ser movidas à vontade, carregando e arrastando as mesmas com o &LMB;. Poderá seleccionar várias peças de uma vez, mantendo pressionada a tecla &Ctrl; e carregando nelas, ou arrastando uma área em torno delas com o &LMB;.</para>
		<para
>Poderá mover as peças à vontade, bastando carregar nelas e arrastá-las. Quando colocar uma peça próxima de outra peça vizinha, ambas ficarão coladas automaticamente (1). Depois de se terem encaixado, já não podem ser mais separadas. Ao contrário da realidade, não poderá combinar duas peças que não sejam verdadeiramente vizinhas.</para>
		<para
>A barra de progresso, por baixo da mesa do 'puzzle', indica a sua evolução (2). O &palapeli; irá gravar automaticamente o seu progresso após cada jogada, pelo que não terá de se preocupar em gravar explicitamente.</para>
		<para
>Com a roda do rato, ou com a barra no canto inferior direito (3), poderá alterar o nível de ampliação da mesa do 'puzzle'. Se carregar com o &RMB;, poderá mover a área de visualização da mesma.</para>
		<para
>O movimento das peças é limitado pela <emphasis
>área da mesa do 'puzzle'</emphasis
>. Esta área está representada no fundo da mesa do 'puzzle' por uma sombra rectangular clara. Quando mover as peças para o extremo da área da mesa do 'puzzle' (4), a área irá expandir automaticamente, de modo a ter mais espaço para movimentar as suas peças. Perto dos contornos sombreados, o cursor do rato muda para uma seta de duas pontas, a qual indica que poderá ajustar a área da mesa do 'puzzle' se carregar e arrastar a mesma com o &LMB;.</para>
		<para
>Poderá bloquear a área da mesa do 'puzzle' com o pequeno botão (5), logo a seguir à barra de progresso. A área em torno da mesa do 'puzzle' (4) irá escurecer e as peças irão parar e mover-se-ão para os extremos da área da mesa. Continua a ser possível ajustar manualmente a área da mesa do 'puzzle'.</para>
		<sect1 id="puzzletable-mouseactions">
			<title
>Interacções com o rato</title>
			<para
>Como foi descrito na secção anterior, existem diversas formas de interagir com a mesa do 'puzzle' do &palapeli;, usando para tal o rato. Poderá configurar à vontade as acções que são despoletadas por determinados botões do rato. (Veja a secção de <link linkend="configuration-mouseactions"
>Configuração do Jogo</link
> para obter mais informações sobre a configuração). A seguinte lista resume todas as acções do rato possíveis:</para>
			<variablelist>
				<varlistentry>
					<term
><action
>Mudar o tamanho da mesa do puzzle ao arrastar os seus extremos</action
></term>
					<listitem
><para
>Por omissão, esta acção está associada ao &LMB;.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Mover as peças por arrastamento</action
></term>
					<listitem
><para
>Quando carregar e arrastar uma peça do 'puzzle', esta peça será movida. Se estiverem várias peças seleccionadas e depois carregar e arrastar uma delas, então todas as peças mover-se-ão. Por omissão, esta acção está associada ao &LMB;.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Mover a área de visualização por arrastamento</action
></term>
					<listitem
><para
>Por omissão, esta acção está associada ao &RMB;.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Seleccionar várias peças de uma vez</action
></term>
					<listitem
><para
>Quando carregar numa área vazia da mesa do 'puzzle', em vez de carregar numa peça, poderá arrastar uma área inteira. Quando largar o botão do rato, todas as peças dentro dessa área ficarão seleccionadas. Todas as outras peças ficarão desmarcadas. Por omissão, esta acção está associada ao &LMB;.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Seleccionar as peças ao carregar</action
></term>
					<listitem
><para
>Quando carregar numa única peça do 'puzzle', esta ficará seleccionada. Se já estava seleccionada, deixará de o estar. Por omissão, esta acção é atribuída ao &LMB; e só fica disponível quando tiver o &Ctrl; carregado.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Comutar o estado de bloqueio da área da mesa do 'puzzle'</action
></term>
					<listitem
><para
>Esta acção é idêntica a carregar no botão (5) da barra de estado. Por omissão, esta acção não está associada a nenhum botão do rato, mas você podê-la-á activar com a <link linkend="configuration-mouseactions"
>janela de configuração</link
>.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Deslocar a área de visualização na horizontal</action
> e <action
>Deslocar a área de visualização na vertical</action
></term>
					<listitem
><para
>Por omissão, esta acção está associada à roda do rato, mas podê-la-á activar com a <link linkend="configuration-mouseactions"
>janela de configuração</link
>.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><action
>Ampliar a área de visualização</action
></term>
					<listitem
><para
>Esta acção é idêntica a mover a barra deslizante (3) na barra de estado. Esta acção está atribuída à roda do rato, por omissão.</para
></listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="toolbars-puzzletable">
			<title
>Introdução à barra de ferramentas</title>
			<variablelist>
				<varlistentry>
					<term
><guiicon
>Reiniciar o 'puzzle'</guiicon
></term>
					<listitem
><para
><action
>Elimina o progresso gravado para este 'puzzle'.</action
></para
></listitem>
				</varlistentry>
			</variablelist>
		</sect1>
	</chapter>

	<chapter id="interface">
		<title
>Apresentação à Interface</title>
		<para
>A duas áreas do &palapeli;, a colecção e a mesa, estão incorporadas no menu como páginas. Existem também dois menus com acções-padrão, os quais estão descritos em baixo.</para>
		<sect1 id="settings-menu">
			<title
>O Menu <guimenu
>Configuração</guimenu
></title>
			<variablelist>
				<varlistentry>
					<term
><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Mostrar a barra de estado da mesa</guimenuitem
></menuchoice
></term>
					<listitem
><para
><action
>Activar ou desactiva a visualização da barra de progresso e os botões respectivos, por baixo da mesa do 'puzzle'.</action
> Esta acção não irá mudar nada na colecção de 'puzzles'.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar os Atalhos...</guimenuitem
></menuchoice
></term>
					<listitem
><para
><action
>Abre uma janela onde poderá configurar as teclas de atalho</action
> do &palapeli;</para
></listitem>
				</varlistentry>
				<varlistentry id="settings-menu-configure">
					<term
><menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o &palapeli;...</guimenuitem
></menuchoice
></term>
					<listitem
><para
>Abre uma janela de configuração do jogo. Veja a secção da <link linkend="configuration"
>Configuração do Jogo</link
> para mais detalhes.</para>
					</listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="help">
			<title
>O Menu <guimenu
>Ajuda</guimenu
></title>
&help.menu.documentation; </sect1>
	</chapter>

	<chapter id="configuration">
		<title
>Configuração do Jogo</title>
		<para
>Para abrir a janela de configuração, use a opção do menu: <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o &palapeli;...</guimenuitem
></menuchoice
></para>
		<sect1 id="configuration-general">
			<title
><guilabel
>Configuração geral</guilabel
></title>
			<variablelist>
				<varlistentry>
					<term
><guilabel
>Fundo</guilabel
></term>
					<listitem
><para
><action
>Permite-lhe escolher outra textura de fundo para a mesa do 'puzzle'.</action
> Se escolher uma única cor, em vez de uma textura, o botão por baixo da área de selecção poderá ser usado para definir essa tal cor única.</para
></listitem>
				</varlistentry>
				<varlistentry>
					<term
><guilabel
>Precisão do ajuste</guilabel
></term>
					<listitem
><para
><action
>Permite-lhe seleccionar quão próximas as peças vizinhas deverão estar para se encaixarem em conjunto.</action
> Se mover a barra mais para a direita, as peças encaixar-se-ão mesmo que não estejam muito próximas. Isto torna o jogo um pouco mais simples de jogar.</para
></listitem>
				</varlistentry>
			</variablelist>
		</sect1>
		<sect1 id="configuration-mouseactions">
			<title
><guilabel
>Interacção do rato</guilabel
></title>
			<para
>Esta página da janela de configuração permite-lhe atribuir as interacções do rato descritas na secção <link linkend="puzzletable-mouseactions"
>Jogar na mesa do 'puzzle'</link
> aos diferentes botões do rato. As interacções são divididas entre as que podem ser atribuídas aos botões do rato (&eg; <action
>Mover a área de visualização por arrastamento</action
>) e as que podem ser atribuídas à roda do rato (&eg; <action
>Deslocar a área de visualização na horizontal</action
>).</para>
			<sect2>
				<title
>Página de <guilabel
>Botões do rato</guilabel
></title>
				<para
>A seguir ao nome de cada interacção, existe um botão com uma imagem de um rato de computador que mostra a acção atribuída de momento. Poderá configurar a interacção, carregando para tal nesse botão com o &LMB; e depois com o botão do rato que deseja atribuir a essa interacção. Se carregar em teclas modificadoras, quando carregar pela segunda vez, a mesa do 'puzzle' irá permitir essa interacção apenas quando estiver a pressionar essas teclas.</para>
				<tip
><para
>Em vez de carregar, poderá também pressionar a tecla <keycap
>Espaço</keycap
>, de modo a atribuir o <guilabel
>Sem-Botão</guilabel
> especial a esta interacção. Isto só é permitido caso as teclas modificadoras estejam a ser pressionadas. O <guilabel
>Sem-Botão</guilabel
> significa que as teclas modificadoras irão ocupar o papel do botão do rato. A interacção começa quando carregar nas teclas modificadoras, terminando quando uma delas for libertada.</para
></tip>
			</sect2>
			<sect2>
				<title
>Página da <guilabel
>Roda do rato</guilabel
></title>
				<para
>Esta página funciona de forma semelhante à anterior. Quando o botão à direita pedir a introdução de dados, terá de movimentar a roda do rato em vez de carregar num botão do mesmo. Também é permitido manter pressionadas as teclas modificadoras, tendo a mesma consequência que o caso anterior.</para>
				<tip
><para
>Se o seu rato tiver uma roda bidireccional (como acontece normalmente nos ratos por toque dos portáteis), poderá tirar partido desta: O botão irá reconhecer se  o utilizador moveu a roda na horizontal ou na vertical.</para
></tip>
			</sect2>
		</sect1>
	</chapter>

	<chapter id="credits">
		<title
>Créditos e Licença</title>
		<para
>O &palapeli; permite trazer a diversão e o desafio dos 'puzzles' para o seu ambiente de trabalho.</para>
		<para
>A ideia foi desenvolvida em primeiro lugar por Bernhard Schiffner, em conjunto com o Stefan Majewsky, que é o actual programador-chefe do &palapeli;.</para>
		<para
>Documentação com 'copyright' 2009, 2010 de Stefan Majewsky.</para>
		<para
>Tradução de José Nuno Pires <email
>zepires@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>

	<appendix id="installation">
		<title
>Instalação</title>
		&install.intro.documentation;
		<sect1 id="Compilation">
			<title
>Compilação e Instalação</title>
&install.compile.documentation; </sect1>
	</appendix>
	&documentation.index;
</book>
