<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
  <!ENTITY kapp "&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
> <othername
></othername
> <surname
>Mahfouf</surname
> <affiliation
> <address
><email
>annma@kde.org</email
></address>
</affiliation>
</author>
</authorgroup>


<copyright>
<year
>2001</year
><year
>2003</year>
<holder
>Anne-Marie Mahfouf</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>


<date
>2004-04-22</date>
<releaseinfo
>1.5</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: Animais (palavras de animais), Fácil, Médio e Difícil. É 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="khangman1.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. O nível é o Animais e a língua é a predefinida (neste caso o Inglês, mas será a sua língua actual no KDE), não existe nenhum tema de fundo e as imagens do enforcado não são transparentes. 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 nível e o modo do fundo; 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>

<!-- FIXME: A word can't really be displayed and hidden at the same time, -->
<!-- although I can't think of a better way to phrase this -->
<para
>É mostrada uma palavra, cujas letras estão escondidas. Você sabe quantas letras existem na palavra. Você terá 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 Adivinhar 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
>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 começam por uma letra maiúscula. O programa faz isso automaticamente. </para>

<para
>O nível e a língua actuais são mostrados 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 níveis: 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. </para>
 
<para
>No nível 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 de o boneco do enforcado ficar completo),é-lhe pedida outra palavra, onde você poderá carregar nas teclas <keycap
>S</keycap
> ou <keycap
>N</keycap
> ou o rato para responder Sim ou Não. Se disser <guilabel
>Não</guilabel
>, o jogo sai. Se você disser que <guilabel
>Sim</guilabel
>, ficará outra palavra pronta para ser adivinhada. </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;. 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 Falhas 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
> da barra de ferramentas. Você poderá também alterar o nível com o botão de nível da barra de ferramentas (isto mostrar-lhe-á uma palavra nova para o nível novo).</para>

<para
>Os melhoramentos futuros (no KDE 4) permitir-lhe-ão criar o seu próprio ficheiro de palavras ou carregar um ficheiro diferente dos quatro que vêm incluídos. </para>
</sect1>

<sect1 id="languages">
<title
>Jogar em línguas diferentes</title>
<para
>Você poderá jogar o &khangman; em vinte e uma línguas: Búlgaro, Checo, Catalão, Dinamarquês, Holandês, Inglês, Finlandês, Francês, Alemão, Húngaro, Irlandês (Gaélico), Português Europeu, Português do Brasil, Italiano, Espanhol, Norueguês(Bokm&#229;l), Norueguês (Nynorsk), Esloveno, Sérvio (Ocidental e Cirílico), Sueco e Tajik. </para>

<para
>Por omissão, depois da primeira instalação do &khangman; para o KDE 3.3, 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, a opção <guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o &khangman;..</guimenuitem
> <guimenuitem
>Configuração Avançada</guimenuitem
> <guimenuitem
>As palavras estão em:</guimenuitem
> do &khangman; terá dois itens: Inglês e Português, sendo este último a opção por omissão. </para>

<para
>Você 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. Você carrega no menu <guimenu
>Ficheiro</guimenu
> e depois em <guimenu
>Obter os dados numa nova língua...</guimenu
>. Irá aparecer uma janela semelhante à seguinte: </para>

<screenshot>
<screeninfo
>A janela para Obter Coisas Novas do &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="getnewstuff.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Imagem de Obtenção de Coisas Novas</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Carregue no nome da língua que deseja instalar e depois no botão Instalar. Irá aparecer uma janela que lhe diz quando a língua foi instalada, apresentando: Instaladas as coisas novas com sucesso. Você irá carregar em OK para fechar esta janela de informação e depois em Fechar para sair da janela (se quiser outra língua, poderá repetir estes passos). A nova língua passou a estar disponível! </para>

<para
>Poderá então alterar facilmente a língua se for à opção <guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o &khangman;...</guimenuitem
> <guimenuitem
>Opções Avançadas</guimenuitem
> <guimenuitem
>As palavras estão em:</guimenuitem
> e escolher outra língua. </para>

<para
>Repare que você pode agora escrever os caracteres especiais de uma língua, mostrando a <interface
>Barra de 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. </para
></important>

</sect1>
<sect1 id="few-tips">
<title
>Algumas sugestões</title>
<para
>Tente adivinhar primeiro as vogais. Depois, vá às consoantes mais comuns: 'l', 't', 'r', 'n' e 's' </para>
<para
>Quando você 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 <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o &khangman;</guimenuitem
><guimenuitem
>Opções Avançadas</guimenuitem
><guimenuitem
>Inserir Caracteres Acentuados</guimenuitem
></menuchoice
> não está assinalada. Quando a opção <guimenuitem
>Inserir Caracteres Acentuados</guimenuitem
> 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 os dados de uma 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 os dados 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
>Níveis</guimenu
> permite-lhe escolher o nível, &ie; a dificuldade da palavra a adivinhar. </para>
<para
>O menu <guimenuitem
>Configuração</guimenuitem
> permite-lhe configurar facilmente o &khangman;. Primeiro, o <guimenuitem
>Barras de Ferramentas</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 duas barras de ferramentas: a principal, que é a que aparece com os botões e as listas e a barra de <interface
>Caracteres</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 de menu normal do &kde; que lhe permite adicionar ou suprimir os itens da barra de ferramentas. Quando o <guimenuitem
>Modo de Ecrã Completo</guimenuitem
> está activo, ele coloca o jogo em todo o ecrã, só com a barra de ferramentas no topo e tendo o &khangman; a ocupar o resto de todo o espaço. Na barra de ferramentas, o ícone <guiicon
>Voltar ao Tamanho Normal</guiicon
> permite-lhe voltar do modo de ecrã completo para o tamanho da janela que tinha antes.</para>

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

<para
>Aqui você tem o &khangman; com o tema Azul, as imagens transparentes do enforcado, a língua Catalã e o nível Fácil. A barra de <interface
>Caracteres</interface
> é mostrada aqui.</para>

<para
>O nível é escolhido com uma lista na barra de ferramentas ou no submenu <guimenu
>Níveis</guimenu
> do menu. Os níveis disponíveis são o fácil, médio, animais e difícil. O fácil está relacionado com os objectos comuns que uma criança de seis ou sete anos conhece. O médio diz respeito a nomes um pouco mais desafiantes, o difícil é bastante complicado e o animais diz respeito apenas a nomes de animais. </para>

<para
>Todas as palavras são substantivos; não existem verbos nem adjectivos. O nível escolhido é então apresentado 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), para sair do jogo e para entrar no modo de ecrã completo (disponível para os ecrãs de resolução baixa e para jogar com várias pessoas). Este manual de utilizador também será aberto se você carregar no ícone do manual do &khangman;. O nível e o fundo são facilmente alterados com 2 listas na barra de ferramentas. </para>
<para
>Na opção <guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o &khangman;...</guimenuitem
>, irá encontrar duas páginas. A primeira é para a Aparência e Comportamento. </para>

<sect2 id="normal-settings">
<title
>Aparência e Comportamento</title>

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

<para
>A secção de Imagens do Enforcado dá-lhe a hipótese de ter as imagens do enforcado <guimenuitem
>Suaves</guimenuitem
> ou <guimenuitem
>Normais</guimenuitem
>. As imagens <guimenuitem
>Suaves</guimenuitem
> permitem-lhe mostrar a última imagem do enforcado de forma menos violenta. Isto significa que o homem não está enforcado mas segura sim a corda com a sua mão. Isto é mais adequado para as crianças mais novas e é a opção por omissão. Se escolher o <guimenuitem
>Normal</guimenuitem
>, o homem estará então pendurado pelo pescoço. </para>

<para
>Poderá também definir a imagem de fundo. A opção <guimenu
>Sem fundo</guimenu
> deixa tudo a cinzento, enquanto que se assinalar o <guimenu
>Tema azul</guimenu
> ou o <guimenu
>Tema de natureza</guimenu
>, terá algumas imagens de fundo bonitas. </para>

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

</sect2>
<sect2 id="advanced-settings">
<title
>Configuração Avançada</title>

<screenshot>
<screeninfo
>Configuração avançada do &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="advancedsettings.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Configuração avançada do &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>A segunda página lida com as opções mais avançadas. Algumas delas só estão disponíveis para algumas línguas e, se não estiverem disponíveis na língua com que está a jogar, as opções respectivas ficarão então desactivadas. </para>

<para
>A primeira opção permite-lhe escolher a língua para as palavras. Esta língua será a sua língua predefinida no KDE, se estiver disponível. Caso contrário, será o Inglês. O Inglês é distribuído para todos, enquanto os outros dados vêm no pacote de 'i18n' correspondente. Para além disso, poderá obter línguas novas se usar o menu <guimenu
>Jogo</guimenu
> <guimenuitem
>Obter Dados da Nova Língua...</guimenuitem
>. </para>

<para
>A opção <guimenu
>Inserir Caracteres Acentuados</guimenu
> está disponível para o Português do Brasil, 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>

<para
>Algumas línguas também têm dicas para o ajudar a adivinhar a palavra. A dica é mostrado ao carregar com o botão direito e dá-lhe uma definição breve da palavra a adivinhar. Se assinalar a opção <guimenu
>Mostrar as dicas</guimenu
> numa das línguas disponíveis, você poderá carregar com o &RMB; em qualquer lado do jogo e obter uma dica durante quatro segundos. Esta sugestão devê-lo-á ajudar a adivinhar a palavra. </para>

<para
>Se a opção estiver assinalada, o <guimenu
>Só uma Instância de uma Letra</guimenu
> irá mostrar apenas a primeira instância de uma letra se existirem várias letras iguais na palavra. 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
>Se você assinalar a opção <guimenu
>Não mostrar a janela "Parabéns! Ganhou"</guimenu
>, então esta janela não será mostrada quando você ganhar um jogo. Em vez disso, a palavra será mostrada durante 4 segundos e depois irá começar um jogo de novo, imediatamente. </para>

</sect2>
</sect1>

</chapter>

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

<sect1 id="khangman-mainwindow">
<title
>Menus e teclas de atalhos</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
>G</keycap
></keycombo
> </shortcut
> <guimenu
>Jogo</guimenu
> <guimenuitem
>Obter os dados de uma nova língua...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra</action
> a janela do KNewStuff 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
>Níveis</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Níveis</guimenu
> <guimenuitem
>Animais</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a lista de palavras de animais a adivinhar</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Níveis</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
>Níveis</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
>Níveis</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
>Configuração</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Barras de Ferramentas</guimenuitem
> <guimenuitem
>Mostrar o Principal</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Activa ou desactiva</action
> a Barra Principal</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Barras de Ferramentas</guimenuitem
> <guimenuitem
>Mostrar os Caracteres</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Activa ou desactiva</action
> a Barra de Caracteres</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
><shortcut
> <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>F</keycap
></keycombo
> </shortcut
> <guimenu
>Configuração</guimenu
> <guimenuitem
>Modo de Ecrã Completo</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Activa ou desactiva</action
> o modo de ecrã completo </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar os Atalhos...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura</action
> as combinações de teclas que usa para aceder às diferentes acções.</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 adicionar palavras numa nova língua ao jogo</title>

<para
>Graças ao Stefan Asserhäll, é muito fácil de adicionar uma nova língua directamente ao jogo. O procedimento aqui descrito também pode ser encontrado na pasta de código do <filename class="directory"
>khangman</filename
> no ficheiro <filename
>README.languages</filename
>. Por favor, siga o procedimento e envie ao autor os ficheiros num pacote 'tar.gz' para <email
>annemarie.mahfouf@free.fr</email
>. </para>
<para
>As 23 línguas disponíveis até agora são: bg ca cs da de en es fr fi ga hu it nb nl nn pt pt_BR ru sl sr sr@Ltn sv tg e tr. Se o código da sua língua não consta aqui, poderá ir mais além. </para>
<para
>A maioria destes dados deverá estar completa para incluir <emphasis
>dicas</emphasis
>, como poderá ver em baixo. Os dados completos só existem em: bg fr en it, pelo que as outras línguas deverão ser actualizadas o mais cedo possível. </para>
<para
>Garanta que está a trabalhar com a última versão do código de CVS em HEAD do KHangMan, indicando um comando <screen
><userinput
><command>
cvs up -dPA khangman
</command
></userinput
></screen
> no módulo 'kdeedu'. Depois <screen
><userinput
><command>
cd kdeedu/khangman
</command
></userinput
></screen>
</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/codigo_lingua</filename
>. O ficheiro <filename
>easy.txt</filename
> é para o nível fácil, o ficheiro <filename
>medium.txt</filename
> é para o médio, o <filename
>animals.txt</filename
> para o nível dos animais e o <filename
>hard.txt</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-i18n correspondente. </para>
<procedure>
<step
><para
>Indique os seguintes comandos numa &konsole; para criar a pasta e os ficheiros para a nova língua:</para>
<!-- Do not wrap or indent the next line, it's white space sensitive -->
<screen
><userinput
><command
>./add_language <replaceable
>codigo_lingua</replaceable
></command
></userinput
></screen>
<para
>Aqui você precisa de substituir o <replaceable
>codigo_lingua</replaceable
> pelo código da sua lingua (ou seja, pt).</para>
</step>
<step>
<para
>Os ficheiros usam agora o formato 'kvtml'. A marca <sgmltag class="starttag"
>o</sgmltag
> corresponde à palavra <sgmltag class="starttag"
>t</sgmltag
> à sugestão. 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
>Um exemplo de um ficheiro KVTML é o seguinte:</para>
<programlisting
><markup>
        &lt;?xml version="1.0"?&gt; 
        &lt;!DOCTYPE kvtml SYSTEM "kvoctrain.dtd"&gt; 
        &lt;kvtml&gt; 
        &lt;e&gt; 
        &lt;o&gt;cão&lt;/o&gt; 
        &lt;t&gt;&egrave; o teu animal doméstico preferido&lt;/t&gt; 
        &lt;/e&gt; 
        ...
        ...
        &lt;/kvtml&gt;
</markup
></programlisting>
</step>
<step>
<para
>Edite todos os ficheiros de texto indicados na nova pasta com um editor de texto e substitua cada palavra dentro da marca <sgmltag class="starttag"
>o</sgmltag
> pela palavra traduzida e cada dica dentro de uma marca <sgmltag class="starttag"
>t</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. Poderá incluir palavras com os espaços em branco ou com um - entre elas, onde neste caso será mostrado o espaço em branco ou o - em vez de _. Por favorm, contacte a Anne-Marie Mahfouf <email
>annemarie DOT mahfouf AT free DOT fr</email
> se ocorrer algo de especial, relacionado com a sua língua, para que se possa adaptar o código a isso (especialmente a parte de caracterss especiais e acentuados).</para
> 
	
<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>

<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
>Mantenha por favor os ficheiros actualizados na sua pasta <replaceable
>codigo_lingua</replaceable
>.</para>
</step>

<step>
<para
>Indique o seguinte comando para instalar os novos ficheiros de dados:</para>
<screen
><userinput
><command
>make</command
></userinput>
<userinput
><command
>make install</command
></userinput
></screen>

<para
>Você poderá ter de passar para <systemitem class="username"
>root</systemitem
> para correr o <command
>make install</command
>, dependendo da sua instalação.</para>
</step>
<step>
<para
>Execute o jogo e verifique se a sua língua foi adicionada:</para>
<screen
><userinput
><command
>khangman</command
></userinput
></screen>
</step>
<step
><para
>Em vez de enviar via CVS os seus ficheiros, por favor remeta-os para a Anne-Marie Mahfouf <email
>annemarie DOT mahfouf AT free DOT fr</email
> num pacote 'tar.gz'. Dado que existem agora vinte e três línguas, vem agora incluído um novo assistente (KNewStuff) no KHangMan para obter e instalar facilmente as novas línguas que estão colocadas na página Web. Isto é feito para reduzir o tamanho do módulo 'kdeedu' e também será efectuado no KLettres, no KStars e talvez no KTouch. Por favor contacte a Anne-Marie por e-mail, se precisar de mais informações.</para>
<para
>Quando enviar ficheiros ao autor, 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 <guimenu
>Jogo</guimenu
> -> <guimenu
>Obter os Dados de uma Nova Língua ...</guimenu
>, os dados da mesma são gravados em <filename class="directory"
>$~/.kde/share/apps/khangman/data</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/khangman</filename
>. </para>
<para
>No ficheiro de configuração, por cada utilizador no seu ficheiro <filename
>~/.kde/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 do KNewStuff. </para>
</sect1>
<sect1 id="planned-features">
<title
>Funcionalidades Planeadas para o &khangman;</title>
<para
>Uma funcionalidade planeada é, obviamente, ter mais dados de línguas e mais sugestões para todas as línguas. Você poderá ajudar com isto para a sua língua, se ainda não tiver sido feito. Por favor contacte o autor se o quiser ajudar nesta tarefa, que não é mais do que traduzir as palavras em Inglês para a sua língua (veja em <link linkend="changing-words"
>Como adicionar palavras numa nova língua ao jogo</link
>. </para>
<para
>O que também pode ser feito é usar outros ficheiros KVTML como os que estão no 'site' Web do KDE-Edu para jogar o &khangman;. Por exemplo, imagine que poderá jogar com as capitais do mundo, onde a dica lhe indicará o país e você terá de adivinhar a capital. Ou aprender palavras noutra língua, em que a dica é a palavra na sua língua e a palavra a adivinhar é a tradução na nova língua. </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.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>O &khangman; não se inicia correctamente depois de eu ter actualizado para uma das versões 3.3 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"
>$HOME/.kde/share/config</filename
>. </para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

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

<para
>&khangman; </para>
<para
>Programa copyright 2001-2004 Anne-Marie Mahfouf <email
>annma AT kde DOT org</email
> </para>
<para
>Contribuições: <itemizedlist>
<listitem
><para
>Gráficos do homem enforcado: Renaud Blanchard <email
>kisukuma AT chez DOT com</email
></para
> </listitem>
<listitem
><para
>Sons: Ludovic Grossard <email
>ludovic.grossard AT libertysurf DOT fr</email
></para
> </listitem>
<listitem
><para
>Tema azul, ícones e código: Primoz Anzur <email
>zerokode AT yahoo DOT com</email
></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 DOT asserhall AT telia DOT com </email
></para
> </listitem>
<listitem
><para
>Tema da Natureza: Joe Bolin <email
>jbolin AT users DOT sourceforge DOT net</email
></para
> </listitem>
<listitem
><para
>Imagens Suaves do Homem Enforcado: Matt Howe <email
>mdhowe AT bigfoot DOT com</email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Espanhol: eXParTaKus <email
>expartakus AT expartakus DOT com </email
></para
> </listitem>
<listitem
><para
>Dados de sugestões em Espanhol: Rafael Beccar <email
>rafael DOT beccar AT kdemail DOT net </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Dinamarquês: Erik Kjaer Pedersen <email
>erik AT mpim-bonn DOT mpg DOT de </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Finlandês: Niko Lewman <email
>niko DOT lewman AT edu DOT hel DOT fi </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Português do Brasil: João Sebastião de Oliveira Bueno <email
>gwidion AT mpc DOT com DOT br </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Catalão: Antoni Bella <email
>bella5 AT teleline DOT es </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Italiano: Giovanni Venturi <email
>jumpyj AT tiscali DOT it </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Holandês: Rinse <email
>rinse AT kde DOT nl </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Português Europeu: Pedro Morais <email
>morais AT kde DOT org </email
></para
> </listitem>
<listitem
><para
>Ficheiros de dados em Sérvio (Cirílico e Ocidental): Chusslove Illich <email
>chaslav AT sezampro DOT yu </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Esloveno: Jure Repinc <email
>jlp AT holodeck1 DOT com </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Checo Luk&aacute;&scaron; Tinkl <email
>lukas AT kde DOT org</email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Tajik: Roger Kovacs <email
>rkovacs AT khujand DOT org </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Norueguês: (Bokm&#229;l): Torger &#197;ge Sinnes <email
>torg-a-s AT online DOT no </email
></para
> </listitem>
<listitem
><para
>Hungarian data files: Tamas Szanto <email
>tszanto AT mol DOT hu </email
></para
> </listitem>
<listitem
><para
>Ficheiro de dados em Norueguês (Nynorsk): Gaute Hvoslef Kvalnes <email
>gaute AT verdsveven DOT com </email
></para
> </listitem>
<listitem
><para
>Ficheiros de dados em Turco: Mehmet &Ouml;zel <email
>mehmet_ozel2003 AT hotmail DOT com </email
></para
> </listitem>
<listitem
><para
>Ficheiros de dados em Búlgaro: Radostin Radnev <email
>radnev AT yahoo DOT com </email
></para
> </listitem>
<listitem
><para
>Ficheiros de dados em Irlandês (Gaélico): Kevin Patrick Scannell <email
>scannell AT slu DOT edu </email
></para
> </listitem>

<listitem
><para
>Ajuda na codificação: Robert Gogolok <email
>robertgogolok AT gmx DOT de</email
></para
> </listitem>
<listitem
><para
>Akida na codificação: Benjamin Meyer <email
>ben AT meyerhome DOT net</email
></para
> </listitem>
<listitem
><para
>Correcções de código: Lubos Lun&agrave;k <email
>l.lunak AT kde DOT org</email
></para
> </listitem>
<listitem
><para
>Correcções de código: Albert Astals Cid <email
>tsdgeos AT terra DOT es</email
></para
> </listitem>
<listitem
><para
>Estudo de usabilidade: Celeste Paul <email
>seele AT obso1337 DOT org</email
></para
> </listitem>
</itemizedlist>
</para>

<para
>Documentação copyright 2001-2004 Anne-Marie Mahfouf <email
>annma AT kde DOT org</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:
-->
