<?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 % Catalan  "INCLUDE"
><!-- change language only here -->
]>

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

<bookinfo>
<title
>El manual de &khangman;</title>

<authorgroup>
<author
><firstname
>Anne-Marie</firstname
> <surname
>Mahfouf</surname
> <affiliation
> <address
>&Anne-Marie.Mahfouf.mail;</address>
</affiliation>
</author>
&traductor.Antoni.Bella; 
</authorgroup>


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

<legalnotice
>&FDLNotice;</legalnotice>


<date
>18-10-2012</date>
<releaseinfo
>2.5 (&kde; 4.10)</releaseinfo>

<abstract>
<para
>&khangman; és el clàssic joc del penjat per a la canalla, adaptat per a &kde;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>KHangMan</keyword>
<keyword
>penjat</keyword>
<keyword
>joc</keyword>
<keyword
>canalla</keyword>
<keyword
>paraules</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introducció</title>

<para
>&khangman; és un joc basat en el conegut joc del penjat. Està dirigit a nens de 6 anys o més. El joc disposa de diverses categories de paraules amb les que jugar: <guimenuitem
>Animals</guimenuitem
> (noms d'animals) i tres nivells de dificultat: <guimenuitem
>Fàcil</guimenuitem
>, <guimenuitem
>Mitjà</guimenuitem
> i <guimenuitem
>Difícil</guimenuitem
>. Es tria una paraula aleatòriament, les lletres resten ocultes i s'ha d'endevinar la paraula provant una lletra rere l'altra. Cada vegada que s'escriu una lletra errònia es va dibuixant la imatge del penjat. Haureu d'endevinar-la abans de quedar penjat! Disposareu de 10 intents. </para>

</chapter>

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

<screenshot>
<screeninfo
>Aquesta és una captura de pantalla de &khangman; quan l'inicieu per primera vegada</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman-main.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Captura de pantalla de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Aquí podeu veure l'aspecte de &khangman; la primera vegada que s'executa. La categoria és «Animals», l'idioma és el per omissió (anglès en aquest cas, el per omissió serà el vostre idioma actual al &kde;, sempre que hi siguin les dades), el tema és el «Marí». Qualsevol canvi que feu en la categoria, l'idioma o el tema (fons) serà escrit en el fitxer de configuració i restaurat a la següent partida. </para>

<para
>Si us plau, tingueu present el fàcil que resulta canviar el tema, simplement fent clic sobre el quadre combinat de la barra d'eines. Obtenir una nova paraula i sortir del joc també resulta fàcil fent clic sobre el corresponent botó de la barra d'eines. </para>

<sect1 id="general-usage">
<title
>Ús general</title>

<para
>Es mostra una paraula amb les lletres ocultes pel símbol de guió pla (_). Sabreu quantes lletres hi ha. Heu d'endevinar la mateixa provant una lletra rere l'altra. Heu d'introduir la lletra al quadre de text i prémer &Intro; o fer clic sobre el botó <guibutton
>Prova</guibutton
> per a veure si aquesta lletra pertany o no a la paraula. </para>

<para
>La paraula s'escull aleatòriament i no sortirà dues vegades consecutives. </para>

<important
><para
>Totes les paraules són substantius (ni verbs ni adjectius, &etc;).</para
></important>

<para
>Si necessiteu ajuda per esbrinar la paraula, podeu fer clic sobre la icona <guiicon
>Mostra un suggeriment</guiicon
> <inlinemediaobject
><imageobject
> <imagedata fileref="games-hint.png" format="PNG"/></imageobject
></inlinemediaobject
> de la barra d'eines i es mostrarà el consell relacionat per a que agafeu alguna idea sobre la paraula en qüestió. Feu clic sobre la icona <guiicon
>Mostra el suggeriment</guiicon
> per a ocultar-lo. </para>

<para
>Els suggeriments no es mostren en el mode d'inici per omissió. </para>

<para
>Usualment no és important el que escriviu les lletres en majúscules o minúscules. El programa les converteix a minúscules (excepte l'alemany que respecta les paraules que comencen per majúscula). El programa farà això automàticament. </para>

<para
>La categoria i l'idioma actuals són mostrats a la línia d'estat. </para>

<para
>Cada vegada que entreu una lletra que no es trobi a la paraula es dibuixarà una altra part del dibuix del penjat. Teniu 10 intents per a completar-la. Després dels quals es mostrarà la resposta correcta. </para>

<para
>Hi ha quatre categories: fàcil, mitjà, difícil i animals a més d'altres temes en alguns idiomes. El programa cerca tots els fitxers de dades disponibles per a tots els idiomes i també usa fitxers de paraules del &kanagram;. </para>
 
<para
>En la categoria fàcil les paraules són molt simples, relacionades amb la vida diària. És adequat per a nens d'entre 6 i 9 anys. La categoria animals tan sols conté noms d'animals que poden resultar fàcils d'endevinar. Alguns són fàcils i d'altres més difícils. En la categoria mitjà les paraules són més llargues i amb més dificultat. Adequat per a nens més grans de 9 anys. La categoria difícil és... difícil, &ead;, les paraules són complicades de lletrejar i no gaire conegudes. Aquesta categoria és un repte fins i tot per als adults. </para>

<para
>Després d'endevinar una paraula (o es completa el penjat), sereu felicitat i se us demanarà si cal una altra paraula. Podeu fer clic a <guilabel
>Torna a jugar</guilabel
> i una altra paraula estarà llesta per a ser endevinada o seleccioneu una altra <guimenu
>Categoria</guimenu
> per a jugar. Per a sortir del joc seleccioneu <menuchoice
><guimenu
>Joc</guimenu
><guimenuitem
>Surt</guimenuitem
> </menuchoice
> o feu clic a la icona <guiicon
>Surt</guiicon
> en la barra d'eines. </para>

<para
>Heu d'escriure la lletra que voleu provar en el quadre de text (el cursor del ratolí ja es troba allí) i prémer la tecla &Intro; o fer clic sobre el botó <guibutton
>Prova</guibutton
>. Si la lletra pertany a la paraula, se situa al seu lloc, tantes vegades com sigui necessari. Si la lletra no pertany a la paraula, se situa al camp d'<guilabel
>Errades</guilabel
> i es dibuixa una part més del penjat. Disposeu de deu intents abans de perdre la partida i veure la paraula correcta. </para>

<para
>Durant el joc, podreu escollir iniciar una nova partida seleccionant en el menú <guimenu
>Joc</guimenu
> l'opció <guimenuitem
>Nova</guimenuitem
> o fent clic a sobre de la icona <guiicon
>Nova</guiicon
> <inlinemediaobject
> <imageobject
> <imagedata fileref="document-new.png" format="PNG"/></imageobject
></inlinemediaobject
> de la barra d'eines. També podreu canviar la categoria usant el menú <guimenuitem
>Categoria</guimenuitem
> de la barra d'eines (això farà que aparegui una nova paraula per a la nova categoria).</para>

<para
>L'aspecte es pot modificar amb facilitat amb la llista desplegable que hi ha a la barra d'eines <guimenuitem
>Aspecte</guimenuitem
>.</para>

<para
>El botó <guiicon
>Surt</guiicon
> sobre la barra d'eines <inlinemediaobject
><imageobject
> <imagedata fileref="application-exit.png" format="PNG"/></imageobject
></inlinemediaobject
> us permetrà eixir de l'aplicació amb facilitat.</para>

<para
>També podeu jugar amb un fitxer local instal·lat a l'ordinador i obrir-lo usant el menú <guimenu
>Joc</guimenu
> i escollint <guimenuitem
>Obre</guimenuitem
>.</para>

</sect1>

<sect1 id="languages">
<title
>Jugar en idiomes diferents</title>
<para
>És possible jugar a &khangman; en molts idiomes inclosos els següents: brasiler portuguès, búlgar, català, txec, danès, holandès, anglès(americà i britànic), finès, francès, alemany, hongarès, irlandès (gaèlic), italià, neerlandès, noruec (Bokm&#229;l), noruec (Nynorsk), polonès, portuguès, romanès, espanyol, serbi (llatí i ciríl·lic), eslovac, tajic, suec, rus i turc. Podeu intentar triar el xinès si instal·leu els fitxers des del &kanagram;! </para>

<para
>Per omissió, després de la primera instal·lació de &khangman;, tan sols estaran disponibles l'anglès i el vostre idioma de &kde; sempre que tingueu instal·lat el seu paquet kde-i18n. Per exemple, si sou un usuari danès i teniu el danès al &kde;, al menú <guimenu
>Idioma</guimenu
> veureu dos elements: El danès per omissió i l'anglès com a segon idioma. </para>

<para
>Encara podreu jugar a &khangman; en els altres idiomes. Això és tan fàcil com afegir-hi noves fonts de dades. Necessitareu connexió a la Internet. Feu clic sobre el menú <guimenu
>Joc</guimenu
> i aleshores a <guimenu
>Obté paraules en un idioma nou...</guimenu
>. Apareixerà un diàleg, similar a aquest: </para>

<screenshot>
<screeninfo
>El diàleg Obté paraules en un idioma nou per a &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="getnewstuff.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>El diàleg Obté paraules en un idioma nou per a &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Feu clic sobre el nom de l'idioma que voleu instal·lar i llavors sobre el botó <guibutton
>Instal·la</guibutton
>. Si l'idioma està ben instal·lat, es mostrarà una marca verda al davant del nom i el botó <guibutton
>Instal·la</guibutton
> canviarà a <guibutton
>Desinstal·la</guibutton
>. Les dades restaran immediatament instal·lades i disponibles en &khangman;. Feu clic sobre el botó <guibutton
>Tanca</guibutton
> per a tancar el diàleg Obté paraules en un idioma nou (si desitgeu un altra idioma, repetiu aquestes passes). </para>

<para
>Podeu canviar fàcilment l'idioma mitjançant la llista desplegable <guimenu
>Idioma</guimenu
> i escollint-ne un altre. </para>

<para
>Si us plau, tingueu present que ara podeu escriure els caràcters especials per a un idioma en concret mostrant-los a la barra d'eines <interface
>Caràcters especials</interface
>. Aquesta barra d'eines manté alguns botons amb una icona per a cada caràcter especial, com per exemple la &eacute; en francès. Fent clic sobre el botó amb dit caràcter s'escriurà la lletra corresponent en la línia d'entrada i aleshores l'haureu de validar prement &Intro;. Per descomptat també podreu usar la disposició del teclat corresponent a dit idioma. Aquesta barra d'eines es pot mostrar o ocultar. La vostra preferència serà restaurada la propera vegada que feu una partida a &khangman;. </para>

<important
><para
>Si us plau, tingueu present que us caldran els tipus de lletra Arial i URW Bookman per tal de poder mostrar els caràcters especials en alguns idiomes. Segurament ja les teniu instal·lades i el &khangman; les usarà automàticament. Si veieu quadres petits en comptes de lletres, això indicarà que no teniu instal·lat un d'aquests tipus de lletra. Escriviu <command
>fonts:/</command
> a la barra Localització del &konqueror; per comprovar quins tipus de lletra teniu instal·lats. </para
></important>

</sect1>
<sect1 id="few-tips">
<title
>Uns quants consells</title>
<para
>En l'anglès, primer intenteu endevinar les vocals. Aleshores proveu-ho amb les consonants més comuns: l, t, r, n, s </para>
<para
>En els idiomes francès i anglès; si veieu «io», tot seguit proveu amb una n. </para>
<para
>En el brasiler portuguès, català, espanyol i portuguès, els accents seran descoberts quan escriviu la vocal corresponent sense accentuar. Per exemple, totes les «a» accentuades seran mostrades automàticament amb l'accent quan escriviu «a». Això serà així mentre l'opció <guilabel
>Escriu les lletres accentuades</guilabel
> a la pàgina <guilabel
>Idiomes</guilabel
> al diàleg de configuració de &khangman; estigui sense marcar. Si ho està, aleshores haureu d'escriure les lletres accentuades vosaltres mateixos. Quan escriviu «a», tan sols es mostrarà «a» i quan escriviu &atilde; es mostrarà aquesta lletra. </para>
<para
>Sabíeu que? A l'anglès, la lletra més comú és la «e» (12,7%), seguida per la «t» (9,1%), després la «a» (8,2%), «i» (7,0%) i «n» (6,7%). </para>
</sect1>


</chapter>

<chapter id="menus">
<title
>Barra de menús i barra d'eines</title>

<sect1 id="mainwindow">
<title
>La finestra principal de &khangman;</title>

<para
>El menú <guimenu
>Joc</guimenu
> disposa de 3 elements: <guimenuitem
>Nou</guimenuitem
>, <guimenuitem
>Obté paraules en un idioma nou...</guimenuitem
> i <guimenuitem
>Surt</guimenuitem
>.</para>

<para
><guimenuitem
>Nou</guimenuitem
> obrirà una nova partida, &ead;, us presenta una nova paraula a endevinar, en el mateix nivell en el que us trobeu. <guimenuitem
>Obté paraules en un idioma nou...</guimenuitem
> mostrarà un diàleg per a permetre-us descarregar les dades en un idioma nou. Amb <guimenuitem
>Surt</guimenuitem
> se sortirà del joc tancant la finestra principal i desant les preferències reals en el fitxer de configuració.</para>

<para
>El menú <guimenu
>Categoria</guimenu
> us permet escollir la categoria de les paraules amb les que voleu jugar, hi ha tres categories de dificultat. </para>

<para
>El menú <guimenu
>Idioma</guimenu
> us permet canviar l'idioma per a les paraules que es mostraran. </para>

<para
>El menú <guimenu
>Aspecte</guimenu
> proposa quatre temes: El <guimenuitem
>Tema marí</guimenuitem
>, el <guimenuitem
>Tema hivernal</guimenuitem
>, el <guimenuitem
>Tema d'abelles</guimenuitem
> i el <guimenuitem
>Tema del desert</guimenuitem
>. Per a cada tema es canviaran els colors de fons i el dels tipus de lletra. </para>

<para
>El menú <guimenuitem
>Arranjament</guimenuitem
> us permet configurar &khangman; de manera fàcil. Primer hi ha l'opció <guimenuitem
>Barres d'eines</guimenuitem
> i després <guimenuitem
>Mostra línia d'estat</guimenuitem
>, donant-vos la possibilitat d'ocultar o mostrar les barres d'eines o la línia d'estat. </para>

<para
>Hi ha quatre barres d'eines: les <guimenuitem
>Principal</guimenuitem
>, <guimenuitem
>Aspecte</guimenuitem
> i <guimenuitem
>Idioma</guimenuitem
> que apareixen a dalt de tot amb els botons i els quadres combinats, i la de <guilabel
>Caràcters especials</guilabel
>, que quan es mostra, és a la part inferior. Aquesta barra d'eines té botons amb els caràcters especials per a cada idioma: lletres accentuades i d'altres caràcters especials. Això permet que els usuaris juguin amb facilitat en un altre idioma sense que calgui configurar una nova disposició del teclat. Feu clic sobre una d'aquestes lletres especials i serà mostrada com a la lletra seleccionada. Tot seguit premeu &Intro; per a fer que el programa miri si aquesta és present a la paraula. Aquesta barra d'eines la podeu ocultar d'acord a les vostres necessitats. Aquesta preferència serà desada al fitxer de configuració, així que si la barra d'eines és oculta, serà oculta la propera vegada que executeu el &khangman;. </para>

<tip>
<para
>Per descomptat és possible moure les barres d'eines al voltant. Poseu el cursor del ratolí en la petita nansa que hi ha a l'esquerra de la barra d'eines, premeu el &BER; i arrossegueu-la per a situar-la en el punt de la pantalla a on preferiu. Si apunteu el ratolí a sobre d'una de les barres d'eines i premeu el botó dret del ratolí us apareixerà un menú contextual, aquest us permetrà escollir diferents opcions per a dita barra d'eines. </para>
</tip>

<para
><guimenuitem
>Configura dreceres...</guimenuitem
> és un diàleg d'arranjament estàndard del &kde;, aquest us permetrà escollir diferents dreceres de teclat per a diferents accions. Per exemple, <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> és la drecera estàndard per <guimenuitem
>Surt</guimenuitem
>.</para>
<para
><guimenuitem
>Configura barres d'eines...</guimenuitem
> també és un element de menú estàndard del &kde;, aquest us permetrà afegir o suprimir elements des de la barra d'eines. </para>

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

<para
>Aquí teniu &khangman; amb el tema desert, l'idioma català amb la categoria Comarques. Aquí es mostra la barra d'eines de <interface
>Caràcters especials</interface
>.</para>

<para
>La categoria s'escull amb un quadre combinat en la barra d'eines o el menú <guimenu
>Categoria</guimenu
> en la barra de menús. Els nivells són <guimenuitem
>Fàcil</guimenuitem
>, <guimenuitem
>Mitjà</guimenuitem
>, <guimenuitem
>Animals</guimenuitem
> i <guimenuitem
>Difícil</guimenuitem
>. <guimenuitem
>Fàcil</guimenuitem
> està relacionat als objectes comuns que pot conèixer un nen de sis o set anys. El <guimenuitem
>Mitjà</guimenuitem
> és un pel més desafiant, el <guimenuitem
>Difícil</guimenuitem
> és realment difícil i <guimenuitem
>Animals</guimenuitem
> tan sols són noms d'animals. També hi ha algunes altres categories de paraules, depenent de l'idioma. </para>

<para
>Totes les paraules són substantius. Ni verbs, ni adjectius. La categoria escollida és el que es mostra a la línia d'estat.</para>
<para
>En el quadre de text tan sols està permès escriure-hi lletres.</para>
</sect1>

<sect1 id="settings">
<title
>Paràmetres disponibles</title>
<para
>Es proveeix una barra d'eines de ràpid accés per a algunes opcions. Podeu fer clic sobre un botó per a obtenir una nova partida (&ead;, una nova paraula), o per a sortir del joc. El tema es pot canviar amb facilitat mitjançant un quadre combinat a la barra d'eines. </para>
<para
>A <menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura &khangman;...</guimenuitem
> </menuchoice
> trobareu tres pàgines. La primera és la de paràmetres <guilabel
>General</guilabel
>. </para>

<sect2 id="general-settings">
<title
>Paràmetres generals</title>

<screenshot>
<screeninfo
>Paràmetres generals de &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-general.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Paràmetres generals de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
><guilabel
>Requereix més intents per a lletres duplicades</guilabel
>: Per omissió aquesta opció està sense marcar. En aquest estat, si trieu la lletra «a» i aquesta apareix diverses vegades a la paraula, aleshores es mostraran totes. Per exemple, si la paraula és «potato» i trieu la «o», es mostraran ambdues. Però si marqueu aquesta opció, tan sols es mostrarà la primera «o», de manera que per a veure l'altra haureu de tornar a triar altra vegada la segona «o». Això incrementa la dificultat. </para>

<para
><guilabel
>Habilita les animacions</guilabel
>: Per omissió aquesta opció està marcada, el qual vol dir que quan guanyeu una partida, es mostrarà un quadre de missatge dient que heu guanyat i per a demanar-vos si voleu jugar una altra vegada. Però si desmarqueu aquesta opció, aquest diàleg no serà mostrat més, en el seu lloc s'iniciarà una nova partida després de 3 segons. </para>

<para
><guilabel
>Habilita els suggeriments globalment</guilabel
>: Per omissió està sense marcar. Els consells no es mostraran. Si la marqueu (o useu la icona <guilabel
>Mostra els suggeriments</guilabel
> o el menú <menuchoice
><guimenu
>Arranjament</guimenu
><guimenuitem
>Mostra els suggeriments</guimenuitem
></menuchoice
> o useu la drecera <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
>), es mostrarà un consell per a la paraula que us ajudarà a endevinar-la. </para>

<para
>En la secció <guilabel
>Sons</guilabel
>, si marqueu <guilabel
>Habilita els sons</guilabel
> es reproduirà un so en una nova partida i un altra so quan es guanyi. </para>

</sect2>
<sect2 id="languages-settings">
<title
>Paràmetres Idiomes</title>
<para
>La pestanya d'opcions <guilabel
>Idiomes</guilabel
> us permet establir algunes opcions específiques per a alguns idiomes. Si aquestes opcions no estan disponibles per a l'idioma que esteu usant es tornarà grisa, de manera que restarà deshabilitada per a que no la pugueu escollir. </para>

<screenshot>
<screeninfo
>Paràmetres d'idioma per a &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-languages.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Paràmetres d'idioma per a &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
><guilabel
>Escriu les lletres accentuades</guilabel
> està disponible per al portuguès, el català, el portuguès i l'espanyol en el diàleg de configuració de &khangman;. Si la marqueu, llavors haureu d'escriure totes les vocals amb accent (com &atilde;). Però si resta sense marcar, quan escriviu qualsevol vocal, es mostraran totes sense importar si estan o no amb accent. </para>

</sect2>

<sect2 id="timers-settings">
<title
>Paràmetres Temporitzadors</title>
<para
>La pestanya de paràmetres <guilabel
>Temporitzadors</guilabel
> us permet establir <guilabel
>Temps durant el qual es mostra el rètol de Lletra ja intentada</guilabel
>. </para>

<screenshot>
<screeninfo
>Paràmetres de temps per a &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-timers.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Paràmetres de temps per a &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
><guilabel
>Temps durant el qual es mostra el rètol de Lletra ja intentada</guilabel
> us permet variar el temps per a mostrar el consell de lletres ja intentades. Aquest consell és un rètol que apareixerà quan trieu una lletra que ja s'ha provat. Alguna gent no el voldrà veure mentre que a la canalla li caldrà temps per aprendre. </para>

</sect2>

</sect1>

</chapter>

<chapter id="commands">
<title
>Referència d'ordres</title>

<sect1 id="khangman-mainwindow">
<title
>Menús i dreceres de teclat</title>

<sect2>
<title
>El menú <guimenu
>Joc</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Joc</guimenu
> <guimenuitem
>Nou</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Nou</action
> joc (&ead;, nova paraula)</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Joc</guimenu
> <guimenuitem
>Obre</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Obre</action
> un fitxer local per a jugar amb les paraules.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
> </shortcut
> <guimenu
>Joc</guimenu
> <guimenuitem
>Obté paraules en un idioma nou...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra</action
> el diàleg <guilabel
>Obtén novetats candents</guilabel
> la llista de totes les dades disponibles en els diferents idiomes. </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Joc</guimenu
> <guimenuitem
>Surt</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Surt</action
> de &khangman;</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>El menú <guimenu
>Categoria</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoria</guimenu
> <guimenuitem
>Animals</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Es <action
>tria</action
> la llista a endevinar de paraules d'animals.</para>
<para
>Totes les altres categories instal·lades també són mostrades com a elements en aquest menú.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoria</guimenu
> <guimenuitem
>Fàcil</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Es <action
>tria</action
> la llista a endevinar de paraules fàcils.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoria</guimenu
> <guimenuitem
>Mitjà</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Es <action
>tria</action
> la llista a endevinar de paraules de nivell mitjà.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoria</guimenu
> <guimenuitem
>Difícil</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Es <action
>tria</action
> la llista a endevinar de paraules difícils.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>El menú <guimenu
>Idioma</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Idioma</guimenu
> <guimenuitem
>Anglès</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Es <action
>tria</action
> l'idioma anglès per a les paraules a endevinar.</para>
<para
>Tots els altres idiomes instal·lats també són mostrats com a elements en aquest menú.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>El menú <guimenu
>Aspecte</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Aspecte</guimenu
> <guimenuitem
>Tema marí</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Es <action
>tria</action
> la imatge de fons marina i els colors de tipus de lletra associats</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Aspecte</guimenu
> <guimenuitem
>Tema hivernal</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Es <action
>tria</action
> la imatge de fons hivernal i els colors de tipus de lletra associats</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Aspecte</guimenu
> <guimenuitem
>Tema d'abelles</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Es <action
>tria</action
> la imatge de fons d'abelles i els colors de tipus de lletra associats</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Aspecte</guimenu
> <guimenuitem
>Tema desert</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Es <action
>tria</action
> la imatge de fons desert i els colors de tipus de lletra associats</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>El menú <guimenu
>Arranjament</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guisubmenu
>Barres d'eines mostrades</guisubmenu
> </menuchoice
></term>
<listitem
><para
><action
>Mostra o oculta</action
> les barres d'eines <guimenuitem
>Principal</guimenuitem
>, <guimenuitem
>Caràcters especials</guimenuitem
>, <guimenuitem
>Aspecte</guimenuitem
> i <guimenuitem
>Idioma</guimenuitem
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Arranjament</guimenu
> <guimenuitem
>Mostra el suggeriment</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra/Oculta</action
> els suggeriments.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Mostra la línia d'estat</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra o oculta</action
> la línia d'estat.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura dreceres...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Obre</action
> un diàleg d'opció estàndard de &kde; que us permet escollir diferents dreceres de teclat per a accions diferents. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura barres d'eines...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura</action
> els elements que voleu posar en la barra d'eines. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura &khangman;...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra</action
> el diàleg d'arranjament de &khangman;. </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title
>El menú <guimenu
>Ajuda</guimenu
></title>
&help.menu.documentation; </sect2>
</sect1>
</chapter>

<chapter id="developers">
<title
>Guia per a desenvolupadors de &khangman;</title>

<sect1 id="changing-words">
<title
>Com traduir paraules a un nou idioma per al joc</title>

<para
>Si us plau, seguiu el procediment i envieu-me els fitxer amb tar i comprimits amb gzip a &Anne-Marie.Mahfouf.mail;. </para>
<para
>Si us plau, feu un cop d'ull en &khangman; a l'opció <guimenuitem
>Obté paraules en un idioma nou...</guimenuitem
> en el menú <guimenu
>Joc</guimenu
> per a veure si el vostre idioma ja està disponible. Si és així, podeu mirar si ja conté <emphasis
>consells</emphasis
>. </para>
<para
>Les paraules estan desades en 4 fitxers separats, de manera que creen categories diferents. Els fitxers estan en <filename class="directory"
>/khangman/data/</filename
>. El fitxer <filename
>easy.kvtml</filename
> és per a la categoria fàcil, <filename
>medium.kvtml</filename
> és per a la categoria mitjà, <filename
>animals.kvtml</filename
> és per a la categoria d'animalons i <filename
>hard.kvtml</filename
> és per a la categoria difícil.</para>
<para
>L'anglès és l'idioma per omissió i és l'únic idioma inclòs amb &khangman;. Totes les altres dades d'idioma es troben en el mòdul kde-l10n corresponent. </para>
<procedure>
<step>
<para
>El fitxer usa el format kvtml. L'etiqueta <sgmltag class="starttag"
>text</sgmltag
> és per a la paraula i l'etiqueta <sgmltag class="starttag"
>comment</sgmltag
> és per al consell, totes dues dintre d'una etiqueta <sgmltag class="starttag"
>entry</sgmltag
>. Si us plau,intenteu fer coincidir el consell amb la categoria de dificultat. La categoria <guimenuitem
>Fàcil</guimenuitem
> requerirà un consell en conseqüència, de la mateixa manera la categoria <guimenuitem
>Difícil</guimenuitem
> potser requerirà ja la definició al diccionari. En el consell mireu de no emprar paraules dintre de la mateixa família, que puguin estar indicant amb facilitat de quina paraula es tracta!</para>

<para
>Tingueu en compte que haureu d'emprar la <emphasis role="bold"
>codificació UTF-8</emphasis
> per a editar els fitxers. Si el vostre editor no ho pot fer, proveu a usar el &kwrite; o el &kate;. Quan obriu un fitxer amb qualsevol d'aquests dos editors podeu seleccionar la codificació amb el quadre combinat que hi ha a la part superior del diàleg per obrir fitxers.</para>

<para
>El següent és un exemple d'un fitxer kvtml:</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;Animals&lt;/title&gt;&lt;!--Translate tag content--&gt;
    &lt;comment&gt;Animals from across the
planet&lt;/comment&gt;&lt;!--Translate tag content--&gt;
  &lt;/information&gt;
  &lt;identifiers&gt;
    &lt;identifier id="0" &gt;
      &lt;locale&gt;en&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;bear&lt;/text&gt;&lt;!--Translate all text tags
content--&gt;
        &lt;comment&gt;Large heavy animal with thick
fur&lt;/comment&gt;&lt;!--Translate all comment tags content--&gt;
      &lt;/translation&gt;
    &lt;/entry&gt;
...
&lt;/kvtml&gt;
</markup
></programlisting>
</step>
<step>
<para
>Al començament del fitxer, haureu de traduir el contingut de les etiquetes <sgmltag class="starttag"
>title</sgmltag
> i <sgmltag class="starttag"
>comment</sgmltag
> que resten dintre de l'etiqueta <sgmltag class="starttag"
>information</sgmltag
>. El títol serà el que apareixerà en el menú Categoria de la partida (a on l'usuari tria el fitxer amb el que juga). </para>
</step>
<step>
<para
>Després dintre de l'etiqueta <sgmltag class="starttag"
>identifier</sgmltag
>, si us plau, poseu-hi el codi d'idioma en comptes de «en» a l'etiqueta <sgmltag class="starttag"
>locale</sgmltag
>.</para>

<para
>Si us plau, no traduïu el nom de fitxer tanmateix com que aquests no hauran de contenir mai cap caràcter especial. De manera que deseu-lo amb el mateix nom que a l'anglès.</para>
</step>
<step>
<para
>Editeu els fitxers kvtml amb un editor de text (a poder ser que usi el ressaltat de la sintaxi &XML;) i substituïu cada paraula dintre de l'etiqueta <sgmltag class="starttag"
>text</sgmltag
> amb una traducció i cada consell dintre de l'etiqueta <sgmltag class="starttag"
>comment</sgmltag
> amb un consell que hi esdevingui com a adequat. No és realment important que signifiqui el mateix, però mireu de mantenir la llargada i el nivell de dificultat al llarg del mateix. </para
> 

<para
>Podeu incloure-hi paraules amb espais, guionets o punts volants, en aquest cas, aquests signes que no són lletres seran mostrats. Si us plau, contacteu amb mi si hi ha res especial relacionat al vostre idioma de manera que pugui adaptar el codi a aquest nou caràcter (especialment els caràcters especials i els accents). </para>
</step
>	

<step>
<para
>Simplement podeu traduir les paraules però després també les haureu d'adaptar a la categoria i afegir-n'hi de noves, si així ho voleu. Per exemple, «taula» és a la categoria fàcil en anglès però al vostre idioma aquesta podria ser de categoria mitjà. Trobeu-vos lliure d'adaptar els fitxers al que necessita el vostre idioma. El nombre de paraules en un fitxer no és important, se n'hi poden afegir tantes com es vulgui.</para>

<para
>Recordeu que totes les paraules són substantius.</para>

</step>

<step>
<para
>Després podreu fer commit dels vostres fitxers a <emphasis
>l10n-kde4/&lt;codi_idioma&gt;/data/kdeedu/khangman</emphasis
>. No oblideu actualitzar també el fitxer CMakeLists.txt. Si us plau, contacteu amb mi si necessiteu quelcom més d'informació. Envieu-me els fitxers, no us oblideu de fer menció a qualsevol <emphasis role="bold"
>caràcter especial</emphasis
> usat en el vostre idioma (poseu-los en un fitxer de text, un per línia i afegiu-lo a l'arxiu tar), i feu també menció a qualsevol altra peculiaritat.</para>
<para
><emphasis
>Si us plau, no publiqueu cap fitxer en una branca perquè podríeu fer petar el joc.</emphasis
></para>
</step>
</procedure>
<para
>Moltes gràcies per la vostra contribució!</para>
</sect1>

<sect1 id="internal">
<title
>Què desa &khangman; i a on</title>
<para
>Quan obteniu un nou idioma mitjançant <menuchoice
><guimenu
>Joc</guimenu
> <guimenuitem
>Obté paraules en un idioma nou...</guimenuitem
></menuchoice
> es desaran dites dades a <filename class="directory"
>$KDEHOME/share/apps/kvtml/</filename
> a la carpeta de codi d'idioma. També es desen els noms de carpeta dels idiomes disponibles en el fitxer de configuració de &khangman; en <filename
>$KDEHOME/share/config/khangmanrc</filename
>. </para>
<para
>El nom proveït (&ead;, l'adreça del lloc web des d'on descarregar els nous idiomes) és desat a <filename
>$KDEDIR/share/apps/khangman/khangmanrc</filename
>. </para>
<para
>L'idioma anglès (per omissió) i l'idioma de l'usuari des del seu paquet i18n (si està disponible) són desats en <filename class="directory"
>$KDEDIR/share/apps/kvtml</filename
>. </para>
<para
>En el fitxer de configuració, desat per a cada usuari en el seu propi <filename
>$KDEHOME/share/config/khangmanrc</filename
> es desen tots els paràmetres de joc com el fons, i l'ultima categoria jugada... a més de a on s'han desat els fitxers des del diàleg <guilabel
>Obtén novetats candents</guilabel
>. </para>
</sect1>
</chapter>

<chapter id="faq">
<title
>Preguntes i respostes</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Un missatge d'error m'informa que no es troben les imatges.</para>
</question>
<answer>
<para
>El joc s'instal·la per omissió en <filename class="directory"
>/usr/local/kde</filename
>, de manera que haureu d'afegir <filename class="directory"
>/usr/local/kde/bin</filename
> a la vostra PATH i establir la variable d'entorn <envar
>KDEDIR</envar
> a <filename class="directory"
>/usr/local/kde</filename
> abans d'executar el joc. Una forma senzilla és configurar &khangman; amb l'opció <option
>--prefix</option
>=$<envar
>KDEDIR</envar
> a on $<envar
>KDEDIR</envar
> és el lloc en el que està instal·lada la resta de &kde;. Aquest lloc pot variar depenen de la distribució i el sistema operatiu que estigueu emprant. És millor instal·lar &khangman; des de la vostra distribució!</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>&khangman; no s'engega correctament després d'una actualització a la versió &kde; 4</para>
</question>
<answer>
<para
>Això es podria deure als canvis en el fitxer de configuració. Si us plau, esborreu el fitxer <filename
>khangmanrc</filename
> en la vostra carpeta <filename class="directory"
>$KDEHOME/share/config</filename
>. </para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title
>Crèdits i llicència</title>

<para
>&khangman; </para>
<para
>Copyright del programa 2001-2007 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; </para>
<para
>Col·laboradors: <itemizedlist>
<listitem
><para
>Gràfics del penjat: Renaud Blanchard <email
>kisukuma@chez.com</email
></para
> </listitem>
<listitem
><para
>Sons: Ludovic Grossard <email
>ludovic.grossard@libertysurf.fr</email
></para
> </listitem>
<listitem
><para
>Antic mantenidor: &Primoz.Anzur; &Primoz.Anzur.mail;</para
> </listitem>
<listitem
><para
>Fitxer de dades en suec, ajuda en la programació, imatges transparents i correccions a la i18n: Stefan Asserhäll <email
>stefan.asserhall@telia.com</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en espanyol: eXParTaKus <email
>expartakus@expartakus.com</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en alemany: Rafael Beccar <email
>rafael.beccar@kdemail.net</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en danès: Erik Kjaer Pedersen <email
>erik@mpim-bonn.mpg.de</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en finès: Niko Lewman <email
>niko.lewman@edu.hel.fi</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en portuguès brasiler: João Sebastião de Oliveira Bueno <email
>gwidion@mpc.com.br</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en català: &credits.Antoni.Bella;</para
> </listitem>
<listitem
><para
>Fitxers de dades en italià: Giovanni Venturi <email
>jumpyj@tiscali.it</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en neerlandès: Rinse <email
>rinse@kde.nl</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en portuguès: Pedro Morais <email
>morais@kde.org</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en serbi (ciríl·lic i llatí): Chusslove Illich <email
>chaslav@sezampro.yu</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en eslovè: Jure Repinc <email
>jlp@holodeck1.com</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en txec: Luk&aacute;&scaron; Tinkl <email
>lukas@kde.org</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en tajik: Roger Kovacs <email
>rkovacs@khujand.org</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en noruec (Bokm&#229;l): Torger &#197;ge Sinnes <email
>torg-a-s@online.no</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en hongarès: Tamas Szanto <email
>tszanto@mol.hu</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en noruec (Nynorsk): Gaute Hvoslef Kvalnes <email
>gaute@verdsveven.com</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en turc: Mehmet &Ouml;zel <email
>mehmet_ozel2003@hotmail.com</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en búlgar: Radostin Radnev <email
>radnev@yahoo.com</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en irlandès (gaèl·lic): Kevin Patrick Scannell <email
>scannell@slu.edu</email
></para
> </listitem>
<listitem
><para
>Ajuda en la programació: &Robert.Gogolok; &Robert.Gogolok.mail;</para
> </listitem>
<listitem
><para
>Ajuda en la programació: Benjamin Meyer <email
>ben@meyerhome.net</email
></para
> </listitem>
<listitem
><para
>Correccions en el codi: Lubos Lun&agrave;k <email
>l.lunak@kde.org</email
></para
> </listitem>
<listitem
><para
>Correccions en el codi: Albert Astals Cid &Albert.Astals.Cid.mail;</para
> </listitem>
<listitem
><para
>Estudi d'usabilitat: Celeste Paul <email
>seele@obso1337.org</email
></para
> </listitem>
</itemizedlist>
</para>

<para
>Copyright de la documentació 2001-2007 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; </para>

<para
>Traductor de la documentació: &credits.Antoni.Bella;</para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instal·lació</title>

<sect1 id="getting-khangman">
<title
>Com obtenir &khangman;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Compilació i instal·lació</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:
-->
