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

<book lang="&language;">

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

<authorgroup>
<author
><firstname
>Anne-Marie</firstname
> <surname
>Mahfouf</surname
> <affiliation
> <address
>&Anne-Marie.Mahfouf.mail;</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
>2001</year
><year
>2007</year>
<holder
>&Anne-Marie.Mahfouf;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>


<date
>2007-09-26</date>
<releaseinfo
>1.7</releaseinfo>

<abstract>
<para
>O &khangman; é o jogo clássico da forca para as crianças, adaptado para o &kde;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>KHangMan</keyword>
<keyword
>enforcado</keyword>
<keyword
>jogo</keyword>
<keyword
>crianças</keyword>
<keyword
>palavras</keyword>
</keywordset>

</bookinfo>

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

<para
>O &khangman; é um jogo baseado no conhecido jogo da forca. É destinado às crianças com 6 e mais anos .O jogo tem quatro níveis de dificuldade: <guimenuitem
>Animais</guimenuitem
> (palavras de animais), <guimenuitem
>Fácil</guimenuitem
>, <guimenuitem
>Médio</guimenuitem
> e <guimenuitem
>Difícil</guimenuitem
>. É escolhida uma palavra ao acaso, as palavras são escondidas e você precisa de adivinhar a palavra, tentando uma letra a seguir a outra. De cada vez que erra uma letra, parte da imagem de um enforcado é desenhada. Você precisa de adivinhar a palavra antes de ele ficar enforcado! Você tem 10 tentativas. </para>

</chapter>

<chapter id="using-khangman">
<title
>Usar o &khangman;</title>

<screenshot>
<screeninfo
>Aqui está uma imagem no &khangman; quando você o inicia pela primeira vez</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman-main.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Imagem do &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Aqui você poderá ver o &khangman; tal como aparece da primeira vez que o executa. A Categoria são os Animais e a língua é a predefinida (neste caso o Inglês, mas será a sua língua actual no &kde;, se existirem dados para tal), o tema é o "Mar". Todas as alterações no nível, língua ou modo do fundo são registadas no ficheiro de configuração e repostas no seu próximo jogo. </para>

<para
>Repare quão fácil é alterar o tema; basta carregar nas listas da barra de ferramentas. Para obter uma palavra nova e para sair do jogo também é fácil de conseguir, recorrendo aos botões correspondentes na barra de ferramentas. </para>

<sect1 id="general-usage">
<title
>Uso geral</title>

<para
>É mostrada uma palavra, cujas letras são mostradas como sublinhados (_). Você sabe quantas letras existem na palavra. Terá então de adivinhar a palavra, escrevendo uma letra atrás de outra. Pode indicar a letra no campo de texto e carregar de seguida na tecla &Enter; ou carregar no botão <guibutton
>Adivinhar</guibutton
> para saber se a letra pertence ou não à palavra. </para>

<para
>A palavra é escolhida aleatoriamente e não é a mesma que a anterior. </para>

<important
><para
>Todas as palavras são substantivos (não existem verbos, adjectivos, &etc;).</para
></important>

<para
>Se precisar de ajuda a adivinhar a palavra, poderá carregar no ícone <guiicon
>Mostrar uma Dica</guiicon
> <inlinemediaobject
><imageobject
> <imagedata fileref="games-hint.png" format="PNG"/></imageobject
></inlinemediaobject
> da barra de ferramentas, para que possa ser apresentada uma dica que lhe dê alguma pista sobre a palavra. Se carregar no ícone <guiicon
>Mostrar a Dica</guiicon
> de novo, irá esconder a mesma dica ou sugestão. </para>

<para
>Normalmente, não é importante se você escreve letras maiúsculas ou minúsculas. O programa converte tudo para minúsculas (excepto as palavras alemãs que comecem por uma letra maiúscula). O programa faz isso automaticamente. </para>

<para
>A categoria e a língua actuais são mostradas na barra de estado. </para>

<para
>De cada vez que indica uma letra que não está na palavra, é desenhada outra parte do enforcado. Você tem 10 tentativas para adivinhar a palavra. Depois disso, a resposta correcta é mostrada. </para>

<para
>Existem 4 categorias: fácil, médio, difícil e animais, mais alguns níveis sobre outros tópicos para algumas línguas. O programa pesquisa todos os ficheiros de dados em todas as línguas, e usa também os ficheiros de palavras do &kanagram;. </para>
 
<para
>No categoria simples, as palavras são bastante simples e relacionam-se com o dia-a-dia. Este é adequado para as crianças dos 6 aos 9 anos. O nível dos animais contém apenas nomes de animais, por isso são mais fáceis de adivinhar. Alguns deles são fáceis, mas há outros mais difíceis de adivinhar. No nível médio, as palavras são maiores e mais difíceis. É adequado para as idades superiores aos 9 anos. O nível difícil é mesmo isso - difícil -, &ie;, as palavras são difíceis de soletrar e não são muito conhecidas. Este nível é um desafio, mesmo para os adultos. </para>

<para
>Depois de adivinhar uma palavra (ou o enforcado ficar completo), são-lhe dados os parabéns e é-lhe apresentada outra palavra. Poderá então carregar em <guilabel
>Jogar de novo</guilabel
> para que fique outra palavra pronta para adivinhar ou seleccionar então outra <guimenu
>Categoria</guimenu
> para jogar. Para sair do jogo agora, seleccione a opção <menuchoice
><guimenu
>Jogo</guimenu
><guimenuitem
>Sair</guimenuitem
> </menuchoice
> ou carregue no botão <guiicon
>Sair</guiicon
> da barra de ferramentas. </para>

<para
>Você escreve a letra que deseja tentar no campo de texto (o cursor do rato está preparado no campo) e carrega na tecla &Enter; ou no botão <guibutton
>Adivinhar</guibutton
>. Se a letra pertencer à palavra, irá ocupar o seu lugar, tantas vezes quantas as que aparece na palavra. Se a letra não pertencer à palavra, vai para o campo de <guilabel
>Falhas</guilabel
> e é desenhada mais uma parte do enforcado à direita. Você tem 10 tentativas e, depois destas, você perderá e a palavra correcta é então apresentada. </para>

<para
>Durante o jogo, você poderá optar por iniciar um jogo, escolhendo a opção do menu <guimenu
>Jogo</guimenu
> que é a <guimenuitem
>Novo</guimenuitem
> ou carregando no ícone <guiicon
>Novo</guiicon
> <inlinemediaobject
><imageobject
> <imagedata fileref="document-new.png" format="PNG"/></imageobject
></inlinemediaobject
> da barra de ferramentas. Você poderá também alterar a categoria de palavras com o menu <guimenu
>Categoria</guimenu
> (isto mostrar-lhe-á uma palavra nova para o nível novo).</para>

<para
>A aparência poderá ser alterada facilmente com a barra <guimenuitem
>Aparência</guimenuitem
> que contém a opção da aparência.</para>

<para
>O botão <guiicon
>Sair</guiicon
> na barra de ferramentas <inlinemediaobject
><imageobject
> <imagedata fileref="application-exit.png" format="PNG"/></imageobject
></inlinemediaobject
> permite-lhe sair facilmente do jogo.</para>

<para
>Poderá também jogar com um ficheiro local instalado na sua máquina, o qual poderá abrir com o menu <guimenu
>Jogo</guimenu
> e a sua opção <guimenuitem
>Abrir</guimenuitem
>.</para>

</sect1>

<sect1 id="languages">
<title
>Jogar em línguas diferentes</title>
<para
>Você poderá jogar o &khangman; em diversas línguas, incluindo: Português do Brasil, Búlgaro, Catalão, Checo, Dinamarquês, Holandês, Inglês (EUA e GB), Finlandês, Francês, Alemão, Húngaro, Irlandês (Gaélico), Italiano, Norueguês(Bokm&#229;l), Norueguês (Nynorsk), Polaco, Português, Espanhol, Sérvio (Latim e Cirílico), Esloveno, Tajique, Sueco, Russo e Turco. Poderá até tentar o Chinês, se instalar os ficheiros do &kanagram;!! </para>

<para
>Por omissão, depois da primeira instalação do &khangman;, só o Inglês e a sua língua do &kde;, se for uma das mencionadas acima e se você tiver o pacote kde-i18n correspondente, estarão instalados. Por exemplo, se você for um utilizador Português e se tiver o &kde; em Português, no menu <guimenu
>Língua</guimenu
> terá dois itens: Inglês e Português, sendo este último a opção por omissão. </para>

<para
>Poderá à mesma jogar o &khangman; noutras línguas. É muito fácil adicionar novos dados no &khangman;. Tudo o que precisa é de uma ligação à Internet a funcionar. Carregue no menu <guimenu
>Jogo</guimenu
> e depois em <guimenu
>Obter as Palavras numa Nova Língua...</guimenu
>. Irá aparecer uma janela semelhante à seguinte: </para>

<screenshot>
<screeninfo
>A janela para Obter Palavras Novas do &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="getnewstuff.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>A janela para Obter Palavras Novas do &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Carregue no nome da língua que deseja instalar e depois no botão <guibutton
>Instalar</guibutton
>. Se a língua for instalada com sucesso, irá aparecer uma marca verde à frente do nome da língua e o botão <guibutton
>Instalar</guibutton
> muda para <guibutton
>Desinstalar</guibutton
>. Os dados ficarão imediatamente instalados e disponíveis no &khangman;. Poderá carregar em <guibutton
>Fechar</guibutton
> para sair da janela Obter Palavras Novas (se quiser outra língua, poderá repetir estes passos). </para>

<para
>Poderá então alterar facilmente a língua se for à opção <guimenu
>Língua</guimenu
> e escolher outra língua. </para>

<para
>Repare que você pode agora escrever os caracteres especiais de uma língua, mostrando a barra de <interface
>Caracteres Especiais</interface
>. Esta barra de ferramentas mostra botões com um ícone correspondente a cada carácter especial de uma determinada língua, como o &eacute; no Francês, por exemplo. Se carregar num botão destes, irá escrever a letra correspondente no campo de texto e você poderá validar a sua escolha com o &Enter;. Você poderá obviamente usar a disposição de teclado correspondente à língua. Esta barra de ferramentas poderá ser escondida ou apresentada. A configuração é reposta da próxima vez que jogar o &khangman;. </para>

<important
><para
>Lembre-se por favor que você precisa de ter os tipos de letra Arial e URW Bookman instalados para mostrar correctamente os caracteres especiais em algumas línguas. Desde que tenha estes tipos de letra instalados, o &khangman; usá-los-á automaticamente. Se você ver pequenos rectângulos em vez de letras, então poderão estar a faltar estes tipos de letra. Escreva <command
>fonts:/</command
> na barra de endereços do &konqueror; para ver que tipos de letra tem instalados. </para
></important>

</sect1>
<sect1 id="few-tips">
<title
>Algumas sugestões</title>
<para
>Em Inglês, tente adivinhar primeiro as vogais. Depois, vá às consoantes mais comuns: 'l', 't', 'r', 'n' e 's' </para>
<para
>Quando ver <quote
>io</quote
>, tente o 'n' a seguir a isso em Francês e Inglês. </para>
<para
>No Português Europeu e do Brasil, no Catalão e no Espanhol, as vogais acentuadas poderão ficar a descoberto quando você escrever a vogal não acentuada correspondente. Por exemplo, todos os <quote
>a</quote
>'s acentuados são mostrados na palavra quando escrever <quote
>a</quote
>. Isto acontece quando a opção <guilabel
>Escrever letras acentuadas</guilabel
> não estiver assinalada. Se a opção estiver assinalada, então você terá de escrever você próprio as letras acentuadas. Quando você escrever <quote
>a</quote
>, só o <quote
>a</quote
> é que é apresentado e você terá de escrever, por exemplo, o &atilde; para esta letra aparecer. </para>
<para
>Sabia que, no Inglês, a letra mais comum é o 'e' (12,7%), seguida do 't' (9,1%), depois com o 'a' (8,2%), o 'i' (7,0%) e o 'n' (6,7%). </para>
</sect1>


</chapter>

<chapter id="menus">
<title
>Menu e Barras de Ferramentas</title>

<sect1 id="mainwindow">
<title
>A Janela Principal do &khangman;</title>

<para
>O menu <guimenu
>Jogo</guimenu
> tem 3 itens: o <guimenuitem
>Novo</guimenuitem
>, o <guimenuitem
>Obter Palavras numa nova língua</guimenuitem
> e o <guimenuitem
>Sair</guimenuitem
>.</para>

<para
>O <guimenuitem
>Novo</guimenuitem
> traz-lhe um novo jogo, &ie; uma nova palavra para adivinhar, no mesmo nível em que já se encontra. O <guimenuitem
>Obter Palavras numa Nova Língua...</guimenuitem
> irá mostrar a janela para Obter Coisas Novas que lhe permitirá obter os dados numa nova língua. O <guimenuitem
>Sair</guimenuitem
> abandona o jogo, fechando a janela principal e guardando a configuração actual no ficheiro de configuração respectivo.</para>

<para
>O menu <guimenu
>Categoria</guimenu
> permite-lhe escolher a categoria das palavras com que quer jogar, assim como três categorias de dificuldade. </para>

<para
>O menu <guimenu
>Línguas</guimenu
> permite-lhe escolher a língua em que as palavras são apresentadas. </para>

<para
>O menu <guimenu
>Ver</guimenu
> propõe dois temas: o tema <guimenuitem
>Marinho</guimenuitem
> e o tema <guimenuitem
>Deserto</guimenuitem
>. O fundo e as cores dos tipos de letra mudam para cada tema. </para>

<para
>O menu <guimenuitem
>Configuração</guimenuitem
> permite-lhe configurar facilmente o &khangman;. Primeiro, o <guimenuitem
>Barras de Ferramentas</guimenuitem
>, <guimenuitem
>Mostrar a Dica</guimenuitem
> e o <guimenuitem
>Mostrar a Barra de Estado</guimenuitem
> dão-lhe a possibilidade de esconder/mostrar as barras de ferramentas e a barra de estado. </para>

<para
>Existem quatro barras de ferramentas: a <guimenuitem
>Principal</guimenuitem
>, a <guimenuitem
>Aparência</guimenuitem
> e <guimenuitem
>Língua</guimenuitem
>, que são as que aparecem com os botões e as listas e a barra de <interface
>Caracteres Especiais</interface
> que é mostrada em baixo. Esta barra tem os botões com os caracteres especiais de cada língua: as letras acentuadas e outros caracteres especiais. Isto permite aos utilizadores jogarem facilmente noutra língua sem ter configurar o teclado de novo. Você carrega numa letra especial e ela é mostrada como uma letra de uma tentativa. Se carregar em &Enter;, o programa irá ver se a letra está presente na palavra ou não. A barra de ferramentas poderá ser escondida, se não precisar dela. Isto é registado no ficheiro de configuração, como tal, se a barra estiver escondida, também irá estar da próxima vez que executar o &khangman;. </para>

<tip>
<para
>Claro que é possível mover as barras de ferramentas para qualquer lado. Coloque o cursor do rato na pequena pega do lado esquerdo da barra de ferramentas, carregue no &LMB; e arraste a barra de ferramentas para a posicionar no ecrã, no local onde a deseja colocar. Se apontar o rato para uma das barras de ferramentas e se carregar no botão direito do rato, irá aparecer um menu de contexto que lhe permite escolher diferentes opções para a barra de ferramentas. </para>
</tip>

<para
>O <guimenuitem
>Configurar os Atalhos...</guimenuitem
> é uma configuração normal do &kde; que lhe permite escolher as diferentes combinações de teclas para as várias acções. Por exemplo, o <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> é o atalho normal para <guimenuitem
>Sair</guimenuitem
>.</para>
<para
>O <guimenuitem
>Configurar as Barras de Ferramentas...</guimenuitem
> é também um item normal de menu do &kde; que lhe permite adicionar ou remover itens da barra de ferramentas. </para>

<screenshot>
<screeninfo
>Tema Deserto do &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman-desert.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Tema Deserto do &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Aqui você tem o &khangman; com o tema Deserto, a língua Francês e o nível Fácil. A barra de <interface
>Caracteres Especiais</interface
> é mostrada aqui.</para>

<para
>O nível é escolhido com uma lista na barra de ferramentas ou no submenu <guimenu
>Categoria</guimenu
> do menu. Os níveis disponíveis são o <guimenuitem
>Fácil</guimenuitem
>, <guimenuitem
>Médio</guimenuitem
>, <guimenuitem
>Animais</guimenuitem
> e <guimenuitem
>Difícil</guimenuitem
>, bem como mais algumas. O <guimenuitem
>Fácil</guimenuitem
> está relacionado com os objectos comuns que uma criança de seis ou sete anos conhece. O <guimenuitem
>Médio</guimenuitem
> diz respeito a nomes um pouco mais desafiantes, o <guimenuitem
>Difícil</guimenuitem
> é bastante complicado e o <guimenuitem
>Animais</guimenuitem
> diz respeito apenas a nomes de animais. Existem também outras categorias de palavras, dependendo da língua. </para>

<para
>Todas as palavras são substantivos. Não existem verbos nem adjectivos. A categoria escolhida é então apresentada na barra de estado.</para>
<para
>Só são permitidas letras no campo de texto.</para>
</sect1>

<sect1 id="settings">
<title
>Configurações Disponíveis</title>
<para
>É fornecida uma barra de ferramentas para aceder rapidamente a algumas configurações. Você poderá carregar num botão para começar um novo jogo (i.e., uma nova palavra) ou para sair do jogo. O nível e o tema são facilmente alterados com as listas na barra de ferramentas. </para>
<para
>Na opção <guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o &khangman;...</guimenuitem
>, irá encontrar três páginas. A primeira é para a configuração <guilabel
>Geral</guilabel
>. </para>

<sect2 id="general-settings">
<title
>Configuração Geral</title>

<screenshot>
<screeninfo
>Configuração geral do &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-general.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Configuração geral do &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
><guilabel
>Necessitar de adivinhar mais vezes letras duplicadas</guilabel
>: esta está desligada por omissão. Quando estiver desligada, se escrever a letra "a" e a palavra tiver vários "a"s, serão todos mostrados. Por exemplo, se a palavra for "batata" e se você carregar em "a", então só o primeiro "a" será mostrado. Você terá de escrever "a" de novo para mostrar a segunda e terceira instâncias, indo a quarta para as letras erradas. Isto aumenta a dificuldade. </para>

<para
><guilabel
>Activar as animações</guilabel
>: por omissão, este item está assinalado, o que significa que, quando ganhar um jogo, irá aparecer uma janela de mensagem que lhe indica se ganhou e se deseja jogar de novo. Se desligar esta opção, esta janela não aparece mais, pelo que um jogo novo se inicia automaticamente ao fim de 3 segundos. </para>

<para
>Na secção de <guilabel
>Sons</guilabel
>, se você assinalar a opção <guilabel
>Activar os sons</guilabel
>, então irá ouvir um som no início do jogo e irá ouvir outro quando ganhar um jogo. </para>

</sect2>
<sect2 id="languages-settings">
<title
>Configuração das Línguas</title>
<para
>A página de Configuração da Língua lida com algumas opções relacionadas com as línguas. Se estas opções não existirem para a língua com que está a jogar, as opções respectivas ficarão então desactivadas. </para>

<screenshot>
<screeninfo
>Configuração da Língua do &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-languages.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Configuração da Língua do &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>A opção <guilabel
>Inserir caracteres acentuados</guilabel
> está disponível para o Catalão, o Português e o Espanhol. Se você assinalar esta opção, então você terá de escrever todas as vogais acentuadas (como o &atilde;). Se não a activar, então quando você escrever uma vogal qualquer todas as vogais acentuadas serão também apresentadas. </para>

</sect2>

<sect2 id="timers-settings">
<title
>Configuração dos Relógios</title>
<para
>A página de Configuração dos <guilabel
>Relógios</guilabel
> permite-lhe definir o <guilabel
>Tempo para a Letra Já Adivinhada</guilabel
>. </para>

<screenshot>
<screeninfo
>Configuração dos Relógios do &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-timers.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Configuração dos Relógios do &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>O <guilabel
>Tempo para mostrar a Letra Já Adivinhada</guilabel
> permite-lhe aumentar ou diminuir o tempo para mostrar a dica de Letra Já Adivinhada. Esta dica é um texto que aparece quando você tentar uma letra que já foi indicada. Algumas pessoas poderão não querer ver a mensagem durante bastante tempo, enquanto as crianças levam tempo a compreender e, como tal, poderão precisar de ter o texto visível durante mais tempo. </para>

</sect2>

</sect1>

</chapter>

<chapter id="commands">
<title
>Referência de Comandos</title>

<sect1 id="khangman-mainwindow">
<title
>Menus e Teclas de Atalho</title>

<sect2>
<title
>O Menu <guimenu
>Jogo</guimenu
></title>

<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
>Começa um novo</action
> jogo (&ie;, uma nova palavra)</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Abrir</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Abre</action
> um ficheiro local para jogar com as suas palavras</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
> </shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Obter Palavras numa Nova Língua...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra</action
> a janela para <guilabel
>Obter Coisas Novas!</guilabel
> que enumera todos os dados disponíveis nas línguas diferentes. </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 &khangman;</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>O Menu <guimenu
>Categoria</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoria</guimenu
> <guimenuitem
>Animais</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a lista de palavras de animais a adivinhar</para>
<para
>Todas as outras categorias instaladas são também mostradas como itens deste menu.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoria</guimenu
> <guimenuitem
>Fácil</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a lista de palavras simples a adivinhar</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoria</guimenu
> <guimenuitem
>Médio</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a lista de palavras de dificuldade média a adivinhar</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoria</guimenu
> <guimenuitem
>Difícil</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a lista de palavras difíceis a adivinhar</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>O Menu <guimenu
>Língua</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Língua</guimenu
> <guimenuitem
>Inglês</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a língua inglesa para as palavras a adivinhar.</para>
<para
>Todas as outras línguas instaladas são também mostradas como itens deste menu.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>O menu <guimenu
>Ver</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Ver</guimenu
> <guimenuitem
>Tema do Mar</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> imagem de fundo marinha, bem como as cores associadas</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Ver</guimenu
> <guimenuitem
>Tema do Deserto</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a imagem de fundo do Deserto e as cores associadas</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>O Menu <guimenu
>Configuração</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guisubmenu
>Barras de Ferramentas</guisubmenu
> </menuchoice
></term>
<listitem
><para
><action
>Activa ou desactiva</action
> as barras de ferramentas <guimenuitem
>Principal</guimenuitem
>, <guimenuitem
>Caracteres Especiais</guimenuitem
>, <guimenuitem
>Aparência</guimenuitem
> e <guimenuitem
>Língua</guimenuitem
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Configuração</guimenu
> <guimenuitem
>Mostrar a Dica</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Activa ou desactiva</action
> a apresentação das dicas.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Mostrar a Barra de Estado</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Activa ou desactiva</action
> a barra de estado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar os Atalhos...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Abre</action
> a janela de configuração normal do &kde; que lhe permite escolher teclas de atalho diferentes para as acções diferentes. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar as Barras de Ferramentas...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura</action
> os itens que você deseja colocar na barra de ferramentas. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o &khangman;...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra</action
> a janela de configuração do &khangman;. </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title
>O Menu <guimenu
>Ajuda</guimenu
></title>
&help.menu.documentation; </sect2>
</sect1>
</chapter>

<chapter id="developers">
<title
>Guia de Programação do &khangman;</title>

<sect1 id="changing-words">
<title
>Como traduzir palavras numa língua nova para o jogo</title>

<para
>Siga por favor o procedimento e envie então os ficheiros num pacote 'tar.gz' para &Anne-Marie.Mahfouf.mail;. </para>
<para
>Veja então a opção do &khangman; <guimenuitem
>Obter as Palavras numa Nova Língua...</guimenuitem
>, no menu <guimenu
>Jogo</guimenu
>, para ver se a sua língua já está disponível. Se estiver, então poderá ver se esta contém <emphasis
>sugestões</emphasis
>. </para>
<para
>As palavras são guardadas em 4 ficheiros separados, um por cada nível. Os ficheiros estão em <filename class="directory"
>/khangman/data</filename
>. O ficheiro <filename
>easy.kvtml</filename
> é para o nível fácil, o ficheiro <filename
>medium.kvtml</filename
> é para o médio, o <filename
>animals.kvtml</filename
> para o nível dos animais e o <filename
>hard.kvtml</filename
> para o nível difícil.</para>
<para
>O Inglês é a predefinida e, como tal, é a única língua a ser fornecida com o &khangman;. Todas as outras línguas vêm no pacote kde-l10n correspondente. </para>
<procedure>
<step>
<para
>Os ficheiros usam agora o formato 'kvtml'. A marca <sgmltag class="starttag"
>text</sgmltag
> corresponde à palavra e <sgmltag class="starttag"
>comment</sgmltag
> à sugestão, estando estas inseridas numa marca <sgmltag class="starttag"
>entry</sgmltag
>. Tente corresponder a dica ao nível de dificuldade. O nível <quote
>Fácil</quote
> irá necessitar de uma dica fácil mas o nível <quote
>Difícil</quote
> irá necessitar da definição do dicionário. Tente não usar palavras da mesma família na dica, porque darão a palavra de forma demasiado fácil!</para>

<para
>Lembre-se que precisa de usar a <emphasis role="bold"
>codificação UTF-8</emphasis
> ao editar os ficheiros. Se o seu editor não o fizer, tente usar o &kwrite; ou o &kate;. Ao abrir um ficheiro no &kwrite; ou no &kate;, você poderá seleccionar a codificação UTF-8 na lista no topo da janela de abertura de ficheiros.</para>

<para
>Um exemplo de um ficheiro KVTML é o seguinte:</para>
<programlisting
><markup>
&lt;?xml version="1.0"?&gt; 
&lt;DOCTYPE kvtml PUBLIC "kvtml2.dtd"
"http://edu.kde.org/kanagram/kvtml2.dtd"&gt; 
&lt;kvtml version="2.0"&gt; 
&lt;information&gt;
    &lt;generator&gt;converter&lt;/generator&gt;
    &lt;title&gt;Animais&lt;/title&gt;&lt;!--Traduzir o conteúdo da marca--&gt;
    &lt;comment&gt;Animais do planeta&gt;&lt;!--Traduzir o conteúdo da marca--&gt;
  &lt;/information&gt;
  &lt;identifiers&gt;
    &lt;identifier id="0" &gt;
      &lt;locale&gt;pt&lt;/locale&gt;
    &lt;/identifier&gt;
  &lt;/identifiers&gt;
...
&lt;entry id="0" &gt;
      &lt;inactive&gt;false&lt;/inactive&gt;
      &lt;inquery&gt;false&lt;/inquery&gt;
      &lt;translation id="0" &gt;
        &lt;text&gt;urso&lt;/text&gt;&lt;!--Traduzir o conteúdo de todas as marcas--&gt;
        &lt;comment&gt;Grande animal pesado com pêlo grosso&lt;/comment&gt;&lt;!--Traduzir o conteúdo de todas as marcas--&gt;
      &lt;/translation&gt;
    &lt;/entry&gt;
...
&lt;/kvtml&gt;
</markup
></programlisting>
</step>
<step>
<para
>No início do ficheiro, você deverá traduzir o conteúdo das marcas <sgmltag class="starttag"
>title</sgmltag
> e <sgmltag class="starttag"
>comment</sgmltag
>, as quais se encontram dentro da marca <sgmltag class="starttag"
>information</sgmltag
>. O título será o que irá aparecer no menu Categoria do jogo (onde o utilizador escolhe o ficheiro com que irá jogar). </para>
</step>
<step>
<para
>Depois, dentro da marca <sgmltag class="starttag"
>identifier</sgmltag
>, indique por favor o seu código de língua em vez do 'en' no <sgmltag class="starttag"
>locale</sgmltag
>.</para>

<para
>Por favor não traduza o nome do ficheiro, dado que os nomes dos ficheiros não deverão conter caracteres especiais. Como tal, guarde o seu ficheiro com o mesmo nome usado para o Inglês.</para>
</step>
<step>
<para
>Edite todos os ficheiros de texto indicados na nova pasta com um editor de texto (será mais fácil se usar o realce de sintaxe de &XML;) e substitua cada palavra dentro da marca <sgmltag class="starttag"
>text</sgmltag
> pela palavra traduzida e cada dica dentro de uma marca <sgmltag class="starttag"
>comment</sgmltag
> com a dica traduzida. Não é realmente importante se o significado exacto se mantém, mas tente manter o tamanho e o nível de dificuldade aproximadamente igual. </para
> 

<para
>Poderá incluir palavras com espaços ou - nelas; nesse caso, o espaço em branco ou o '-' serão apresentados em vez do '_'. Contacte o autor por favor, no caso de ocorrer algo especial relacionado com a sua língua, para que o código possa ser adaptado para tal (especialmente no caso dos caracteres especiais e acentuados). </para>
</step
>	

<step>
<para
>Você poderá traduzir as palavras, mas também as poderá adaptar de acordo com o nível e adicionar novas se o desejar. Por exemplo, a palavra <quote
>table</quote
> (mesa) está num nível simples em Inglês mas na sua língua poderá pertencer ao nível médio. Sinta-se à vontade para adaptar os ficheiros à medida das suas necessidades. O número de palavras de um ficheiro não é importante, mas poderá adicionar algumas se quiser.</para>

<para
>Lembre-se que todas as palavras são nomes.</para>

</step>

<step>
<para
>Poderá então enviar os seus ficheiros para <emphasis
>l10n-kde4/&lt;código-língua&gt;/data/kdeedu/khangman</emphasis
>. Não se esqueça de actualizar também o ficheiro CMakeLists.txt. Contacte o autor por e-mail em caso de qualquer dúvida. Quando enviar a este os ficheiros, não se esqueça de mencionar os <emphasis role="bold"
>caracteres especiais</emphasis
> da sua língua (coloque-os num ficheiro de texto, um por cada linha, e adicione este ficheiro ao pacote) e mencione por favor outras especificidades que possam existir.</para>
<para
><emphasis
>Por favor nunca envie via CVS os ficheiros num BRANCH (ramificação), dado que poderá invalidar o jogo.</emphasis
></para>
</step>
</procedure>
<para
>Muito obrigado pela sua contribuição!</para>
</sect1>

<sect1 id="internal">
<title
>O que é gravado pelo &khangman; e onde</title>
<para
>Quando você obter uma nova língua através da opção <menuchoice
><guimenu
>Jogo</guimenu
><guimenuitem
>Obter Palavras numa Nova Língua...</guimenuitem
></menuchoice
>, os dados da mesma são gravados em <filename class="directory"
>$~/.kde/share/apps/apps/kvtml/</filename
>, na pasta com o código da língua. Os nomes das pastas de línguas são também gravados no ficheiro de configuração do &khangman; em <filename
>~/.kde/share/config/khangmanrc</filename
>. </para>
<para
>O nome do distribuidor (i.e. o endereço do 'site' Web onde obter as novas línguas) é guardado no <filename
>$KDEDIR/share/apps/khangman/khangmanrc</filename
>. </para>
<para
>A língua Inglesa (por omissão) e a língua do utilizador do seu pacote 'i18n' (se estiver disponível) são gravados em <filename class="directory"
>$KDEDIR/share/apps/kvtml</filename
>. </para>
<para
>No ficheiro de configuração, por cada utilizador no seu ficheiro <filename
>$KDEHOME/share/config/khangmanrc</filename
>, são gravadas todas as configurações do jogo como o fundo, o último nível jogado, ... para além dos ficheiros que foram transferidos a partir da janela para <guilabel
>Obter Coisas Novas!</guilabel
>. </para>
</sect1>
</chapter>

<chapter id="faq">
<title
>Perguntas e Respostas</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Eu obtive uma mensagem de erro a dizer que as imagens não puderam ser encontradas.</para>
</question>
<answer>
<para
>O jogo instala-se por omissão no <filename class="directory"
>/usr/local/kde</filename
>, por isso adicione o <filename class="directory"
>/usr/local/kde/bin</filename
> à sua <envar
>PATH</envar
> e defina a variável <envar
>KDEDIR</envar
> como sendo igual a <filename class="directory"
>/usr/local/kde</filename
> antes de executar o jogo. Uma forma fácil é configurar o &khangman; com a opção <option
>--prefix</option
>=$<envar
>KDEDIR</envar
> em que a $<envar
>KDEDIR</envar
> é o local onde o resto do &kde; está instalado. Isto poderá variar bastante, dependendo da distribuição e do sistema operativo que usa. É melhor instalar o &khangman; a partir da sua distribuição!</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>O &khangman; não se inicia correctamente depois de eu ter actualizado para a versão 4 do &kde;</para>
</question>
<answer>
<para
>Poderá haver um problema devido à alteração do ficheiro de configuração. Por favor, remova o ficheiro <filename
>khangmanrc</filename
> na sua pasta <filename class="directory"
>$KDEHOME/share/config</filename
>. </para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

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

<para
>&khangman; </para>
<para
>Programa com 'copyright' 2001-2007 de &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; </para>
<para
>Contribuições: <itemizedlist>
<listitem
><para
>Imagens do homem enforcado: Renaud Blanchard <email
>kisukuma@chez.com</email
></para
> </listitem>
<listitem
><para
>Sons: Ludovic Grossard <email
>ludovic.grossard@libertysurf.fr</email
></para
> </listitem>
<listitem
><para
>Tema azul, ícones e código: &Primoz.Anzur; &Primoz.Anzur.mail;</para
> </listitem>
<listitem
><para
>Ficheiro de dados em sueco, ajuda na codificação, imagens transparentes e correcções de i18n: Stefan Asserhäll <email
>stefan.asserhall@telia.com</email
></para
> </listitem>
<listitem
><para
>Tema da Natureza: Joe Bolin <email
>jbolin@users.sourceforge.net</email
></para
> </listitem>
<listitem
><para
>Imagens Suaves do Homem Enforcado: Matt Howe <email
>mdhowe@bigfoot.com</email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Espanhol: eXParTaKus <email
>expartakus@expartakus.com</email
></para
> </listitem>
<listitem
><para
>Dados de sugestões em Espanhol: Rafael Beccar <email
>rafael.beccar@kdemail.net </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Dinamarquês: Erik Kjaer Pedersen <email
>erik@mpim-bonn.mpg.de </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Finlandês: Niko Lewman <email
>niko.lewman@edu.hel.fi </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Português do Brasil: João Sebastião de Oliveira Bueno <email
>gwidion@mpc.com.br </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Catalão: Antoni Bella <email
>bella5@teleline.es </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Italiano: Giovanni Venturi <email
>jumpyj@tiscali.it </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Holandês: Rinse <email
>rinse@kde.nl </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Português Europeu: Pedro Morais <email
>morais@kde.org </email
></para
> </listitem>
<listitem
><para
>Ficheiros de dados em Sérvio (Cirílico e Ocidental): Chusslove Illich <email
>chaslav@sezampro.yu </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Esloveno: Jure Repinc <email
>jlp@holodeck1.com </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Checo Luk&aacute;&scaron; Tinkl <email
>lukas@kde.org</email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Tajik: Roger Kovacs <email
>rkovacs@khujand.org </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Norueguês: (Bokm&#229;l): Torger &#197;ge Sinnes <email
>torg-a-s@online.no </email
></para
> </listitem>
<listitem
><para
>Ficheiros de dados em Húngaro: Tamas Szanto <email
>tszanto@mol.hu </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Norueguês (Nynorsk): Gaute Hvoslef Kvalnes <email
>gaute@verdsveven.com </email
></para
> </listitem>
<listitem
><para
>Ficheiros de dados em Turco: Mehmet &Ouml;zel <email
>mehmet_ozel2003@hotmail.com </email
></para
> </listitem>
<listitem
><para
>Ficheiros de dados em Búlgaro: Radostin Radnev <email
>radnev@yahoo.com </email
></para
> </listitem>
<listitem
><para
>Ficheiros de dados em Irlandês (Gaélico): Kevin Patrick Scannell <email
>scannell@slu.edu </email
></para
> </listitem>
<listitem
><para
>Ajuda na codificação: &Robert.Gogolok; &Robert.Gogolok.mail;</para
> </listitem>
<listitem
><para
>Akida na codificação: Benjamin Meyer <email
>ben@meyerhome.net</email
></para
> </listitem>
<listitem
><para
>Correcções de código: Lubos Lun&agrave;k <email
>l.lunak@kde.org</email
></para
> </listitem>
<listitem
><para
>Correcções de código: Albert Astals Cid <email
>tsdgeos@terra.es</email
></para
> </listitem>
<listitem
><para
>Estudo de usabilidade: Celeste Paul <email
>seele@obso1337.org</email
></para
> </listitem>
</itemizedlist>
</para>

<para
>Documentação com 'copyright' 2001-2007 de &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; </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-khangman">
<title
>Como obter o &khangman;</title>
&install.intro.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-minimize-attributes: nil
sgml-general-insert-case: lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
