# El manual de &khangman;

## Introducció

&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.

El meu fill Joachim de 9 anys hem va donar la idea d'aquest joc al juny de 2000.

## Ús de &khangman;

Aquesta és una instantània de &khangman; quan l'inicieu per primera vegada Instantània de &khangman;

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.

Si us plau, tingueu present el fàcil que resulta canviar el nivell i el fons, simplement 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.

### El seu ús en general

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.

Totes les paraules són substantius (ni verbs ni adjectius, &etc;).

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.

El nivell i idioma actuals són mostrats a la línia d'estat.

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.

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.

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.

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 S o N, o clicant amb el ratolí per a respondre sí o no. Si responeu No, es sortirà del joc. Si responeu Sí, apareixerà una altra paraula a punt per a ser endevinada.

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.

Durant el joc, podreu escollir l'iniciar una nova partida seleccionant en el menú Joc l'opció Nova o clicant a sobre de la icona Nova 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).

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

É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ú Idiomes.

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ó Barra d'eines caràcters especials. Aquesta barra d'eines manté uns botons amb una icona per a cada caràcter especial, com per exemple la é 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;.

### Uns quants consells

Primer intenteu endevinar les vocals. Llavores proveu-ho amb les consonants més comuns: l, t, r, n, s

En els idiomes francès i anglès; si veieu un io, tot seguit proveu amb una n.

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ó Arranjament Escriu les lletres accentuades estigui sense marcar. Si ho està, llavores haureu d'escriure les lletres accentuades vosaltres mateixos. Quan escriviu a, sols es mostrarà a i quan escriviu ã es mostarà aquesta lletra.

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%).

## Barra de menú i barra d'eines

### La finestra principal de &khangman;

El menú Joc té dos ítems Nova i Abandona.

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

El menú Idiomes conté dotze ítems: portuguès brasiler, català, danès, holandès, anglès, finès, francès, alemany, italià, portuguès, espanyol i suec. 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;.

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

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 Caràcters especials, 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;.

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.

Configura dreceres... és una opció estàndard del &kde;, aquesta us permetrà escollir diferents dreceres de teclat per a diferents accions. Per exemple, &Ctrl;Q és la drecera estàndard per Abandona (sortir de l'aplicació).

Configura barres d'eines... 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 Mode pantalla sensera, 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 Surt mode pantalla sensera, la qual us permetrà tornar a la mida de finestra que tenieu abans.

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

Amb Imatges usaus del penjat 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.

Escriure les lletres accentuades é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 ã) 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 a també es descobrirà ã, sempre que siguin presents a la paraula.

Habilita consells, 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.

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.

Tema blau de &khangman; Tema blau de &khangman;

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

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.

Les paraules són substantius. Ni verbs, ni adjectius. El nivell escollit és el que es mostra a la línia d'estat.

En el camp d'entrada tan sols està permés d'escriure-hi lletres

## Referència de comadaments

### Tecles dels menús i dreceres

#### El menú Joc

&Ctrl;N Joc Nova

- Nova partida (&ead;, nova paraula)

&Ctrl;Q Joc Abandona

- Surt de &khangman;

#### El menú Idiomes

Idiomes «els idiomes»

- S'escull l'idioma en qüestió per a les paraules

#### El menú Arranjament

Arranjament Barres d'eines Mostra Principal

- Oculta/mostra la barra d'eines principal

Arranjament Barres d'eines Mostra els caràcters especials

- Oculta/mostra la barra d'eines amb els caràcters especials

Arranjament Mostra línia d'estat

- Oculta/mostra la línia d'estat

&Ctrl;T Arranjament Imatges transparents

- Oculta/mostra la transparència per a les imatges del penjat

&Ctrl;S Arranjament Imatges suaus del penjat

- Oculta/mostra les imatges suaus/originals del penjat

&Ctrl;A Arranjament Escriu les lletres accentuades

- Us permet escriure les lletres accentuades en els idiomes: brasiler portuguès, català, portuguès i espanyol.

&Ctrl;H Arranjament Habilita consells

- Us permetrà veure un consell sobre el clic dret (tan sols en francès i Italià)

&Ctrl;Majús.F Arranjament Mode pantalla sensera

- Oculta/mostra el mode a pantalla sensera

Arranjament Configura dreceres...

- Configura les tecles que usareu per accedir a les diferents accions.

Arranjament Configura barres d'eines...

- Configura els ítems que desitgeu posar a la barra d'eines

#### El menú Ajuda

&help.menu.documentation;

## Guia per a desenvolupadors de &khangman;

### Com afegir paraules en un nou idioma per al joc

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 `README.languages` que hi ha a la carpeta `khangman` 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.

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 `/khangman/data/codi_idioma`. El fitxer `easy.txt` és per al nivell fàcil, `medium.txt`és per al nivell mitjà, `animals.txt` és per al nivell d'animalons i `hard.txt` és per al nivell difícil.

1. Introduïu els següents comandaments en una &konsole; per a crear la carpeta i els fitxers per al nou idioma:

       ./add_language codi_idioma

   Aquí haureu de substituir `codi_idioma` pel codi real del vostre idioma.

2. 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.

   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, taula é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.

   Recordeu que totes les paraules són substantius.

   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.

   Si us plau, mantingueu els noms de fitxer actuals (en anglès) en el vostre directori `codi_idioma`.

3. Introduïu el següent comandament per a instal·lar els nous fitxers de dades:

       make
       make install

   Haureu d'accedir com a `root` i executar `make install`, depenent de la vostra instal·lació.

4. Executar el joc i comprovar que el vostre idioma ha estat afegit correctament:

       khangman

5. Publicar al servidor de CVS els fitxers per al nou idioma amb el següent comandament:

       cvs commit -m "Added new language nom_del_vostre_idioma"

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 `o` és per a la paraula i l'etiqueta `t` és per al respectiu consell. Mireu d'emparellar dit consell amb el nivell de dificultat en el que es troba dita paraula. El nivell Fàcil requereix d'un consell fàcil però ja en el nivell Difñicil 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!

El següent és un exemple d'un fitxer kvtml:

    <?xml version="1.0"?>
    <!DOCTYPE kvtml SYSTEM "kvoctrain.dtd">
    <kvtml>
    <e>
    <o>cane</o>
    <t>è il tuo animale domestico preferito</t>
    </e>
    ...
    ...
    </kvtml>

### Característiques planejades per a &khangman;

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 `KNewStuff` 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;.

Una altra característica planejada és per descomptat el tenir consells en cada idioma.

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.

## Preguntes i respostes

&reporting.bugs; &updating.documentation;

Un missatge d'error m'informa de que no es troben les imatges.

El joc s'instal·la per omissió en `/usr/local/kde`, de manera que haureu d'afegir `/usr/local/kde/bin` a la vostra PATH per omissió i establir la variable d'entorn `KDEDIR` a `/usr/local/kde` abans d'executar el joc. Una forma senzilla és configurar &khangman; amb l'opció `--prefix`=$`KDEDIR` a on $`KDEDIR` é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.

&khangman; no s'engega correctament després d'una actualització a una de les versions de &kde;-3.2

Això es podria deure als canvis en el fitxer de configuració. Si us plau, esborreu el fitxer `khangmanrc` en la vostra carpeta `$HOME/.kde/share/config`.

## Crèdits i llicència

&khangman;

Copyright del programa 2001-2003 Anne-Marie Mahfouf annma AT kde DOT org

Col·laboradors:

- Gràfics del penjat: Renaud Blanchard kisukuma AT chez DOT com

- Sons: Ludovic Grossard ludovic.grossard AT libertysurf DOT fr

- Tema blau, icones i codi: Primoz Anzur zerokode AT yahoo DOT com

- Fitxer de dades en suec, ajuda en la programació, imatges transparents i correccions a la i18n: Stefan Asserhäll stefan DOT asserhall AT telia DOT com

- Tema natura: Joe Bolin jbolin AT users DOT sourceforge DOT net

- Imatges suaus del penjat: Matt Howe mdhowe AT bigfoot DOT com

- Fitxers de dades en espanyol: eXParTaKus expartakus AT expartakus DOT com

- Fitxers de dades en danès: Erik Kjaer Pedersen erik AT mpim-bonn DOT mpg DOT de

- Fitxers de dades en finès: Niko Lewman niko DOT leman AT edu DOT hel DOT fi

- Fitxers de dades en portuguès brasiler: João Sebastião de Oliveira Bueno gwidion AT mpc DOT com DOT br

- Fitxers de dades en català: Antoni Bella bella5 AT teleline DOT es

- Fitxers de dades en italià: Giovanni Venturi jumpyj AT tiscali DOT it

- Fitxers de dades en alemany: Rinse rinse AT kde DOT nl

- Fitxers de dades en portuguès: Pedro Morais morais AT kde DOT org

- Ajuda en la programació: Robert Gogolok robertgogolok AT gmx DOT de

- Ajuda en la programació: Benjamin Meyer ben AT meyerhome DOT net

- Correccions en el codi : Lubos Lunàk l.lunak AT kde DOT org

- Correccions en el codi : Albert Astals Cid tsdgeos AT terra DOT es

Copyright de la documentació 2001-2003 Anne-Marie Mahfouf annma AT kde DOT org

&underFDL; &underGPL;

## Instal·lació

### Com obtenir &khangman;

&install.intro.documentation;

### Compilació i instal·lació

&install.compile.documentation;
&documentation.index;