<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
  <!ENTITY kapp "&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
>2004-04-22</date>
<releaseinfo
>1.5</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>

</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 è animali, la lingua è quella predefinita (la lingua corrente di KDE, in questo caso inglese), non c'è un tema per lo sfondo e la figura dell'impiccato non ha lo sfondo 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. Inserisci la lettera nella casella e premi Invio o fai clic sul pulsante Prova per vedere se appartiene o meno alla parola.  </para>

<para
>La parola viene scelta a caso e non è uguale alla precedente. </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>

<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 (in KDE 4) permetterà di creare file di parole personalizzati o di caricare un file diverso dai quattro già inclusi. </para>
</sect1>

<sect1 id="languages">
<title
>Giocare in diverse lingue</title>
<para
>Puoi giocare a &khangman; in ventidue lingue: bulgaro, catalano, ceco, danese, finlandese, francese, inglese, irlandese (gaelico), italiano, norvegese (Bokm&#229;l), norvegese (Nynorsk), olandese, portoghese, portoghese brasiliano, serbo (latino e cirillico), sloveno, spagnolo, svedese, tagico, tedesco e ungherese. </para>

<para
>L'impostazione predefinita è che, con la prima installazione di &khangman; per KDE 3.3, siano inclusi solo l'inglese e la lingua scelta per &kde;, a patto che sia una di quelle elencate e che il corrispondente pacchetto kde-i18n sia installato. Per esempio, se sei un utente italiano e hai &kde; in italiano, in <guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura &khangman;..</guimenuitem
> <guimenuitem
>Impostazioni avanzate</guimenuitem
> <guimenuitem
>Parole in:</guimenuitem
> vedrai due voci, Inglese e Italiano, e Italiano sarà l'impostazione predefinita. </para>

<para
>Puoi comunque giocare a &khangman; in altre lingue. Aggiungere nuovi dati è molto facile, è sufficiente una connessione a Internet. Fai clic sul menu <guimenu
>File</guimenu
>, quindi su <guimenu
>Ottieni dati in nuova lingua...</guimenu
>. Apparirà una finestra di dialogo simile a questa: </para>

<screenshot>
<screeninfo
>La finestra che consente di scaricare nuovi dati per &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="getnewstuff.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Immagine finestra per lo scaricamento di nuovi dati</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Fai clic sul nome della lingua che vuoi installare, quindi sul pulsante Installa. Una finestra ti comuncherà che l'installazione è avvenuta con successo. Fai clic su OK per chiudere questa finestra, quindi su Chiudi per chiudere quella precedente. Se vuoi un'altra lingua, basta ripetere la procedura. La nuova lingua è ora disponibile! </para>

<para
>Puoi cambiare facilmente lingua andando nel menu <guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura &khangman;...</guimenuitem
> <guimenuitem
>Impostazioni avanzate</guimenuitem
> <guimenuitem
>Parole in:</guimenuitem
> e scegliendo un'altra lingua. </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
>Nota che, per visualizzare correttamente i caratteri speciali di alcune lingue, è necessario avere i set Arial e URW Bookman. Se sono installati, &khangman; li utilizzerà automaticamente. Se vedi dei rettangoli al posto delle lettere, può darsi che uno di questi set di caratteri sia assente. </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 la voce <menuchoice
><guimenu
>Impostazioni</guimenu
><guimenuitem
>Configura &khangman;</guimenuitem
> <guimenuitem
>Impostazioni avanzate</guimenuitem
> <guimenuitem
>Digita lettere accentate</guimenuitem
></menuchoice
> non è marcata. 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 tre voci: <guimenuitem
>Nuova</guimenuitem
>, <guimenuitem
>Ottieni dati in nuova lingua</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
>Ottieni dati in nuova lingua</guimenuitem
> visualizza l'apposita finestra di dialogo per scaricare i dati di una nuova lingua. <guimenuitem
>Esci</guimenuitem
> provoca l'uscita dal gioco, chiudendo la finestra principale e salvando le impostazioni correnti nel file di configurazione.</para>

<para
>Il menu <guimenu
>Livelli</guimenu
> permette di scegliere il livello, ovvero il grado di difficoltà delle parole da indovinare. </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>

<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 a sfondo 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 cascata o tramite il menu <guimenu
>Livelli</guimenu
> e può essere facile, medio, animali e difficile. 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>

<sect1 id="settings">
<title
>Impostazioni disponibili</title>
<para
>Una barra degli strumenti permette un accesso rapido ad alcune impostazioni. Puoi fare clic su un pulsante per iniziare una nuova partita (ovvero una nuova parola), per uscire dal gioco e per attivare la modalità a tutto schermo (fornita per schermi a bassa risoluzione e per le partite con molte persone). Un clic sull'icona del manuale di &khangman; farà aprire questa guida. Il livello e lo sfondo si possono cambiare facilmente grazie a due liste a cascata sulla barra degli strumenti. </para>
<para
>In <guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura &khangman;</guimenuitem
> troverai due schede. La prima è per l'aspetto. </para>

<sect2 id="normal-settings">
<title
>Aspetto</title>

<screenshot>
<screeninfo
>Impostazioni normali di &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="normalsettings.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Impostazioni normali di &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>La sezione Immagini dell'impiccato ti consente di avere immagini <guimenuitem
>Incruente</guimenuitem
> o <guimenuitem
>Normali</guimenuitem
>. <guimenuitem
>Incruente</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. Scegliendo <guimenuitem
>Normali</guimenuitem
> l'impiccato sarà invece appeso per il collo. </para>

<para
>Puoi anche impostare l'immagine di sfondo. <guimenu
>Niente sfondo</guimenu
> lascia tutto grigio, mentre scegliendo <guimenu
>Tema Blu</guimenu
> o <guimenu
>Tema Natura</guimenu
> otterrai gradevoli immagini. </para>

<para
>Nella sezione Suoni, marcando la casella <guimenu
>Abilita suoni</guimenu
>, si udirà un suono all'inizio di una nuova partita, e un altro dopo una vittoria. </para>

</sect2>
<sect2 id="advanced-settings">
<title
>Impostazioni avanzate</title>

<screenshot>
<screeninfo
>Impostazioni avanzate di &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="advancedsettings.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Impostazioni avanzate di &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>La seconda scheda comprende impostazioni più avanzate. Alcune sono disponibili solo per certe lingue, e saranno disabilitate se la lingua corrente non le prevede. </para>

<para
>La prima impostazione ti consente di scegliere la lingua per le parole. L'impostazione predefinita sarà la lingua corrente di KDE, se disponibile, altrimenti sarà l'inglese. L'inglese è incluso di serie, mentre tutte le altre lingue si trovano nel modulo i18n corrispondente. Puoi inoltre scaricare nuove lingue tramite il menu <guimenu
>Partita</guimenu
>, voce <guimenuitem
>Ottieni dati in nuova lingua...</guimenuitem
> </para>

<para
><guimenu
>Digita lettere accentate</guimenu
>, è disponibile per Catalano, Portoghese, Portoghese Brasiliano e Spagnolo. Marcando la casella relativa, dovrai digitare esplicitamente le vocali accentate nel gioco (come &atilde;). In caso contrario, digitando una vocale anche quelle eventualmente accentate saranno visualizzate. </para>

<para
>Alcune lingue dispongono anche di suggerimenti per aiutarti a indovinare la parola. Il suggerimento è mostrato tramite un clic col pulsante destro del mouse, e consiste in una breve definizione della parola da indovinare. Se l'opzione è abilitata e marchi la casella  <guimenu
>Mostra suggerimenti</guimenu
>, con un clic del pulsante destro del mouse su un punto qualsiasi della finestra il suggerimento sarà visualizzato per quattro secondi. Ti dovrebbe essere d'aiuto per indovinare la parola. </para>

<para
>Se marcato, <guimenu
>Una lettera alla volta</guimenu
> mostrerà solo la prima apparizione di una lettera, nel caso in cui compaia più volte all'interno di una parola. Per esempio, se la parola è "armadio", digitando "a" soltanto la prima "a" sarà mostrata. Dovrai digitare di nuovo "a" per vederne la seconda apparizione, mentre digitandola una terza volta essa finirà tra le lettere sbagliate. Ciò ha l'effetto di aumentare la difficoltà del gioco. </para>

<para
>Marcando <guimenu
>Non visualizzare il messaggio "Congratulazioni, hai vinto!"</guimenu
> il messaggio in questione non sarà mostrato dopo aver vinto una partita. La parola indovinata sarà mostrata per quattro secondi, dopodiché inizierà una nuova partita. </para>

</sect2>
</sect1>

</chapter>

<chapter id="commands">
<title
>Guida ai 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
>G</keycap
></keycombo
> </shortcut
> <guimenu
>Partita</guimenu
> <guimenuitem
>Ottieni dati in nuova lingua...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Visualizza</action
> la finestra di dialogo KNewStuff con tutti i dati disponibili nelle varie lingue. </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
>Livelli</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Livelli</guimenu
> <guimenuitem
>Animali</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sceglie</action
> la lista di nomi di animali da indovinare</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Livelli</guimenu
> <guimenuitem
>Facile</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sceglie</action
> la lista di parole facili da indovinare</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Livelli</guimenu
> <guimenuitem
>Medio</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sceglie</action
> la lista di parole di media difficoltà da indovinare</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Livelli</guimenu
> <guimenuitem
>Difficile</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sceglie</action
> la lista di parole difficili da indovinare</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;&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>

<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura &khangman;...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra/nasconde</action
> la finestra impostazioni di &khangman; </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
>Grazie a Stefan Asserhäll è molto facile aggiungere una nuova lingua al gioco. La procedura descritta qui si può trovare anche nella cartella dei sorgenti <filename class="directory"
>khangman</filename
>, nel file <filename
>README.languages</filename
>. Segui la procedura descritta e mandami i file in un archivio tar.gz,all'indirizzo annemarie.mahfouf@free.fr. </para>
<para
>I codici delle ventiquattro lingue attualmente disponibili sono: bg ca cs da de en es fr fi ga hu it nb nl nn pt pt_BR ru sl sr sr@Ltn sv tg e tr. Se la tua lingua non è compresa puoi procedere oltre. </para>
<para
>La maggior parte di questi dati andrebbero completati con dei <emphasis
>suggerimenti</emphasis
>, vedi sotto. Solo bg, fr, en e it li hanno già, perciò le altre lingue vanno aggiornate al più presto. </para>
<para
>Assicurati di stare lavorando con gli ultimi sorgenti dall'HEAD del cvs di KHangMan digitando il comando <screen
><userinput
><command>
cvs up -dPA khangman
</command
></userinput
></screen
> nel modulo kdeedu. Quindi <screen
><userinput
><command>
cd kdeedu/khangman
</command
></userinput
></screen>
</para>
<para
>Le parole sono contenute il quattro file, uno per livello. I file si trovano in <filename class="directory"
>/khangman/data/en</filename
>. Il file <filename
>easy.txt</filename
> è per il livello facile, <filename
>medium.txt</filename
> per il livello medio, <filename
>animals.txt</filename
> per il livello animali e <filename
>hard.txt</filename
> per il livello difficile.</para>
<para
>L'inglese è la lingua predefinita e l'unica inclusa di serie in &khangman;. Tutte le altre lingue si trovano nel pacchetto kde-i18n corrispondente. </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
>I file ora utilizano il formato kvtml. 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>
</step>
<step>
<para
>Utilizza un editor di testi per modificare in una nuova cartella tutti i file di testo indicati, sostituendo ogni parola entro il tag <sgmltag class="starttag"
>o</sgmltag
> con la traduzione e ogni suggerimento nel tag <sgmltag class="starttag"
>t</sgmltag
> col relativo suggerimento tradotto. Non importa che sia conservato l'esatto significato della parola, ma cerca di mantenere per quanto possibile inalterate la sua lunghezza e difficoltà. Puoi includere parole comprendenti spazi o trattini (-), che saranno mostrati dall'inizio nel gioco al posto del carattere _. Contatta Anne-Marie Mahfouf <email
>annemarie DOT mahfouf AT free DOT fr</email
> se la tua lingua ha necessità speciali, in modo che possa adattare il codice (specialmente per quanto riguarda caratteri speciali e accentati).</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 <emphasis role="bold"
>codifica UTF-8</emphasis
> 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 cascata 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
>Invece di fare commit dei tuoi file, mandali ad Anne-Marie Mahfouf <email
>annemarie DOT mahfouf AT free DOT fr</email
> in un archivio tar.gz. Dato che al momento sono ventitré le lingue supportate, una procedura guidata (KNewStuff) è stata inclusa in KHangMan per scaricare e installare facilmente nuove lingue rese disponibili sul sito web. Ciò ha lo scopo di ridurre la dimensione del modulo kdeedu, e sarà fatto anche per KLettres, KStars e forse KTouch. Contatta Anne-Marie via e-mail se hai bisogno di ulteriori informazioni.</para>
<para
>Quando mi mandi dei file non dimenticare di menzionare eventuali <emphasis role="bold"
>caratteri speciali</emphasis
> presenti nella tua lingua. Mettili in un file di testo, uno per riga, e aggiungi il file al pacchetto. Segnala anche ogni altra particolarità.</para>
<para
><emphasis
>Non fare mai commit di file su un BRANCH, dato che potrebbe rendere il gioco inutilizzabile.</emphasis
></para>
</step>
</procedure>
<para
>Grazie infinite per il tuo contributo!</para>
</sect1>

<sect1 id="internal">
<title
>Che cosa viene memorizzato da &khangman;, e dove</title>
<para
>Quando ti procuri una nuova lingua tramite <guimenu
>Partita</guimenu
> -> <guimenu
>Ottieni dati in nuova lingua...</guimenu
>, i dati relativi sono memorizzati in <filename class="directory"
>$~/.kde/share/apps/khangman/data</filename
>, nella cartella che ha per nome il codice della lingua. I nomi delle cartelle con le lingue disponibili sono inoltre memorizzati nel file di configurazione di &khangman;, <filename
>~/.kde/share/config/khangmanrc</filename
>. </para>
<para
>Il nome del fornitore (ovvero l'indirizzo del sito web da cui scaricare la nuova lingua) è memorizzato in <filename
>$KDEDIR/share/apps/khangman/khangmanrc</filename
>. </para>
<para
>La lingua inglese (predefinita) e la lingua dell'utente dal pacchetto i18n (se disponibile) si trovano in <filename class="directory"
>$KDEDIR/share/apps/khangman</filename
>. </para>
<para
>Nel file di configurazione, che per ciascun utente è <filename
>~/.kde/share/config/khangmanrc</filename
>, sono salvate tutte le impostazioni del gioco, come lo sfondo, l'ultimo livello a cui si è giocato e così via, e inoltre i file scaricati tramite la finestra KNewStuff. </para>
</sect1>
<sect1 id="planned-features">
<title
>Miglioramenti previsti per &khangman;</title>
<para
>Un miglioramento in progetto consiste ovviamente nell'avere più lingue, e inoltre suggerimenti in ogni lingua. Puoi contribuire con la tua lingua, se ciò non è già stato fatto. Contattami se hai intenzione di dare una mano, si tratta solo di tradurre le parole inglesi nella tua lingua (vedi <link linkend="changing-words"
>Come aggiungere parole in una nuova lingua</link
>). </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.3.</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-2004 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 a sfondo trasparente 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
>Suggerimenti per lo spagnolo: Rafael Beccar <email
>rafael DOT beccar AT kdemail DOT net </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
>File di dati per il serbo (cirillico e latino): Chusslove Illich <email
>chaslav AT sezampro DOT yu </email
></para
> </listitem>
<listitem
><para
>File di dati per lo sloveno: Jure Repinc <email
>jlp AT holodeck1 DOT com </email
></para
> </listitem>
<listitem
><para
>File di dati per il ceco: Luk&aacute;&scaron; Tinkl <email
>lukas AT kde DOT org</email
></para
> </listitem>
<listitem
><para
>File di dati per il tagico: Roger Kovacs <email
>rkovacs AT khujand DOT org </email
></para
> </listitem>
<listitem
><para
>File di dati per il norvegese (Bokm&#229;l): Torger &#197;ge Sinnes <email
>torg-a-s AT online DOT no </email
></para
> </listitem>
<listitem
><para
>File di dati per l'ungherese: Tamas Szanto <email
>tszanto AT mol DOT hu </email
></para
> </listitem>
<listitem
><para
>File di dati per il norvegese (Nyorsk): Gaute Hvoslef Kvalnes <email
>gaute AT verdsveven DOT com </email
></para
> </listitem>
<listitem
><para
>File di dati per il turco: Mehmet &Ouml;zel <email
>mehmet_ozel2003 AT hotmail DOT com </email
></para
> </listitem>
<listitem
><para
>File di dati per il bulgaro: Radostin Radnev <email
>radnev AT yahoo DOT com </email
></para
> </listitem>
<listitem
><para
>File di dati per l'irlandese (gaelico): Kevin Patrick Scannell <email
>scannell AT slu DOT edu </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>
<listitem
><para
>Studio usabilità: Celeste Paul <email
>seele AT obso1337 DOT org</email
></para
> </listitem>
</itemizedlist>
</para>

<para
>Copyright documentazione 2001-2004 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:
-->
