<!-- 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
>&kgeography; è uno strumento per l'apprendimento della geografia per &kde;. Ti permette di apprendere le divisioni politiche di alcune nazioni (divisioni, capitali di queste divisioni e le loro bandiere se ve ne sono). </para>
<para
>Le mappe attualmente disponibili sono: Africa, America del nord e centrale, America del sud, Asia, Austria, Brasile, Canada, Cina, Europa, Francia, Germania, Italia, Italia per province, Norvegia, Polonia, Spagna, Stati Uniti d'America e il mondo. </para>
</chapter>
<chapter id="quick-start">
<title
>Introduzione rapida a &kgeography;</title>
<para
>Quando avvii &kgeography; per la prima volta, ti chiede per prima cosa di scegliere una mappa con cui iniziare. <screenshot>
<screeninfo
>Immagine di &kgeography; al primo avvio</screeninfo>
>Quando hai finito tutte le domande, viene mostrata una finestra di dialogo con i risultati mostrando le tue risposte corrette e quelle non corrette: <screenshot>
>Indovina una divisione dalla sua capitale: ti viene chiesto di trovare il nome di una provincia, data la sua capitale, in una lista di 4: <screenshot>
<screeninfo
>Indovina una divisione dalla sua capitale</screeninfo>
>Indovina la capitale di una divisione: hai una capitale e quattro nomi di provincia e devi scegliere quello corretto. Come prima, alla fine viene mostrata una finestra di dialogo con i risultati. </para>
<para
>Indovina divisione dalla sua bandiera: viene mostrata una bandiera e tu devi trovare la provincia a cui appartiene. <screenshot>
> uno strumento (creato da Yann Verley) che lo ha aiutato con la mappa della Francia. Per vedere il suo utilizzo, eseguilo semplicemente e leggi il messaggio di aiuto. Sostanzialmente, crea il file <literal role="extension"
>.kgm</literal
> da un file di testo semplice e crea un file con i colori che ha assegnato a ogni divisione, così puoi riempire la mappa a seconda di quei colori.</para>
</sect1>
<sect1 id="description-file">
<title
>File di descrizione</title>
<para
>Il file di descrizione è richiesto e la sua estensione è <literal role="extension"
>.kgm</literal
>. Dovrebbe cominciare con <sgmltag class="starttag"
>map</sgmltag
> e finire con <sgmltag class="endtag"
>map</sgmltag
>. </para>
<para
>Dentro quelle tag ci dovrebbero essere: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>mapFile</sgmltag
> e <sgmltag class="endtag"
>mapFile</sgmltag
>: il nome del file (senza alcun percorso) contenente l'immagine della mappa, ⪚ <quote
>europe.png</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> e <sgmltag class="endtag"
>name</sgmltag
>: il nome della mappa, ⪚ <quote
>Europe</quote
>.</para>
</listitem>
<listitem>
<para
>Un <sgmltag class="starttag"
>division</sgmltag
> e <sgmltag class="endtag"
>division</sgmltag
> per ogni divisione nella mappa.</para>
</listitem>
</itemizedlist>
</para>
<para
>Ogni divisione ha queste tag: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>name</sgmltag
> e <sgmltag class="endtag"
>name</sgmltag
>: il nome della divisione, ⪚ <quote
>Albania</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>capital</sgmltag
> e <sgmltag class="endtag"
>capital</sgmltag
>: il nome della capitale della divisione, ⪚ <quote
>Tirana</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>ignore</sgmltag
> e <sgmltag class="endtag"
>ignore</sgmltag
>: può essere impostato a <userinput
>yes</userinput
>, <userinput
>allowClickMode</userinput
> e <userinput
>no</userinput
>. Se questa tag è impostata a <userinput
>yes</userinput
>, allora la divisione non sarà considerata nelle domande sulle divisioni in quella mappa. È come se questa divisione non esistesse nella modalità a quiz di &kgeography;. Se questa tag è impostata a <userinput
>allowClickMode</userinput
>, allora &kgeography; chiederà la divisione nella modalità <guibutton
>Fai clic sulla divisione nella mappa...</guibutton
> ma non in altri quiz. Impostare questa tag a <userinput
>no</userinput
> significa far sì che la divisione venga considerata in tutte le modalità (sfoglia e quiz). Questa tag è opzionale e se non vi è una tag <sgmltag class="starttag"
>ignore</sgmltag
>, allora è come se fosse impostata a <userinput
>no</userinput
>. Per esempio <quote
>Algeria</quote
> ha questa tag impostata a <userinput
>yes</userinput
> nella mappa <quote
>Europa</quote
>, e ciò significa che <quote
>Algeria</quote
> non sarà inclusa dei quiz della mappa <quote
>Europa</quote
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>flag</sgmltag
> e <sgmltag class="endtag"
>flag</sgmltag
>: il file (senza alcun percorso) contenente la bandiera della divisione, ⪚ <quote
>albania.png</quote
>. Questa tag è opzionale. Non richiesta per divisioni la cui tag <sgmltag class="starttag"
>ignore</sgmltag
> è impostata a <userinput
>yes</userinput
>.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>color</sgmltag
> e <sgmltag class="endtag"
>color</sgmltag
>: il colore che la divisione ha nella mappa.</para>
</listitem>
</itemizedlist>
</para>
<para
>Il colore è definito usando tre tag: <itemizedlist>
<listitem>
<para
><sgmltag class="starttag"
>red</sgmltag
> e <sgmltag class="endtag"
>red</sgmltag
>: la componente di rosso del colore. Valori validi sono quelli compresi tra 0 e 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>green</sgmltag
> e <sgmltag class="endtag"
>green</sgmltag
>: la componente di verde del colore. Valori validi sono quelli compresi tra 0 e 255.</para>
</listitem>
<listitem>
<para
><sgmltag class="starttag"
>blue</sgmltag
> e <sgmltag class="endtag"
>blue</sgmltag
>: la componente di blu del colore. Valori validi sono quelli compresi tra 0 e 255.</para>
</listitem>
</itemizedlist>
</para>
<tip>
<para
>È conveniente creare 2 o 3 false divisioni <quote
>Water</quote
>, <quote
>Frontier</quote
> e <quote
>Coast</quote
> e impostarle con la tag <sgmltag class="starttag"
>ignore</sgmltag
> impostata a <userinput
>yes</userinput
>. </para>
</tip>
<important>
<para
>Tutti i nomi (capitali e divisioni) devono essere in inglese.</para>
</important>
</sect1>
<sect1 id="map-file">
<title
>File di mappa</title>
<para
>Il file di una mappa è piuttosto semplice ma richiede un po' di lavoro. Deve essere nel formato <acronym
>PNG</acronym
>. Puoi trovare alcune mappe da trasformare presso le <ulink url="http://www.odci.gov/cia/publications/factbook/docs/refmaps.html"
>mappe di riferimento della Cia</ulink
>. Se nessuna mappa si adatta alle tue esigenze, puoi scaricare la <ulink url="http://www.odci.gov/cia/publications/factbook/reference_maps/pdf/political_world.pdf"
>mappa degli stati del mondo</ulink
>, fare un'istantanea di questa e lavorare a partire da quella. Ogni divisione nella mappa dovrebbe avere uno e un solo colore. Per far ciò, puoi usare programmi di modifica delle immagini come <application
>The Gimp</application
> e <application
>Kolourpaint</application
>. </para>
</sect1>
<sect1 id="flags">
<title
>Bandiere</title>
<para
>Se hai usato la tag <sgmltag class="starttag"
>flag</sgmltag
>, devi fornire anche i file delle bandiere. Devono essere nel formato <acronym
>PNG</acronym
> ed è meglio se sono grandi 300x200 pixel e se fornisci un file <acronym
>SVG</acronym
> per esse. Per avere bandiere <acronym
>SVG</acronym
> di quasi tutti i paesi nel mondo e di alcune altre divisioni, puoi consultare la <ulink url="http://www.sodipodi.com/index.php3?section=clipart/flags"
>collezione delle bandiere di Sodipodi</ulink
>. </para>
</sect1>
<sect1 id="how-to-test">
<title
>Come provare</title>
<para
>Prima di inviare la tua mappa ad Albert <email
>tsdgeos@terra.es</email
>, dovresti provare a vedere se non ci sono errori. Per far ciò, devi fare le seguenti cose: <itemizedlist
> <listitem
> <para
>Metti i file di descrizione della mappa e di immagine della mappa in <filename class="directory"
>È possibile creare mappe non politiche? Certo! <screenshot>
<screeninfo
>Esempio di come creare una mappa non politica</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="river.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Esempio di come creare una mappa non politica</phrase>
</textobject>
</mediaobject>
</screenshot>
</para>
<para
>Ovviamente, il concetto di divisione può essere esteso ad un fiume o ad una montagna. Durante la creazione della mappa, dovresti tener presente che la maggior parte delle volte il fiume o la montagna sarà troppo piccolo e che dovresti fornire un'area aggiuntiva su cui fare clic. In questo esempio, il fiume avrà l'area marrone e il colore <20,76,34> come suo identificatore. </para>
</sect1>
</chapter>
<chapter id="commands">
<title
>Guida ai comandi</title>
<!-- (OPTIONAL, BUT RECOMMENDED) This chapter should list all of the
application windows and their menubar and toolbar commands for easy reference.
Also include any keys that have a special function but have no equivalent in the
menus or toolbars. This may not be necessary for small apps or apps with no tool
or menu bars. -->
<sect1 id="kapp-mainwindow">
<title
>La finestra principale di &kgeography;</title>
<sect2>
<title
>Il menu <guimenu
>File</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Apri mappa...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Apre la finestra di dialogo di scelta della mappa</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>File</guimenu
> <guimenuitem
>Esci</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Esce</action
> da &kgeography;</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Il menu <guimenu
>Visualizza</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Visualizza</guimenu
> <guimenuitem
>Zoom</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Va in modalità zoom</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Visualizza</guimenu
> <guimenuitem
>Dimensione originale</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Reimposta</action
> la mappa alla sua dimensione originale</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Visualizza</guimenu
> <guimenuitem
>Muovi</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sposta</action
> la mappa corrente</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Il menu <guimenu
>Impostazioni</guimenu
></title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Mostra/Nascondi la barra degli strumenti</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra/nasconde la barra degli strumenti di &kgeography;.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura le scorciatoie...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura le scorciatoie da tastiera di &kgeography;.</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Impostazioni</guimenu
> <guimenuitem
>Configura le barre degli strumenti...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura la barra degli strumenti di &kgeography;.</action
></para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2>
<title
>Il menu <guimenu
>Aiuto</guimenu
></title>
&help.menu.documentation; </sect2>
</sect1>
</chapter>
<!--<chapter id="faq">
<title
>Questions and Answers</title>
&reporting.bugs;
&updating.documentation;
<qandaset id="faqlist">
<qandaentry>
<question>
<para
>My Mouse doesn't work. How do I quit &kgeography;?</para>
</question>
<answer>
<para
>You silly goose! Check out the <link linkend="commands"
>Commands
Section</link
> for the answer.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Why am I not able to twiddle my documents?</para>
</question>
<answer>
<para
>You can only twiddle your documents if you have the foobar.lib
installed.</para>
</answer>
</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 licenza</title>
<para
>&kgeography; </para>
<para
>Copyright del programma 2004-2005 Albert Astals Cid <email
