<?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 lang="&language;">

<bookinfo>
<title
>El manual de &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
>2003-10-15</date>
<releaseinfo
>1.3</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. Té quatre nivells de dificultat: Animals (norms d'animals), Fàcil, Medi i Difícil. S'escull una paraula aleatoriament, 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 pengat! Disposareu de 10 intents. </para>
<para
>El meu fill Joachim de 9 anys hem va donar la idea d'aquest joc al juny de 2000. </para>

</chapter>

<chapter id="using-khangman">
<title
>Ús de &khangman;</title>

<screenshot>
<screeninfo
>Aquesta és una instantània de &khangman; quan l'inicieu per primera vegada</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman1.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Instantània de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Aquí podeu veure l'aspecte de &khangman; la primera vegada que s'executa. El nivell és «Fàcil», l'idioma és el per omissió (català en aquest cas), no hi ha tema de fons i les imatges del penjat no són transparents. Qualsevol canvi que feu en el nivell, idioma o fons serà desat 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 nivell i el fons, si­mplement clicant a sobre de les llistes despleables de la barra d'eines. Obtenir una nova paraula i sortir del joc també resulta fàcil clicant a sobre del corresponent botó de la barra d'eines. </para>

<sect1 id="general-usage">
<title
>El seu ús en general</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
>Es mostra una paraula amb les lletres ocultes. S'ha d'endevinar la mateixa provant una lletra rere l'altra. La paraula s'escull aleatoriament i aquesta no sortirà dues vegades consecutives.</para>

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

<para
>No té importància el que escriviu les lletres en majúscules o minúscules. El programa les converteix a minúscules, a excepció de a l'alemany en que repecta les paraules que comencin per majúscula. El programa farà això automàticament. </para>

<para
>El nivell i idioma actuals són mostrats a la línia d'estat. </para>
<para
>Cada vegada que entreu una lletra que no estiga 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 nivells: fàcil, mitjà, difícil i animals a més d'altres tòpics en alguns idiomes. El programa cerca tots els fitxers de dades disponibles per a tots els idiomes. </para>
<para
>En el nivell 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. El nivell 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 el nivell mitjà les paraules són més llargues i amb més dificultat. Adequat per a nens majors de 9 anys. El nivell difícil és... difícil, &ead;, les paraules són complicades de lletrejar i no gaire conegudes. Aquest nivell és un repte fins i tot per als adults. </para>

<para
>Una vegada que s'hagi endevinat una paraula (o el penjat s'hagi completat), se us demanarà si voleu seguir jugant i podreu respondre amb les tecles <keycap
>S</keycap
> o <keycap
>N</keycap
>, o clicant amb el ratolí per a respondre sí o no. Si responeu <guilabel
>No</guilabel
>, es sortirà del joc. Si responeu <guilabel
>Sí</guilabel
>, apareixerà una altra paraula a punt per a ser endevinada. </para>

<!-- FIXME: should we call it 'field' or 'text edit' or...? -->
<para
>Heu d'escriure la lletra que voleu provar en el camp d'entrada (el cursor del ratolí ja es troba allí) i prémer la tecla &Intro;. Si la lletra pertany a la paraula, es situa al seu lloc, tantes vegades com sigui necessari. Si la lletra no pertany a la paraula, es situa al camp d'errades i es dibuixa una part més del penjat. Disposeu de deu intents abans de perdre la partida i mostrar-vos la paraula correcta. </para>

<para
>Durant el joc, podreu escollir l'iniciar una nova partida seleccionant en el menú <guimenu
>Joc</guimenu
> l'opció <guimenuitem
>Nova</guimenuitem
> o clicant a sobre de la icona <guiicon
>Nova</guiicon
> de la barra d'eines. També podreu canviar el nivell usant el botó de nivell de la barra d'eines (això farà que aparegui una nova paraula per al nou nivell).</para>

<para
>Futures millores us permetran crear els vostres propis fitxers de paraules o carregar-ne un de diferent dels quatre que hi venen inclosos. </para>

<para
>És possible jugar a &khangman; en dotze idiomes: català, danès, holandès, anglès, finès, francès, alemany, brasiler portuguès, italià, portuguès, espanyol i suec. Podeu canviar-lo fàcilment mitjançant el menú <guimenu
>Idiomes</guimenu
>. </para>

<para
>Si us plau, tingueu present que ara podeu escriure els caràcters especials per a un idioma en concret mostrant-los com a botons amb l'opció <interface
>Barra d'eines caràcters especials</interface
>. Aquesta barra d'eines manté uns botons amb una icona per a cada caràcter especial, com per exemple la &eacute; en francès. Clicant a sobre del botó amb dit caràcter s'escriurà la lletra corresponent en la línia d'entrada i llavores l'haureu de validar prement &Intro;. Per descomptat també podreu usar la disposició del teclat corresponent a dir 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>

</sect1>
<sect1 id="few-tips">
<title
>Uns quants consells</title>
<para
>Primer intenteu endevinar les vocals. Llavores 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 un <quote
>io</quote
>, 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 <quote
>a</quote
> accentuades seran mostrades automàticament amb l'accent quan escriviu <quote
>a</quote
>. Això serà així mentre l'opció <menuchoice
><guimenu
>Arranjament</guimenu
><guimenuitem
>Escriu les lletres accentuades</guimenuitem
></menuchoice
> estigui sense marcar. Si ho està, llavores haureu d'escriure les lletres accentuades vosaltres mateixos. Quan escriviu <quote
>a</quote
>, sols es mostrarà <quote
>a</quote
> i quan escriviu &atilde; es mostarà 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ú i barra d'eines</title>

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

<para
>El menú <guimenu
>Joc</guimenu
> té dos ítems <guimenuitem
>Nova</guimenuitem
> i <guimenuitem
>Abandona</guimenuitem
>.</para>

<para
><guimenuitem
>Nova</guimenuitem
> obrirà una nova partida, &ead;, us presenta una nova paraula a endevinar, en el mateix nivell en el que us trobeu. Amb <guimenuitem
>Abandona</guimenuitem
> es sortirà del joc tancant la finestra principal i desant les preferències actuals en el fitxer de configuració.</para>

<para
>El menú <guimenu
>Idiomes</guimenu
> conté dotze ítems: <guimenuitem
>portuguès brasiler</guimenuitem
>, <guimenuitem
>català</guimenuitem
>, <guimenuitem
>danès</guimenuitem
>, <guimenuitem
>holandès</guimenuitem
>, <guimenuitem
>anglès</guimenuitem
>, <guimenuitem
>finès</guimenuitem
>, <guimenuitem
>francès</guimenuitem
>, <guimenuitem
>alemany</guimenuitem
>, <guimenuitem
>italià</guimenuitem
>, <guimenuitem
>portuguès</guimenuitem
>, <guimenuitem
>espanyol</guimenuitem
> i <guimenuitem
>suec</guimenuitem
>. Per omissió, si el vostre idioma al &kde; és un dels dotze, aquest serà seleccionat de forma predeterminada, d'altra manera sortirà seleccionat l'anglès. Després de la primera partida, l'últim idioma que hageu seleccionat serà el que romandrà actiu en tornar a usar &khangman;. </para>
<para
>El menú <guimenuitem
>Arranjament</guimenuitem
> us permet configurar &khangman; de forma 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 dues barres d'eines: la principal que és la que apareix a dalt de tot amb els botons i les llistes desplegables, i la de <interface
>Caràcters especials</interface
>, que quan es mostra apareixerà 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 tenir que configurar una nova disposició del teclat. Cliqueu a sobre d'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ó, per a que sigui reestablerta la següent vegada que entreu a &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ú de context, aquest us permetrà escollir diferents opcions per a dita barra d'eines. </para>
</tip>
<para
><guimenuitem
>Configura dreceres...</guimenuitem
> és una opció estàndard del &kde;, aquesta 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
>Abandona</guimenuitem
> (sortir de l'aplicació).</para>
<para
><guimenuitem
>Configura barres d'eines...</guimenuitem
> també és un ítem de menú estàndard del &kde;, aquest us permetrà afegir o suprimir ítems des de la barra d'eines. Quan es marqui <guimenuitem
>Mode pantalla sensera</guimenuitem
>, lògicament us portarà l'aplicació al mode a pantalla sensera, amb tan sols la barra d'eines a la part superior i el &khangman; ocupant tot l'escriptori. Sobre la barra d'eines principal podreu veure la icona <guiicon
>Surt mode pantalla sensera</guiicon
>, la qual us permetrà tornar a la mida de finestra que tenieu abans.</para>

<para
>Amb <guimenuitem
>Imatges transparents</guimenuitem
> s'indica si voleu tenir imatges transparents del penjat, això dependrà de si teniu marcada dita opció o no.</para>

<para
>Amb <guimenuitem
	>Imatges usaus del penjat</guimenuitem
> s'indica si voleu tenir unes imatges més suaus per al penjat. Això vol dir que no es penja a l'home sinó que està penjant de la corda agafant-la amb la mà. Això és força més adequat per a nens més joves.</para>

<para
><guimenuitem
>Escriure les lletres accentuades</guimenuitem
> és un mode que sols està disponible per al català, brasiler portuguès i espanyol. Si està marcada, llavores l'usuari haurà d'escriure les lletres amb accents (com &atilde;) per a que es reconegui aquesta. Si no aquesta opció no està marcada, llavores en triar una vocal normal també es descobriran totes les accentuades, per exemple triant <quote
>a</quote
> també es descobrirà &atilde;, sempre que siguin presents a la paraula.</para>

<para
><guimenuitem
>Habilita consells</guimenuitem
>, de moment sols és disponible en francès i italià. Si maqueu aquesta opció en aquests dos idiomes, podreu clicar amb el &BDR; a qualsevol lloc de la partida i obtindreu un consell que es mostrarà durant quatre segons. Aquest us ajudarà a endevinar la paraula.</para>

<para
>Si us plau, tingueu en compte que les imatges transparents per al penjat no estan disponibles en el mode Sense fons. La transparència només estarà disponible amb una imatge de fons. Per omissió, la transparència romà habilitada.</para>

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

<para
>Aquí teniu &khangman; amb el tema Blau, imatges transparents del penjat, i l'idioma Català amb el nivell Fàcil. Aquí es mostren els <interface
>caràcters</interface
> de la barra d'eines.</para>

<para
>El nivell s'escull amb una llista desplegable i disposeu de fàcil, mitjà, animals i difícil. Fàcil està relacionat als objectes comuns que pot conèixer un nen de sis o set anys. El mitjà és un pel més desafiant, el difícil és realment difícil i animals tan sols són noms d'animals. </para>

<para
>Les paraules són substantius. Ni verbs, ni adjectius. El nivell escollit és el que es mostra a la línia d'estat.</para>
<para
>En el camp d'entrada tan sols està permés d'escriure-hi lletres</para>
</sect1>
</chapter>

<chapter id="commands">
<title
>Referència de comadaments</title>

<sect1 id="khangman-mainwindow">
<title
>Tecles dels menús i dreceres</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
>Nova</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Nova</action
> partida (&ead;, nova paraula)</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Joc</guimenu
> <guimenuitem
>Abandona</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Surt</action
> de &khangman;</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

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

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Idiomes</guimenu
> <guimenuitem
>«els idiomes»</guimenuitem
> </menuchoice
></term>
<listitem
><para
>S'<action
>escull</action
> l'idioma en qüestió per a les paraules</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

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

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Barres d'eines</guimenuitem
> <guimenuitem
> Mostra Principal</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Oculta/mostra</action
> la barra d'eines principal</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Barres d'eines</guimenuitem
> <guimenuitem
> Mostra els caràcters especials</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Oculta/mostra</action
> la barra d'eines amb els caràcters especials</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Mostra línia d'estat</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Oculta/mostra</action
> la línia d'estat</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>T</keycap
></keycombo
> </shortcut
> <guimenu
>Arranjament</guimenu
> <guimenuitem
>Imatges transparents</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Oculta/mostra</action
> la transparència per a les imatges del penjat </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Arranjament</guimenu
> <guimenuitem
>Imatges suaus del penjat</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Oculta/mostra</action
> les imatges suaus/originals del penjat </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>A</keycap
></keycombo
> </shortcut
> <guimenu
>Arranjament</guimenu
> <guimenuitem
>Escriu les lletres accentuades</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Us permet escriure les lletres accentuades en els idiomes: brasiler portuguès, català, portuguès i espanyol. </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Arranjament</guimenu
> <guimenuitem
>Habilita consells</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Us permetrà veure un consell sobre el clic dret (tan sols en francès i Italià) </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Majús.</keycap
><keycap
>F</keycap
></keycombo
> </shortcut
> <guimenu
>Arranjament</guimenu
> <guimenuitem
>Mode pantalla sensera</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Oculta/mostra</action
> el mode a pantalla sensera </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura dreceres...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura</action
> les tecles que usareu per accedir a les diferents accions.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura barres d'eines...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura</action
> els ítems que desitgeu posar a la barra d'eines </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 afegir paraules en un nou idioma per al joc</title>

<para
>Gràcies a en Stefan Asserhäll, és realment fàcil afegir un nou idioma directament al joc. El procediment que es descriu aquí també pot trobar-se en el fitxer <filename
>README.languages</filename
> que hi ha a la carpeta <filename class="directory"
>khangman</filename
> que es troba a les fonts originals. De tota manera ja hi ha dotze idiomes i és d'esperar que la cosa es compliqui considerablement en afegir-hi d'altres, doncs el menú es farà massa llarg. Si us plau, seguiu el procediment aquí descrit en comptes d'enviar-me'ls en un fitxer compremut. D'aquesta manera farem que estigui disponible a la pàgina web de &khangman;. Per al proper llançament de &khangman; (amb el &kde; 3.3) aquest tindrà un assistent per a descarregar i instal·lar nous idiomes amb facilitat. </para>

<para
>Es descarrega l'última versió CVS de &khangman;. Les pareaules estan desades en 4 fitxers separats, un per a cada nivell. Els fitxers estan en <filename class="directory"
>/khangman/data/codi_idioma</filename
>. El fitxer <filename
>easy.txt</filename
> és per al nivell fàcil, <filename
>medium.txt</filename
>és per al nivell mitjà, <filename
>animals.txt</filename
> és per al nivell d'animalons i <filename
>hard.txt</filename
> és per al nivell difícil.</para>

<procedure>
<step
><para
>Introduïu els següents comandaments en una &konsole; per a crear la carpeta i els fitxers per al nou idioma:</para>
<!-- Do not wrap or indent the next line, it's white space sensitive -->
<screen
><userinput
><command
>./add_language <replaceable
>codi_idioma</replaceable
></command
></userinput
></screen>
<para
>Aquí haureu de substituir <replaceable
>codi_idioma</replaceable
> pel codi real del vostre idioma.</para>
</step>
<step>
<para
>Editeu tots els fitxers de text indicats en la nova carpeta amb un editor de text i substituïu cada paraula per una paraula traduïda. No és realment important que es conservi el significat exacte, tan sols intenteu que la longitud i el nivell de dificultat siguin similars.</para
> 

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

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

<para
>Tingueu en compte que haureu d'emprar el codificat UTF-8 per a editar els fitxers. Si el vostre editor no pot fer-ho, intenteu-ho usant &kwrite; o &kate;. Quan obriu un fitxer amb qualsevol d'aquests dos editors podeu seleccionar el codificat amb la llista desplegable que hi ha a la part superior del diàleg per obrir fitxers.</para>

<para
>Si us plau, mantingueu els noms de fitxer actuals (en anglès) en el vostre directori <replaceable
>codi_idioma</replaceable
>.</para>
</step>

<step>
<para
>Introduïu el següent comandament per a instal·lar els nous fitxers de dades:</para>
<screen
><userinput
><command
>make</command
></userinput>
<userinput
><command
>make install</command
></userinput
></screen>

<para
>Haureu d'accedir com a <systemitem class="username"
>root</systemitem
> i executar <command
>make install</command
>, depenent de la vostra instal·lació.</para>
</step>
<step>
<para
>Executar el joc i comprovar que el vostre idioma ha estat afegit correctament:</para>
<screen
><userinput
><command
>khangman</command
></userinput
></screen>
</step>
<step
><para
>Publicar al servidor de CVS els fitxers per al nou idioma amb el següent comandament:</para>
<screen
><userinput
><command
>cvs commit -m "Added new language <replaceable
>nom_del_vostre_idioma</replaceable
>"</command
></userinput
></screen>
</step>
</procedure>

<para
>Si usted voleu disposar de consells en el nou idioma, haureu de treballar unamica més. Haureu d'usar el format de kvtml, el millor és fer un cop d'ull a les dades per al francès o l'italià. L'etiqueta <sgmltag class="starttag"
>o</sgmltag
> és per a la paraula i l'etiqueta <sgmltag class="starttag"
>t</sgmltag
> és per al respectiu consell. Mireu d'emparellar dit consell amb el nivell de dificultat en el que es troba dita paraula. El nivell <quote
>Fàcil</quote
> requereix d'un consell fàcil però ja en el nivell <quote
>Difñicil</quote
> es pot emprar una definició de disccionari. Intenteu no usar paraules de la mateixa família en el consell, això resultaria realment contradictori en resultar molt fàcil de resoldre!</para>

<para
>El següent és un exemple d'un fitxer kvtml:</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;cane&lt;/o&gt; 
&lt;t&gt;&egrave; il tuo animale domestico preferito&lt;/t&gt; 
&lt;/e&gt; 
...
...
&lt;/kvtml&gt;
</markup
></programlisting>


</sect1>
<sect1 id="planned-features">
<title
>Característiques planejades per a &khangman;</title>

<para
>Atès que el nombre d'idiomes s'incrementa amb molta celeritat es fa necessari l'aturar l'afegiment directe al programa. Planegem només tenir-hi alguns idiomes tals com l'anglès, francès, l'alemany i l'espanyol entregats amb la distribució de &khangman; i els altres restaran disponibles en el modul de i18n, tanmateix &khangman; els podrà descarregar a petició de l'usuari mitjançant l'ús de la classe <classname
>KNewStuff</classname
> per a tenir un assistent que permeti a l'usuari descarregar i instal·lar amb facilitat alguns idiomes addicionals. Això també es farà per a &klettres; i &kstars;, atès que no desitgem augmentar la mida del modul del &package;. </para>
<para
>Una altra característica planejada és per descomptat el tenir consells en cada idioma. </para>
<para
>El que també podeu fer és usar d'altres fitxers de kvtml com els que estan en el lloc web de KDE-Edu per a jugar amb &khangman;. Per exemple, imagineu-vos que sabeu jugar a les capitals del món, el consell us dirà el país i vosaltres haureu d'endevinar la capital. O apreneu les paraules en un altre idioma, el consell per a la paraula serà en el vostre idioma, la paraula a endevinar serà la traducció en el nou idioma. </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 de 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 per omissió 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.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>&khangman; no s'engega correctament després d'una actualització a una de les versions de &kde;-3.2</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"
>$HOME/.kde/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-2003 Anne-Marie Mahfouf <email
>annma AT kde DOT org</email
> </para>
<para
>Col·laboradors: <itemizedlist>
<listitem
><para
>Gràfics del penjat: 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 blau, icones i codi: Primoz Anzur <email
>zerokode AT yahoo DOT com</email
></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 DOT asserhall AT telia DOT com </email
></para
> </listitem>
<listitem
><para
>Tema natura: Joe Bolin <email
>jbolin AT users DOT sourceforge DOT net</email
></para
> </listitem>
<listitem
><para
>Imatges suaus del penjat: Matt Howe <email
>mdhowe AT bigfoot DOT com</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en espanyol: eXParTaKus <email
>expartakus AT expartakus DOT com</email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en danès: Erik Kjaer Pedersen <email
>erik AT mpim-bonn DOT mpg DOT de </email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en finès: Niko Lewman <email
>niko DOT leman AT edu DOT hel DOT fi </email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en portuguès brasiler: João Sebastião de Oliveira Bueno <email
>gwidion AT mpc DOT com DOT br </email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en català: Antoni Bella <email
>bella5 AT teleline DOT es </email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en italià: Giovanni Venturi <email
>jumpyj AT tiscali DOT it </email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en alemany: Rinse <email
>rinse AT kde DOT nl </email
></para
> </listitem>
<listitem
><para
>Fitxers de dades en portuguès: Pedro Morais <email
>morais AT kde DOT org </email
></para
> </listitem>
<listitem
><para
>Ajuda en la programació: Robert Gogolok <email
>robertgogolok AT gmx DOT de</email
></para
> </listitem>
<listitem
><para
>Ajuda en la programació: Benjamin Meyer <email
>ben AT meyerhome DOT net</email
></para
> </listitem>
<listitem
><para
>Correccions en el codi : Lubos Lun&agrave;k <email
>l.lunak AT kde DOT org</email
></para
> </listitem>
<listitem
><para
>Correccions en el codi : Albert Astals Cid <email
>tsdgeos AT terra DOT es</email
></para
> </listitem>
</itemizedlist>
</para>

<para
>Copyright de la documentació 2001-2003 Anne-Marie Mahfouf <email
>annma AT kde DOT org</email
> </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:
-->
