<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appversion "0.1.5">
<!ENTITY manrevision "0.2.0">
<!ENTITY date "2007-06-29">
<!ENTITY app "<application>Accerciser</application>">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Apr 11, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="it">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
    <title>Manuale di <application>Accerciser</application> v0.2.0</title>       

    <copyright> 
      <year>2006</year> 
      <year>2007</year> 
      <year>2008</year> 
      <holder>IBM Corporation</holder> 
    </copyright><copyright><year>2007, 2008</year><holder>Lorenzo Travaglio (ltrav02@yahoo.it)</holder></copyright> 

<!-- translators: uncomment this:

  <copyright>
   <year>2002</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->
<!-- An address can be added to the publisher information.  If a role is 
     not specified, the publisher/author is the same for all versions of the 
     document.  -->
    <publisher> 
      <publishername>GNOME Documentation Project</publishername> 
    </publisher> 

	<!-- This file  contains link to license for the documentation (GNU FDL), and 
        other legal stuff such as "NO WARRANTY" statement. Please do not change 
	any of this. -->

    <authorgroup> 
      <author role="maintainer"> 
        <firstname>Eitan</firstname> 
        <surname>Isaacson</surname> 
        <affiliation> 
          <orgname>Team Accerciser</orgname> 
          <address> <email>eitan@ascender.com</email> </address> 
        </affiliation> 
      </author> 

      <author role="editor"> 
        <firstname>Peter</firstname> 
        <surname>Parente</surname> 
        <affiliation> 
          <orgname>Team Accerciser</orgname> 
          <address> <email>pparent@us.ibm.com</email> </address> 
        </affiliation> 
      </author> 
      
<!-- This is appropriate place for other contributors: translators,
     maintainers,  etc. Commented out by default.
     
      <othercredit role="translator">
        <firstname>Latin</firstname> 
        <surname>Translator 1</surname> 
        <affiliation> 
          <orgname>Latin Translation Team</orgname> 
          <address> <email>translator@gnome.org</email> </address> 
          </affiliation>
          <contrib>Latin translation</contrib>
      </othercredit>
-->
    </authorgroup>


<!-- According to GNU FDL, revision history is mandatory if you are -->
<!-- modifying/reusing someone else's document.  If not, you can omit it. -->
<!-- Remember to remove the &manrevision; entity from the revision entries other
-->
<!-- than the current revision. -->
<!-- The revision numbering system for GNOME manuals is as follows: -->
<!-- * the revision number consists of two components -->
<!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
<!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
<!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
<!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
<!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
<!-- to V3.0, and so on. -->  
    <revhistory>
      <revision> 
        <revnumber>Manuale di Accerciser v0.2.0</revnumber> 
        <date>29/06/2007</date> 
        <revdescription> 
          <para role="author">Eitan Isaacson <email>eitan@ascender.com</email></para>
          <para role="publisher">Team Accerciser</para>
        </revdescription> 
      </revision> 
    </revhistory> 

    <releaseinfo>Questo manuale descrive la versione 0.1.5 di Accerciser.</releaseinfo> 
    <abstract role="description">
      <para>Questo manuale descrive l'uso di <application>Accerciser</application>.</para>
    </abstract> 
    <legalnotice> 
      <title>Commenti</title> 
      <para>Per segnalare un problema o inviare suggerimenti riguardanti <application>Accerciser</application> o questo manuale, seguire le istruzioni presenti nella <ulink url="ghelp:gnome-feedback" type="help">Pagina dei commenti di GNOME</ulink>.</para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </articleinfo> 

  <indexterm zone="index"> 
    <primary>Accerciser</primary> 
  </indexterm> 

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<!-- Use the Introduction section to give a brief overview of what
     the application is and what it does. -->
  <sect1 id="myapp-introduction">
    <title>Introduzione</title> 

    <para><application>Accerciser</application> è un esploratore interattivo di accessibilità per l'ambiente grafico GNOME scritto in Python. Usa <ulink url="http://directory.fsf.org/at-spi.html" type="http">AT-SPI</ulink> per ispezionare e controllare i widget, permettendo di controllare se un'applicazione fornisce le corrette informazioni di tecnologia assistiva e framework di test automatici. <application>Accerciser</application> dispone di un semplice framework di plugin con il quale è possibile creare viste personalizzate delle informazioni di accessibilità.</para>

    <para>Essenzialmente, <application>Accerciser</application> è uno strumento at-poke di ultima generazione <ulink url="http://svn.gnome.org/viewcvs/at-poke" type="http">at-poke</ulink>.</para>

  </sect1>

<!-- =========== Getting Started ============================== -->
<!-- Use the Getting Started section to describe the steps required
     to start the application and to describe the user interface components
     of the application. If there is other information that it is important
     for readers to know before they start using the application, you should
     also include this information here. 
     If the information about how to get started is very short, you can 
     include it in the Introduction and omit this section. -->

  <sect1 id="accerciser-getting-started"> 
    <title>Per iniziare</title> 

    <sect2 id="myapp-start">
      <title>Avviare <application>Accerciser</application></title>
      <para>È possibile avviare <application>Accerciser</application> in uno dei seguenti modi:</para> 
      <variablelist>
        <varlistentry>
          <term>Menù <guimenu>Applicazioni</guimenu></term>
          <listitem>
            <para>Selezionare la voce di menù <menuchoice><guisubmenu>Programmazione</guisubmenu><guimenuitem>Accerciser</guimenuitem></menuchoice>.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Riga di comando</term>
          <listitem>
            <para>Digitare il seguente comando in una finestra terminale quindi premere <keycap>Invio</keycap>:</para>
            <para> 
              <command>accerciser</command> 
            </para> 
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>

    <sect2 id="accerciser-when-start">
      <title>Avvio di <application>Accerciser</application></title>
      <para>All'avvio di <application>Accerciser</application> apparirà la seguente finestra.</para>

      <!-- ==== Figure ==== -->
      <figure id="mainwindow-fig"> 
        <title>Finestra principale di <application>Accerciser</application></title> 
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/accerciser.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>
				Shows <application>Accerciser</application> main window. Contains title bar, menu bar,
				accessible tree , right plugin display area, and bottom plugin
				display area. The menu bar contains File, Edit, Bookmarks, 
				View, and Help menus.
			  </phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    <!-- ==== End of Figure ==== -->

    <!-- Include any descriptions of the GUI immediately after 
		 the screenshot of the main UI, -->
    <!-- for example, the items on the menubar and on the toolbar. 
		 This section is optional. -->

      <para>La finestra principale di <application>Accerciser</application> contiene i seguenti elementi:</para>
      <variablelist>
        <varlistentry>
          <term>Barra dei menù</term>
          <listitem>
			<para>La barra dei menù contiene i comandi per la gestione dei plugin, la gestione e l'uso dei segnalibri, l'aggiornamento della vista dell'albero degli elementi accessibili nonché l'accesso a questa finestra di aiuto.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Vista dell'albero degli elementi accessibili</term>
          <listitem>
			<para>La vista dell'albero degli elementi accessibili consente la vista di tutti gli elementi accessibili partendo dal livello del desktop. La selezione di un elemento accessibile ne rende disponibile l'analisi successiva per mezzo dei plugin caricati.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Vista plugin destro</term>
          <listitem>
            <para>Questa è una delle due viste predefinite dei plugin. Quando <application>Accerciser</application> viene avviato per la prima volta, molti plugin risiedono qui. È possibile trascinare le schede dei plugin sulla vista inferiore dei plugin o sulla scrivania per visualizzare due o più plugin contemporaneamente.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Pannello inferiore visualizzazione plugin</term>
          <listitem>
            <para>È possibile trascinare plugin dalla vista destra verso quest'area o viceversa.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
	<sect2>
	  <title>Gestione vista plugin</title>
	  <para><application>Accerciser</application> dispone di due modalità per la visualizzazione dei plugin. La modalità corrente può essere scambiata mediante il menù <menuchoice><guimenu>Vista</guimenu><guimenuitem>Vista singolo plugin</guimenuitem></menuchoice> o premendo <keycombo><keycap>Ctrl</keycap><keycap>t</keycap></keycombo>. In modalità singola, tutti i plugin saranno posti, ordinati alfabeticamente nella finestra di visualizzazione in alto a destra, ciò può risultare utile per gli utenti che non abbiano dimestichezza con la disposizione spaziale a livelli dei plugin di <application>Accerciser</application>. Quando la modalità singola è disabilitata le linguette dei plugin possono essere trascinate verso differenti visualizzazioni o sul desktop per spostare il plugin desiderato in una nuova visualizzazione. Il posizionamento dei plugin può anche essere manipolato mediante il menù contestuale dei plugin, che può essere attivato tanto dalle linguette dei plugin quanto dalla porzione «plugin» della finestra di dialogo delle Preferenze.</para>
	</sect2>
  </sect1>
<!-- ================ Usage ================================ -->
<!-- Use this section to describe how to use the application to perform the tasks for 
  which the application is designed. -->
  <sect1 id="myapp-usage"> 
    <title>Uso</title> 
    <para>È possibile usare <application>Accerciser</application> per analizzare ogni widget di accessibili contenuto nella vista ad albero usando i plugin disponibili. Per prima cosa occorre selezionare un elemento accessibile da ispezionare usando uno dei seguenti metodi: <itemizedlist> 
      <listitem> 
        <para><xref linkend="accerciser-tree-select"/></para> 
      </listitem> 
      <listitem> 
        <para><xref linkend="accerciser-bookmarks"/></para> 
      </listitem> 
    </itemizedlist></para>
    <!-- ================ Usage Subsection ================================ -->

    <sect2 id="accerciser-tree-select"> 
      <title>Selezionare un elemento accessibile mediante la vista ad albero.</title> 
      <para>Usare la visualizzazione ad albero per esplorare la gerarchia degli oggetti accessibili con radice sul desktop. Quando viene aperto, un nodo rivela i suoi figli, viceversa chiudendolo li nasconde. Ogni nodo mostra un'icona per ogni applicazione associata o ruoli widget ed ogni nome di accessibile, qualora disponibile. La seconda colonna mostra la quantità di nodi che verranno visualizzati all'apertura dell'elemento.</para>
      
    </sect2> 
    <sect2 id="accerciser-bookmarks"> 
      <title>Gestire i segnalibri.</title> 
      <para>Accerciser consente di allocare nei segnalibri gli elementi accessibili selezionati per un successivo esame. Ciò può essere utile qualora l'applicazione dovesse essere fatta ripartire, per esempio in seguito ad una nuova generazione. Per inserire l'elemento attualmente selezionato scegliere <menuchoice><guimenu>Segnalibri</guimenu><guimenuitem>Aggiungi segnalibro...</guimenuitem></menuchoice> o premere <keycombo><keycap>Ctrl</keycap><keycap>d</keycap></keycombo>.</para>
      <para>I segnalibri agli elementi accessibili in Accerciser sono definiti mediante un nome di applicazione ed un «percorso» nella gerarchia interna dell'applicazione verso l'accessibile marcato. Quando l'applicazione è in uno stato differente (ad esempio frame multiple a livello alto) il percorso potrebbe risultare errato.</para>
      <para>I segnalibri possono essere modificati tramite la finestra di gestione segnalibri, raggiungibile mediante <menuchoice><guimenu>Segnalibri</guimenu><guimenuitem>Modifica segnalibri...</guimenuitem></menuchoice>.</para>
    </sect2> 
  </sect1>

  <!-- ============= Plugins =================================== -->
  <sect1 id="accerciser-default-plugins"> 
    <title>Plugin predefiniti</title> <para><application>Accerciser</application> contiene diversi plugin predefiniti. Questi permettono di visualizzare molteplici informazioni sull'elemento accessibile correntemente selezionato nell'albero di visualizzazione, nonché sui suoi vicini. I plugin predefiniti disponibili nella versione 0.1.5 sono i seguenti:</para>
    <itemizedlist> 
      <listitem> 
        <para><xref linkend="accerciser-iface-viewer"/></para> 
      </listitem> 
      <listitem> 
        <para><xref linkend="accerciser-event-monitor"/></para> 
      </listitem>
      <listitem> 
        <para><xref linkend="accerciser-console"/></para>
      </listitem> 
      <listitem> 
        <para><xref linkend="accerciser-api-browser"/></para>
      </listitem> 
      <listitem> 
        <para><xref linkend="accerciser-script-recorder"/></para>
      </listitem> 
      <listitem> 
        <para><xref linkend="accerciser-quick-select"/></para>
      </listitem> 
      <listitem> 
        <para><xref linkend="accerciser-validate"/></para>
      </listitem> 
    </itemizedlist> 

    <sect2 id="accerciser-iface-viewer"> 
      <title>Visualizzatore interfaccia</title>
      <para>Questo plugin visualizza informazioni sulle interfacce disponibili per l'accessibile selezionato nell'albero di visualizzazione. Le interfacce non supportate sono visualizzate in grigio. Gli strumenti per visualizzare e controllare le interfacce sono disponibili mediante gli espansori.</para>

      <figure id="iface-viewer-fig"> 
        <title>Visualizzatore interfaccia</title> 
        <screenshot> 
          <mediaobject> 
            <imageobject>
              <imagedata fileref="figures/interface_viewer.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>Le interfacce supportate dell'accessibile selezionato sono visualizzate come sensibili.</phrase>
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-event-monitor"> 
      <title>Monitor eventi</title> 
      <para>Questo plugin visualizza gli eventi selezionati dall'albero degli accessibili, dalla finestra ad albero delle applicazioni o dal desktop intero.</para>
      <figure id="event-monitor-fig"> 
        <title>Monitor eventi</title> 
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/event_monitor.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>La parte inferiore della finestra di monitor degli eventi permette di prelevare il tipo e la sorgente degli eventi.</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
      <tip>
        <para>Mediante <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>l</keycap></keycombo> in qualsiasi parte del desktop, verrà evidenziato l'ultimo evento registrato, per una successiva analisi. Per modificare questa combinazione di tasti, consultare <xref linkend="accerciser-hotkey-config"/>.</para>
      </tip>
    </sect2> 
    <sect2 id="accerciser-console"> 
      <title>Console IPython</title> 
      <para>Questo plugin rappresenta una console <ulink url="http://ipython.scipy.org/moin/" type="http">IPython</ulink> completa. Premere <keycap>Tab</keycap> per visualizzare i possibili completamenti per il comando attuale. Premendo <keycap>Invio</keycap> verrà eseguito ogni comando Python valido. I comandi alla console hanno accesso all'accessibile attualmente selezionato nell'albero degli accessibili mediante la variabile <varname>acc</varname>. In aggiunta, tutte le funzioni e le costanti dal pacchetto «pyatspi» sono disponibili come locali nella console. Le più importanti fra di esse sono le funzioni di interrogazione verso altre interfacce di accessibili; ad esempio per l'interrogazione di interfacce di testo: <command>t = acc.queryText() </command>. È anche possibile l'importazione dalla directory di lavoro o da un percorso Python.</para> 
    </sect2> 
    <sect2 id="accerciser-api-browser"> 
      <title>Esploratore API</title>
      <para>Questo plugin visualizza le interfacce, i metodi e gli attributi supportati dall'accessibile selezionato nella visualizzazione ad albero.</para>
      <figure id="api-browser-fig"> 
        <title>Esploratore API</title>
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/api_browser.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>Esploratore API.</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-script-recorder"> 
      <title>Registratore di script</title>
      <para>Il registratore di script di <application>Accerciser</application> permette la memorizzazione delle interazioni da tastiera con altre applicazioni desktop allo scopo di costruire gli script di test per l'interfaccia utente. Attualmente il plugin consente la generazione di script per tre piattaforme: Dogtail, LDTP ed una API interna di Accerciser. Una volta premuto il pulsante «Registra» ogni interazione da tastiera verrà registrata in uno script che potrà essere eseguito in seguito come uno script a sé stante.</para>
      <figure id="script-recorder-fig"> 
        <title>Registratore di script</title>
        <screenshot> 
          <mediaobject> 
            <imageobject><imagedata fileref="figures/script_recorder.png" format="PNG"/> 
            </imageobject>
            <textobject> 
              <phrase>Il registratore di script</phrase> 
            </textobject> 
          </mediaobject> 
        </screenshot> 
      </figure>
    </sect2> 
    <sect2 id="accerciser-quick-select"> 
      <title>Selezione veloce</title>
      <para>Questo plugin fornisce le scorciatoie globali da tastiera per la selezione veloce degli accessibili tramite l'interfaccia utente dell'applicazione. Premendo <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>a</keycap></keycombo> verrà selezionato l'ultimo widget dell'accessibile selezionato in <application>Accerciser</application>. Premendo <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>t</keycap></keycombo> verrà selezionato l'accessibile del widget che si trova sotto al puntatore.</para>
    </sect2> 

    <sect2 id="accerciser-validate"> 
      <title>Validazione</title>
      <para>Questo plugin verifica le applicazioni in merito ai problemi di accessibilità e genera un report includendone la gravità e la descrizione dei problemi. Il report collega gli errori alla documentazione riguardante i rimedi ai problemi più comuni. Il plugin è estensibile con schemi di test che definiscano le regole di validazione.</para>

      <para>Per lanciare il validatore occorre anzitutto selezionare un elemento nell'albero degli accessibili. Il plugin verificherà l'accessibile selezionato e tutti i suoi discendenti. Occorre quindi selezionare uno schema di test. Premere quindi il pulsante <guibutton>Validazione</guibutton> per avviare il test. Un'ulteriore pressione del pulsante arresterà l'esecuzione del test.</para>

      <para>Al termine del test, la tabella dei risultati visualizzerà gravità e descrizione di tutti gli errori. Un doppio clic su una riga della tabella mostrerà il relativo accessibile nell'albero. Con l'elemento selezionato, fare clic su <guibutton>Aiuto</guibutton> per ottenere le informazioni sulla possibile soluzione del problema.</para>
    </sect2>

  </sect1>
  <!-- ============= Customization ============================= -->
  <!-- Use this section to describe how to customize the application. -->
  <sect1 id="accerciser-prefs"> 
    <title>Preferenze</title>
    <para>Alcuni elementi di <application>Accerciser</application> sono configurabili:</para>
    <itemizedlist> 
      <listitem> 
        <para><xref linkend="accerciser-plugin-layout"/></para> 
      </listitem>
      <listitem> 
        <para><xref linkend="accerciser-hotkey-config"/></para> 
      </listitem>
    </itemizedlist>
    <sect2 id="accerciser-plugin-layout">
      <title>Disposizione dei plugin</title> 
      <para>Esistono due metodi per configurare la disposizione dei plugin di <application>Accerciser</application>. Anzitutto occorre selezionare <menuchoice><guimenu>Modifica</guimenu><guimenuitem>Preferenze</guimenuitem></menuchoice> per attivare la finestra di dialogo delle <guilabel>Preferenze</guilabel>. Questa finestra contiene schede per ogni sezione, selezionare quindi la scheda <guilabel>Plugin</guilabel>. In questa sezione è contenuto un elenco di tutti i plugin disponibili. Fare clic con il tasto destro su qualsiasi plugin per configurarne la visualizzazione.</para>
        
      <para>È possibile ignorare la finestra <guilabel>Preferenze</guilabel> usando il trascinamento per muovere le schede dei plugin. Trascinare una scheda di plugin dall'area dei plugin inferiore o superiore nella finestra principale per spostare il plugin. Trascinando una scheda sul desktop verrà creata una nuova finestra al cui interno verrà depositato il plugin.</para>
    </sect2>
    <sect2 id="accerciser-hotkey-config">
      <title>Configurazione generale delle scorciatoie</title>
      <para>Alcuni elementi di <application>Accerciser</application> possono abilitare determinate funzionalità mediante scorciatoie. Le combinazioni dei tasti possono essere modificate mediante la finestra delle <guilabel>Preferenze</guilabel>, per farlo occorre selezionare <menuchoice><guimenu>Modifica</guimenu><guimenuitem>Preferenze</guimenuitem></menuchoice> per attivare la finestra delle <guilabel>Preferenze</guilabel>. Selezionare quindi la scheda <guilabel>Scorciatoie generali</guilabel>. All'interno di questa scheda è contenuto un elenco di tutte le combinazioni di tasti disponibili. A questo punto è possibile modificare a piacimento le combinazioni di tasti.</para>
    </sect2>
  </sect1>
<!-- ============= Bugs ================================== -->
<!-- This section is optional and is commented out by default. 
     You can use it to describe known bugs and limitations of the 
	  program if there are any - please be frank and list all
     problems you know of. 
  
  <sect1 id="mayapp-bugs">
  <title>Known Bugs and Limitations</title>
  <para> </para>
 </sect1>
-->
<!-- ============= About ================================== -->
<!-- This section contains info about the program (not docs), such as
      author's name(s), web page, license, feedback address. This
      section is optional: primary place for this info is "About.." box of
      the program. However, if you do wish to include this info in the
      manual, this is the place to put it. Alternatively, you can put this information in the title page.-->
  <sect1 id="myapp-about"> 
    <title>Informazioni su <application>Accerciser</application></title> 
    <para><application>Accerciser</application> è stato scritto da Eitan Isaacson (<email>eitan@ascender.com</email>). Per ulteriori informazioni su <application>Accerciser</application> occorre visitare la pagina <ulink url="http://live.gnome.org/Accerciser" type="http"><application>Accerciser</application> GNOME Live! page</ulink>.</para>

    <para>Per segnalare un problema o un suggerimento riguardante quest'applicazione, seguire le istruzioni contenute in questo <ulink url="ghelp:gnome-feedback" type="help">documento</ulink>.</para>

    <para>La redistribuzione e l'uso di sorgenti ed eseguibili, con o senza modificazioni, sono permessi secondo i termini della licenza BSD.</para>
  </sect1> 
</article>
