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

<book id="khangman" lang="&language;">

<bookinfo>
<title
>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
>Luiz Fernando</firstname
><surname
>Ranghetti</surname
><affiliation
><address
><email
>elchevive@opensuse.org</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>


<copyright>
<year
>2001</year
><year
>2009</year>
<holder
>&Anne-Marie.Mahfouf;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>


<date
>31/05/2013</date>
<releaseinfo
>2.5 (&kde; 4.11)</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
>forca</keyword>
<keyword
>jogo</keyword>
<keyword
>criança</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 após a outra. Cada vez que erra uma letra, parte da imagem de um enforcado é desenhada. Você precisa de adivinhar a palavra antes que ele seja enforcado! Você tem 10 tentativas. </para>

</chapter>

<chapter id="using-khangman">
<title
>Usando 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
>Captura de tela 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 o idioma é o padrão (neste caso o Inglês, mas será o seu idioma atual no &kde;, se existirem dados para isso), o tema é o "Mar". Todas as alterações no nível, idioma ou tema (imagem de fundo) são registradas no arquivo de configuração e restauradas no seu próximo jogo. </para>

<para
>Note quão fácil é alterar o tema; basta carregar nas listas da barra de ferramentas. Obter uma nova palavra e sair do jogo é facilmente conseguido clicando-se nos botões correspondentes na barra de ferramentas. </para>

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

<para
>Uma palavra é escolhida e suas letras são mostradas como sublinhados (_). Você sabe quantas letras existem na palavra. Terá então que adivinhar a palavra, digitando uma letra atrás de outra. Você pode inserir a letra no campo de texto e pressionar &Enter; ou clicar 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, adjetivos, &etc;).</para
></important>

<para
>Se você precisar de ajuda para adivinhar a palavra, poderá clicar 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. Clicar no ícone <guiicon
>Mostrar a Dica</guiicon
> novamente, irá ocultar a dica ou sugestão. </para>

<para
>As sugestões não são apresentadas no modo inicial por padrão. </para>

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

<para
>A categoria atual, assim como as vitórias e derrotas, são mostradas na barra de status. </para>

<para
>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 correta é mostrada. </para>

<para
>Existem 4 categorias: fácil, médio, difícil e animais, mais algumas categorias sobre outros tópicos para alguns idiomas. O programa pesquisa todos os arquivos de dados em todos os idiomas e também os arquivos de palavras do &kanagram;. </para>
 
<para
>No nível simples, as palavras são bastante simples e relacionam-se com o dia-a-dia. Ele é 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 é isso mesmo - 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
>Após adivinhar uma palavra (ou o enforcado ficar completo), você recebe os parabéns e será apresentada outra palavra. Você poderá então clicar em <guilabel
>Jogar de novo</guilabel
> para que outra palavra fique pronta para adivinhar ou selecionar então outra <guimenu
>Categoria</guimenu
> para jogar. Para sair do jogo agora, selecione a opção <menuchoice
><guimenu
>Jogo</guimenu
><guimenuitem
>Sair</guimenuitem
> </menuchoice
> ou clique no botão <guiicon
>Sair</guiicon
> da barra de ferramentas. </para>

<para
>Você digita a letra que deseja tentar no campo de texto (o cursor do mouse está pronto no campo) e pressiona a 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 correta será então apresentada. </para>

<para
>Durante o jogo, você poderá optar por iniciar um jogo, selecionando a opção do menu <guimenu
>Jogo</guimenu
> que é a <guimenuitem
>Novo</guimenuitem
> ou clicando 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 lhe mostrará uma palavra nova para o novo nível).</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
>Você poderá também jogar com um arquivo local instalado na sua máquina, que poderá ser aberto com o menu <guimenu
>Jogo</guimenu
> e a sua opção <guimenuitem
>Abrir</guimenuitem
>.</para>

</sect1>

<sect1 id="languages">
<title
>Jogar em idiomas diferentes</title>
<para
>Você poderá jogar o &khangman; em diversos idiomas, 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. Você poderá até tentar o Chinês, se instalar os arquivos do &kanagram;!! </para>

<para
>Por padrão, depois da primeira instalação do &khangman;, somente o Inglês e o seu idioma 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 usuário brasileiro e tiver o &kde; em Português do Brasil, no menu <guimenu
>Idioma</guimenu
> você terá dois itens: Inglês e Português do Brasil, sendo este último a opção padrão. </para>

<para
>Você ainda poderá jogar o &khangman; em outros idiomas. É muito fácil adicionar novos dados no &khangman;. Tudo o que precisa é de uma conexão à Internet funcionando. Você clica no menu <guimenu
>Jogo</guimenu
> e depois em <guimenuitem
>Obter palavras em novo idioma...</guimenuitem
>. 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
>Clique no nome do idioma que deseja instalar e depois no botão <guibutton
>Instalar</guibutton
>. Se o idioma for instalado com sucesso, irá aparecer uma marca em verde à frente do nome do idioma e o botão <guibutton
>Instalar</guibutton
> muda para <guibutton
>Desinstalar</guibutton
>. Os dados ficarão imediatamente instalados e disponíveis no &khangman;. Você poderá clicar em <guibutton
>Fechar</guibutton
> para sair da janela Obter Palavras Novas (se quiser outro idioma, poderá repetir estes passos). </para>

<para
>Você poderá então alterar facilmente o idioma acessando o menu <guimenu
>Idioma</guimenu
> e selecionando outro idioma. </para>

<para
>Repare que você pode agora digitar os caracteres especiais de um idioma, mostrando a barra de <interface
>Caracteres Especiais</interface
>. Esta barra de ferramentas mostra botões com um ícone correspondente a cada caractere especial de um determinado idioma, como o &eacute; no Português do Brasil, por exemplo. Clicando num botão destes, você irá inserir 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 ao idioma. Esta barra de ferramentas poderá ser oculta ou apresentada. A configuração é restaurada 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 corretamente os caracteres especiais em alguns idiomas. Uma vez que tenha estas fontes instaladas, o &khangman; as usará automaticamente. Se você ver pequenos retângulos em vez de letras, então poderão estar faltando estas fontes. Digite <command
>fonts:/</command
> na barra de endereços do &konqueror; para ver que tipos de fontes você possui. </para
></important>

</sect1>
<sect1 id="few-tips">
<title
>Algumas sugestões</title>
<para
>Em Inglês, tente adivinhar primeiro as vogais. Depois, tente as consoantes mais comuns: 'l', 't', 'r', 'n' e 's' </para>
<para
>Quando você ver <quote
>io</quote
>, tente o 'n' após 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 ser descobertas ao você digitar a vogal não acentuada correspondente. Por exemplo, todos os <quote
>a</quote
>'s acentuados são mostrados na palavra quando digitar <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á que escrever você próprio as letras acentuadas. Quando você escrever <quote
>a</quote
>, só o <quote
>a</quote
> é apresentado e você terá que 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
> possui 3 itens: o <guimenuitem
>Novo</guimenuitem
>, o <guimenuitem
>Obter Palavras em novo Idioma...</guimenuitem
> e o <guimenuitem
>Sair</guimenuitem
>.</para>

<para
>O <guimenuitem
>Novo</guimenuitem
> inicia um novo jogo, &ie; uma nova palavra para adivinhar, no mesmo nível em que já se encontra. O <guimenuitem
>Obter Palavras em Novo Idioma...</guimenuitem
> irá mostrar a janela para Obter Coisas Novas que lhe permitirá obter os dados em um novo idioma. O <guimenuitem
>Sair</guimenuitem
> abandona o jogo, fechando a janela principal e guardando a configuração atual no arquivo de configuração.</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
>Idioma</guimenu
> permite-lhe escolher o idioma em que as palavras são apresentadas. </para>

<para
>O menu <guimenu
>Aparência</guimenu
> propõe quatro temas: o <guimenuitem
>Tema Marinho</guimenuitem
>, o <guimenuitem
>Tema Inverno</guimenuitem
>, o <guimenuitem
>Tema Abelhas</guimenuitem
> e o <guimenuitem
>Tema Deserto</guimenuitem
>. O fundo e as cores das fontes mudam para cada tema. </para>

<para
>O menu <guimenu
>Configurações</guimenu
> permite-lhe configurar facilmente o &khangman;. Primeiro, a opção <guimenuitem
>Barras de ferramentas</guimenuitem
>, <guimenuitem
>Mostrar dica</guimenuitem
> e <guimenuitem
>Mostrar a barra de status</guimenuitem
> permitem-lhe ocultar/mostrar as barras de ferramentas e a barra de status. </para>

<para
>Existem quatro barras de ferramentas: a <guimenuitem
>Principal</guimenuitem
>, a <guimenuitem
>Ver</guimenuitem
> e a <guimenuitem
>Idioma</guimenuitem
> que estão no topo como botões e caixas combinadas, e a barra de <interface
>Caracteres</interface
> que é mostrada abaixo. Esta barra possui os botões com os caracteres especiais de cada idioma: as letras acentuadas e outros caracteres especiais. Isto permite aos usuários jogarem facilmente em outro idioma sem ter que configurar o teclado novamente. Você clica numa letra especial e ela é mostrada como uma letra de uma tentativa. Pressionando em &Enter;, o programa irá ver se a letra está presente na palavra ou não. A barra de ferramentas poderá ser oculta, se não precisar dela. Isto é registrado no arquivo de configuração, assim, 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 mouse na pequena pega do lado esquerdo da barra de ferramentas, clique no &LMB; e arraste a barra de ferramentas para posicioná-la na tela, no local onde deseja colocá-la. Se você apontar o mouse para uma das barras de ferramentas e clicar no botão direito do mouse, 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 padrão do &kde; que lhe permite escolher as diferentes combinações de teclas para as várias ações. Por exemplo, o <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> é o atalho padrão para <guimenuitem
>Sair</guimenuitem
>.</para>
<para
>O <guimenuitem
>Configurar as Barras de Ferramentas...</guimenuitem
> é também um item padrão 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, o idioma Francês e o nível Fácil. A barra de <interface
>Caracteres Especiais</interface
> é mostrada aqui.</para>

<para
>A categoria é escolhida 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 alguns. O <guimenuitem
>Fácil</guimenuitem
> está relacionado com os objetos 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 do idioma. </para>

<para
>Todas as palavras são substantivos. Não existem verbos nem adjetivos. A categoria escolhida é então apresentada na barra de estado.</para>
<para
>Só é permitido digitar letras na caixa de texto.</para>
</sect1>

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

<sect2 id="general-settings">
<title
>Configurações gerais</title>

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

<para
><guilabel
>Precisa de mais tentativas para letras duplicadas</guilabel
>: esta está desligada por padrão. Quando estiver desligada, se digitar a letra "a" e a palavra tiver vários "a"s, todos serão mostrados. Por exemplo, se a palavra for "batata" e se você tentar o "a", então só o primeiro "a" será mostrado. Você terá que escrever "a" de novo para mostrar a segunda e terceira ocorrências, indo a quarta para as letras erradas. Isto aumenta a dificuldade. </para>

<para
><guilabel
>Ativar as animações</guilabel
>: por padrã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, e um novo jogo se inicia automaticamente ao fim de 3 segundos. </para>

<para
><guilabel
>Ativar as dicas globalmente</guilabel
>: por padrão está desligada. As sugestões não são apresentadas. Se assinalar isto (ou usar o ícone <guilabel
>Mostrar as Dicas</guilabel
>, a opção do menu <menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Mostrar a Dica</guimenuitem
></menuchoice
> ou ainda o atalho <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
>), será apresentada uma sugestão acima da palavra, de modo a ajudá-lo a descobrir a palavra mais facilmente. </para>

<para
>Na seção de <guilabel
>Sons</guilabel
>, se você assinalar a opção <guilabel
>Ativar 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ções de idioma</title>
<para
>A página de Configuração do <guilabel
>Idioma</guilabel
> permite que você configure algumas opções específicas para alguns idiomas. Se estas opções não existirem para o idioma com que está jogando, então estas opções ficarão em cinza e desabilitadas, de modo que você não possa selecioná-las. </para>

<screenshot>
<screeninfo
>Configurações de idioma do &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-languages.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Configurações de idioma 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á que escrever todas as vogais acentuadas (como o &atilde;). Se não a ativar, 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 mostrar 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
>Menu Jogo</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 arquivo 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 em Novo Idioma...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra</action
> a janela para <guilabel
>Obter Coisas Novas!</guilabel
> que enumera todos os dados disponíveis nos diferentes idiomas. </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
>Menu Categoria</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoria</guimenu
> <guimenuitem
>Animais</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a lista de palavras de animais para adivinhar</para>
<para
>Todas as outras categorias instaladas são exibidas como itens neste 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 para 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 para 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 para adivinhar</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>Menu Idioma</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Idioma</guimenu
> <guimenuitem
>Inglês</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> o idioma inglês para as palavras a adivinhar.</para>
<para
>Todas os outros idiomas instalados são exibidos como itens neste menu.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>Menu Aparência</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Aparência</guimenu
> <guimenuitem
>Tema Marinho</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a imagem de fundo Marinho e as cores associadas</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Aparência</guimenu
> <guimenuitem
>Tema Inverno</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a imagem de fundo Inverno e as cores associadas</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Aparência</guimenu
> <guimenuitem
>Tema Abelhas</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a imagem de fundo Abelhas e as cores associadas</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Aparência</guimenu
> <guimenuitem
>Tema Deserto</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a imagem de fundo Deserto e as cores associadas</para
></listitem>
</varlistentry>
</variablelist>

<para
>O &khangman; possui os itens dos menus <guimenu
>Configurações</guimenu
> e <guimenu
>Ajuda</guimenu
>, comuns do &kde;. Para mais informações, consulte as seções sobre o <ulink url="help:/fundamentals/ui.html#menus-settings"
>Menu Configurações</ulink
> e o <ulink url="help:/fundamentals/ui.html#menus-help"
>Menu Ajuda</ulink
> dos Fundamentos do &kde;. </para>

</sect2>

</sect1>
</chapter>

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

<sect1 id="changing-words">
<title
>Como traduzir palavras num novo idioma para o jogo</title>

<para
>Por favor, siga o procedimento e envie os arquivos compactados como .tar.gz para &Anne-Marie.Mahfouf.mail;. </para>
<para
>Por favor, veja então a opção do &khangman; <guimenuitem
>Obter as Palavras em Novo Idioma...</guimenuitem
>, no menu <guimenu
>Jogo</guimenu
>, para ver se o seu idioma já está disponível. Se estiver, então você poderá ver se ele contém <emphasis
>sugestões</emphasis
>. </para>
<para
>As palavras são guardadas em 4 arquivos separados, um para cada nível. Os arquivos estão em <filename class="directory"
>/khangman/data</filename
>. O arquivo <filename
>easy.kvtml</filename
> é para o nível fácil, o arquivo <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 é o padrão e, como tal, é o único idioma a ser fornecida com o &khangman;. Todos os outros idiomas vêm no pacote kde-l10n correspondente. </para>
<procedure>
<step>
<para
>Os arquivos 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 senão ficará muito fácil descobrir a palavra!</para>

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

<para
>Um exemplo de um arquivo 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_BR&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 arquivo, 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 usuário escolhe o arquivo 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 idioma em vez do 'en' no <sgmltag class="starttag"
>locale</sgmltag
>.</para>

<para
>Por favor, não traduza o nome do arquivo, uma vez que os nomes dos arquivos não deverão conter caracteres especiais. Como tal, guarde o seu arquivo com o mesmo nome usado para o Inglês.</para>
</step>
<step>
<para
>Edite todos os arquivos kvtml 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 exato se mantém, mas tente manter o tamanho e o nível de dificuldade aproximadamente igual. </para
> 

<para
>Você 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 o seu idioma, para que o código possa ser adaptado para isso (especialmente no caso dos caracteres especiais e acentuados). </para>
</step
>	

<step>
<para
>Você poderá traduzir as palavras, mas também poderá adaptá-las de acordo com a categoria e adicionar novas se 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 arquivos à medida das suas necessidades. O número de palavras de um arquivo não é importante, assim você poderá adicionar algumas se quiser.</para>

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

</step>

<step>
<para
>Você poderá então enviar os seus arquivos para <emphasis
>l10n-kde4/&lt;código-língua&gt;/data/kdeedu/khangman</emphasis
>. Não se esqueça de atualizar também o arquivo CMakeLists.txt. Contacte o autor por e-mail em caso de qualquer dúvida. Quando enviar os arquivos, não se esqueça de mencionar os <emphasis role="bold"
>caracteres especiais</emphasis
> do seu idioma (coloque-os num arquivo de texto, um por cada linha, e adicione este arquivo ao pacote) e mencione por favor outras especificidades que possam existir.</para>
<para
><emphasis
>Por favor, nunca envie arquivos para um BRANCH (ramificação), uma vez 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 um novo idioma através da opção <menuchoice
><guimenu
>Jogo</guimenu
><guimenuitem
>Obter palavras em um novo idioma...</guimenuitem
></menuchoice
>, os dados dele são gravados em <filename class="directory"
> $KDEHOME/share/apps/kvtml</filename
>, na pasta com o código do idioma. Os nomes das pastas de idiomas são também gravados no arquivo de configuração do &khangman; em <filename
>$KDEHOME/share/config/khangmanrc</filename
>. </para>
<para
>O nome do distribuidor (p.ex.: o endereço do site onde obter os novos idiomas) é guardado no <filename
>$KDEDIR/share/apps/khangman/khangmanrc</filename
>. </para>
<para
>O idioma inglês (padrão) e o idioma do usuário do seu pacote 'i18n' (se estiver disponível) são salvos em <filename class="directory"
>$KDEDIR/share/apps/kvtml</filename
>. </para>
<para
>No arquivo de configuração, por cada usuário no seu arquivo <filename
>$KDEHOME/share/config/khangmanrc</filename
>, são salvas todas as configurações do jogo como o fundo, o último nível jogado, ... além dos arquivos que foram transferidos a partir da janela para <guilabel
>Obter novidades!</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 dizendo que as imagens não puderam ser encontradas.</para>
</question>
<answer>
<para
>O jogo instala-se por padrã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 operacional que usa. É melhor instalar o &khangman; a partir da sua distribuição!</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>O &khangman; não inicia corretamente depois de eu ter atualizado de uma versão anterior ao &kde; 4</para>
</question>
<answer>
<para
>Poderá haver um problema devido à alteração do arquivo de configuração. Por favor, remova o arquivo <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
>Direitos autorais do programa 2001-2007 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; </para>
<para
>Contribuições: <itemizedlist>
<listitem
><para
>Gráficos 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
>Antigo desenvolvedor: &Primoz.Anzur; &Primoz.Anzur.mail;</para
> </listitem>
<listitem
><para
>Arquivo de dados em sueco, ajuda na codificação, imagens transparentes e correções de i18n: Stefan Asserhäll <email
>stefan.asserhall@telia.com</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em espanhol: eXParTaKus <email
>expartakus@expartakus.com</email
></para
> </listitem>
<listitem
><para
>Dados de dicas em espanhol: Rafael Beccar <email
>rafael.beccar@kdemail.net</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em dinamarquês: Erik Kjaer Pedersen <email
>erik@mpim-bonn.mpg.de</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em finlandês: Niko Lewman <email
>niko.lewman@edu.hel.fi</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em português brasileiro: João Sebastião de Oliveira Bueno <email
>gwidion@mpc.com.br</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em catalão: Antoni Bella <email
>bella5@teleline.es</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em italiano: Giovanni Venturi <email
>jumpyj@tiscali.it</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em holandês: Rinse <email
>rinse@kde.nl</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em português: Pedro Morais <email
>morais@kde.org</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em sérvio (cirílico e latim): Chusslove Illich <email
>chaslav@sezampro.yu</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em esloveno: Jure Repinc <email
>jlp@holodeck1.com</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em checo Luk&aacute;&scaron; Tinkl <email
>lukas@kde.org</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em tajique: Roger Kovacs <email
>rkovacs@khujand.org</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em Norueguês: (Bokm&#229;l): Torger &#197;ge Sinnes <email
>torg-a-s@online.no </email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em húngaro: Tamas Szanto <email
>tszanto@mol.hu</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em Norueguês (Nynorsk): Gaute Hvoslef Kvalnes <email
>gaute@verdsveven.com </email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em turco: Mehmet &Ouml;zel <email
>mehmet_ozel2003@hotmail.com</email
></para
> </listitem>
<listitem
><para
>Arquivos de dados em búlgaro: Radostin Radnev <email
>radnev@yahoo.com</email
></para
> </listitem>
<listitem
><para
>Arquivos 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
>Ajuda na codificação: Benjamin Meyer <email
>ben@meyerhome.net</email
></para
> </listitem>
<listitem
><para
>Correções de código: Lubos Lun&agrave;k <email
>l.lunak@kde.org</email
></para
> </listitem>
<listitem
><para
>Correções de código: Albert Astals Cid &Albert.Astals.Cid.mail;</para
> </listitem>
<listitem
><para
>Estudo de usabilidade: Celeste Paul <email
>seele@obso1337.org</email
></para
> </listitem>
</itemizedlist>
</para>

<para
>Direitos autorais da documentação 2001-2007 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; </para>

<para
>Tradução de Luiz Fernando Ranghetti <email
>elchevive@opensuse.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:
-->
