# El manual del &khangman;

## Introducció

El &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 per jugar-hi: Animals (noms d'animals), Roba, Ordinadors, Monedes, Fàcil i Fruites. 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.

## Usar &khangman;

Aquesta és una captura de pantalla de &khangman; quan l'inicieu per primera vegada Captura de pantalla de &khangman;

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

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

### Ús general

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. Escriviu la lletra amb el teclat o seleccioneu-la amb el &BER;. Si la lletra pertany a la paraula, el color de fons de la lletra canviarà a verd, en cas contrari a vermell.

Les tecles de lletra a la finestra de joc permeten jugar al &khangman; en idiomes estrangers sense canviar la vostra disposició del teclat.

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

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

Si necessiteu ajuda per esbrinar la paraula, podeu fer clic sobre la icona de la barra d'eines i es mostrarà el consell relacionat perquè agafeu alguna idea sobre la paraula en qüestió. Feu clic en aquesta icona per a ocultar-lo.

Els consells no es mostren per omissió.

Usualment no és important el que escriviu les lletres en majúscules o minúscules. El programa converteix tota l'entrada a majúscules. El programa farà això automàticament.

La categoria, victòries i derrotes es mostren a la finestra.

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.

Hi ha diverses categories disponibles, depenent de l'idioma seleccionat. El programa cercarà tots els fitxers de dades disponibles per a tots els idiomes i també utilitza els fitxers de paraules del &kanagram;.

Una vegada endevineu una paraula (o es completi el penjat), rebreu les felicitacions i es presentarà la següent paraula. Per sortir del joc, feu clic a la icona a la part superior de la barra d'eines.

Heu d'escriure la lletra que voleu provar amb el teclat o seleccionar-la amb el &BER;. Si la lletra pertany a la paraula la tecla es ressaltarà en color verd i la lletra apareixerà al seu lloc, totes les vegades que apareix en la paraula. Si la lletra no pertany a la paraula, la tecla es ressaltarà en color vermell. Disposeu de deu intents i després perdreu i apareixerà la paraula correcta.

Durant el joc, podreu escollir iniciar una nova partida fent clic a la icona a la barra d'eines inferior. També podreu canviar la categoria de les paraules fent clic a la categoria actual.

L'aspecte es pot modificar amb facilitat amb el botó de tema que hi ha a la barra d'eines inferior.

### Jugar en idiomes diferents

És possible jugar al &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ål), noruec (Nynorsk), polonès, portuguès, romanès, espanyol, serbi (llatí i ciríl·lic), eslovac, tadjik, suec, rus i turc. Podeu intentar triar el xinès si instal·leu els fitxers des del &kanagram;.

Per omissió, després de la primera instal·lació del &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ú Idioma veureu dos elements: El danès per omissió i l'anglès com a segon idioma.

Encara podreu jugar al &khangman; en els altres idiomes. Això és tan fàcil com afegir-hi noves fonts de dades. Necessitareu connexió a la Internet. Feu clic a la icona i apareixerà un diàleg, similar a aquest:

El diàleg Obté paraules en un idioma nou per al &khangman; El diàleg Obté paraules en un idioma nou per al &khangman;

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

Podeu canviar fàcilment l'idioma fent clic al botó d'idioma i escollint-ne un altre.

Si us plau, tingueu present que al teclat es mostren els caràcters especials existents en un idioma. Veureu botons amb una icona per a cada caràcter especial per a cada idioma: com per exemple é en francès. En fer clic en un botó, se seleccionarà la lletra corresponent. Per descomptat, també podeu utilitzar la disposició de teclat corresponent a l'idioma.

### Uns quants consells

En l'anglès, primer intenteu endevinar les vocals. Aleshores proveu-ho amb les consonants més comunes: l, t, r, n, s.

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

Podeu optar per escriure les lletres accentuades o fer clic sobre seu. Quan escriviu a, només es mostrarà a i perquè es mostri l'accent haureu d'escriure ã per aquesta lletra.

Sabíeu que? A l'anglès, la lletra més comuna é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ús i barra d'eines

### La finestra principal del &khangman;

Tema desert del &khangman; Tema desert del &khangman;

Aquí teniu el &khangman; amb el tema desert, l'idioma català amb la categoria Comarques. També es mostren els caràcters especials per al català.

El joc té la barra d'eines a la part superior de la finestra:

- o la icona per iniciar o aturar el joc
- Obre el diàleg de configuració
- Quant al &khangman;
- Quant al &kde;
- Visualitza el manual del &khangman;
- Baixa fitxers nous d'idioma des d'Internet
- Surt del &khangman;

La barra d'eines inferior només es mostra quan es juga una partida, si feu una pausa, aquesta barra d'eines s'ocultarà:

- - Mostra un consell sobre la paraula a endevinar
- Un botó per a canviar la categoria
- Selecció de l'idioma
- Selecció del tema
- Revela la paraula a endevinar
- Carrega la paraula següent i inicia un joc nou

Totes les paraules són substantius. Ni verbs, ni adjectius. La categoria escollida és el que es mostra a la línia d'estat.

En el quadre de text tan sols està permès escriure-hi lletres.

### Ajustaments

Arranjament del &khangman; Arranjament del &khangman;

El Temps de resolució de paraula en segons estableix el temps màxim permès per a la resolució de la paraula al &khangman;. El valor per omissió és de 120 segons. Els nens petits necessitaran més temps per entendre el joc, pels adults, es redueix el temps de resolució per a mantenir el joc emocionant.

El Factor multiplicador de la puntuació determina el factor pel qual es multiplicaran les puntuacions.

Si marqueu Sons, llavors es reproduirà un so en una partida nova i un altre so quan es guanyi.

## Guia per a desenvolupadors del &khangman;

### Com traduir paraules a un nou idioma per al joc

Si us plau, seguiu el procediment i després envieu-nos els fitxers amb tar i comprimits amb gzip a la llista de correu kde-edu.

Si us plau, doneu un cop d'ull a la icona del &khangman; a la part superior de la barra d'eines per a veure si el vostre idioma ja està disponible. Si és així, podeu mirar si ja conté consells.

Les paraules estan desades en 4 fitxers separats, de manera que creen categories diferents. Els fitxers estan en `/khangman/data/`. El fitxer `easy.kvtml` és per a la categoria fàcil, `medium.kvtml` és per a la categoria mitjana, `animals.kvtml` és per a la categoria d'animalons i `hard.kvtml` és per a la categoria difícil.

L'anglès és l'idioma per omissió i és l'únic idioma inclòs amb el &khangman;. Totes les altres dades d'idioma es troben en el mòdul kde-l10n corresponent.

1. El fitxer usa el format kvtml. L'etiqueta `text` és per a la paraula i l'etiqueta `comment` és per al consell, totes dues dintre d'una etiqueta `entry`. Si us plau, intenteu fer coincidir el consell amb la categoria de dificultat. La categoria Fàcil requerirà un consell en conseqüència, de la mateixa manera la categoria Difícil 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!

   Tingueu en compte que haureu d'emprar la codificació UTF-8 per a editar els fitxers. Si el vostre editor no ho pot fer, proveu d'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.

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

       <?xml version="1.0"?>
       <DOCTYPE kvtml PUBLIC "kvtml2.dtd"
       "http://edu.kde.org/kanagram/kvtml2.dtd">
       <kvtml version="2.0">
       <information>
           <generator>converter</generator>
           <title>Animals</title><!--Translate tag content-->
           <comment>Animals from across the
       planet</comment><!--Translate tag content-->
         </information>
         <identifiers>
           <identifier id="0" >
             <locale>en</locale>
           </identifier>
         </identifiers>
       ...
       <entry id="0" >
             <inactive>false</inactive>
             <inquery>false</inquery>
             <translation id="0" >
               <text>bear</text><!--Translate all text tags
       content-->
               <comment>Large heavy animal with thick
       fur</comment><!--Translate all comment tags content-->
             </translation>
           </entry>
       ...
       </kvtml>

2. Al començament del fitxer, haureu de traduir el contingut de les etiquetes `title` i `comment` que resten dintre de l'etiqueta `information`. El títol serà el que apareixerà en el menú Categoria de la partida (a on l'usuari tria el fitxer amb el qual juga).

3. Després dintre de l'etiqueta `identifier`, si us plau, poseu-hi el codi d'idioma en comptes de «en» a l'etiqueta `locale`.

   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.

4. 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 `text` amb una traducció i cada consell dintre de l'etiqueta `comment` 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.

   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 la llista de correu kde-edu si hi ha res especial relacionat amb el vostre idioma de manera que puguem adaptar el codi a aquest nou caràcter (especialment els caràcters especials i els accents).

5. 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 mitjana. 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.

   Recordeu que totes les paraules són substantius.

6. Després podreu fer commit dels vostres fitxers a l10n-kf5/<lang_code>/data/kdeedu/kdeedu-data/. No oblideu actualitzar també el fitxer CMakeLists.txt. Si us plau, contacteu amb la llista de correu kde-edu si necessiteu quelcom més d'informació. Envieu-nos els fitxers, no us oblideu de fer menció a qualsevol caràcter especial emprat 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.

   Si us plau, no publiqueu cap fitxer en una branca perquè podríeu fer petar el joc.

Moltes gràcies per la vostra contribució!

### Què desa &khangman; i a on

Quan obteniu un nou idioma mitjançant Joc Obté paraules en un idioma nou... es desaran dites dades a `$XDG_DATA_HOME/share/apps/kvtml/` 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 `$XDG_DATA_HOME/share/config/khangmanrc`.

El nom proveït (&ead;, l'adreça del lloc web des d'on descarregar els nous idiomes) és desat a `$XDG_DATA_HOME/share/apps/khangman/khangmanrc`.

L'idioma anglès (per omissió) i l'idioma de l'usuari des del/s seu/s paquet/s i18n (si està/n disponibles) són emmagatzemats en `$XDG_DATA_HOME/share/apps/kvtml`.

En el fitxer de configuració, desat per a cada usuari en el seu propi `$XDG_DATA_HOME/share/config/khangmanrc` es desen tots els paràmetres de joc com el fons, i l'última categoria jugada... a més d'on s'han desat els fitxers des del diàleg Obtén novetats candents.

## Crèdits i llicència

&khangman;

Copyright del programa 2001-2007 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;

Col·laboradors:

- Gràfics del penjat: Renaud Blanchard kisukuma@chez.com

- Sons: Ludovic Grossard ludovic.grossard@libertysurf.fr

- Antic mantenidor: &Primoz.Anzur; &Primoz.Anzur.mail;

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

- Fitxers de dades en espanyol: eXParTaKus expartakus@expartakus.com

- Fitxers de dades en alemany: Rafael Beccar rafael.beccar@kdemail.net

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

- Fitxers de dades en finès: Niko Lewman niko.lewman@edu.hel.fi

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

- Fitxers de dades en català: &credits.Antoni.Bella;

- Fitxers de dades en italià: Giovanni Venturi jumpyj@tiscali.it

- Fitxers de dades en neerlandès: Rinse rinse@kde.nl

- Fitxers de dades en portuguès: Pedro Morais morais@kde.org

- Fitxers de dades en serbi (ciríl·lic i llatí): Chusslove Illich chaslav@sezampro.yu

- Fitxers de dades en eslovè: Jure Repinc jlp@holodeck1.com

- Fitxers de dades en txec: Lukáš Tinkl lukas@kde.org

- Fitxers de dades en tadjik: Roger Kovacs rkovacs@khujand.org

- Fitxers de dades en noruec (Bokmål): Torger Åge Sinnes torg-a-s@online.no

- Fitxers de dades en hongarès: Tamas Szanto tszanto@mol.hu

- Fitxers de dades en noruec (Nynorsk): Gaute Hvoslef Kvalnes gaute@verdsveven.com

- Fitxers de dades en turc: Mehmet Özel mehmet_ozel2003@hotmail.com

- Fitxers de dades en búlgar: Radostin Radnev radnev@yahoo.com

- Fitxers de dades en irlandès (gaèlic): Kevin Patrick Scannell scannell@slu.edu

- Ajuda en la programació: &Robert.Gogolok; &Robert.Gogolok.mail;

- Ajuda en la programació: Benjamin Meyer ben@meyerhome.net

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

- Correccions en el codi: Albert Astals Cid &Albert.Astals.Cid.mail;

- Estudi d'usabilitat: Celeste Paul seele@obso1337.org

Copyright de la documentació 2001-2007 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;

Traductor de la documentació: &credits.Antoni.Bella;

&underFDL; &underGPL;
&documentation.index;