<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY ksirk '<application
>KsirK</application
>'>
  <!ENTITY kapp "&ksirk;"
><!-- replace ksirk here -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Italian "INCLUDE">
]>

<book lang="&language;">

<bookinfo>
<title
>Il manuale di &kapp;</title>

<authorgroup>
<author
><firstname
>Gael</firstname
> <othername
>Kleag</othername
> <surname
>de Chalendar</surname
> <affiliation
> <address
><email
>Kleag@free.fr</email
></address>
</affiliation>
</author>
<othercredit role="translator"
><firstname
>Dario</firstname
><surname
>Panico</surname
><affiliation
><address
><email
>Dareus_Persarumrex@fastwebnet.it</email
></address
></affiliation
><contrib
></contrib
></othercredit
> <othercredit role="translator"
><firstname
>Martino</firstname
><surname
>Barbon</surname
><contrib
></contrib
></othercredit
> 
</authorgroup>


<copyright>
<year
>2002-2008</year>
<holder
>Gael de Chalendar</holder>
</copyright>
<!-- Translators: put here the copyright notice of the translation -->
<!-- Put here the FDL notice.  Read the explanation in fdl-notice.docbook
     and in the FDL itself on how to use it. -->
<legalnotice
>&FDLNotice;</legalnotice>

<!-- Date and version information of the documentation
Don't forget to include this last date and this last revision number, we
need them for translation coordination !
Please respect the format of the date (DD/MM/YYYY) and of the version
(V.MM.LL), it could be used by automation scripts.
Do NOT change these in the translation. -->

<date
>18/08/2005</date>
<releaseinfo
>1.03.00</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para
>&kapp; è la versione computerizzata di un famoso gioco di strategia. Esistono una versione commerciale e una libera ma io (Gael de Chalendar) ho creato questo gioco inizialmente come esercizio per imparare il C++ e poi l'ho sviluppato fino a questo punto (vedi README per i dettagli). </para>
<para
>Alla versione attuale, &kapp; è un gioco con funzionalità di rete per più di un giocatore, con una IA di base. (vedi TODO per i dettagli) </para>
<para
>Questa documentazione fornisce le principali informazioni necessarie per iniziare a giocare. Leggi i suggerimenti e i messaggi della barra di stato per completare le informazioni. Un capitolo spiega come creare nuovi temi per &kapp; </para>
<para
>Lo scopo del gioco è semplicemente conquistare il Mondo... Lo otterrai attaccando i tuoi vicini con i tuoi eserciti. Pacifista, no? :-) </para>
</abstract>

<!-- This is a set of Keywords for indexing by search engines.
Please at least include KDE, the KDE package it is in, the name
 of your application, and a few relevant keywords. -->

<keywordset>
<keyword
>KDE</keyword>
<keyword
>giochi kde</keyword>
<keyword
>gioco</keyword>
<keyword
>strategia</keyword>
<keyword
>Rischio</keyword>
<keyword
>libero</keyword>
<keyword
>GPL</keyword>
<keyword
>Rete</keyword>
<keyword
>IA</keyword>
</keywordset>

</bookinfo>

<!-- The contents of the documentation begin here.  Label
each chapter so with the id attribute. This is necessary for two reasons: it
allows you to easily reference the chapter from other chapters of your
document, and if there is no ID, the name of the generated HTML files will vary
from time to time making it hard to manage for maintainers and for the CVS
system. Any chapter labelled (OPTIONAL) may be left out at the author's
discretion. Other chapters should not be left out in order to maintain a
consistent documentation style across all KDE apps. -->

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

<!-- The introduction chapter contains a brief introduction for the
application that explains what it does and where to report
problems. Basically a long version of the abstract.  Don't include a
revision history. (see installation appendix comment) -->
<para
>&kapp; è la versione computerizzata di un famoso gioco di strategia. Esistono una versione commerciale e una libera ma io (Gael de Chalendar) ho creato questo gioco inizialmente come esercizio per imparare il C++ e poi l'ho sviluppato fino a questo punto (vedi README per i dettagli). </para>
<para>
<screenshot>
  <screeninfo
>Ecco una schermata di &kapp;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="firing-screenshot.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Schermata</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>Alla versione attuale, &kapp; è un gioco con funzionalità di rete per più di un giocatore, con una IA di base. (vedi TODO per i dettagli) </para>
<para
>Questa documentazione fornisce le principali informazioni necessarie per iniziare a giocare. Leggi i suggerimenti e i messaggi della barra di stato per completare le informazioni. </para>
<para
>Lo scopo del gioco è semplicemente conquistare il Mondo... Lo otterrai attaccando i tuoi vicini con i tuoi eserciti. Pacifista, no? :-) </para>
</chapter>

<chapter id="using-kapp">
<title
>Usare &kapp;</title>

<!-- This chapter should tell the user how to use your app. You should use as
many sections (Chapter, Sect1, Sect3, etc...) as is necessary to fully document
your application. -->



<sect1 id="playing-ksirk">
<title
>Giocare a &kapp;</title>
<para
>Nota preliminare: si può scorrere la mappa in tre modi. Primo, puoi mettere il mouse vicino al bordo della finestra, e la mappa scorrerà in quella direzione. Secondo, puoi usare la rotellina del mouse: senza modificatore, scorrerà in verticale; premendo il tasto Meta, scorrerà in orizzontale. Inoltre, puoi usare i tasti freccia. </para>
<sect2 id="mainmenu">
<title
>Iniziare una partita</title>
<para
>Quando &kapp; si avvia, ti accoglie con il menu principale. <screenshot>
  <screeninfo
>Il menu principale di &kapp;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="introscreen.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Menu principale</phrase>
    </textobject>
  </mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term>
  <menuchoice>
    <guimenu
>Nuova partita</guimenu>
  </menuchoice>
</term>
<listitem>
  <para>
  <action
>Avvia una nuova partita</action>
  </para>
</listitem>
</varlistentry>
<varlistentry>
  <term>
    <menuchoice>
      <guimenu
>Partecipa</guimenu>
    </menuchoice>
  </term>
  <listitem>
    <para>
      <action
>Permette di partecipare a una partita in rete</action>
    </para>
  </listitem>
</varlistentry>
<varlistentry>
  <term>
    <menuchoice>
      <guimenu
>Carica</guimenu>
    </menuchoice>
  </term>
  <listitem>
    <para>
      <action
>Usa questo per caricare una partita precedentemente salvata</action>
    </para>
  </listitem>
</varlistentry>
<varlistentry>
  <term>
    <menuchoice>
      <guimenu
>Esci</guimenu>
    </menuchoice>
  </term>
  <listitem>
    <para>
      <action
>Magari alla fine non vuoi giocare?</action>
    </para>
  </listitem>
</varlistentry>
</variablelist>
</para>
<para
>Se fai clic su Nuova partita, ti si aprirà la finestra di dialogo Nuova partita dove potrai scegliere il numero di giocatori, il tema da usare, il tipo di partita (conquista o per obbiettivi) e infine se giocare la partita in rete o localmente. <screenshot>
  <screeninfo
>Finestra di dialogo Nuova partita</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="newgamedialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Finestra di dialogo Nuova partita</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>Per avviare una partita in rete, seleziona la casella «Partita in rete» sulla destra della casella numerica del numero dei giocatori. Dopo aver fatto clic su Ok, potrai impostare i parametri di rete: numero di giocatori in rete e porta TCP su cui aspettare connessioni. <screenshot>
  <screeninfo
>Finestra di dialogo Parametri di rete</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="numnetplayersdialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Finestra di dialogo Parametri di rete</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>A quel punto i giocatori in rete potranno connettersi selezionando Partecipa nel menu principale e indicando l'IP o l'hostname dell'ospite e il numero della porta che hai precedentemente selezionato. <screenshot>
  <screeninfo
>Finestra di dialogo Partecipa a partita in rete</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="joinnetgame.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Finestra di dialogo Partecipa a partita in rete</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>Ogni connessione è indicata dal messaggio nella barra di stato. <screenshot>
  <screeninfo
>Messaggio di connessione</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="justjoined.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Messaggio di connessione</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</para>
<para
>Immaginiamo tu mantenga tutte le impostazioni predefinite e selezioni Ok. Allora imposterai due giocatori, uno dopo l'altro. Per ciascuno dovrai scegliere un nome, una nazionalità e, se vuoi, impostare una password in modo che nessun altro possa utilizzare questo giocatore caricando il salvataggio della partita. Infine puoi scegliere se questo giocatore sarà guidato dal computer o da un essere umano. <screenshot>
  <screeninfo
>Finestra di dialogo Impostazioni giocatore</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="playersetupdialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Finestra di dialogo Impostazioni giocatore</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>Se scegli di giocare per obbiettivi, l'obbiettivo di ogni giocatore locale sarà mostrato preceduto da un messaggio di avviso che consiglia di non far vedere l'obbiettivo agli altri giocatori vicino al computer. <screenshot>
  <screeninfo
>Finestra di dialogo Mostra obbiettivo</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="displaygoalmessage.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Finestra di dialogo Mostra obbiettivo</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<screenshot>
  <screeninfo
>Messaggio di avviso Mostra obbiettivo</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="displaygoalwarningmessage.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Messaggio di avviso Mostra obbiettivo</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>

<sect2 id="distribution">
<title
>Distribuzione</title>
<para
>All'inizio del gioco, gli stati sono distribuiti a tutti i giocatori. All'inizio ogni stato contiene un'armata (rappresentata da un soldato di fanteria). Ogni giocatore possiede alcune armate da distribuire ai suoi stati nel suo turno (indicato dalla presenza del suo nome e della sua bandiera nella barra di stato). Nota che cinque armate sono rappresentate da un soldato di cavalleria, e dieci da un cannone. </para>
<para
>Per mettere un'armata in uno dei tuoi stati, fai clic con il pulsante sinistro del mouse. Per rimuovere un'armata, fai clic con il tasto destro. Nota, come regola generale, che non potrai mai rimuovere un numero di armate superiore a quelle che hai già disposto. <screenshot>
  <screeninfo
>Posizionamento armate</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="placingarmies.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Posizionamento armate</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</para>
<para
>Quando un giocatore ha distribuito tutte le proprie armate, il giocatore successivo è selezionato automaticamente per svolgere la stessa procedura. Quando tutti i giocatori avranno finito di distribuire le proprie armate, si potrà scegliere tra due possibilità tramite due pulsanti nel pannello di destra: <variablelist>
<varlistentry>
<term>
  <menuchoice>
    <guimenu>
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="distributionArmees.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Ridistribuzione</phrase>
        </textobject>
      </inlinemediaobject
> : Ridistribuzione </guimenu>
  </menuchoice>
</term>
<listitem>
  <para>
  <action
>Un giocatore vuole cambiare alcune delle sue scelte. Il primo giocatore può quindi rimuovere un'armata che ha messo in uno stato con il tasto destro del mouse, e metterla in un altro con il tasto sinistro. Quando termina, passa il controllo al giocatore successivo con il pulsante «Convalida». Quando tutti i giocatori hanno finito la ridistribuzione, i due pulsanti sono visualizzati di nuovo. </action>
  </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
  <menuchoice>
    <guimenu>
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="distributionArmeesFinie.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Fine della ridistribuzione</phrase>
        </textobject>
      </inlinemediaobject
> : Fine della ridistribuzione </guimenu>
  </menuchoice>
</term>
<listitem
><para
><action
>La ridistribuzione è terminata e il gioco può continuare. </action
></para
></listitem>
</varlistentry>
</variablelist>

</para>
</sect2>

<sect2 id="fight">
<title
>Combatti</title>
<para
>Dopo la ridistribuzione, inizia il turno. Ogni giocatore gioca a turno. Può scegliere di: <variablelist>
  <varlistentry>
    <term>
      <menuchoice>
        <guimenu>
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="joueurSuivant.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Giocatore Successivo</phrase>
            </textobject>
          </inlinemediaobject
> : Passa la mano al giocatore seguente (pulsante nella barra degli strumenti) </guimenu>
      </menuchoice>
    </term>
    <listitem>
      <para>
        <action
>Finisce il turno dell'attuale giocatore e tocca al successivo. </action>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term>
      <menuchoice>
        <guimenu>
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="attackOne.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Attacca 1</phrase>
            </textobject>
          </inlinemediaobject>
&nbsp;<inlinemediaobject
> <imageobject
> <imagedata fileref="attackTwo.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Attacca 2</phrase
> </textobject
> </inlinemediaobject
> &nbsp;<inlinemediaobject
> <imageobject
> <imagedata fileref="attackThree.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Attacca 3</phrase
> </textobject
> </inlinemediaobject
> : Attacca con una, due o tre armate &nbsp;<inlinemediaobject>
            <imageobject>
              <imagedata fileref="autoattack.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Attacca automaticamente</phrase>
            </textobject>
          </inlinemediaobject>
        </guimenu>
      </menuchoice>
    </term>
    <listitem>
      <para
>Per attaccare trascina le armate dallo stato che attacca a quello attaccato. Ti sarà mostrato un menu contestuale con le seguenti voci.<screenshot
> <screeninfo
>Menu di attacco</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="attackmenu.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Menu di attacco</phrase
> </textobject
> </mediaobject
> </screenshot
> Affinché uno stato X attacchi uno stato Y con x armate, due condizioni devono essere verificate: 1. i due stati devono confinare; 2. lo stato X deve avere almeno x+1 armate prima dell'attacco. Se l'attacco è valido, è mostrata una finestra di dialogo al difensore se vuole difendere con una due armate o lasciar decidere al computer. </para>
      <para
>Dopo la scelta del difensore avrà luogo la battaglia. Quest'ultimo è descritto in seguito. <screenshot>
            <screeninfo
>Finestra di dialogo Difesa</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="defensedialog.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Finestra di dialogo Difesa</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term>
      <menuchoice>
        <guimenu>
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="moveArmies.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Muovi armate</phrase>
            </textobject>
          </inlinemediaobject
> : Muove le armate da uno stato ad un altro </guimenu>
      </menuchoice>
    </term>
    <listitem>
      <para>
        <action
>Questa è l'ultima azione del turno di un giocatore. Dà la possibilità di muovere alcune armate da uno dei propri stati ad un altro, confinante con il primo. Per scegliere i due paesi, fai clic e trascina come per un attacco. Quando entrambe le nazioni sono selezionate, appare un cursore con cui scegliere quante armate vorrai avere in ogni stato. </action>
      </para>
    </listitem>
  </varlistentry>
</variablelist>
</para>
</sect2>
<sect2  id="fight-solution">
  <title
>Risoluzione del combattimento</title>
  <para
>Per ogni armata coinvolta si lancerà un dado. Il giocatore che otterrà il numero maggiore sul dado, sia esso l'attaccante o il difensore, vince e quello con il numero più basso perde un numero di armate basato sul numero di dadi lanciati. <screenshot>
            <screeninfo
>Riepilogo attacco</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="shownumberofarmies.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Riepilogo attacco</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
  </para>
  <para
>Se il numero delle armate nello stato del difensore raggiunge lo 0, lo stato diventa di proprietà dell'attaccante: viene impostata la sua bandiera e una delle sue armate si installa nel suo nuovo stato. Viene allora mostrato il cursore «Muovi armate» come alla fine del turno. <screenshot>
            <screeninfo
>Cursore invasione</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="invasionslider.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Cursore invasione</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
  </para>
</sect2>
<sect2  id="end_of_turn">
  <title
>Fine del turno</title>
  <para
>Per concludere il turno attuale, se non vuoi muovere armate, puoi fare clic sul pulsante Prossimo giocatore» nella barra degli strumenti. </para>
  <para
>Quando tutti hanno giocato, la mano finisce. Vengono distribuite alcune armate ai giocatori, a seconda degli stati che possiedono: 1 per ogni gruppo di stati, con un minimo di tre. Inoltre c'è un bonus per i giocatori che possiedono un intero continente, ognuno differente. I valori dei bonus per il tema attuale sono: <table>
      <title
>Bonus per i continenti</title>
      <tgroup cols="2">
        <thead>
          <row
><entry
>Continente</entry
><entry
>Bonus</entry
></row>
        </thead>
        <tbody>
          <row
><entry
>Nord America</entry
><entry
>5</entry
></row>
          <row
><entry
>Sud America</entry
><entry
>2</entry
></row>
          <row
><entry
>Europa</entry
><entry
>5</entry
></row>
          <row
><entry
>Africa</entry
><entry
>3</entry
></row>
          <row
><entry
>Asia</entry
><entry
>7</entry
></row>
          <row
><entry
>Area del Pacifico</entry
><entry
>2</entry
></row>
        </tbody>
      </tgroup>
    </table>
  </para>
  <para
>Quando un giocatore termina di distribuire le proprie armate, fa clic su «Convalida» per permettere al giocatore seguente di distribuire le sue armate bonus. Come per la distribuzione iniziale, quando tutti i giocatori hanno disposto tutte le loro armate, possono iniziare un ulteriore giro di ridistribuzione o iniziare una nuova mano... </para>
</sect2>
<sect2 id="sending-messages">
<title
>Inviare messaggi agli altri giocatori</title>
<para
>Se vuoi comunicare con gli altri giocatori in una partita in locale, beh, parla (a meno che tu non abbia problemi di accessibilità)... Ma se stai partecipando ad una partita in rete, puoi usare lo spazio di chat sul fondo della finestra (può essere nascosto o mostrato usando le frecce). Inserisci il tuo messaggio e premi Invio. <screenshot>
            <screeninfo
>Inviare messaggi</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="messagesent.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Inviare messaggi</phrase>
              </textobject>
            </mediaobject>
          </screenshot>

</para>
</sect2>
</sect1>
</chapter>

<chapter id="commands">
<title
>Guida ai Comandi</title>

<sect1 id="kapp-mainwindow">
<title
>La finestra principale di &kapp;</title>
<sect2>
<title
>I pulsanti</title>
<para>
<variablelist>
<varlistentry>
<term>
  <menuchoice>
    <guimenu>
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="quit.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Esci</phrase>
        </textobject>
      </inlinemediaobject
> : Esce dal gioco </guimenu>
  </menuchoice>
</term>
<listitem
><para
><action
>Fa terminare il programma. </action
></para
></listitem>
</varlistentry>
<varlistentry>
<term>
  <menuchoice>
    <guimenu>
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="newGame.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Nuovo Gioco</phrase>
        </textobject>
      </inlinemediaobject
> : Nuovo Gioco </guimenu>
  </menuchoice>
</term>
<listitem
><para
><action
>Inizia un nuovo gioco. Verrà visualizzata una finestra di dialogo dove inserire il numero di giocatori. Dopodiché, verrà chiesto il nome di ogni giocatore in un'altra finestra. </action
></para
></listitem>
</varlistentry>
</variablelist>
</para>

</sect2>

</sect1>
</chapter>

<chapter id="developers">
  <title
>Guida degli Sviluppatori di &kapp;</title>
  
  <para
>Si prega di fare riferimento alla documentazione di KDoc per le API. Era piuttosto completa, ma è attualmente un po' datata. Non ci sono commenti nei file <filename
>.cpp</filename
> di implementazione. </para>
  <para
>Nota che ho sviluppato originariamente questo gioco in Windoz con Borland C++ e WinG. L'ho portato in &Java; per poi riconvertirlo in C++ e&kde;. All'inizio ho usato il francese o un misto di francese e inglese per nominare gli identificatori (classi, metodi, membri, &etc;). Ho anche usato il francese per i commenti. Quando ho deciso di distribuire questo gioco, ho scelto di convertirlo tutto in inglese... ma chiaramente non sono un madrelingua: per piacere suggeriscimi oppure fai e invia le correzioni, ai commenti del codice o a questa documentazione </para>
  
</chapter>

<chapter id="skins">
  <title
>Creare nuovi temi</title>
  <para
>&kapp; è completamente modificabile. Per quelli che hanno capacità di grafica, creare un nuovo tema è semplice come copiarne uno esistente, modificarlo o cambiare la grafica e aggiornare i dati in un file .desktop di configurazione. L'ultimo passo è modificare il file descrivendo cosa installare. </para>
  <para
>Tutti gli esempi (testo ed immagini) sono presi dal tema predefinito di &kapp;</para>
  <sect1 id="sdf">
    <title
>Struttura delle cartelle e dei file</title>
    <para>
      <itemizedlist>
        <listitem>
          <para
>Data/: Dati utilizzati dal programma per manipolare le immagini del tema. <itemizedlist>
              <listitem
><para
>CMakeLists.txt: Descrive cosa installare.</para
></listitem>
              <listitem
><para
>onu.desktop: File principale per la descrizione del tema. Vedi sotto per la sua descrizione.</para
></listitem>
            </itemizedlist>
          </para>
        </listitem>
        <listitem>
          <para
>Images/: Le immagini del tema (mappa, entità, ecc.) <itemizedlist>
              <listitem
><para
>CMakeLists.txt: Descrive cosa installare.</para
></listitem>
              <listitem
><para
>pool.svg: la mappa e le entità usate in questo tema.</para
></listitem>
              <listitem
><para
>map-mask.png: l'immagine che permette al programma di cercare sopra che stato è il mouse durante il gioco (vedi sotto).</para
></listitem>
              <listitem
><para
>*.png: le altre immagini qui sono immagini di pulsanti.</para
></listitem>
            </itemizedlist>
          </para>
        </listitem>
        <listitem
><para
>CMakeLists.txt/: Descrive cosa installare.</para
></listitem>
        <listitem
><para
>Sounds/: file audio per il tema.</para
></listitem>
      </itemizedlist>
    </para>
  </sect1>
  <sect1 id="tdd">
    <title
>La cartella Data</title>
    <sect2>
      <title
>Il file onu.desktop</title>
      <para
>Questo file è una descrizione dei contenuti del tema. E' usato per descrivere l'organizzazione del mondo e come visualizzarla. Presenta la seguente struttura: </para>
      <para
>Un gruppo onu contiene un certo numero di stati, un certo numero di nazionalità e per finire un certo numero di continenti. Dunque vari gruppi contengono la descrizione di diverse entità, la descrizione di diversi stati, continenti, nazionalità e obbiettivi. </para>
      <para
>La sezione seguente descrive i contenuti di ogni gruppo. </para>
      <sect3>
        <title
>Gruppo onu</title>
        <para>
          <table>
            <title
>Le voci del gruppo onu</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Nome della voce</entry
><entry
>Significato</entry
></row
></thead>
              <tbody>
                <row
><entry
>Larghezza</entry
><entry
>La larghezza della mappa del tema</entry
></row>
                <row
><entry
>altezza</entry
><entry
>L'altezza della mappa del tema</entry
></row>
                <row
><entry
>percorso del tema</entry
><entry
>Il percorso del tema relativo al percorso dei dati dell'applicazione (e.g. skins/default)</entry
></row>
                <row
><entry
>nb-countries</entry
><entry
>Il numero di stati (42 nel tema predefinito). Ci dovrebbe essere lo stesso numero di gruppi di stato specificati sotto</entry
></row>
                <row
><entry
>nb-nationalities</entry
><entry
>Il numero di nazionalità (6 nel tema predefinito). ci dovrebbe essere lo stesso numero di gruppi di nazionalità di seguito</entry
></row>
                <row
><entry
>nb-continents</entry
><entry
>Il numero di continenti (6 nel tema predefinito). Ci dovrebbero essere lo stesso numero di gruppi continente di seguito</entry
></row>
                <row
><entry
>pool</entry
><entry
>Il percorso e il nome del file con le immagini relativo al percorso del tema (p.e. Images/pool.svg)</entry
></row>
                <row
><entry
>map-mask</entry
><entry
>Il percorso e il nome del file maschera della mappa relativo al percorso del tema (ad es. Images/map-mask.png)</entry
></row>
                <row
><entry
>format-version</entry
><entry
>La versione del formato del file del tema (2.0)</entry
></row>
                <row
><entry
>nome</entry
><entry
>Il nome dell'elemento da mostrare</entry
></row>
                <row
><entry
>desc</entry
><entry
>Una lunga descrizione del tema</entry
></row>
                <row
><entry
>fighters-flag-y-diff</entry
><entry
>La differenza di altezza tra entità bandiere e cannoni</entry
></row>
                <row
><entry
>width-between-flag-and-fighter</entry
><entry
>Il numero di pixel tra il pixel più a sinistra della bandiera e il pixel più a destra del cannone semplice (quando non è né in sparo né in esplosione)</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>I gruppo di descrizione delle entità</title>
        <para
>Ogni tipo di entità (bandiera, fanteria, cavalleria, cannone, cannone che spara e cannone che esplode) è definita da un gruppo. Solo alcune entità hanno una voce larghezza. Questa voce è usata per il posizionamento relativo durante le animazioni: i cannoni, che sparano o che esplodono, non dovrebbero "muoversi" attorno alla bandiera dello stato durante il combattimento. <table>
            <title
>Voci del gruppo di descrizione delle entità</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Voce</entry
><entry
>Significato</entry
></row
></thead>
              <tbody>
                <row
><entry
>Larghezza</entry
><entry
>La larghezza di riferimento dei fotogrammi dell'entità bandiera</entry
></row>
                <row
><entry
>altezza</entry
><entry
>L'altezza di riferimento dei fotogrammi dell'entità bandiera</entry
></row>
                <row
><entry
>frames</entry
><entry
>Il numero di fotogrammi dell'entità</entry
></row>
                <row
><entry
>versions</entry
><entry
>Il numero di versioni delle entità bandiera</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>I gruppi di descrizione degli stati</title>
        <para
>Ogni stato elencato nel gruppo onu ha il suo gruppo, la cui etichetta è il nome dello stato. La tabella seguente elenca le voci di questi gruppi. </para>
        <para>
          <table>
            <title
>Voci dello stato</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Nome della voce</entry
><entry
>Significato</entry
></row
></thead>
              <tbody>
                <row
><entry
>id</entry
><entry
>Il numero intero di identificazione univoca di ogni stato, deve partire da zero (0)</entry
></row>
                <row
><entry
>nome</entry
><entry
>Il nome dello stato da mostrare</entry
></row>
                <row
><entry
>&lt;sprite&gt;-point</entry
><entry
>Ogni tipo di entità (bandiera, fanteria, ecc.) è visualizzata in una certa posizione dello stato definita da questa etichetta, composta da due interi separati da una virgola</entry
></row>
                <row
><entry
>neighbours</entry
><entry
>La lista degli identificativi degli stati confinanti con lo stato corrente</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>I gruppi di descrizione delle nazionalità</title>
        <para
>Ogni nazionalità elencato nel gruppo onu ha il suo gruppo, la cui etichetta è il nome della nazionalità. La tabella seguente elenca le voci di questi gruppi. </para>
        <para>
          <table>
            <title
>Nationality entries</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Nome della voce</entry
><entry
>Significato</entry
></row
></thead>
              <tbody>
                <row
><entry
>nome</entry
><entry
>Il nome della nazionalità (ad es. Giappone)</entry
></row>
                <row
><entry
>leader</entry
><entry
>Il nome proposto al giocatore mentre sceglie la sua nazionalità</entry
></row>
                <row
><entry
>flag</entry
><entry
>Il nome dell'entità della bandiera della nazione nel file SVG onu</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>I gruppi di descrizione dei continenti</title>
        <para
>Ogni continente elencato nel gruppo onu ha il suo gruppo, la cui etichetta è il nome del continente. La tabella seguente elenca le voci di questi gruppi. </para>
        <para>
          <table>
            <title
>Voci continente</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Nome della voce</entry
><entry
>Significato</entry
></row
></thead>
              <tbody>
                <row
><entry
>nome</entry
><entry
>Il nome del continente (ad es. Africa)</entry
></row>
                <row
><entry
>id</entry
><entry
>Il numero intero di identificazione univoca del continente</entry
></row>
                <row
><entry
>bonus</entry
><entry
>Il numero di armate ottenute alla fine del turno dal giocatore che possiede tutti gli stati di un continente</entry
></row>
                <row
><entry
>continent-countries</entry
><entry
>La lista degli id degli stati appartenenti al continente in questione</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>I gruppi di descrizione degli obbiettivi</title>
        <para
>Ogni obbiettivo elencato nel gruppo onu ha il suo gruppo, la cui etichetta è il nome dell'obbiettivo. La tabella seguente elenca le voci di questi gruppi. </para>
        <para>
          <table>
            <title
>Voci obbiettivo</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Nome della voce</entry
><entry
>Significato</entry
></row
></thead>
              <tbody>
                <row
><entry
>type</entry
><entry
>Il tipo dell'obbiettivo. Possono essere continenti, stati o giocatori</entry
></row>
                <row
><entry
>nbArmiesByCountry</entry
><entry
>imposta il numero minimo di armate che un giocatore deve posizionare in ogni stato</entry
></row>
                <row
><entry
>nbCountries</entry
><entry
>imposta il numero di stati che il giocatore deve possedere</entry
></row>
                <row
><entry
>nbCountriesFallback</entry
><entry
>Per un obbiettivo di tipo giocatore, se la vittima è uccisa da un altro giocatore, imposta il numero di stati che il giocatore deve conquistare come obbiettivo</entry
></row>
                <row
><entry
>desc</entry
><entry
>Una descrizione testuale dell'obbiettivo con appropriati segnaposto (c'è bisogno di ulteriore documentazione per questo)</entry
></row>
                <row
><entry
>continents</entry
><entry
>La lista degli identificativi dei continenti che un giocatore deve conquistare</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

    </sect2>
  </sect1>
  <sect1 id="tid">
    <title
>La cartella Images</title>
    <para
>Questa cartella contiene i pulsanti di &kapp; e il file SVG contenitore che include la mappa e tutte le entità. </para>
    <sect2>
      <title
>Il file pool.svg</title>
      <para
>Questo file SVG contiene la mappa e tutte le entità del gioco. Ogni elemento ha un nome così che il gioco possa selezionare e disegnare separatamente ognuno di essi. </para>
      <para
>Nel tema predefinito, le entità sono bandiere, fanteria, cavalleria e cannone. La fanteria rappresenta una armata, la cavalleria cinque e i cannoni dieci. I cannoni sono inoltre usati per visualizzare le battaglie in corso. Per questo motivo ci sono tre tipi di entità cannone: quello normale (fermo o in movimento), quello che spara e quello che esplode. </para>
      <para
>Ogni immagine di entità è costituita valle varie viste dell'oggetto e, per ogni vista, dai suoi fotogrammi. Le viste sono organizzate verticalmente e i fotogrammi orizzontalmente. Dividendo l'altezza dell'immagine per il numero di viste e la larghezza per il numero dei fotogrammi si trova dove tagliare l'immagine nei singoli fotogrammi. Questi dati si trovano nel file onu.desktop. <mediaobject
><imageobject
><imagedata fileref="cannon.png" format="PNG"/></imageobject
><caption
><para
>Un esempio di un'immagine di entità: cannon.png</para
></caption
></mediaobject>
      </para>
      <para
>Per le entità armata ci sono tre viste differenti, dall'alto al basso: guardando a destra, guardando a sinistra e di fronte. Per le bandiere, c'è solo una vista. Tutti gli sfondi delle entità dovrebbero essere trasparenti. <mediaobject
><imageobject
><imagedata fileref="italy.png" format="PNG"/></imageobject
><caption
><para
>Un esempio di immagine di entità bandiera: italy.png</para
></caption
></mediaobject>
      </para>
      <para>
      <table>
      <title
>Gli elementi del contenitore</title>
      <tgroup cols="3">
      <thead
><row
><entry
>Nome dell'elemento</entry
><entry
>Immagine di esempio</entry
><entry
>Significato</entry
></row
></thead>
      <tbody>
        <row>
          <entry
>map</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="map.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>La mappa del mondo del tema. Gli stati possono avere qualsiasi forma, ma dovrebbero essere raggruppati in continenti riconoscibili a colpo d'occhio, solo dalla posizione o dal colore</entry>
  </row>
        <row>
          <entry
>italy</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="italy.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>La bandiera della nazione italiana. Ce n'è una per ogni nazionalità</entry>
  </row>
        <row>
          <entry
>infantry</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>cavalry</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>cannon</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>firing</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>exploding</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>Alaska</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>reddices</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>mark1</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
        </row>
      </tbody>
      </tgroup>
      </table>
      </para>
    </sect2>
    <sect2>
      <title
>Il file map-mask.png</title>
      <para
>Questo è un file png che rappresenta anche la mappa del mondo del tema, ma con un codice di colori che permette di identificare univocamente ogni stato. Gli stati devono avere almeno le stesse forme degli stati corrispondenti nel file map.png in modo che gli utenti possano fare clic ovunque in uno stato visibile e selezionare quello corretto. Gli stati con piccole isole come l'Indonesia nella mappa predefinita possono essere più grandi del corrispondente nel file map.png per facilitare la selezione dello stato. <mediaobject>
          <imageobject
><imagedata fileref="map-mask.png" format="PNG"/></imageobject>
          <textobject
><phrase
>Una maschera di mappa di esempio</phrase
></textobject>
        </mediaobject>
      </para>
      <para
>Il componente blu (secondo il modello RGB) del colore di uno stato identifica lo stato: l'indice 0 è lo stato 0 nel file onu.xml, l'indice 1 è lo stato 1, &etc;. Il bianco (0xFFFFFF in RGB) identifica l'assenza di stato (oceani oppure, perché no, terre di nessuno). </para>
    </sect2>
    <sect2>
      <title
>Le immagini dei pulsanti</title>
      <para
>I nomi dei file sono codificati nel codice, in questo modo non saranno modificati. La tabella seguente mostra i pulsanti che dovrebbero essere forniti.</para>
      <table>
      <title
>I pulsanti della &GUI; </title>
      <tgroup cols="3">
      <thead
><row
><entry
>Immagine</entry
><entry
>Nome del file</entry
><entry
>Significato</entry
></row
></thead>
      <tbody>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="newNetGame.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>newNetGame.png</entry
><entry
>Cerca di partecipare a una partita in rete</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="recycling.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>distributionArmees.png</entry
><entry
>Dopo che tutti i giocatori hanno disposto le loro armate, è possibile modificare le distribuzioni (operazione di ricircolo). Questo pulsante chiede se fare questa ridistribuzione</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="recyclingFinished.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>distributionArmeesFinie.png</entry
><entry
>Sceglie di non ridistribuire. Tutte le finestre dei client devono aver cliccato questo pulsante perché termini realmente la distribuzione</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="nextPlayer.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>joueurSuivant.png</entry
><entry
>Termina il turno del giocatore corrente e passa a quello successivo o alla mano successiva se il giocatore corrente era l'ultimo</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="attackOne.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>attackOne.png</entry
><entry
>Sceglie di iniziare l'attacco con un'armata</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="attackTwo.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>attackTwo.png</entry
><entry
>Sceglie di iniziare l'attacco con due armate</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="attackThree.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>attackThree.png</entry
><entry
>Sceglie di iniziare l'attacco con un'armata</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="defendOne.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>defendOne.png</entry
><entry
>Sceglie di difendere uno stato attaccato con una armata</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="defendTwo.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>defendTwo.png</entry
><entry
>Sceglie di difendere uno stato attaccato con due armate</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="moveArmies.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>moveArmies.png</entry
><entry
>Sceglie di iniziare a spostare le armate tra due stati (ultima azione del turno)</entry>
        </row>
      </tbody>
      </tgroup>
      </table>
    </sect2>
  </sect1>
  <sect1 id="tsd">
    <title
>La cartella Sounds</title>
    <para
>Questa cartella contiene tre file audio: roll.wav che viene riprodotto durante lo spostamento delle armate; caccon.wav riprodotto durante un attacco e crash.wav riprodotto quando un'armata viene distrutta.</para>
  </sect1>
</chapter>

<chapter id="faq">
<title
>Domande e Risposte</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist"
> <qandaentry>
<question>
<para
>Quale sarà la prima domanda a proposito di &kapp;?</para>
</question>
 
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE
distribution. -->

<title
>Ringraziamenti e Accordi di Licenza</title>

<para
>&kapp; </para>
<para
>Copyright del programma 2002-2008 Gael de Chalendar <email
>kleag@free.fr</email
> </para>
<para
>Contributi di: Robin Doer, Albert Astals Cid, Michal Golunski (traduzione in Polacco). </para>

<para
>Copyright della documentazione 2002-2008 Gael de Chalendar <email
>kleag@free.fr</email
> </para>

<para
>Traduzione di Dario Panico<email
>Dareus_Persarumrex@fastwebnet.it</email
> e Martino Barbon</para
> 
&underFDL; &underGPL; </chapter>

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

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

<sect1 id="compilation">
<title
>Compilazione e installazione</title>
&install.compile.documentation; </sect1>

<sect1 id="configuration">
<title
>Configurazione</title>

<para
>La voce menu impostazioni apre una finestra di dialogo che ti permette di: <screenshot>
            <screeninfo
>Finestra di dialogo Preferenze</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="preferences.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Finestra di dialogo Preferenze</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
</para>
      <itemizedlist>
        <listitem>
          <para
>abilita o disabilita i suoni: </para>
        </listitem>
        <listitem>
          <para
>imposta la velocità delle entità (da lenta a immediata): </para>
        </listitem>
        <listitem>
          <para
>abilita o disabilita l'aiuto contestuale mostrato nelle finestre a comparsa: </para>
        </listitem>
        <listitem>
          <para
>mostra o nasconde il numero di armate per stato. La schermata seguente mostra la mappa quando il numero di armate è visualizzato. <screenshot>
              <screeninfo
>Mostra il numero di armate</screeninfo>
              <mediaobject>
                <imageobject>
                  <imagedata fileref="shownumberofarmies.png" format="PNG"/>
                </imageobject>
                <textobject>
                  <phrase
>Mostra il numero di armate</phrase>
                </textobject>
              </mediaobject>
            </screenshot>

          </para>
        </listitem>
      </itemizedlist>

</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:
-->













