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

<book lang="&language;">

<bookinfo>
<title
>Manuale di &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; è il classico gioco dell'impiccato per bambini, adattato a &kde;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>KHangMan</keyword>
<keyword
>impiccato</keyword>
<keyword
>gioco</keyword>
<keyword
>bambino</keyword>
<keyword
>parole</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introduzione</title>

<para
>&khangman; è un gioco basato sul ben noto gioco dell'impiccato. È pensato per i bambini da sei anni in su. Ha quattro livelli di difficoltà: animali (nomi di animali), facile, medio e difficile. Una parola è scelta a caso, le lettere sono nascoste, e bisogna indovinare la parola provando una lettera alla volta. Ogni volta che provi una lettera sbagliata, viene disegnata parte dell'immagine di un impiccato. Devi indovinare la parola prima di farti impiccare! Hai a disposizione dieci tentativi. </para>
<para
>Mio figlio Joachim, che allora aveva nove anni e mezzo, mi ha dato l'idea per questo gioco nel giugno del 2000. </para>

</chapter>

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

<screenshot>
<screeninfo
>Ecco un'immagine di &khangman; quando lo si avvia per la prima volta</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman1.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Immagine di &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Qui puoi vedere &khangman; alla prima esecuzione. Il livello è facile, la lingua è quella predefinita (in questo caso inglese), non c'è un tema per lo sfondo e la figura dell'impiccato non è trasparente. Ogni modifica al livello, alla lingua o al tema dello sfondo viene scritta nel file di configurazione e sarà ripristinata al successivo avvio. </para>

<para
>Nota come è facile cambiare il livello e la modalità di sfondo: basta fare clic sulle liste a comparsa nella barra degli strumenti. Allo stesso modo, per passare a una nuova parola o uscire dal gioco è sufficiente fare clic sugli appositi pulsanti nella barra degli strumenti. </para>

<sect1 id="general-usage">
<title
>Utilizzo generale</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
>Una parola è visualizzata, nascosta. Sai già da quante lettere è composta. Devi indovinare di che parola si tratta provando una lettera dopo l'altra. La parola è scelta a caso, e non è mai la stessa due volte di seguito.</para>

<important
><para
>Tutte le parole sono sostantivi (niente verbi, aggettivi &etc;).</para
></important>

<para
>È indifferente scrivere in lettere maiuscole o minuscole. Il programma converte automaticamente tutto in minuscolo, fatta eccezione per le parole tedesche con iniziale maiuscola.  </para>

<para
>Il livello e la lingua correnti sono mostrati nella barra di stato. </para>
<para
>Ogni volta che provi una lettera che non fa parte della parola, una parte dell'impiccato viene disegnata. Hai dieci tentativi a disposizione per indovinare la parola, dopodiché viene mostrata la risposta corretta. </para>
<para
>Ci sono quattro livelli: facile, medio, difficile e animali, oltre a livelli su altri temi in alcune lingue. Il programma ricerca tutti i file di dati in tutte le lingue. </para>
<para
>Nel livello facile le parole sono abbastanza semplici, prese dalla vita di tutti i giorni. È adatto per bambini dai sei ai nove anni. Il livello animali contiene solo nomi di animali, in modo che sia più facile indovinarli. Alcuni sono facili, altri più difficili. Nel livello medio, le parole sono più lunghe e più difficili. È adatto per bambini dai nove anni in su. Il livello difficile è, come dice il nome, difficile, &ie; le parole sono complicate e non molto conosciute. Si tratta di un livello non banale anche per gli adulti. </para>

<para
>Dopo che una parola è stata indovinata (o che l'impiccato è stato completato) ti viene proposta una nuova parola, e puoi usare sia i tasti <keycap
>S</keycap
> o <keycap
>N</keycap
>, sia il mouse per rispondere sì o no. Se rispondi <guilabel
>no</guilabel
>, il gioco ha termine. Se rispondi <guilabel
>sì</guilabel
>, un'altra parola è pronta per essere indovinata. </para>

<!-- FIXME: should we call it 'field' or 'text edit' or...? -->
<para
>Digita la lettera che vuoi provare nella casella (il cursore del mouse è pronto in posizione) e premi &Enter;. Se la lettera fa parte della parola, sarà visualizzata nelle posizioni opportune. In caso contrario, finirà nella lista delle lettere sbagliate, e un altro pezzo dell'impiccato sarà disegnato. Hai dieci tentativi, dopo i quali perdi la partita e la parola corretta viene visualizzata. </para>

<para
>Durante il gioco puoi scegliere di iniziare una nuova partita andando nel menu <guimenu
>Partita</guimenu
> e scegliendo <guimenuitem
>Nuova</guimenuitem
>, o facendo clic sull'icona <guiicon
>Nuovo</guiicon
> nella barra degli strumenti. Puoi anche cambiare il livello col pulsante apposito nella barra degli strumenti (ciò farà comparire una nuova parola dal livello appena selezionato).</para>

<para
>Un aggiornamento futuro permetterà di creare file di parole personalizzati o di caricare un file diverso dai quattro già inclusi. </para>

<para
>You can play &khangman; in thirteen languages: Brazilian Portuguese, Catalan, Czech, Danish, Dutch, English, Finnish, French, German, Italian, Portuguese, Spanish and Swedish. You can easily change the Language by going in the <guimenu
>Languages</guimenu
> menu and choosing another language. </para>

<para
>Nota che ora puoi digitare i caratteri speciali di una lingua visualizzando la <emphasis
>barra degli strumenti caratteri speciali</emphasis
>. Questa barra contiene pulsanti con le icone dei caratteri speciali di una lingua, come per esempio la &eacute; francese. Facendo clic su un pulsante la lettera corrispondente comparirà nella riga di inserimento, e dovrai confermare la scelta premendo Invio. Ovviamente puoi anche usare il layout di tastiera corrispondente alla lingua. Questa barra degli strumenti può essere mostrata o nascosta a piacere. L'impostazione sarà ripristinata al successivo avvio di &khangman;. </para>

<important
><para
>Please note that for Czech special characters you will need a font that supports these characters so you can see them displayed. Choosing Arial in KDE Control Center as a general font and adjusting all fonts will work fine. </para
></important>

</sect1>
<sect1 id="few-tips">
<title
>Qualche suggerimento</title>
<para
>Prova a indovinare prima le vocali. Poi passa alle consonanti più comuni: l, t, r, n, s. </para>
<para
>Se stai giocando in francese o inglese e compare <quote
>io</quote
>, prova la lettera n. </para>
<para
>In portoghese brasiliano, catalano, spagnolo e portoghese le vocali accentate compaiono anche premendo la vocale non accentata corrispondente. Per esempio, tutte le <quote
>a</quote
> accentate di una parola saranno mostrate premendo <quote
>a</quote
>. Ciò accade quando <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Digita lettere accentate</guimenuitem
></menuchoice
> non è selezionato. Quando invece lo è, bisogna digitare anche le lettere accentate. Premendo <quote
>a</quote
>, solo le <quote
>a</quote
> saranno visualizzate, e dovrai per esempio digitare &atilde; perché questa lettera sia mostrata. </para>
<para
>Lo sapevi? In inglese, la lettera più comune è la e (12,7%), seguita dalla t (9,1%) dalla a (8,2%), dalla i (7,0%) e dalla n (6,7%). </para>
</sect1>
</chapter>

<chapter id="menus">
<title
>Barra dei menu e barre degli strumenti</title>

<sect1 id="mainwindow">
<title
>La finestra principale di &khangman;</title>

<para
>Il menu <guimenu
>Partita</guimenu
> ha due voci: <guimenuitem
>Nuova</guimenuitem
> ed <guimenuitem
>Esci</guimenuitem
>.</para>

<para
><guimenuitem
>Nuova</guimenuitem
> fa iniziare una nuova partita, &ie; una nuova parola da indovinare, nel livello corrente. <guimenuitem
>Esci</guimenuitem
> provoca l'uscita dal gioco, chiudendo la finestra principale e salvando le impostazioni correnti nel file di configurazione.</para>

<para
>The <guimenu
>Languages</guimenu
> menu has thirteen menu items: <guimenuitem
>Brazilian Portuguese</guimenuitem
>, <guimenuitem
>Catalan</guimenuitem
>, <guimenuitem
>Czech</guimenuitem
>, <guimenuitem
>Danish</guimenuitem
>, <guimenuitem
>Dutch</guimenuitem
>, <guimenuitem
>English</guimenuitem
>, <guimenuitem
>Finnish</guimenuitem
>, <guimenuitem
>French</guimenuitem
>, <guimenuitem
>German</guimenuitem
>, <guimenuitem
>Italian</guimenuitem
>, <guimenuitem
>Portuguese</guimenuitem
>, <guimenuitem
>Spanish</guimenuitem
> and <guimenuitem
>Swedish</guimenuitem
>. As default, if your &kde; language is one of those thirteen, then it is set as default otherwise English is chosen. After your first game, the language you set up the last time you used &khangman; is restored. </para>
<para
>Il menu <guimenuitem
>Impostazioni</guimenuitem
> ti permette di configurare &khangman; con facilità. Per prima cosa, <guimenuitem
>Barre degli strumenti</guimenuitem
> e <guimenuitem
>Mostra barra di stato</guimenuitem
> ti danno la possibilità di visualizzare o nascondere queste barre. </para>

<para
>Ci sono due barre degli strumenti: quella principale, con i pulsanti e le liste a discesa, nella parte alta della finestra, e quella <interface
>Caratteri</interface
> che, quando è visibile, si trova in basso. Questa barra dispone di pulsanti con i caratteri speciali di ogni lingua: lettere accentate e altri caratteri particolari. Ciò permette all'utente di giocare con un'altra lingua senza dover configurare un nuovo layout di tastiera. Facendo clic su un carattere speciale esso è visualizzato al posto della lettera da provare. Premendo &Enter; il programma controllerà se la lettera è presente nella parola o meno. Puoi nascondere questa barra degli strumenti se lo desideri. L'impostazione è salvata nel file di configurazione: in tal modo, se la barra degli strumenti è nascosta, lo rimarrà anche al successivo avvio di &khangman;. </para>
<tip>
<para
>Ovviamente è possibile spostare le barre degli strumenti. Posiziona il puntatore del mouse sulla piccola maniglia all'estremità sinistra della barra, premi il &LMB; e trascina la barra nella posizione desiderata. Se ti posizioni col puntatore del mouse su una barra degli strumenti e premi il pulsante destro, apparirà un menu contestuale con il quale potrai impostare diverse opzioni per la barra. </para>
</tip>
<para
><guimenuitem
>Configura le scorciatoie...</guimenuitem
> è un'impostazione standard di &kde; che ti permette di scegliere diverse scorciatoie da tastiera per diverse azioni. Ad esempio, <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> è la scorciatoia standard per il comando <guimenuitem
>Esci</guimenuitem
>.</para>
<para
>Anche <guimenuitem
>Configura le barre degli strumenti...</guimenuitem
> è una voce di menu standard di &kde;, che ti permette di aggiungere o togliere elementi alla barra. Quando la voce <guimenuitem
>Modalità a tutto schermo</guimenuitem
> è marcata viene attivata tale modalità, con la sola barra degli strumenti in alto e &khangman; che occupa tutto lo schermo. Sulla barra degli strumenti principale, l'icona <guiicon
>Esci dalla modalità a tutto schermo</guiicon
> ti consente di ridimensionare la finestra alle dimensioni precedenti.</para>

<para
><guimenuitem
>Immagini trasparenti</guimenuitem
> ti consente di scegliere se abilitare o meno la trasparenza per l'immagine dell'impiccato.</para>

<para
><guimenuitem
>Impiccato meno cruento</guimenuitem
> ti permette di addolcire l'ultima immagine dell'impiccato. In altre parole, non avrà il nodo scorsoio al collo ma si terrà appeso alla fune con una mano. Si tratta di un'immagine più adatta a bambini piccoli.</para>

<para
><guimenuitem
>Digita lettere accentate</guimenuitem
> è disponibile soltanto in catalano, portoghese brasiliano e spagnolo. Se marcato, l'utente deve digitare le lettere accentate come &atilde; per trovarle nella parola. In caso contrario, provando una qualunque vocale si scopriranno anche quelle accentate: per esempio, provando <quote
>a</quote
> si scopriranno anche &atilde; e altre a accentate, se presenti.</para>

<para
><guimenuitem
>Abilita suggerimenti</guimenuitem
> è disponibile solo in francese e italiano. Attivando l'opzione in queste due lingue, con un clic del pulsante destro del mouse su un punto qualsiasi della finestra un suggerimento sarà visualizzato per quattro secondi. Il suggerimento dovrebbe essere d'aiuto per indovinare la parola.</para>

<para
>Nota che le immagini trasparenti dell'impiccato non sono abilitate nella modalità Niente sfondo. La trasparenza è disponibile soltanto con un'immagine di sfondo, e l'impostazione predefinita è di abilitarla.</para>

<screenshot>
<screeninfo
>Il tema blu di &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman2.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>tema blu di &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Ecco &khangman; con il tema blu, la figura trasparente dell'impiccato, lingua catalana e livello facile. È mostrata la barra degli strumenti <interface
>Caratteri</interface
>.</para>

<para
>Il livello si sceglie da una lista a comparsa e può essere facile, medio, difficile e animali. Il livello facile contiene oggetti comuni noti a un bambino di sei o sette anni. Il livello medio contiene nomi un po' più complicati, e in misura maggiore il livello difficile. Il livello animali contiene solo nomi di animali. </para>

<para
>Tutte le parole sono sostantivi. Niente verbi né aggettivi. Il livello scelto viene mostrato nella barra di stato.</para>
<para
>Nella casella si possono digitare soltanto lettere.</para>
</sect1>
</chapter>

<chapter id="commands">
<title
>Riferimento dei comandi</title>

<sect1 id="khangman-mainwindow">
<title
>Menu e scorciatoie da tastiera</title>

<sect2>
<title
>Il menu <guimenu
>Gioco</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Gioco</guimenu
> <guimenuitem
>Nuovo</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Nuova</action
> partita (&ie; nuova parola)</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Gioco</guimenu
> <guimenuitem
>Esci</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Esce</action
> da &khangman;</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>Il menu <guimenu
>Lingue</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Lingue</guimenu
> <guimenuitem
>Lingue</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sceglie</action
> la lingua per le parole</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>Il menu <guimenu
>Impostazioni</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Barre degli strumenti</guimenuitem
> <guimenuitem
>Mostra principale</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra/nasconde</action
> la barra degli strumenti principale</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Barre degli strumenti</guimenuitem
> <guimenuitem
>Mostra caratteri</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra/nasconde</action
> la barra degli strumenti Caratteri</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Mostra barra di stato</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra/nasconde</action
> la barra di stato</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>T</keycap
></keycombo
> </shortcut
> <guimenu
>Impostazioni</guimenu
> <guimenuitem
>Immagini trasparenti</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Attiva/disattiva</action
> la trasparenza per le immagini dell'impiccato </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Impostazioni</guimenu
> <guimenuitem
>Impiccato meno cruento</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Alterna</action
> le immagini più o meno cruente dell'impiccato. </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>A</keycap
></keycombo
> </shortcut
> <guimenu
>Impostazioni</guimenu
> <guimenuitem
>Digita lettere accentate</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Consente di digitare separatamente le lettere accentate (in portoghese brasiliano, catalano, portoghese e spagnolo) </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Impostazioni</guimenu
> <guimenuitem
>Abilita suggerimenti</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Permette di vedere un suggerimento facendo clic col tasto destro del mouse (solo in francese e italiano) </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Shift;<keycap
>F</keycap
></keycombo
> </shortcut
> <guimenu
>Impostazioni</guimenu
> <guimenuitem
>Modalità a tutto schermo</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Attiva/disattiva</action
> la modalità a tutto schermo </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura scorciatoie...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura</action
> i tasti da usare per accedere alle varie azioni.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura le barre degli strumenti...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura</action
> gli elementi da inserire nella barra degli strumenti </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title
>Il menu <guimenu
>Aiuto</guimenu
></title>
&help.menu.documentation; </sect2>
</sect1>
</chapter>

<chapter id="developers">
<title
>Guida dello sviluppatore a &khangman;</title>

<sect1 id="changing-words">
<title
>Come aggiungere parole in una nuova lingua</title>

<para
>Thanks to Stefan Asserhäll, it is very easy to add a new language directly to the game. The procedure described here can also be found in the <filename class="directory"
>khangman</filename
> source folder in the file <filename
>README.languages</filename
>. However, as there are already thirteen languages, it will be difficult to add others as the menu will be too long. So please follow the procedure below but instead of committing your files you send them to me tarred and gzipped. That way I'll make your language available on the &khangman; web page. Next &khangman; release (with &kde; 3.3) will have a wizard to easily download and install new languages. </para>

<para
>Scarica l'ultima versione cvs di &khangman;. Le parole sono contenute in quattro file separati, uno per ogni livello. I file si trovano in <filename class="directory"
>/khangman/data/codice_lingua</filename
>. Il file <filename
>easy.txt</filename
> è per il livello facile, il file <filename
>medium.txt</filename
> per il livello medio, il file <filename
>animals.txt</filename
> per il livello animali e il file <filename
>hard.txt</filename
> per il livello difficile.</para>

<procedure>
<step
><para
>Digita il comando seguente in &konsole; per creare la cartella e i file della nuova lingua:</para>
<!-- Do not wrap or indent the next line, it's white space sensitive -->
<screen
><userinput
><command
>./add_language <replaceable
>codice_lingua</replaceable
></command
></userinput
></screen>
<para
>Devi sostituire a <replaceable
>codice_lingua</replaceable
> il codice della tua lingua.</para>
</step>
<step>
<para
>Modifica tutti i file di testo nella nuova cartella con un editor, e al posto di ogni parola mettine una nella tua lingua. Non è necessario inserire traduzioni esatte, ma cerca di preservare la lunghezza e il livello di difficoltà.</para
> 

<para
>Puoi limitarti a tradurre le parole, ma se vuoi puoi anche adattarle al livello e aggiungerne di nuove. Per esempio, <quote
>tavolo</quote
> è nel livello facile in inglese, ma potrebbe essere nel livello medio nella tua lingua. Sentiti libero di adattare i file alle necessità del tuo idioma. Il numero di parole in un file non è importante, quindi ne puoi aggiungere alcune se lo desideri.</para>

<para
>Ricorda che tutte le parole sono sostantivi.</para>

<para
>Nota che devi usare la codifica UTF-8 quando modifichi i file. Se il tuo editor non ha questa funzione, prova a utilizzare &kwrite; o &kate;. Aprendo un file con questi editor puoi selezionare la codifica utf8 tramite la lista a discesa in cima alla finestra di dialogo per l'apertura di un file.</para>

<para
>Mantieni i nomi inglesi dei file nella tua cartella <replaceable
>codice_lingua</replaceable
>.</para>
</step>

<step>
<para
>Digita il comando seguente per installare i nuovi file di dati:</para>
<screen
><userinput
><command
>make</command
></userinput>
<userinput
><command
>make install</command
></userinput
></screen>

<para
>A seconda del tipo di installazione, potresti dover diventare <systemitem class="username"
>root</systemitem
> per eseguire <command
>make install</command
>.</para>
</step>
<step>
<para
>Esegui il gioco e controlla che la nuova lingua sia stata aggiunta:</para>
<screen
><userinput
><command
>khangman</command
></userinput
></screen>
</step>
<step
><para
>Fai un commit dei nuovi file di lingua con il comando seguente:</para>
<screen
><userinput
><command
>cvs commit -m "Added new language <replaceable
>nome_della_tua_lingua</replaceable
>"</command
></userinput
></screen>
</step>
</procedure>

<para
>Se vuoi avere i suggerimenti nella nuova lingua c'è del lavoro aggiuntivo. Devi usare il formato kvtml, e la cosa migliore da fare è dare un'occhiata ai file di dati del francese o dell'italiano. Il tag <sgmltag class="starttag"
>o</sgmltag
> è per la parola e il tag <sgmltag class="starttag"
>t</sgmltag
> per il suggerimento. Cerca di adattare il suggerimento al livello di difficoltà. Il livello <quote
>Facile</quote
> richiederà un suggerimento semplice, ma per il livello <quote
>Difficile</quote
> servirà la definizione del dizionario. Cerca di non usare nel suggerimento parole della stessa famiglia di quella da scoprire, altrimenti indovinarla diventa troppo facile!</para>

<para
>Un esempio di file kvtml è il seguente:</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
>Miglioramenti previsti per &khangman;</title>

<para
>Con l'aumentare del numero di lingue disponibili sarà impossibile continuare ad aggiungerle al programma. Pensiamo di fornire di serie con &khangman; solo alcune lingue come inglese, francese, tedesco e spagnolo, e di rendere disponibili le altre per lo scaricamento nel modulo i18n. &khangman; si servirà della classe <classname
>KnewStuff</classname
> per creare una procedura guidata che consenta di scaricare e installare facilmente nuove lingue. Una cosa simile sarà fatta per &klettres; e &kstars;, in modo da non aumentare ancora le dimensioni del modulo &package;. </para>
<para
>Ovviamente un altro miglioramento in programma è avere i suggerimenti in tutte le lingue. </para>
<para
>Un'altra miglioria possibile è utilizzare altri file kvtml, come quelli presenti sul sito web di KDE Edu, per giocare a &khangman;. Per esempio, immagina di giocare con le capitali del mondo: il suggerimento è la nazione e bisogna indovinarne la capitale. Oppure si potrebbero imparare i vocaboli di una lingua straniera: il suggerimento sarebbe la parola nella tua lingua, e bisognerebbe indovinarne la traduzione nella lingua straniera. </para>
</sect1>
</chapter>

<chapter id="faq">
<title
>Domande e risposte</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Un messaggio d'errore mi dice che è impossibile trovare le immagini.</para>
</question>
<answer>
<para
>La cartella di installazione predefinita del gioco è <filename class="directory"
>/usr/local/kde</filename
>, perciò aggiungi <filename class="directory"
>/usr/local/kde/bin</filename
> al tuo path e imposta la variabile <envar
>KDEDIR</envar
> a <filename class="directory"
>/usr/local/kde</filename
> prima di avviare il gioco. Un modo più semplice è configurare &khangman; con l'opzione <option
>--prefix</option
>=$<envar
>$KDEDIR</envar
>, dove $<envar
>KDEDIR</envar
> è la cartella dove è installato il resto di &kde;. Tale cartella può variare notevolmente a seconda della distribuzione e del sistema operativo che utilizzi.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>&khangman; non si avvia correttamente dopo l'aggiornamento a una delle versioni di &kde; 3.2.</para>
</question>
<answer>
<para
>Ci potrebbe essere un problema causato dal cambiamento del file di configurazione. Elimina il file <filename
>khangmanrc</filename
> nella cartella <filename class="directory"
>$HOME/.kde/share/config</filename
>. </para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title
>Ringraziamenti e licenza</title>

<para
>&khangman; </para>
<para
>Copyright programma 2001-2003 Anne-Marie Mahfouf <email
>annma AT kde DOT org</email
> </para>
<para
>Hanno contribuito: <itemizedlist>
<listitem
><para
>Grafica: Renaud Blanchard <email
>kisukuma AT chez DOT com</email
></para
> </listitem>
<listitem
><para
>Suoni: Ludovic Grossard <email
>ludovic.grossard AT libertysurf DOT fr</email
></para
> </listitem>
<listitem
><para
>Tema blu, icone e codice: Primoz Anzur <email
>zerokode AT yahoo DOT com</email
></para
> </listitem>
<listitem
><para
>File di dati per lo svedese, aiuto nella programmazione, immagini trasparenti e correzioni 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
>Impiccato meno cruento: Matt Howe <email
>mdhowe AT bigfoot DOT com</email
></para
> </listitem>
<listitem
><para
>File di dati per lo spagnolo: eXParTaKus <email
>expartakus AT expartakus DOT com </email
></para
> </listitem>
<listitem
><para
>File di dati per il danese: Erik Kjaer Pedersen <email
>erik AT mpim-bonn DOT mpg DOT de </email
></para
> </listitem>
<listitem
><para
>File di dati per il finlandese: Niko Lewman <email
>niko DOT lewman AT edu DOT hel DOT fi </email
></para
> </listitem>
<listitem
><para
>File di dati per il portoghese brasiliano: João Sebastião de Oliveira Bueno <email
>gwidion AT mpc DOT com DOT br </email
></para
> </listitem>
<listitem
><para
>File di dati per il catalano: Antoni Bella <email
>bella5 AT teleline DOT es </email
></para
> </listitem>
<listitem
><para
>File di dati per l'italiano: Giovanni Venturi <email
>jumpyj AT tiscali DOT it </email
></para
> </listitem>
<listitem
><para
>File di dati per l'olandese: Rinse <email
>rinse AT kde DOT nl </email
></para
> </listitem>
<listitem
><para
>File di dati per il portoghese: Pedro Morais <email
>morais AT kde DOT org </email
></para
> </listitem>
<listitem
><para
>Aiuto nella programmazione: Robert Gogolok <email
>robertgogolok AT gmx DOT de</email
></para
> </listitem>
<listitem
><para
>Aiuto nella programmazione: Benjamin Meyer <email
>ben AT meyerhome DOT net</email
></para
> </listitem>
<listitem
><para
>Correzioni al codice: Lubos Lun&agrave;k <email
>l.lunak AT kde DOT org</email
></para
> </listitem>
<listitem
><para
>Correzioni al codice: Albert Astals Cid <email
>tsdgeos AT terra DOT es</email
></para
> </listitem>
</itemizedlist>
</para>

<para
>Copyright documentazione 2001-2003 Anne-Marie Mahfouf <email
>annma AT kde DOT org</email
> </para>
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installazione</title>

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

<sect1 id="compilation">
<title
>Compilazione e installazione</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:
-->
