<sect1 id="gkbapplet">
  <title>Applet Tastiera internazionale GKB</title>

  <para>
    L'<application>applet GNOME KeyBoard</application>, mostrata nella sua
    configurazione standard in <xref linkend="gkbapplet-fig">, permette di
    modificare facilmente e velocemente la mappatura della tastiera per
    differenti paesi. Per aggiungere questa applet ad un
    <interface>Pannello</interface>, cliccate con il tasto destro del mouse sul
    <interface>Pannello</interface> e scegliete
      <menuchoice>
	<guimenu>Pannello</guimenu>
	<guisubmenu>Aggiungi al pannello</guisubmenu>
	<guisubmenu>Applet</guisubmenu>
	<guisubmenu>Utilità</guisubmenu>
	<guimenuitem>Tastiera internazionale GKB</guimenuitem>
      </menuchoice>.
  </para>

  <figure id="gkbapplet-fig">
    <title>Applet Tastiera internazionale GKB</title>
   <screenshot>
      <screeninfo>Applet Tastiera internazionale GKB</screeninfo>
      <graphic format="png" fileref="gkb_applet" 
	       srccredit="muet">
      </graphic>
    </screenshot>
  </figure>


  <!-- ============= Usage  ================================ -->
  <sect2 id="gkb-usage">
    <title>Uso</title>
    <para>
      Una volta configurata l'applet <application>GNOME Keyboard</application>
      vi permetterà di modificare la mappatura della tastiera fra due diversi
      paesi. Sarà sufficiente cliccare sull'applet con il tasto sinistro del
      mouse per cambiare la mappatura.
    </para>

    <para>
      Cliccando con il tasto destro del mouse sull'applet apparirà un menù
      contenenti le seguenti voci:
      <itemizedlist>

	<listitem>
	  <para>
	    <guimenuitem>Proprietà &hellip; </guimenuitem> &mdash; apre la
	    finestra di dialogo <link linkend="gkbapplet-prefs">
	    <guilabel>Proprietà GKB</guilabel></link>.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    <guimenuitem>Aiuto</guimenuitem> &mdash; mostra questo documento.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    <guimenuitem>Informazioni su &hellip; </guimenuitem> &mdash; mostra le
	    informazioni riguardo <application>Applet Tastiera internazionale
	    GKB</application>, come la versione dell'applet e il nome
	    dell'autore.
	  </para>
	</listitem>

      </itemizedlist>
    </para>
  </sect2>


  <!-- ============= Customization ============================= -->
  <sect2 id="gkbapplet-prefs">
    <title>Personalizzazione</title>
    <para>
      È possibile personalizzare l'applet <application>GNOME
      KeyBoard</application> cliccandoci con il tasto destro del mouse e
      scegliendo <guimenuitem>Proprietà&hellip;</guimenuitem>. Apparirà così la
      finestra di dialogo <interface>Proprietà</interface> (mostrata in <xref
      linkend="gkbapplet-settings-fig">), che permette di aggiungere,
      configurare ed eliminare la varie mappature.
    </para>

    <figure id="gkbapplet-settings-fig">
      <title>Finestra di dialogo Proprietà GKB</title>
      <screenshot>
	<screeninfo>Finestra di dialogo Proprietà GKB</screeninfo>
	<graphic format="png" fileref="gkb_applet_settings"
		 srccredit="muet">
	</graphic>
      </screenshot>
    </figure>

    <para>
      <application>GNOME KeyBoard</application> normalmente contiene due
      mappature. Ognuna di queste ha la sua sezione, con un'etichetta indicante
      il linguaggio o il paese a cui si riferisce. In <xref
      linkend="gkbapplet-settings-fig">, ci sono <guilabel>US</guilabel> (per
      una tastiera statunitense) e <guilabel>HU</guilabel> (per una
      ungherese). È possibile eliminare ogni mappatura selezionandola e premendo
      il bottone <guibutton>Delete this keymap</guibutton>. Per aggiungere
      un'altra mappatura premere il bottone <guibutton>New keymap</guibutton>
      facendo apparire una nuova sezione da personalizzare.
    </para> 

    <para>
      Ogni sezione relativa ad una mappatura contiene le seguenti proprietà:
      <itemizedlist>

	<listitem>
	  <para>
	    Nome della mappatura &mdash; Questo è il nome della mappatura che
	    viene mostrato nella sezione in alto.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Percorso delle icone &mdash; Questa è il percorso per l'icona usata
	    per la mappatura in uso. Cliccando sull'immagine della bandiera si
	    ottiene una lista di bandiere di molti paesi. Se si usano queste
	    icone non importa indicare direttamente il path all'icona.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Comando da usare &mdash; Questo è il comando con il quale
	    <application>GNOME KeyBoard</application> cambia effettivamente la
	    mappatura. Per default viene usato il comando
	    <command>setxkbmap <replaceable>LC</replaceable></command>, dove a
	    <replaceable>LC</replaceable> deve essere sostituito dalle due
	    lettere del codice del linguaggio desiderato. Per impostare una
	    mappatura statunitense ad esempio si può usare il comando
	    <command>setxkbmap us</command>.
	  </para>
	  <para>
	    Se questo non dovesse funzionare è possibile anche provare a
	    impostare la tastiera usando il comando <command>gkb_xmmap
	      <replaceable>LC</replaceable></command> (ad esempio
	    <command>gkb_xmmap fr</command> per usare una tastiera
	    francese). Infine, se volete usare un layout della tastiera
	    personale in un file per xmodmap impostate il comando
	    <command>xmodmap
	      <replaceable>xmodmap-filename</replaceable></command> (ad esempio,
	    <command>xmodmap ~/xrus/yawerty.koi8.xmm</command> per usare il
	    layout della tastiera per la codifica dei caratteri cirillici in
	    koi8). Visitate <xref  linkend="gkbappplet-technical"> per
	      maggiori informazioni.
	  </para>
	</listitem>
      </itemizedlist>
    </para>

    <para> 
      Fatti i cambiamenti voluti cliccate sul bottone <guibutton>OK</guibutton>
      per salvare i cambiamenti e chiudere la finestra di dialogo
      <interface>Proprietà GKB</interface>.Per annullare le modifiche e tornare
      alle impostazioni precedenti, cliccate sul pulsante
      <guibutton>Chiudi</guibutton>.
    </para>
  </sect2>

  <sect2 id="gkbappplet-technical">
    <title>Informazioni tecniche</title>
    <para> 
      Normalmente non è necessario conoscere questi dettagli, ma nel caso in cui
      qualcosa non stesse funzionando oppure nel caso in cui siate semplicemente
      curiosi, leggete pure.
    </para>
    <para>
      <application>GNOME Keyboard</application> cambia la mappatura della
      tastiera con un comando ad X Window System. X Window System ha due modi
      per impostare la mappatura della tastiera: la più vecchia è quella
      chiamata "xmodmap" e quella più nuova basata su "Xkb extension". Se avete
      abilitato Xkb dovete usare questo e cambiare mappatura con il comando
      <command>setxkbmap <replaceable>LC</replaceable></command>. Questo viene
      fornito con molti file contenenti i layout per svariate tastiere che si
      trovano normalmente nella directory
      <filename>/usr/X11R6/lib/X11/xkb/symbols</filename>.
    </para>
    <para>
      Se non avete abilitato l'estensione Xkb oppure se in questa non è compreso
      il linguaggio che volete usare dovete usare il più vecchio meccanismo di
      <command>xmodmap</command>. In questo caso dovete avere un file che
      descrive il layout della tastiera in un formato speciale (vedi la pagina
      del manuale di di <command>xmodmap</command> per i dettagli), e il comando
      deve essere <command>xmodmap<replaceable>filename</replaceable>
      </command>. <application>GNOME Keyboard</application> include una serie di
      file di layout che vengono installati nella directory
      <filename>/usr/share/xmodmap</filename> con nomi del tipo
      <filename>xmodmap.de</filename>. Per usare uno di questi file potete usare
      il comando <command>gkb_xmmap <replaceable>LC</replaceable></command> che
      è equivalente al comando <command>xmodmap
      /usr/share/xmodmap/xmodmap.<replaceable>LC</replaceable></command>: ad
      esempio <command>gkb_xmmap hu</command> è lo stesso di <command>xmodmap
      /usr/share/xmodmap/xmodmap.hu</command>.
    </para>
  </sect2>

  <!-- ============= Bugs ================================== -->
  <!-- This section should describe known bugs and limitations of
  the program if there are any - please be frank and list all
  problems you know of -->
  <sect2 id="bugs">
    <title>Bug conosciuti e limitazioni</title>
    <para>
      La sequenza con cui vengono indicate le mappature non viene salvata sopo
      aver chiuso la finestra di dialogo <interface>Proprietà GKB</interface>.
    </para>
  </sect2>


  <!-- ============= Authors ================================ -->

  <sect2 id="authors">
    <title>Autori</title>
    <para>
      <application>GNOME KeyBoard</application> è stata scritta da Szabolcs Ban
      (<email>shooby@gnome.hu</email>). Inviate tutti i commenti,
      suggerimenti e notifiche di errori al <ulink url="http://bugs.gnome.org"
      type="http">GNOME bug tracking database</ulink>. (Le istruzioni per
      riportare errori possono essere trovate <ulink
      url="http://bugs.gnome.org/Reporting.html" type="http">on-line</ulink>. Se
      state usando la versione di GNOME 1.1 o una più recente è possibile usare
      anche il programma <application>bug-buddy</application>
      (<command>bug-buddy</command>), che si trova nel sotto-menù
      <guisubmenu>Utilità</guisubmenu> nel <guimenu>Menù Principale</guimenu>,
      per riportare errori.
    </para>

    <para>
      Questo manuale è stato scritto da Szabolcs (Shooby) Ban
      (<email>shooby@gnome.hu</email>) e Dan Mueth
      (<email>d-mueth@uchicago.edu</email>). Inviate tutti i commenti e i
      suggerimenti riguardo questo manuale allo <ulink type="http"
      url="http://www.gnome.org/gdp">GNOME Documentation Project</ulink>
      mandando un email a <email>docs@gnome.org</email>. È possibile anche
      spedire commenti on-line usando lo <ulink type="http"
      url="http://www.gnome.org/gdp/doctable/">GNOME Documentation Status
      Table</ulink>.
    </para>

    <para>
      La traduzione italiana è stata realizzata da Leandro Noferini
      (<email>lnoferin@cybervalley.org</email>). Inviate tutti i commenti e
      suggerimenti riguardo questa traduzione a
      <email>gnome-i18n@lists.it.gnome.org</email>.
    </para>

  </sect2>


  <!-- ============= Application License ============================= -->

  <sect2 id="license">
    <title>Licenza</title>
    <para>
      This program is free software; you can redistribute it and/or
      modify it under the terms of the <citetitle>GNU General Public
	License</citetitle> as published by the Free Software Foundation;
      either version 2 of the License, or (at your option) any later
      version.
    </para>
    <para>
      This program is distributed in the hope that it will be useful, but
      WITHOUT ANY WARRANTY; without even the implied warranty of
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      <citetitle>GNU General Public License</citetitle> for more details.
    </para>
    <para>
      A copy of the <citetitle>GNU General Public License</citetitle> is
      included as an appendix to the <citetitle>GNOME Users
	Guide</citetitle>.  You may also obtain a copy of the
      <citetitle>GNU General Public License</citetitle> from the Free
      Software Foundation by visiting <ulink type="http"
      url="http://www.fsf.org">their Web site</ulink> or by writing to
      <address>
	Free Software Foundation, Inc.
	<street>59 Temple Place</street> - Suite 330
	<city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
	<country>USA</country>
      </address>
    </para>
  </sect2>

</sect1>




