<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kmyapplication "<application
>Simon</application
>">
  <!ENTITY kappname "&kmyapplication;">
  <!ENTITY package "kde-module">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">

]>


<book id="simon" lang="&language;">

<bookinfo>
<title
>Manuale di &kmyapplication;</title>

<copyright>
<year
>2008-2012</year>
<holder
>Peter Grasch</holder>
</copyright>

<date
>2012-12-14</date>
<releaseinfo
>0.4</releaseinfo>

<legalnotice
>&FDLNotice;</legalnotice>

<authorgroup>
<author
><personname
> <firstname
>Peter</firstname
> <othername
>H.</othername
> <surname
>Grasch</surname
> </personname
> <email
>peter.grasch@bedahr.org</email
> </author>
<othercredit role="translator"
><firstname
>Innocenzo</firstname
><surname
>Ventre</surname
><affiliation
><address
><email
>innocenzo.ventre@gmail.com</email
></address
></affiliation
><contrib
>Traduzione italiana</contrib
></othercredit
> 
</authorgroup>

<abstract>
<para
>&kmyapplication; è una soluzione di riconoscimento vocale a sorgente aperto. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>riconoscimento</keyword>
<keyword
>pronuncia</keyword>
<keyword
>voce</keyword>
<keyword
>comando</keyword>
<keyword
>controllo</keyword>
<keyword
>scenari</keyword>
<keyword
>acustica</keyword>
<keyword
>accessibilità</keyword>
</keywordset>

</bookinfo>

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

<para
>&kmyapplication; è l'interfaccia principale per il riconoscimento vocale a sorgente aperto Simon. È un client Simond e fornisce un'interfaccia utente grafica per gestire il modello vocale ed i comandi. Inoltre, Simon è in grado di eseguire tutti i tipi di comandi in base agli input che riceve dal server: Simond. </para>

<para
>In contrasto con le offerte commerciali esistenti, Simon offre un unico approccio fai-da-te al riconoscimento vocale. Invece di predefiniti, pre-qualificati modelli di pronuncia, Simon non viene fornito con tutti i modelli di sorta. Al contrario, fornisce un'interfaccia utente facile da usare per creare modelli di pronuncia e di acustica da zero. </para>

<para
>Inoltre, l'utente finale può facilmente scaricare casi d'uso creati da altri utenti e condividere il suo / la sua. </para>

<para
>Puoi usare la versione corrente per configurare soluzioni di comando-e-controllo particolarmente adatto per le persone disabili. Tuttavia, a causa della quantità di formazione necessaria, il dettato libero e continuo non è ragionevole, né supportato dalle versioni attuali di Simon. </para>

<para
>Grazie alla sua architettura, la stessa versione di Simon può essere utilizzata con tutte le lingue ed i dialetti. Puoi anche mescolare le lingue all'interno di un modello, se necessario. </para>
</chapter>


<chapter id="overview">
<title
>Panoramica</title>

<sect1 id="architecture">
<title
>Architettura</title>
<para
>L'architettura di riconoscimento principale di Simon consiste in tre applicazioni. <itemizedlist>
  <listitem
><para
>&kmyapplication;</para
><para
>Questa è l'interfaccia grafica principale.</para
><para
>Si comporta come un client del server Simond.</para
></listitem>
  <listitem
><para
>Simond</para
><para
>Server di riconoscimento.</para
></listitem>
  <listitem
><para
>KSimond</para
><para
>Interfaccia grafica per Simond.</para
></listitem>
</itemizedlist>
</para>

<para
>These three components form a real client / server solution for the recognition. That means that there is one server (Simond) for one or more clients (&kmyapplication;; this application). KSimond is just a front-end for Simond which means it adds no functionality to the system but rather provides a way to interact with Simond graphically. </para>

<para
>In aggiunta a Simon, Simond e KSimond, altre applicazioni anche più specializzate fanno parte di questa distribuzione integrata di Simon. <itemizedlist>
  <listitem
><para
>Sam</para
><para
>Fornisce un controllo più approfondito al modello vocale e permette di testare il modello acustico.</para
></listitem>
  <listitem
><para
>SSC / SSCd</para
><para
>Puoi usare queste due applicazioni per raccogliere più facilmente grandi quantità di campioni vocali da persone differenti.</para
></listitem>
  <listitem
><para
>Afaras</para
><para
>This simple utility allows users to quickly check large corpora of speech data for erroneous samples.</para
></listitem>
</itemizedlist>
</para>

<para
>Fai riferimento ai singoli manuali di tali applicazioni per maggiori dettagli. </para>


<para>
<screenshot>
<screeninfo
>Architettura</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="architecture.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>&kmyapplication; is used to create and maintain a representation of your pronunciation and language. This representation is then sent to the server Simond which compiles it into a usable speech model.</para>
<para
>&kmyapplication; then records sound from the microphone and transmits it to the server which runs the recognition on the received input stream. Simond sends the recognition result back to the client (&kmyapplication;).</para>
<para
>&kmyapplication; utilizza quindi questo risultato del riconoscimento per eseguire comandi come aprire programmi, seguire i link, &etc;</para>

<para
>Simond identifies its connections with a user / password combination which is completely independent from the underlying operating system and its users. By default a standard user is set up in both Simon and Simond so the typical use case of one Simond server per Simon client will work <quote
>out of the box</quote
>.</para>
<para
>Every Simon client logs onto the server with a user / password combination which identifies a unique user and thus a unique speech model. Every user maintains his own speech model but may use it from different computers (different, physical Simon instances) simply by accessing the same Simond server. One Simond instance can of course also serve multiple users.</para>
<para
>If you want to open up the server to the Internet or use multiple users on one server, you will have to configure Simond. Please see the <ulink url="help:/simond"
>Simond manual</ulink
> for details. </para>
</sect1>

<sect1 id="needed_parts">
<title
>Risorse richieste per una installazione funzionante di &kmyapplication;</title>

<note>
<para
>For background information about speech models, please refer to the <link linkend="speech_model"
>Speech Recognition: Background section</link
>. </para>
</note>

<para
>To get Simon to recognize speech and react to it you need to set up a speech model.</para>

<para
>I modelli di discorso descrivono i suoni vocali, le parole esistenti, il loro suono e quali combinazioni di parole (<quote
>frasi</quote
> o <quote
>strutture</quote
>) esistono.</para>

<para
>Un modello vocale si compone essenzialmente di due parti: <itemizedlist>
<listitem
><para
>Modello di linguaggio: descrive tutte le parole esistenti e quali frasi sono grammaticalmente corrette </para
></listitem>
<listitem
><para
>Modello acustico: descrive il suono delle parole </para
></listitem>
</itemizedlist>
</para>

<para
>You need both these components to get Simon to recognize your voice.</para>

<para
>In Simon, the language model will be created from your active <emphasis
>scenarios</emphasis
> and the acoustic model will be either built solely through your voice recordings (training) or with the help of a <emphasis
>base model</emphasis
>.</para>

<sect2 id="scenarios">
<title
>Scenari</title>

<para
>One scenario makes up one complete use case of Simon. To control Firefox, for example, the user just installs the Firefox scenario. </para>

<para
>In other words, scenarios tell Simon what words and phrases to listen for and what to do when they are recognized. </para>

<para
>Because scenarios do not contain information about how these words and phrases actually sound, they can be shared and exchanged between different Simon users without problems. To accommodate this community based repository pool, a <ulink url="http://kde-files.org/index.php?xcontentmode=692"
>category for Simon scenarios has been created on kde-files.org</ulink
> where the scenarios, which are just simple text files (XML format), can be exchanged easily. </para>

<para
>In most cases scenarios are tailored to work best with a specific <link linkend="base_model"
>base model</link
> to avoid <link linkend="phoneme_set_issues"
>issues with the phoneme set</link
>. </para>

<para
>For information on how to use scenarios in Simon, please refer to the <link linkend="scenarios_use"
>Scenario section in the Use Simon chapter</link
>. </para>
</sect2>

<sect2 id="base_model">
<title
>Acoustic model</title>

<para
>As mentioned above, you need an acoustic model to activate Simon.</para>

<para
>You can either create your own or use and even adapt a base model. Base models are already generated, most often speaker independent, acoustic models that can be used with Simon.</para>

<para
>The following table shows what is required, depending on your Simon configuration: <table frame='all'
><title
>Ways to an acoustic model</title>
<tgroup cols='4' align='left' colsep='1' rowsep='1'>
<thead>
<row>
  <entry
></entry>
  <entry
>Training required</entry>
  <entry
>Base model required</entry>
  <entry
><link linkend="model_backends"
>Model creation backend</link
> required</entry>
</row>
</thead>
<tbody>
<row
> <entry
>Static base model</entry>
  <entry
>No</entry>
  <entry
>Yes</entry>
  <entry
>No</entry>
</row>
<row>
  <entry
>Adapted base model</entry>
  <entry
>Yes</entry>
  <entry
>Yes</entry>
  <entry
>Yes</entry>
</row>
<row>
  <entry
>User-generated model</entry>
  <entry
>Yes</entry>
  <entry
>No</entry>
  <entry
>Yes</entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<sect3 id="model_backends">
<title
>Backends</title>

<para
>Simon uses external software to build acoustic models and to recognize speech. </para>

<para
>Usually, these backends can be split into two distinct components: The "model compiler" or "model generation" backend used to create or adapt acoustic models and the "recognizer" used to recognize speech with the help of these models. </para>

<para
>Not all operation modes of Simon will require a model compiler backend. Please refer to the next section about details on when this is the case. </para>

<para
>Two different backends are supported: <itemizedlist>
<listitem
><para
>Julius / HTK</para>
<para
>Models will be created with the <ulink url="http://htk.eng.cam.ac.uk"
>HTK</ulink
>. <ulink url="http://julius.sourceforge.jp/en_index.php"
>Julius</ulink
> will be used as recognizer.</para>
<para
>To use this backend, please make sure that you have an up-to-date version of both these tools installed.</para>
</listitem>
<listitem
><para
>CMU SPHINX</para>
<para
>This backend, also often simply referred to as "SPHINX backend", uses the PocketSphinx recognizer and the SphinxTrain model generation backend. Please refer to the <ulink url="http://cmusphinx.sourceforge.net/"
>CMU SPHINX website</ulink
> for more details.</para>
<para
>The CMU SPHINX backend requires that Simon is built with the optional SPHINX support. If you have not compiled Simon from source, please refer to your distribution for more information.</para>
</listitem>
</itemizedlist>
</para>

<para
>If you are using base models, Simon will automatically select the appropriate backend for you. However, if you want to build your own models from scratch (user-generated model, see below) and have a certain preference, please <ulink url="help:/simond/speech_model_compilation_configuration.html"
>refer to the Simond configuration</ulink
> for more information.</para>

<para
>Base models created for one backend are not compatible with any other backend. Please refer to the <link linkend="base_model_compatibility"
>compatibility matrix</link
> for details.</para>
</sect3>

<sect3 id="base_model_types">
<title
>Tipi di modelli di base</title>

<para
>Esistono tre tipi di modelli di base: <itemizedlist>
<listitem
><para
>Modello di base statico</para>
</listitem>
<listitem
><para
>Modello di base adattato</para>
</listitem>
<listitem
><para
>Modello generato dall'utente</para>
</listitem>
</itemizedlist>
</para>

<para
>For information on how to use base models in Simon, please refer to the <link linkend="base_model_use"
>Base Models section in the Use Simon chapter</link
>. </para>

<sect4 id="base_model_static">
<title
>Modello di base statico</title>

<para
>I modelli di base statici semplicemente utilizzano un modello acustico pre-compilato senza modificarlo.</para>

<para
>Any training data collected through Simon will not be used to improve the recognition accuracy.</para>

<para
>This type of model <emphasis
>does not</emphasis
> require the model creation backend to be installed.</para>

</sect4>

<sect4 id="base_model_adapted">
<title
>Modello di base adattato</title>

<para
>Adattando un modello acustico pre-compilato puoi migliorare l'accuratezza, adattandolo alla tua voce.</para>

<para
>I dati di formazione raccolti saranno raccolti in una matrice di adattamento che verrà poi applicata al modello base selezionato.</para>

<para
>This type of model <emphasis
>does</emphasis
> require the model creation backend to be installed.</para>

</sect4>

<sect4 id="base_model_user_generated">
<title
>Modello generato dall'utente</title>

<para
>Quando utilizzi i modelli generati dall'utente, l'utente stesso è responsabile per la formazione del proprio modello. Nessun modello di base sarà utilizzato.</para>

<para
>I dati di formazione saranno utilizzati per compilare il modello acustico, consentendo di creare un sistema che riflette direttamente la tua voce.</para>

<para
>This type of model <emphasis
>does</emphasis
> require the model creation backend to be installed.</para>
</sect4>

</sect3>

<sect3 id="base_model_compatibility">
<title
>Requirements</title>

<para
>To build, adapt or use acoustic models of different types, certain software needs to be installed. <table frame='all'
><title
>Base model requirements</title>
<tgroup cols='3' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
  <entry
></entry>
  <entry
>CMU SPHINX</entry>
  <entry
>Julius / HTK</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>Static base model</entry>
  <entry
>PocketSphinx</entry>
  <entry
>Julius</entry>
</row>
<row>
  <entry
>Adapted base model</entry>
  <entry
>SphinxTrain, PocketSphinx</entry>
  <entry
>HTK, Julius</entry>
</row>
<row>
  <entry
>User-generated model</entry>
  <entry
>SphinxTrain, PocketSphinx</entry>
  <entry
>HTK, Julius</entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<para
>All four tools, HTK, Julius, PocketSphinx and SphinxTrain, can safely be installed at the same time. </para>
<para
>SPHINX support in Simon must be enabled during compile time and might not be available on your platform. Please refer to your distribution. </para>
<note>
<para
>The Simon Windows installer includes Julius, PocketSphinx and SphinxTrain but not the HTK. Please refer to the <link linkend="installation"
>installation section</link
> for information on how to install it should you find the need for it. </para>
</note>
</sect3>

<sect3 id="base_model_get">
<title
>Dove trovare i modelli di base</title>

<para
>Simon base models are packaged as <filename
>.sbm</filename
> files. If you happen to have raw model files for your backend, you can package them into a compatible SBM container within Simon. Please refer to the <link linkend="configuration_speechmodel"
>speech model configuration</link
> for details. </para>

<para
>Not all SBM models may work for you. Please refer to the <link linkend="model_backends"
>model backends section</link
> for details. </para>

<para
>To keep this list of available base models up to date, please refer to <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Base_models#Where_to_get_base_models"
>the list in our online wiki</ulink
>. </para>
</sect3>

<sect3 id="phoneme_set_issues">
<title
>Problemi con l'insieme di fonemi</title>

<para
>In order for base models to work, both your scenarios and your base model need to use the same set of phonemes.</para>

<para
>In practice, this often just means that you need to <emphasis
>match scenarios to your base model</emphasis
>. The name of &kmyapplication; base models will most likely start with a tag like "[EN/VF/JHTK]". Try to download scenarios that start with the same tag.</para>

<para
>You can not use scenarios designed for different phoneme set (different base model). If Simon recognizes this error, it will try to disable affected words by removing them from the created speech model. These words will be marked with a red background in the vocabulary of the scenario. To re-enable them, transcribe them with the proper phoneme set or use a user-generated model. </para>

<note>
<title
>Hint</title>
<para
>If you design a new scenario it is therefore a good idea to use the dictionary that was used to create the base model as shadow dictionary. This way Simon will suggest the <quote
>correct</quote
> phonemes when adding the words automatically.</para>
</note>
</sect3>
</sect2>
</sect1>

</chapter>


<chapter id="using-simon">
<title
>Using &kmyapplication;: Typical user</title>

<para
>The following sections will describe how to use Simon.</para>

<sect1 id="first_run">
<title
>Procedura guidata per il primo avvio</title>

<para
>On the first start of Simon, this assistant will guide you through the initial configuration of &kmyapplication;.</para>

<para>
  <screenshot>
    <screeninfo
>Primo avvio: Benvenuto</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="first_run_1.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>La configurazione si compone di cinque semplici passi illustrati qui di seguito. Puoi saltare ogni passo e anche tutta la procedura guidata, se vuoi - in questo caso, il sistema verrà impostato con i valori predefiniti.</para>

<para
>However, please note that without any configuration, there won't be any recognition.</para>

<sect2 id="first_run_scenarios">
<title
>Scenari</title>

<para
>In this step you can add or download <link linkend="scenarios"
>scenarios</link
>.</para>

<para>
  <screenshot>
    <screeninfo
>Primo avvio: Scenari</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="first_run_2.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>To download scenarios from the online repository, select <menuchoice
><guimenuitem
>Open</guimenuitem
><guimenuitem
>Download</guimenuitem
></menuchoice
> to open the download dialog pictured below.</para>

<para>
  <screenshot>
    <screeninfo
>Primo avvio: Ottieni scenari</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="get_hot_new_scenarios_1.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>Especially for new users it is recommended to try some scenarios first to see how the system works before diving into configuring it exactly for your use case.</para>

<para
>After completing the assistant, you can change the scenario configuration with the use of the <link linkend="scenarios_use"
>scenario management dialog</link
>.</para>

<para
>If you are planning to use a <link linkend="base_model"
>base model</link
>, make sure that you download <link linkend="phoneme_set_issues"
>matching scenarios</link
>.</para>

</sect2>


<sect2 id="first_run_basemodels">
<title
>Modelli di base</title>

<para
>In this step you can set up Simon to use <link linkend="base_model"
>base models</link
>.</para>

<para>
  <screenshot>
    <screeninfo
>Primo avvio: Modelli di base</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="first_run_3.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>Again, you can download base models from an online repository through <menuchoice
><guimenuitem
>Open model</guimenuitem
><guimenuitem
>Download</guimenuitem
></menuchoice
>.</para>

<para>
  <screenshot>
    <screeninfo
>First run: Base model download</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="base_model_settings_2.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>To use a user-generated model, select <guimenuitem
>Do not use a base model</guimenuitem
>.</para>

<para
>After completing or aborting the first run wizard you can change configuration options defined here in the <link linkend="base_model_use"
>Simon configuration</link
>.</para>

</sect2>

<sect2 id="first_run_server">
<title
>Server</title>

<para
>Internally, Simon is a <link linkend="architecture"
>server / client application</link
>. If you want to take advantage of a network based installation, you can provide the server address here.</para>

<para>
  <screenshot>
    <screeninfo
>Primo avvio: Server</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="first_run_4.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>The default configuration is sufficient for a <quote
>normal</quote
> installation and will assume that you use a local Simond server that will be automatically be started and stopped with Simon.</para>

<para
>Dopo aver completato la procedura guidata, o aver interrotto la prima esecuzione, puoi modificare le opzioni di configurazione definite nella <link linkend="configure_server"
>configurazione del server</link
>.</para>

</sect2>

<sect2 id="first_run_sound_configuration">
<title
>Configurazione sistema sonoro</title>

<para
>Because Simon recognizes sound from one or more microphones, you have to tell Simon which devices you want to use for recognition and training.</para>

<para>
  <screenshot>
    <screeninfo
>Primo avvio: Configurazione sistema sonoro</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="first_run_5.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>Simon can use one or more input- and output devices for different tasks. You can find more information about Simon's multiple device capabilities in the <link linkend="soundconfiguration_device"
>Simon sound configuration section</link
>.</para>

<para
>If you don't have at least one working input device for recognition, you will not be able to activate Simon.</para>

<para
>Dopo aver completato la procedura guidata, o aver interrotto la prima esecuzione, puoi modificare le opzioni di configurazione definite nella <link linkend="base_model_use"
>configurazione del sistema sonoro</link
>.</para>

</sect2>

<sect2 id="first_run_volume_calibration">
<title
>Calibrazione del volume</title>

<para
>For Simon to work correctly, you need to configure your microphones volume to a sensible level.</para>

<para>
  <screenshot>
    <screeninfo
>Primo avvio: Calibrazione del volume</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="first_run_6.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>For more details on this, please see the general section about <link linkend="volume_calibration"
>Volume Calibration</link
>.</para>

</sect2>

</sect1>

<sect1 id="main_window">
<title
>The Simon Main Window</title>
<para>
<screenshot>
<screeninfo
>Una schermata di &kmyapplication;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot_main.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Schermata</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>


<para
>The Simon main window is split into four logical sections. On the top left, you can see the scenario section, to its right you find the training section, on the bottom left is the acoustic model and finally, on the right of that, the recognition section.</para>

<para
>The Simon main window can be hidden at any time by clicking on the Simon logo in the system tray (usually next to the system clock in the task bar) which will minimize Simon to the tray. Click it again to show the main window again. </para>

<sect2 id="main_window_scenarios">
<title
>Main window: Scenarios</title>

<para
>A list of scenarios shows the currently loaded scenarios. You can manage this selection by clicking <guibutton
>Manage scenarios</guibutton
> which will open the <link linkend="scenarios_use"
>scenario management dialog</link
>.</para>

<para
>To <link linkend="using-simon-advanced"
>modify a scenario</link
>, select it from the list and open it by pressing <guibutton
>Open "&lt;name&gt;"</guibutton
>.</para>
</sect2>

<sect2>
<title
>Main window: Training</title>

<para
>This section shows all training texts from all currently active scenarios.</para>

<para
>Selecting a training text will highlight the parent scenario in the scenario section.</para>

<para
>You can start to <link linkend="training_in_progress"
>train the recognition</link
> by selecting a text and clicking on <guibutton
>Start training</guibutton
>. Please note that, depending on your selected model type, training may or may not improve your recognition accuracy. The acoustic model section (see below) in the &kmyapplication; main menu tells you if training will have an effect for your specific configuration. For more information, please refer to the <link linkend="base_model"
>base model section</link
> for background information on this subject.</para>

<para
>The gathered training corpus can be managed by selecting <guibutton
>Manage training data</guibutton
> which will open the <link linkend="sample_management"
>sample management dialog</link
>.</para>

<para
>To help build a general, open speech corpus, please consider contributing your training corpus to the <ulink url="http://voxforge.org"
>Voxforge</ulink
> project by selecting <menuchoice
><guimenuitem
>File</guimenuitem
><guimenuitem
>Contribute samples</guimenuitem
></menuchoice
> to bring up the <link linkend="contribute_samples"
>sample upload assistant</link
>.</para>
</sect2>

<sect2>
<title
>Main window: Acoustic model</title>

<para
>Here, &kmyapplication; shows information about the currently used base- and active model.</para>

<para
>Select <guibutton
>Configure acoustic model</guibutton
> to <link linkend="base_model_use"
>configure the base model</link
>.</para>
</sect2>

<sect2>
<title
>Main window: Recognition</title>

<para
>This section shows information about the recognition status.</para>

<para
>If &kmyapplication; is connected to the server, you can activate and deactivate the recognition by toggling the <guibutton
>Activate</guibutton
> button. If this control element is not available, make sure you are connected by selecting <menuchoice
><guimenu
>File</guimenu
><guimenuitem
>Connect</guimenuitem
></menuchoice
> from &kmyapplication;s menu.</para>

<para
>An integrated volume calibration widget monitors the configured recognition devices. The sound setup can be modified by selecting <guibutton
>Configure audio</guibutton
> to bring up the <link linkend="soundconfiguration"
>sound configuration</link
>.</para>

</sect2>

</sect1>

<sect1 id="scenarios_use">
<title
>Scenari</title>
<para
>This section describes how to import and remove scenarios to your Simon configuration. For general information about scenarios, please refer to <link linkend="scenarios"
>the background chapter</link
>. If you want to create, edit or export scenarios, please refer to the <link linkend="scenarios_use_advanced"
>advanced usage section</link
>.</para>

<para
>To modify your scenario configuration, first open the scenario management dialog by pressing <guibutton
>Manage scenarios</guibutton
> in the Simon main window.</para>

<para>
  <screenshot>
    <screeninfo
>Manage scenarios</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="manage_scenarios_1.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>To activate or deactivation a scenario you can use the arrow buttons between the two lists or simply double click the option you want to load / unload.</para>

<para
>Puoi trovare maggiori informazioni sui singoli scenari nelle descrizioni degli elementi dell'elenco.</para>

<sect2 id="import_scenario">
  <title
>Importa scenario</title>
  <para
>Scenarios can be imported from a local file in Simon's XML scenario file format but can also be directly downloaded and imported from the internet.</para>

  <para
>When downloading scenarios, the list of scenarios is retrieved from <ulink url="http://kde-files.org/index.php?xcontentmode=692"
>Simon Scenarios</ulink
> subsection of the OpenDesktop site <ulink url="http://kde-files.org"
>KDE-files.org</ulink
>.</para>

<para>
  <screenshot>
    <screeninfo
>Scarica gli scenari</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="get_hot_new_scenarios_1.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

  <para
>If you create a scenario that might be valuable for other Simon users, please consider <link linkend="export_scenario"
>uploading it</link
> to this online repository and help other Simon users.</para>
</sect2>

<sect2 id="delete_scenario">
<title
>Elimina scenario</title>

<para
>Per eliminare uno scenario, seleziona lo scenario e fai clic sul pulsante <guibutton
>Elimina</guibutton
>.</para>

<para
>Dato che gli scenari sono sincronizzati con il server di riconoscimento, puoi ripristinare gli scenari eliminati attraverso le <link linkend="configure_synchronization"
>copie di sicurezza della sincronizzazione dei modelli</link
>.</para>
</sect2>

</sect1>


<sect1 id="recording">
<title
>Recordings</title>
<para
>If you are using user-generated or adapted models, Simon builds its acoustic model based on transcribed samples of the users voice. Because of this, the recorded samples are of vital importance for the recognition performance.</para>

<sect2 id="volume">
<title
>Volume</title>
<para
>È importante controllare il volume del microfono prima di registrare i campioni.</para>

<sect3 id="volume_calibration">
<title
>Simon Calibration</title>

<para
>La versione attuale di &kmyapplication; include un semplice metodo per assicurarsi che il volume sia configurato correttamente.</para>

<para>
<screenshot>
<screeninfo
>Simon Volume Calibration</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="volume_calibration.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Per impostazione predefinita, la calibrazione del volume viene visualizzata prima di iniziare qualsiasi registrazione in &kmyapplication;.</para>

<para
>Per la calibrazione leggi il testo visualizzato.</para>

<para
>The calibration will monitor the current volume and tell you to either raise or lower the volume but you have to do that manually in your systems audio mixer.</para>

<para
>Durante la calibrazione, prova a parlare normalmente. Non urlare, ma non essere neanche troppo tranquillo. Tieni conto che  in genere dovresti utilizzare la stessa impostazione del volume per tutti gli allenamenti e anche per il riconoscimento. Puoi parlare più forte (inconsciamente) quando sei agitato o in un altro momento della giornata in modo da cercare di alzare la voce e prevenire tutto ciò. È molto meglio avere un po' di campioni più tranquilli per avviare il ritaglio.</para>

<para
>Nelle impostazioni di &kmyapplication;, puoi cambiare sia il testo visualizzato che i livelli considerati corretti. Se lasci vuoto il testo, sarà visualizzato il testo predefinito. Nelle opzioni è anche possibile disattivare completamente la calibrazione. Vedere la <link linkend="soundconfiguration_training"
>sezione formazione</link
> per maggiori dettagli.</para>
</sect3>

<sect3>
<title
>Calibrazione con Audacity</title>

<para
>In alternativa puoi usare uno strumento per il montaggio audio come il libero <ulink url="http://audacity.sourceforge.net"
>Audacity</ulink
> per controllare il volume di registrazione.</para>

<para
>Troppo basso <screenshot>
<screeninfo
>Volume: troppo basso</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="too_quiet.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Troppo forte: <screenshot>
<screeninfo
>Volume: troppo forte</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="too_loud.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Volume perfetto: <screenshot>
<screeninfo
>Volume perfetto</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="volume_perfect.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect3>

</sect2>

<sect2 id="silence">
<title
>Silenzio</title>
<para
>To help Simon with the automatic segmentation it is recommended to leave about one or two seconds of silence on the recording before and after reading the prompted text.</para>

<para
>Current Simon versions include a graphical notice on when to speak during recording. The message will tell the user to wait for about half a second: <screenshot>
<screeninfo
>Attendere</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="pause_control_wait.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>... prima di dire che l'utente può parlare: <screenshot>
<screeninfo
>Parla ora</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="pause_control_speak.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Questo metodo di feedback visivo si dimostra particolarmente utile quando si registra con le persone che non sanno leggere il testo richiesto per se stessi e, pertanto, hanno bisogno di qualcuno che dica loro quello che bisogna dire. Lo spunto visivo colorato dice loro quando iniziare a ripetere ciò che il facilitatore ha detto senza la necessità di inaffidabili gesti delle mani. </para>
</sect2>


<sect2 id="recording_content">
<title
>Contenuto</title>
<para
>Generally we recommend to record roughly the same sentences that Simon should recognize later.</para>
<para
>(Ovviamente questo non si applica alle acquisizioni di campionamenti di massa, dove altre proprietà come il bilanciamento fonetico sono più importanti)</para>

<para
>Presta attenzione ad evitare quelle registrazioni come <quote
>One One One</quote
> che incrementano rapidamente proprietà come <quote
>il tasso di riconoscimento</quote
>. Tali registrazioni spesso riducono le prestazioni del riconoscimento perché la pronuncia è molto diversa dal dire la parola separatamente.</para>
</sect2>


<sect2 id="microphone">
<title
>Microfono</title>
<para
>For Simon to work well, a high quality microphone is recommended.</para>

<para
>Tuttavia, anche con cuffie relativamente economiche (circa 30 euro) puoi ottenere ottimi risultati - magnitudine migliore dei microfoni interni.</para>

<para
>Per garantire la massima compatibilità raccomandiamo cuffie USB, di solito supportano la frequenza di campionamento di 16 kHz necessaria, sono molto ben supportate sia da Microsoft Windows che GNU / Linux e normalmente non richiedono particolari driver proprietari per funzionare.</para>
</sect2>


<sect2 id="sample_quality_assurance">
<title
>Campione di garanzia della qualità</title>
<para
>Simon will check each recording against certain criteria to ensure that the recorded samples are not erroneous or of poor quality.</para>

<para
>If Simon detects a problematic sample, it will warn the user to re-record the sample.</para>

<para
>Currently, Simon checks the following criteria: <itemizedlist>
<listitem>
<para
>Campione del picco di volume</para>
<para
>If the volume is too loud and the microphone started to <quote
>clip</quote
> (<ulink url="http://en.wikipedia.org/wiki/Clipping_%28audio%29"
>Clipping on wikipedia</ulink
>), Simon will display a warning message urging the user to lower the microphone volume.</para>
</listitem>
<listitem>
<para
>Rapporto segnale rumore (SNR)</para>
<para
>Simon will automatically determine the signal to noise ratio of each recording. If the ratio is below a configurable threshold, a warning message will be displayed.</para>
<para
>The default value of 2300 % means that for Simon to accept a sample as correctly recorded the peak volume has to be 23 times louder than the noise baseline (lowest average over 50 ms).</para>
<para
>Spesso questo può essere il risultato di un microfono di qualità molto bassa, di livelli elevati di rumore ambientale o di un guadagno del microfono basso accoppiato con l'opzione <quote
>spinta microfono</quote
> nel mixer di sistema. </para>
</listitem>
</itemizedlist>
</para>


<para
>SNR warning message triggered by an empty sample. This information dialog is displayed when clicking on the <guibutton
>More information</guibutton
> button on the recording widget. <screenshot>
<screeninfo
>Un campione vuoto attiva l'avviso SNR</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="snr_warning.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect2>
</sect1>

<sect1 id="contribute_samples">
<title
>Contribute Samples</title>

<para
>The <link linkend="base_model"
>base models</link
> that can be used with Simon to augment or replace training are built from other peoples speech samples. In order to create high quality base models, a large amount of training samples are necessary.</para>

<para
>If you trained your local Simon installation, you gathered valuable voice samples that could improve the quality of the general model.</para>

<para
>Through &kmyapplication;'s "Contribute Samples" dialog you can upload those recordings to benefit the <ulink url="http://voxforge.org"
>Voxforge</ulink
> project to create high quality open source base models.</para>

<para>
<screenshot>
<screeninfo
>Contributing Samples: Connect</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="contribute_samples_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>After connecting to the server, &kmyapplication; will ask for some basic meta-information. This information obviously contains no personal information. Instead, it will later be used to group together samples of similar speaker groups to build more accurate acoustic models.</para>

<para>
<screenshot>
<screeninfo
>Contributing Samples: Provide information</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="contribute_samples_2.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>The duration of the upload process itself will depend on your internet connection. Generally speaking, this only transmits relatively little data because the audio samples collected by &kmyapplication; are generally very small: around 0.1 MB per sample.</para>

<para>
<screenshot>
<screeninfo
>Contributing Samples: Upload</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="contribute_samples_3.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

</sect1>

<sect1 id="sample_management">
<title
>Manage training data</title>

<para
>To view and modify your personal training corpus, you can access the training data management dialog by selecting <guibutton
>Manage training data</guibutton
> in the &kmyapplication; main window or the <link linkend="training"
>training section of any opened scenario</link
>.</para>

<para>
<screenshot>
<screeninfo
>Manage training samples</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="training_samples.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<sect2 id="open_sample">
<title
>Modifying samples</title>

<para
>To listen to or re-record a sample, select it from the list and select <guibutton
>Open Sample</guibutton
>.</para>

<para>
<screenshot>
<screeninfo
>Modifying a training sample</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="training_samples_modify.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>In this dialog you can also modify the sample's <link linkend="sample_group"
>group after it was recorded</link
>.</para>

<para
>If you remove the opened sample and do not re-record it, &kmyapplication; will offer to remove it from the corpus.</para>

<para>
<screenshot>
<screeninfo
>Removing a training sample</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="training_samples_remove.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

</sect2>

<sect2 id="clear_training_data">
<title
>Clear training data</title>
<para
>After a confirmation dialog, this will remove all personal training data of the user. </para>
</sect2>

<sect2 id="import_training-data">
<title
>Importazione di campioni di formazione</title>
<para
>Using the import training data field you can import previously gathered training samples from previous Simon versions or manual training.</para>

<note>
<para
>Questa funzione è molto specifica. Utilizzala con cautela e assicurati di sapere esattamente cosa stai facendo prima di continuare. </para>
</note>

<para
>You can either provide a separate prompts file or let Simon extract the transcriptions from the filenames.</para>

<para
>Quando utilizzi trascrizioni basate su istruzioni, il tuo file di istruzioni (UTF-8) deve contenere le seguenti all'interno: <quote
>[nomefile] [content]</quote
>. I nomi dei file sono senza estensioni e il contenuto deve essere in maiuscolo. Ad esempio: <userinput
>demo_2007_03_20 DEMO</userinput
> per importare il file <filename
>demo_2007_03_20.wav</filename
> che contiene la pronuncia della parola <quote
>Demo</quote
>.</para>

<para
>Because prompts files do not contain a file extension, Simon will try wav, mp3, ogg and flac (in that order). If one of those match, no other extension will be tested and only the first file will be imported (in contrast to file based transcription where all files would be imported).</para>

<para
>Quando si utilizzano trascrizioni basate su file, un file chiamato this_is_a_test.wav <emphasis
>deve</emphasis
> contenere <quote
>Questa è una prova</quote
> e nient'altro. I numeri e i caratteri speciali (<quote
>.</quote
>, <quote
>-</quote
>,...) nel nome del file vengono ignorati. </para>

<para
>Files recorded by Simon 0.2 <emphasis
>will</emphasis
> follow this naming scheme so you can safely import them using the file name extraction method. Files generated by previous Simon versions should not be imported using this function but you can use the prompts based import for that.</para>

<para
>I file importati e le loro trascrizioni sono poi aggiunti al corpus di formazione. </para>

<para
>Per importare una cartella contenente campioni di addestramento, è sufficiente selezionare la cartella da importare e, a seconda del tipo di importazione, anche le istruzioni del file. <screenshot>
<screeninfo
>Import training data wizard</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="import_training_data_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>La cartella sarà esaminata in modo ricorsivo. Ciò significa che nella cartella data e in tutte le sue sottocartelle vengono cercati file .wav, .flac, .mp3 e .ogg. Tutti i file trovati verranno importati. </para>

<para
>Quando importi i file audio, tutti i <link linkend="soundconfiguration_postprocessing"
>filtri di post processing</link
> configurati vengono applicati. </para>
<para
>Se importi qualcosa di diverso da file WAV, sei responsabile per la loro decodifica durante il processo di importazione (ad esempio attraverso i filtri di post processing) o la creazione del modello <emphasis
>fallirà</emphasis
>. </para>

</sect2>

</sect1>

<sect1 id="configuration">
<title
>Configurazione</title>
<para
>Simon was designed with high configurability in mind. Because of this, there are plentiful parameters that can be fine-tuned to your specific requirements. </para>

<para
>You can access Simon's configuration dialog through the application's main menu: <menuchoice
><guimenuitem
>Settings</guimenuitem
><guimenuitem
>Configure Simon...</guimenuitem
></menuchoice
>.</para>

<sect2 id="configuration_general">
<title
>Configurazione generale</title>
<para
>La pagina di configurazione generale elenca alcune impostazioni di base.</para>

<para
>If you want to show the <link linkend="first_run"
>first run assistant</link
> again, deselect <guibutton
>Disable configuration wizard</guibutton
>.</para>

<para>
<screenshot>
<screeninfo
>Configurazione generale</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_general.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
<para
>Please note that the option to start Simon at login will work on both Microsoft Windows and when you are using KDE on Linux. Support for other desktop environments like Gnome, XFCE, &etc; might require manually placing Simon in the session autostart (please refer to the respective manuals of your desktop environment). </para>
<para
>When the option to start Simon minimized is selected, Simon will minimize to the system tray immediately after starting. </para>
<para
>Deselezionando l'opzione per avvisarti quando ci sono problemi con i campioni, disattivi anche la <link linkend="sample_quality_assurance"
>garanzia della qualità del campione</link
>. </para>
</sect2>

<sect2 id="soundconfiguration">
<title
>Recordings</title>
<para
>Simon uses fairly sophisticated internal sound processing to enable complex multi-device setups. </para>

<sect3 id="soundconfiguration_device">
<title
>Configurazione del dispositivo</title>
<para
>The sound device configuration allows you to choose which sound device(s) to use, configure them and define additional recording parameters.</para>

<para
>Use the <guibutton
>Refresh devices</guibutton
> button if you have plugged in additional sound devices since you started Simon.</para>

<para>
<screenshot>
<screeninfo
>Sound device configuration: General</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_sound_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Most of the time you will want to use 1 channel and 16kHz (which is also the default) because the recognition only works on mono input and works best at 16kHz (8kHz and 22kHz being other viable options). Some low-cost sound cards might not support this particular mode in which case you can enable automatic Resampling in the device's advanced configuration.</para>

<note
><para
>Only change the channel and the samplerate if you really know what you are doing. Otherwise the recognition will <emphasis
>most likely</emphasis
> not work.</para
></note>

<para>
<screenshot>
<screeninfo
>Sound device configuration: Advanced options</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_sound_advanced.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>You can use Simon with more than one sound device at the same time. Use <guibutton
>Add device</guibutton
> to add a new device to the configuration and <guibutton
>Remove device</guibutton
> to remove it from your configuration. The first device in your sound setup cannot be removed.</para>

<para
>Per ogni dispositivo è possibile determinare ciò che desideri che il dispositivo utilizzi: la formazione o il riconoscimento (quest'ultimo applicabile solo per i dispositivi di input).</para>

<para
>Se utilizzi più di un dispositivo per la formazione, creerà più file audio per ogni espressione. Quando utilizzi più dispositivi per il riconoscimento, ciascuno alimenta un flusso di input audio separato per il server con il conseguente risultato di riconoscimento per ogni flusso.</para>

<para
>Se utilizzi molteplici dispositivi di output, ascolterai la riproduzione dei campioni di formazione su tutti i dispositivi audio configurati.</para>

<para
>Utilizzando diverse frequenze di campionamento per i dispositivi di input, l'output sarà riprodotto solo sui corrispondenti dispositivi di output. Se ad esempio hai un dispositivo di input configurato per utilizzare 16kHz e l'altro per usare 48kHz, la riproduzione dei campioni generati dal primo avverrà solo sulle uscite a 16kHz, l'altra solo sui dispositivi a 48kHz.</para>

<para
>In the device's advanced configuration, you can also define the <link linkend="sample_group"
>sample group tag</link
> of the produced training samples and set activation <link linkend="context_conditions"
>context conditions</link
>.</para>

<para
>If you set up this device to be used for recognition and (any of) it's activation requirements are not met, the device will not record. This can be used to augment or even replace the <link linkend="soundconfiguration_vad"
>traditional voice activity detection</link
> with context information.</para>

<para
>For example, add a <link linkend="face_detection_condition"
>face detection condition</link
> to the recording devices activation requirements to only enable the recognition when you're looking at the webcam.</para>

</sect3>

<sect3 id="soundconfiguration_vad">
  <title
>Rilevamento attività vocale</title>

  <para
>The recognition is done one the Simond server. See the <link linkend="architecture"
>architecture section</link
> for more details.</para>

  <para
>The sound stream is not continuous but is segmented by the Simon client. This is done by something called <quote
>voice activity detection</quote
>.</para>

  <para>
  <screenshot>
  <screeninfo
>Rilevamento attività vocale</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="vad.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Qui puoi configurare questa segmentazione attraverso i seguenti parametri: <itemizedlist>
      <listitem>
        <para
><guilabel
>Livello soglia</guilabel
></para>
        <para
>Ogni suono al di sotto di questo livello è considerato <quote
>silenzio</quote
> (rumore di fondo).</para>
      </listitem>
      <listitem>
        <para
><guilabel
>Margine di testa</guilabel
></para>
        <para
>Memorizza nella cache fino a quando il margine di testa non inizia a considerarlo un campione reale. Durante tutto questo tempo il livello di ingresso deve essere superiore al livello soglia.</para>
      </listitem>
      <listitem>
        <para
><guilabel
>Margine di coda</guilabel
></para>
        <para
>After the recording went below the cutoff level, Simon will wait for as long as tail margin to consider the current recording a finished sample.</para>
      </listitem>
      <listitem>
        <para
><guilabel
>Salta campioni più brevi di</guilabel
></para>
        <para
>I campioni che sono più brevi di questo valore non sono presi in considerazione per il riconoscimento. (colpi di tosse, &etc;)</para>
      </listitem>
    </itemizedlist>
  </para>
</sect3>

<sect3 id="soundconfiguration_training">
  <title
>Impostazioni di formazione</title>

  <para>
  <screenshot>
  <screeninfo
>Impostazioni di formazione</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="training_config.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>When the option <guibutton
>Default to power training</guibutton
> is selected, Simon will, when training, automatically start- and stop the recording when displaying and hiding (respectively) the recording prompt. This option only sets the default value of the option, the user can change it at any time before beginning a training session.</para>

<para
>Il tipo di carattere configurabile qui si riferisce al testo che viene registrato per la formazione del modello acustico (attraverso la formazione esplicita o quando aggiungi una parola).</para>

<para
>This option has been introduced after we have worked with a few clients suffering spastic disability. While we used the mouse to control Simon during the training, they had to read what was on the screen. At first this was very problematic as the regular font size is relatively small and they had trouble making out what to read. This is why we made the font and the font size of the recording prompt configurable.</para>

<para
>Here you can also define the required signal to noise ratio for Simon to consider a training sample to be correct. See the <link linkend="sample_quality_assurance"
>Sample Quality Assurance</link
> section for more details.</para>
<para
>In questa pagina di configurazione puoi anche impostare i parametri per la <link linkend="volume_calibration"
>calibrazione del volume</link
>.</para>

<para
>It can be deactivated for both the add word dialog and the training wizard by unchecking the group box itself.</para>

<para
>The calibration itself uses the <link linkend="soundconfiguration_vad"
>voice activity recognition</link
> to score your sound configuration.</para>

<para
>Il testo richiesto può essere configurato inserendo il testo nel campo di input. Se la modifica è vuota verrà utilizzato un testo predefinito.</para>
</sect3>

<sect3 id="soundconfiguration_postprocessing">
<title
>Post-elaborazione</title>
<para
>Tutto i campioni registrati (formazione) e importati (attraverso i dati di formazione per l'importazione) possono essere trattati con una serie di comandi post-elaborazione. Le catene di post-elaborazione sono una funzione avanzata e non dovrebbero essere necessari per l'utente medio.</para>

<para>
<screenshot>
<screeninfo
>Configurazione audio: post-elaborazione</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_sound_4.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>I comandi di post-elaborazione possono essere visti come una catena di filtri attraverso cui devono passare le registrazioni. Utilizzando questi <quote
>filtri</quote
> puoi definire i comandi per eliminare il rumore di fondo nei dati di formazione o normalizzare le registrazioni.</para>

<para
>Dato il programma <application
>process_audio</application
> che prende i file di input e di output come suoi argomenti (&eg;: <command
>process_audio in.wav out.wav</command
>), il comando di post-elaborazione sarebbe: <userinput
>process_audio %1 %2</userinput
>. I due segnaposto %1 e %2 verranno sostituiti rispettivamente dal nome del file di input e dal nome del file di output.</para>

<para
>The switch to <quote
>apply filters to recordings recorded with Simon</quote
> enables the postprocessing chains for samples recorded during the training (including the initial training while adding the word). If you don't select this switch the postprocesing commands are only applied to imported samples (through the <link linkend="import_training-data"
>import training data wizard</link
>).</para>

</sect3>

<sect3 id="configuration_sound_context">
<title
>Context</title>

<para
>Every sample recorded with Simon is assigned a <link linkend="sample_group"
>sample group</link
>.</para>

<para
>When creating the acoustic model from the training samples Simon can take the current situation into account to only use a subset of all gathered training data.</para>

<para>
<screenshot>
<screeninfo
>Sound Configuration: Context</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_sound_5.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>For example, in a system where multiple, very different speakers use one shared setup, <link linkend="context_conditions"
>context conditions</link
> can be set up to automatically build separate models for both users depending on the current situation.</para>

<para
>The above screenshot, for example, shows a setup where, given that all samples of "peter" were tagged "peters_samples" and all samples of "mathias" were tagged "mathias_samples" (refer to the <link linkend="soundconfiguration_device"
>device configuration for more information on how to set up sample groups</link
>), the active acoustic model will only contain the current user's own samples as long as the file <filename
>/home/bedahr/.username</filename
> contains either "peter" or "mathias".</para>

<para
>Another example use-case would be to switch to a more noise-resistant acoustic model when the user starts playing music.</para>

</sect3>
</sect2>

<sect2 id="configuration_speechmodel">
<title
>Modello vocale</title>
<para
>Qui puoi modificare i parametri del modello vocale.</para>

<sect3 id="base_model_use">
<title
>Base model</title>

<para
>You can optionally use base models to limit / circumvent the training or to avoid installing a model creation backend. Please refer to the general <link linkend="base_model"
>base model section</link
> for more details about base models.</para>

<para>
<screenshot>
<screeninfo
>Base model configuration</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="base_model_settings_1.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</para>

<para
>To use a <link linkend="base_model_user_generated"
>user-generated model</link
>, select <guimenuitem
>Do not use a base model</guimenuitem
>. To use a <link linkend="base_model_static"
>static base model</link
>, select a base model and <emphasis
>do not</emphasis
> select <guibutton
>Adapt base model using training samples</guibutton
>. To instead use an <link linkend="base_model_adapted"
>adapted base model</link
>, check <guibutton
>Adapt base model using training samples</guibutton
> after selecting a base model.</para>

<para
>Simon base models are packaged in <filename
>.sbm</filename
> files.</para>

<para
>To add base models to the selection, you can either import local models (<menuchoice
><guimenuitem
>Open model</guimenuitem
><guimenuitem
>Import</guimenuitem
></menuchoice
>), download them from an online repository (<menuchoice
><guimenuitem
>Open model</guimenuitem
><guimenuitem
>Download</guimenuitem
></menuchoice
>) or create new ones from raw files (<menuchoice
><guimenuitem
>Open model</guimenuitem
><guimenuitem
>Create from model files</guimenuitem
></menuchoice
>).</para>

<para>
  <screenshot>
    <screeninfo
>Importing a base model from the internet</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="base_model_settings_2.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>If you have raw model files produced by either supported <link linkend="model_backends"
>model creation backend</link
>, you can package them into SBM container for use with &kmyapplication;.</para>

<para>
  <screenshot>
    <screeninfo
>Creating base models from raw files</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="base_model_settings_3.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>You can also export your currently active model by selecting <guibutton
>Export active model</guibutton
>. The exported SBM file will contain your full acoustic model (ignoring the <link linkend="configuration_sound_context"
>current context</link
>) that can be <ulink url="http://kde-files.org/index.php?xcontentmode=648"
>shared with other Simon users</ulink
>.</para>
</sect3>

<sect3>
<title
>Training data</title>

<para
>This section allows to configure the training samples.</para>

<para>
<screenshot>
<screeninfo
>Training data configuration</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_speech_model.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
<para
>La frequenza di campionamento impostata qui rappresenta la frequenza di campionamento di destinazione del modello acustico. Non ha nulla a che fare con la frequenza di campionamento di registrazione, ed è responsabilità dell'utente assicurarsi che i campioni siano effettivamente disponibili in tale formato (di solito la registrazione in quella esatta frequenza di campionamento o mediante la definizione di comandi di post-elaborazione per ricampionare i file, consulta la <link linkend="soundconfiguration"
>sezione configurazione audio</link
> per maggiori dettagli).</para>

<para
>Di solito i modelli sono costruiti / utilizzati o a 16kHz o a 8kHz. I modelli a 16kHz avranno una maggiore precisione rispetto ai modelli a 8kHz. Aumentare a più di 16kHz non è raccomandato dato che consumeresti molte risorse macchina e, in pratica, probabilmente non si tradurrà in tassi di riconoscimento più elevati.</para>

<para
>Moreover, the path to the training samples can be adjusted. However, be sure that the previously gathered training samples are also moved to the new location. If you use automatic synchronization the Simond would alternatively also provide Simon with the missing sample but copying them manually is still recommended for performance reasons.</para>
</sect3>


<sect3 id="configure_language_profile">
<title
>Language Profile</title>

<para
>In the language profile section you can select a previously built or downloaded <link linkend="language_profile_general"
>language profile</link
> to aid with the transcription of new words.</para>

<para>
<screenshot>
<screeninfo
>Language profile configuration</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="language_profile_configuration.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect3>
</sect2>

<sect2 id="configuration_model_extensions">
<title
>Estensioni del modello</title>

<para
>Here you can configure the base URL that is going to be used for the <link linkend="import_dict_hadifix"
>automatic bomp import</link
>. The default points to the copy on the Simon listens server.</para>
<para>
<screenshot>
<screeninfo
>Estensioni del modello</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_model_extensions.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect2>

<sect2 id="configure_recognition">
<title
>Riconoscimento</title>

<para
>Here you can configure the recognition and model synchronization with the Simond server.</para>

<sect3 id="configure_server">
  <title
>Server</title>

  <para
>Using the server configuration you can set parameters of the connection to Simond.</para>

<sect4 id="configure_server_general">
<title
>Generale</title>
<para
>The Simon main application connects to the Simond server (see the <link linkend="architecture"
>architecture section</link
> for more information). </para>

<para>
<screenshot>
<screeninfo
>Configurazione server: generale</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_simond_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>To identify individual users of the system (one Simond server can of course serve multiple Simon clients), Simon and Simond use users. Every user has his own speech model. The username / password combination given here is used to log in to Simond. If Simond does not know the username or the password is incorrect, the connection will fail. See the <ulink url="help:/simond"
>Simond manual</ulink
> on how to setup users for Simond.</para>

<para
>The recognition itself - which is done by the server - might not be available at all times. For example it would not be possible to start the recognition as long as the user does not have a compiled acoustic and language model which has to be created first (during synchronization when all the ingredients - vocabulary, grammar, training - are present). Using the option to start the recognition automatically once it is available, Simon will request to start the recognition when it receives the information that it is ready (all <link linkend="needed_parts"
>required components</link
> are available).</para>

<para
>Using the <guilabel
>Connect to server on startup</guilabel
> option, Simon will automatically start the connection to the configured Simond servers after it has finished loading the user interface.</para>
</sect4>

<sect4 id="configure_server_network">
<title
>Rete</title>
<para
>Simon connects to Simond using TCP/IP.</para>

<para>
<screenshot>
<screeninfo
>Configurazione server: rete</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_simond_2.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
<para
>As of yet (Simon 0.4), encryption is not yet supported. </para>
<para
>The timeout setting specifies, how long Simon will wait for a first reply when contacting the hosts. If you are on a very, very slow network and/or use <quote
>connect on start</quote
> on a very slow machine, you may want to increase this value if you keep getting timeout errors and can resolve them by trying again repeatedly. </para>
<para
>Simon supports to be configured to use more than one Simond. This is very useful if you for example are going to use Simon on a laptop which connects to a different server depending where you are. You could for example add the server you use when you are home and the server used when you are at work. When connecting, Simon will try to connect to each of the servers (in order) until it finds one server that accepts the connection.</para>

<para
>Per aggiungere un server, basta inserire il nome host o l'indirizzo IP e la porta (separati da <quote
>:</quote
>) o utilizzare la finestra di dialogo che appare quando si clicca sulla freccia blu accanto al campo di immissione.</para>

</sect4>
</sect3>

<sect3 id="configure_synchronization">
<title
>Sincronizzazione e copia di sicurezza del modello</title>
<para
>Qui puoi configurare la sincronizzazione del modello e ripristinare le versioni precedenti del modello vocale.</para>

<para>
<screenshot>
<screeninfo
>Sincronizzazione e copia di sicurezza del modello</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_synchronization.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Simon creates the speech input files which are then compiled and used by the Simond server (see the <link linkend="architecture"
>section architecture for more details</link
>). </para>

<para
>The process of sending the speech input files, compiling them and receiving the compiled versions is called <quote
>synchronization</quote
>. Only after the speech model is synchronized the changes take effect and a new restore point is set. This is why per default Simon will always synchronize the model with the server when it changes. This is called <guimenuitem
>Automatic Synchronization</guimenuitem
> and is the recommended setting. </para>
<para
>However, if you want more control you can instruct Simon to ask you before starting the synchronization after the model has changed or to rely on manual synchronization all together. When selecting the manual synchronization you have to manually use the <menuchoice
><guimenuitem
>Actions</guimenuitem
><guimenuitem
>Synchronize</guimenuitem
></menuchoice
> menu item of the Simon main window every time you want to compile the speech model. </para>

<para
>The Simon server will maintain a copy of the last five iterations of model files. However, this only includes the <quote
>source files</quote
> (the vocabulary, grammar, &etc;) - <emphasis
>not the compiled model</emphasis
>. However, the compiled model will be regenerated from the restored source files automatically.</para>

<para
>Una volta collegato al server, puoi selezionare uno dei modelli disponibili e ripristinarlo facendo clic su <guimenuitem
>Seleziona modello</guimenuitem
>.</para>

</sect3>
</sect2>



<sect2 id="configure_actions">
<title
>Azioni</title>

<para
>Nella configurazione delle azioni puoi configurare le reazioni ai risultati del riconoscimento.</para>

<sect3 id="configure_actions_recognition">
  <title
>Riconoscimento</title>

  <para
>The recognition of Simon computes not only the most likely result but rather the top ten results.</para>
  <para
>A ciascuno dei risultati viene assegnato un punteggio di confidenza tra 0 e 1 (1 rappresenta la sicurezza al 100%).</para>
  <para
>Con la <guilabel
>fiducia minima</guilabel
> puoi impostare un valore minimo per la fiducia verso i risultati del riconoscimento per essere considerati validi.</para>

  <para
>If more than one recognition results are rated higher than the minimum confidence score, Simon will provide a popup listing the most likely options for you to choose from.</para>

  <para>
  <screenshot>
  <screeninfo
>Intendevi forse...?</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="did_you_mean.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Questa finestra può essere disattivata utilizzando la casella di controllo <guibutton
>Visualizza la selezione a popup per i risultati ambigui</guibutton
>.</para>
</sect3>
<sect3>
  <title
>Finestra di dialogo carattere</title>
  <para
>Many plugins of Simon have a graphical user interface.</para>
  <para
>Puoi configurare i caratteri di queste interfacce a livello centrale e indipendente dalle impostazioni dei caratteri di sistema.</para>

  <para>
  <screenshot>
    <screeninfo
>Numero di ingresso con tipo di carattere personalizzato</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="input_number_huge_font.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>
</sect3>

<sect3>
  <title
>Elenchi</title>
  <para
>Qui puoi trovare la configurazione globale per gli elementi dell'elenco. Questo serve come modello per nuovi scenari, ma viene anche direttamente utilizzato per <link linkend="configure_actions_recognition"
> il popup per il riconoscimento dei risultati ambigui</link
>.</para>
</sect3>
</sect2>

<sect2 id="text-to-speech_config">
<title
>Text-to-speech</title>

<para
>Some parts of &kmyapplication;, most notably the <link linkend="dialog_command_plugin"
>dialog command plugin</link
> employ text-to-speech (or "TTS") to read text aloud.</para>

<sect3>
<title
>Backends</title>
<para
>Multiple external TTS solutions can be used to allow &kmyapplication; to talk. Multiple backends can be enabled at the same time and will be queried in the configured order until one is found that can synthesize the requested message.</para>

<para
>The following backends are available: <itemizedlist>
  <listitem
><para
>Recordings</para
><para
>Instead of an engine to convert arbitrary text into speech, text-snippets can be pre-recorded and will be simply played back.</para
></listitem>
  <listitem
><para
>Jovie</para
><para
>Uses the <ulink url="http://www.kde.org/applications/utilities/jovie"
>Jovie TTS system</ulink
>. This requires a valid Jovie set-up.</para
></listitem>
  <listitem
><para
>Webservice</para
><para
>The webservice backend can be used to talk to any TTS engine that has a web front-end that returns <filename
>.wav</filename
> files.</para
></listitem>
</itemizedlist>
</para>
<para>
  <screenshot>
    <screeninfo
>TTS: backend selection</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="tts_1.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>
</sect3>

<sect3>
<title
>Recordings</title>

<para
>Instead of using an external TTS engine, you can also record yourself or other speakers reading the texts aloud. Simon can then play back these pre-recorded snippet when they are requested of it's text-to-speech engine.</para>

<para
>These recorded sound bites are organized into "sets" of different speakers which can also be imported and exported to share them with other &kmyapplication; users.</para>

<para>
  <screenshot>
    <screeninfo
>TTS: recordings</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="tts_2.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>
</sect3>

<sect3>
<title
>Webservice</title>
<para
>Through the webservice backend, &kmyapplication; can use web-based TTS engines like <ulink url="http://mary.dfki.de"
>MARY</ulink
>.</para>

<para>
  <screenshot>
    <screeninfo
>TTS: webservice</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="tts_3.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>
<para
>You can provide any Url. &kmyapplication; will replace any instance of "%1" within the configured Url with the text to synthesize. The backend expects the queried webservice to return a <filename
>.wav</filename
> file that will be streamed and outputted through &kmyapplication;'s sound layer - respecting the <link linkend="soundconfiguration_device"
>sound device configuration</link
>.</para>
</sect3>
</sect2>

<sect2 id="social_desktop_config">
<title
>Desktop sociale</title>
<para
>Scenarios can be <link linkend="export_scenario"
>uploaded</link
> and <link linkend="import_scenario"
>downloaded from within Simon</link
>.</para>

<para
>For this we use KDEs social desktop facilities and our own <ulink url="http://kde-files.org/index.php?xcontentmode=692"
>category for Simon scenarios on kde-files.org</ulink
>.</para>

<para
>Se hai già un account su <ulink url="http://opendesktop.org"
>opendesktop.org</ulink
> puoi inserire le credenziali. In caso contrario, puoi registrarti direttamente dal modulo di configurazione.</para>

<para
>La registrazione è ovviamente gratuita.</para>
</sect2>

<sect2 id="webcam_configuration">
<title
>Webcam configuration</title>
<para
>In Webcam configuration, you can configure frame per second (fps) and select the webcam to use when multiple webcams are connected to your system. </para>
<para>
  <screenshot>
    <screeninfo
>Webcam configuration</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="configure_webcam.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>Frame per second is the rate at which webcam will produce unique consecutive images called frames. The optimal value of fps is between 5-15 for proper performance. </para>
</sect2>

<sect2 id="jconfs">
<title
>Advanced: Adjusting the recognition parameters manually</title>

<para
>Simon is targeted towards end-users. It's interface is designed to allow even users without any background in speech technology to design their own language and acoustic models by providing reasonable default values for simple uses. </para>
<para
>In special cases (severe speech impairments for example), special configuration might be needed. This is why the raw configuration files for the recognition are also respected by Simon and can of course be modified to suit your needs. </para>

<sect3 id="julius">
<title
>Julius</title>

<para
>Esistono fondamentalmente due parti della configurazione Julius modificabili: <itemizedlist>
<listitem
><para
>adin.jconf</para
><para
>This is the configuration of the Simon client of the Soundstream sent from Simon to the Simond. This file is directly read by the adinstreamer.</para>
<para
>Simon ships with a default adin.jconf without any special parameters. You can change this system wide configuration which will affect all users if there are different user accounts on your machine who all use Simon. To just change the configuration of one of those users copy the file to the user path (see below) and edit this copy.</para>
</listitem>
<listitem
><para
>julius.jconf</para
><para
>This is a configuration of the Simond server and directly influences the recognition. This file is parsed by libjulius and libsent directly.</para>
<para
>Simond ships with a default julius.jconf. Whenever there is a new user added to the Simond database, Simond will automatically copy this system wide configuration to the new user. After that the user is of course free to change it but it won't affect the other users. This way the <quote
>template</quote
> (the system wide configuration) can be changed without affecting other users.</para>
</listitem>
</itemizedlist>
</para>

<para
>Il percorso dei file di configurazione di Julius dipende dalla piattaforma: <table frame='all'
><title
>File di configurazione di Julius</title>
<tgroup cols='3' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<colspec colname='c3'/>
<thead>
<row>
  <entry
>File</entry>
  <entry
>Microsoft Windows</entry>
  <entry
>GNU/Linux</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>adin.jconf (sistema)</entry>
  <entry
>(Percorso di installazione)\share\apps\simon\adin.jconf</entry>
  <entry
>`kde4-config --prefix`/share/apps/simon/adin.jconf</entry>
</row>
<row>
  <entry
>adin.jconf (utente)</entry>
  <entry
>%appdata%\.kde\share\apps\simon\adin.jconf</entry>
  <entry
>~/.kde/share/apps/simon/adin.jconf</entry>
</row>
<row>
  <entry
>julius.jconf (modello)</entry>
  <entry
>(Percorso di installazione)\share\apps\simond\default.conf</entry>
  <entry
>`kde4-config --prefix`/share/apps/simond/default.jconf</entry>
</row>
<row>
  <entry
>julius.jconf (utente)</entry>
  <entry
>%appdata%\.kde\share\apps\simond\models\(user)\active\julius.jconf</entry>
  <entry
>~/.kde/share/apps/simond/models/(user)/active/julius.jconf</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</sect3>

</sect2>

</sect1>

</chapter>


<chapter id="using-simon-advanced">
<title
>Advanced: Creating new scenarios with &kmyapplication;</title>

<para
>The following chapter is aimed towards more experienced users who want to design their own scenarios.</para>

<para
>For general usage instruction, please refer to the chapter <link linkend="using-simon"
>Using &kmyapplication;: Typical user</link
>.</para>

<sect1 id="creating_scenarios_general">
<title
>Introduzione</title>
<para
>To add a new scenario, you first create a new scenario "shell" by <link linkend="add_scenario"
>adding a new scenario object</link
> and then <link linkend="main_window_scenarios"
>open it in the &kmyapplication; main window</link
>.</para>

<para
>To instead modify an existing scenario, you of course just have to open it.</para>

<para
>A &kmyapplication; scenario contains the following components: <itemizedlist>
<listitem
><para
><link linkend="vocabulary"
>Vocabulary</link
></para
></listitem>
<listitem
><para
><link linkend="grammar"
>Grammar</link
></para
></listitem>
<listitem
><para
><link linkend="training"
>Training texts</link
></para
></listitem>
<listitem
><para
><link linkend="context"
>Context</link
></para
></listitem>
<listitem
><para
><link linkend="commands"
>Commands</link
></para
></listitem>
</itemizedlist>
</para>

<para
>Before describing how to configure these elements in Simon, the next section provides background information that will help you understand the basic principles of speech modelling. This fundamental knowledge is necessary to design sensible scenarios.</para>

</sect1>

<sect1 id="speech_model">
<title
>Speech recognition: background</title>

<note
><para
>Before explaining exactly how you can create new scenarios with Simon, this section introduces some fundamental basics to speech recognition in general.</para
></note>

<para
>Il sistema di riconoscimento vocale prendere l'ingresso vocale (spesso da un microfono) e cerca di tradurlo in testo scritto. Per fare questo, si basa su rappresentazioni statistiche di voce umana. In termini semplici: il computer impara parole - o più correttamente i suoni che compongono il suono delle parole. </para>

<para
>Un modello vocale è costituito da due parti distinte: <itemizedlist>
  <listitem
><para
>Modello di linguaggio</para
></listitem>
  <listitem
><para
>Modello acustico</para
></listitem>
</itemizedlist>
</para>

<sect2 id="language_model">
<title
>Modello di linguaggio</title>

<para
>Il modello di linguaggio definisce il vocabolario e la grammatica che vuoi usare.</para>

<sect3 id="vocabulary_theory">
<title
>Vocabulary</title>
<para
>The vocabulary defines what words the recognition process should recognize. Every word you want to be able to use with Simon should be contained in your vocabulary. </para>
<para
>One entry in the vocabulary defines exactly one <quote
>word</quote
>. In contrast to the common use of the word <quote
>word</quote
>, in Simon <quote
>word</quote
> means one unique combination of the following: <itemizedlist
> <listitem
><para
>Wordname</para
><para
>(The written word itself)</para
></listitem
> <listitem
><para
>Category</para
><para
>(Grammatical category; for example: <quote
>Noun</quote
>, <quote
>Verb</quote
>, &etc;)</para
></listitem
> <listitem
><para
>Pronunciation</para
><para
>(How the word is pronounced; Simon accepts any kind of phonetic as long as it does not use special characters or numbers)</para
></listitem
> </itemizedlist
> That means that plurals or even different cases are different <quote
>words</quote
> to Simon. This is an important design decision to allow more control when using a sophisticated grammar. </para>

<para
>In general, it is advisable to keep your vocabulary as sleek as possible. The more words, the higher the chance that Simon might misunderstand you. </para>

<para
>Example vocabulary (please note that the categories here are deliberately set to Noun / Verb to help the understanding; please to refer to the <link linkend="grammar"
>grammar section</link
> why this might not be the best idea): <table frame='all'
><title
>Esempio di vocabolario</title>
<tgroup cols='3' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<colspec colname='c3'/>
<thead>
<row>
  <entry
>Parola</entry>
  <entry
>Category</entry>
  <entry
>Pronuncia</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>Computer</entry>
  <entry
>Nome</entry>
  <entry
>k ax m p y uw t er</entry>
</row>
<row>
  <entry
>Internet</entry>
  <entry
>Nome</entry>
  <entry
>ih n t er n eh t</entry>
</row>
<row>
  <entry
>Posta</entry>
  <entry
>Nome</entry>
  <entry
>m ey l</entry>
</row>
<row>
  <entry
>chiudi</entry>
  <entry
>Verbo</entry>
  <entry
>k l ow s</entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<sect4 id="active_dictionary">
<title
>Dizionario attivo</title>
<para
>Il vocabolario utilizzato per il riconoscimento viene indicato come dizionario attivo o vocabolario attivo.</para>
</sect4>

<sect4 id="shadow_dictionary">
<title
>Dizionario ombra</title>
<para
>Come detto sopra, l'utente dovrebbe mantenere il suo vocabolario / dizionario quanto più snello possibile. Tuttavia, come una parola nel vocabolario deve avere anche informazioni sulla sua pronuncia, sarebbe anche bello avere un grande dizionario in cui si possa guardare la pronuncia e le altre caratteristiche delle parole. </para>
<para
>Simon provides this functionality. We refer to this large reference dictionary as <quote
>shadow dictionary</quote
>. This shadow dictionary is not created by the user but can be imported from various sources. </para>
<para
>As Simon is a multi-language solution we do not ship shadow dictionaries with Simon. However, it is very easy to import them yourself using the import dictionary wizard. This is described in the <link linkend="import_dictionary"
>Import Dictionary section</link
>. </para>
</sect4>
<sect4 id="language_profile_general">
<title
>Language profile</title>
<para
>Additionally to a shadow dictionary, Simon can use a language profile to provide help with transcribing words. </para>

<para
>A language profile consists of rules how words are pronounced in the target language. It can be likened to the way that humans can often pronounce a word they never heard just because they know some implicit "pronunciation rules" of the language.</para>

<para
>Just as with humans, this process is not perfect but can provide a solid starting ground.</para>

<para
>This automatic deduction of a phoneme transcription from a written word is called "grapheme to phoneme conversion".</para>

<para
>Simon requires the <ulink url="http://www-i6.informatik.rwth-aachen.de/web/Software/g2p.html"
>Sequitur G2P</ulink
> grapheme to phoneme converter to be installed and set up for language profiles to work.</para>

<para
>If you have <link linkend="configure_language_profile"
>selected a pre-built language profile</link
> or <link linkend="create_language_profile"
>built your own</link
>, Simon will automatically transcribe new words with it when they are not found in your <link linkend="shadow_dictionary"
>shadow dictionary</link
>.</para>

</sect4>
</sect3>

<sect3 id="grammar_general">
<title
>Grammatica</title>
<para
>La grammatica definisce quali combinazioni di parole sono corrette. </para>
<para
>Let's look at an example: You want to use Simon to launch programs and close those windows when you are done. You would like to use the following commands: <itemizedlist>
  <listitem
><para
><quote
>Computer, Internet</quote
> per aprire un browser</para
></listitem>
  <listitem
><para
><quote
>Computer, Mail</quote
></para
><para
>Per aprire un programma di posta elettronica</para
></listitem>
  <listitem
><para
><quote
>Computer, chiudi</quote
></para
><para
>Per chiudere la finestra attuale</para
></listitem>
</itemizedlist>
</para>
<para
>Seguendo la grammatica inglese, il vocabolario dovrebbe contenere i seguenti elementi: <table frame='all'
><title
>Esempio di vocabolario</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
  <entry
>Parola</entry>
  <entry
>Category</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>Computer</entry>
  <entry
>Nome</entry>
</row>
<row>
  <entry
>Internet</entry>
  <entry
>Nome</entry>
</row>
<row>
  <entry
>Posta</entry>
  <entry
>Nome</entry>
</row>
<row>
  <entry
>chiudi</entry>
  <entry
>Verbo</entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<para
>To allow the sentences defined above Simon would need the following grammar: <itemizedlist>
  <listitem
><para
><quote
>Sostantivo Sostantivo</quote
> per frasi del tipo <quote
>Computer Internet</quote
></para
></listitem>
  <listitem
><para
><quote
>Sostantivo Verbo</quote
> per frasi del tipo <quote
>Computer close</quote
></para
></listitem>
</itemizedlist>
</para>
<para
>While this would work, it would also allow the combinations <quote
>Computer Computer</quote
>, <quote
>Internet Computer</quote
>, <quote
>Internet Internet</quote
>, &etc; which are obviously bogus. To improve the recognition accuracy, we can try to create a grammar that better reflects what we are trying to do with Simon. </para>

<para
>It is important to remember that you define your own <quote
>language</quote
> when using Simon. That means that you are not bound to grammar rules that exist in whatever language you want to use Simon with. For a simple command and control use-case it would for example be advisable to invent new grammatical rules to eliminate the differences between different commands imposed by grammatical information not relevant for this use case. </para>

<para
>Nell'esempio precedente non è rilevante che <quote
>vicino</quote
> sia un verbo o che <quote
>Computer</quote
> e <quote
>Internet</quote
> siano sostantivi. Invece, perché non definirli come qualcosa che rifletta meglio quello che vuoi che siano: <table frame='all'
><title
>Esempio migliorato di vocabolario</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
  <entry
>Parola</entry>
  <entry
>Category</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>Computer</entry>
  <entry
>Attivazione</entry>
</row>
<row>
  <entry
>Internet</entry>
  <entry
>Comando</entry>
</row>
<row>
  <entry
>Posta</entry>
  <entry
>Comando</entry>
</row>
<row>
  <entry
>chiudi</entry>
  <entry
>Comando</entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<para
>Ora cambiamo la grammatica come di seguito: <itemizedlist
><listitem
><para
><quote
>Comando attivazione</quote
></para
></listitem
></itemizedlist
> Questo ti permette tutte le combinazioni sopra descritte. Tuttavia, ti limita anche le possibilità esattamente a quelle tre frasi. Soprattutto in modelli più grandi una grammatica e un vocabolario ben pensati possono significare una grande differenza nei risultati di riconoscimento. </para>
</sect3>


</sect2>

<sect2 id="acoustic_model">
<title
>Modello acustico</title>
<para
>Il modello acustico rappresenta la pronuncia in un formato leggibile dalla macchina.</para>

<para
>Guardiamo l'esempio di vocabolario seguente: <table frame='all'
><title
>Esempio di vocabolario</title>
<tgroup cols='3' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<colspec colname='c3'/>
<thead>
<row>
  <entry
>Parola</entry>
  <entry
>Category</entry>
  <entry
>Pronuncia</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>Computer</entry>
  <entry
>Nome</entry>
  <entry
>k ax m p y uw t er</entry>
</row>
<row>
  <entry
>Internet</entry>
  <entry
>Nome</entry>
  <entry
>ih n t er n eh t</entry>
</row>
<row>
  <entry
>Posta</entry>
  <entry
>Nome</entry>
  <entry
>m ey l</entry>
</row>
<row>
  <entry
>chiudi</entry>
  <entry
>Verbo</entry>
  <entry
>k l ow s</entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<para
>La pronuncia di ogni parola è composta di suoni individuali che sono separati da spazi. Per esempio, la parola <quote
>close</quote
> consiste dei suoni seguenti: <itemizedlist
><listitem
><para
>k</para
></listitem
> <listitem
><para
>l</para
></listitem
> <listitem
><para
>ow</para
></listitem
> <listitem
><para
>s</para
></listitem
> </itemizedlist
>. Il modello acustico utilizza il fatto che le parole pronunciate sono composte di suoni molto simili a parole scritte, che sono composte da lettere. Usando questa conoscenza, possiamo dividere le parole in suoni (rappresentati dalla pronuncia) e rimontare di nuovo durante il riconoscimento. Questi blocchi costruiti vengono chiamati <quote
>fonemi</quote
>. </para>

<para
>Poiché il modello acustico rappresenta in realtà il modo di parlare i fonemi delle parole, il materiale per la formazione è condiviso tra tutte le parole che usano gli stessi fonemi. </para>
<para
>Ciò significa che aggiungendo la parola <quote
>clothes</quote
> al modello di linguaggio, il tuo modello acustico ha già un'idea di come suoni la porzione <quote
>clo</quote
> dato che condivide gli stessi fonemi iniziali (<quote
>k</quote
>, <quote
>l</quote
>, <quote
>ow</quote
>). </para>
<para
>To train the acoustic model (in other words to tell him how you pronounce the phonemes) you have to <quote
>train</quote
> words from your language model. That means that Simon displays a word which you read out loud. Because the word is listed in your vocabulary, Simon already knows what phonemes it contains and can thus <quote
>learn</quote
> from your pronunciation of the word. </para>
</sect2>


</sect1>


<sect1 id="scenarios_use_advanced">
<title
>Scenari</title>
<para
>This section extends the previous one about <link linkend="scenarios_use"
>basic scenario management</link
> and tells you how to create, edit and export scenarios.</para>

<para>
  <screenshot>
    <screeninfo
>Manage scenarios</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="manage_scenarios_1.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<sect2 id="scenario_hierarchies">
<title
>Scenario hierarchies</title>

<para
>You can create scenario hierarchies by dragging and dropping active scenarios on top of each other.</para>

<para>
  <screenshot>
    <screeninfo
>Manage scenarios: Scenario hierarchies</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="manage_scenarios_2.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>Scenario hierarchies serve two purposes: <itemizedlist>
<listitem
><para
>The <link linkend="context"
>context system</link
> respects scenario hierarchies: If the parent scenario gets deactivated, all child scenarios will become deactivated as well.</para
></listitem>
<listitem
><para
>If you attempt to <link linkend="export_scenario"
>export a scenario</link
> that has children, &kmyapplication; will allow you to export them in a joint scenario package. This way, you can share multiple logically co-dependent scenarios (&eg; one "Office" scenario that contains sub-scenarios for "Word", "Excel", etc.).</para
></listitem>
</itemizedlist>
</para>

</sect2>

<sect2 id="add_scenario">
  <title
>Aggiungere un nuovo scenario</title>
  <para
>Per aggiungere un nuovo scenario, selezionare il pulsante <guibutton
>Aggiungi</guibutton
>. Sarà visualizzata una nuova finestra di dialogo.</para>

<para>
  <screenshot>
    <screeninfo
>Aggiungi scenario</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="add_scenario.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>Quando crei un nuovo scenario, inserisci un nome descrittivo. Per i caricamenti successivi su <ulink url="http://kde-files.org/index.php?xcontentmode=692"
>KDE files</ulink
> ti chiediamo di seguire un certo schema di denominazione anche se questo, naturalmente, non è un requisito: <quote
>[&lt;lingua&gt;/&lt;modello di base&gt;] &lt;nome&gt;</quote
>. Se, per esempio, crei uno scenario in inglese che funziona con il modello di base Voxforge per controllare Mozilla Firefox questo diventa: <quote
>[EN / VF] Firefox </quote
>. Se lo scenario non è specificamente su misura per un set di fonemi (modello di base), basta omettere il secondo tag in questo modo: <quote
>[IT] Firefox </quote
>.</para>

<para
>La versione dello scenario è solo un numero di versione incrementale che rende più facile la distinzione tra diverse versioni di uno scenario.</para>

<para
>If your scenario needs a specific feature of Simon (for example because you use a new plugin), you can define minimum and maximum version numbers of Simon here.</para>

<para
>Puoi impostare la licenza dello scenario tramite il menu a discesa. Ovviamente puoi anche aggiungere un testo arbitrario come licenza direttamente nel campo di immissione.</para>

<para
>Puoi quindi aggiungere il tuo nome (o pseudonimo) alla lista degli autori dello scenario. Ti saranno anche chieste le informazioni di contatto. Questo campo è puramente fornito come un modo comodo per contattare l'autore dello scenario per i cambiamenti, i problemi, mail di congratulazioni &etc; Se non vuoi fornire il tuo indirizzo e-mail è sufficiente immettere un trattino <quote
> - </quote
> che indica che non sei disposto a divulgare queste informazioni.</para>

</sect2>

<sect2 id="edit_scenario">
<title
>Modifica scenario</title>
<para
>Per modificare gli scenari, seleziona <guibutton
>Modifica</guibutton
> dalla finestra di dialogo <guilabel
>Gestione scenari</guilabel
>.</para>
<para
>La finestra di dialogo funziona esattamente allo stesso modo di <link linkend="add_scenario"
> Aggiungi scenario</link
>.</para>
</sect2>

<sect2 id="export_scenario">
  <title
>Esporta scenario</title>
  <para
>Scenarios can be exported to a local file in Simon's XML scenario file format and directly uploaded to the <ulink url="http://kde-files.org/index.php?xcontentmode=692"
>Simon Scenarios</ulink
> subsection of the OpenDesktop site <ulink url="http://kde-files.org"
>KDE-files.org</ulink
>.</para>

  <para
>Per caricare sui siti OpenDesktop, è necessario disporre di un account. La <ulink url="http://opendesktop.org/usermanager/new.php"
>registrazione</ulink
> è molto semplice e, naturalmente, gratuita.</para>

  <para
>Simon allows you to upload new content directly from within Simon (<guibutton
>Export</guibutton
> 
> <guimenuitem
>Publish</guimenuitem
>).</para>

<para>
  <screenshot>
    <screeninfo
>Caricamento guidato scenario: 1 di 4</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="upload_scenario_1.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para>
  <screenshot>
    <screeninfo
>Caricamento guidato scenario: 2 di 4</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="upload_scenario_2.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para>
  <screenshot>
    <screeninfo
>Caricamento guidato scenario: 3 di 4</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="upload_scenario_3.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para>
  <screenshot>
    <screeninfo
>Caricamento guidato scenario: 4 di 4</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="upload_scenario_4.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

  <para
>To use this functionality, simply enter your account credentials in the <link linkend="social_desktop_config"
>social desktop configuration</link
> in the Simon configuration.</para>

</sect2>
</sect1>


<sect1 id="vocabulary">
<title
>Vocabulary</title>

<para
>The vocabulary module defines the set of words of the scenario. <screenshot>
<screeninfo
>Simon's Vocabulary</screeninfo>
<mediaobject>
<imageobject>
  <imagedata fileref="vocabulary.png"   format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</para>

<para
>Per impostazione predefinita, viene mostrato il vocabolario attivo. Per visualizzare il vocabolario ombra seleziona la scheda <guilabel
> Vocabolario Ombra </guilabel
>.</para>

<para
>Ogni parola afferma <quote
> tasso di riconoscimento </quote
> che al momento è solo un contatore di quanto spesso è stata registrata la parola (da sola o insieme con altre parole). </para>

<para>
<screenshot>
<screeninfo
>Vocabolario ombra</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="vocabulary1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>


</para>

<sect2 id="add_word">
<title
>Aggiungere parole</title>
<para
>Per aggiungere nuove parole al vocabolario attivo, utilizza la procedura guidata per aggiungere una parola.</para>
<para
>Adding words to Simon is basically a two step procedure: <itemizedlist>
<listitem
><para
>Definizione della parola</para
></listitem>
<listitem
><para
>Formazione iniziale</para
></listitem>
</itemizedlist>
</para>

<sect3 id="add_word_define">
<title
>Definizione della parola</title>
<para
>In primo luogo, ti viene chiesto quale parola vuoi aggiungere. <screenshot>
<screeninfo
>Seleziona la parola da aggiungere</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add_word_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>When the user proceeds to the next page, Simon automatically tries to find as much information about the word in the <link linkend="shadow_dictionary"
>shadow dictionary</link
> as possible. </para>

<para
>If the word is listed in the shadow dictionary, Simon automatically fills out all the needed fields (Category and Pronunciation). <screenshot>
<screeninfo
>Campi riempiti automaticamente dal dizionario ombra</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add_word_2.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
<para
>Tutti i suggerimenti del dizionario ombra sono elencati nella tabella delle <guilabel
> parole simili </guilabel
>. Per impostazione predefinita vengono mostrate solo le parole con corrispondenza esatta. Tuttavia, puoi cambiare questo comportamento selezionando la casella di controllo <guilabel
> Includi parole simili </guilabel
> sotto la tabella proposta. Usando parole simili puoi dedurre rapidamente la pronuncia corretta della parola che stai cercando di aggiungere. Vedi <link linkend="manual_transcription"
>in basso</link
> per i dettagli.</para>

<para
>Naturalmente questo dipende dal vostro dizionario ombra. Se il dizionario ombra non contiene la parola che stai cercando di aggiungere, i campi obbligatori devono essere compilati manualmente.</para>

<para
>Some dictionaries that can be imported with Simon (SPHINX, HTK) do not differentiate between upper and lower case. Suggestions based on those dictionaries will always be uppercase. You are of course free to change these suggestions to the correct case. </para>

<para
>Some dictionaries that can be imported with Simon (SPHINX, PLS and HTK) provide no grammatical information at all. These will assign all the words to the category <guilabel
>Unknown</guilabel
>. You should change this to something appropriate when adding those words. </para>

<sect4>
<title
>Manually Selecting a Category</title>
<para
>The category of the word is defined as the grammatical category the word belongs to. This might be <guilabel
>Noun</guilabel
>, <guilabel
>Verb</guilabel
> or completely new categories like <guilabel
>Command</guilabel
>. For more information see the <link linkend="grammar"
>grammar section</link
>.</para>
<para
>The list contains all categories used in both your active and your shadow lexicon and in your grammar. </para>
<para
>You can add new categories to the drop-down menu by using the green plus sign next to it. </para>
</sect4>

<sect4 id="manual_transcription">
<title
>Fornire manualmente la trascrizione fonetica</title>
<para
>The pronunciation is a bit trickier. Simon does not need a certain type of phonetics so you are free to use any method as long as it uses only ASCII characters and no numbers. However, if you want to use a shadow dictionary and want to use it to its full potential you should use the same phonetics as the shadow dictionary. </para>

<para
>Se non sai come trascrivere una parola da solo puoi facilmente utilizzare il dizionario ombra per aiutarti con la trascrizione - anche se la parola non è presente in esso. Diciamo che vogliamo aggiungere la parola <quote
> Firefox </quote
> (per lanciare firefox), che naturalmente non è presente nel nostro dizionario ombra. </para>

<para
>(Ho importato il lessico inglese HTK voxforge disponibile da <ulink url="http://voxforge.org/home/downloads"
> voxforge </ulink
> come un dizionario ombra.) </para>

<para
><quote
> Firefox </quote
> non è presente nel nostro dizionario ombra, in questo modo non ottieni nessun suggerimento. <screenshot>
<screeninfo
>Aggiungi una parola sconosciuta</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add_word_2_2.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>However, we know that firefox sounds like <quote
>fire</quote
> and <quote
>fox</quote
> put together. So let's just open the vocabulary (you can keep the wizard open) by selecting <guibutton
>Vocabulary</guibutton
> from your Simon main toolbar. </para>
<para
>Passare al vocabolario ombra facendo clic sulla scheda <guilabel
> Vocabolario Ombra </guilabel
>.</para>
<para
>Usa la casella <guilabel
>filtro</guilabel
> sopra l'elenco per la ricerca di <quote
>Fire</quote
>: <screenshot>
<screeninfo
>Aggiunta di una parola sconosciuta: Ricerca della pronuncia</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add_word_2_3.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Possiamo vedere, che la parola <quote
>Fire</quote
> è stato trascritta come <quote
>f ay r </quote
>. Ora filtra per <quote
>fox</quote
>, invece di <quote
>Fire</quote
> e puoi vedere che <quote
>Fox</quote
> è stata trascritta <quote
>f ao k s</quote
>. Possiamo supporre, che firefox debba essere trascritto come <quote
>f ay r f ao k s</quote
>. </para>

<para
>Usando questo approccio deduttivo per la pronuncia di parte della parola, hai il netto vantaggio di non avere solo una trascrizione di alta qualità, ma automaticamente anche usare lo stesso set di fonemi come le altre parole che erano correttamente tirate fuori dal dizionario ombra. </para>

<para
>We can now enter the pronunciation and change the category to something appropriate. <screenshot>
<screeninfo
>Parola definita interamente</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add_word_2_4.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

</sect4>

</sect3>

<sect3 id="add_word_record">
<title
>Formazione per la parola</title>
<para
>Per completare la procedura guidata ora possiamo addestrare la parola due volte. Se non vuoi farlo o per esempio utilizzi un <link linkend="base_model_static"
> modello di base statico </link
>, puoi ignorare queste due pagine. </para>

<para
>Because you are about to record some training samples, Simon will display the volume calibration to make sure that your microphone is set up correctly. For more information please refer to the <link linkend="volume_calibration"
>volume calibration section</link
> </para>

<para
>Simon will try to prompt you for real-world examples. To do that, Simon will automatically fetch grammar structures using the category of the word and substitute the generic categories with example words from your active lexicon. </para>
<para
>For example: You have the grammar structure <quote
>Trigger Command</quote
> and have the word <quote
>Computer</quote
> of the category <quote
>Trigger</quote
> in your vocabulary. You then add a new word <quote
>Firefox</quote
> of the category <quote
>Command</quote
>. Simon will now automatically prompt you for <quote
>Computer Firefox</quote
> as it is - according to your grammar - a valid sentence. </para>
<para
>If Simon is unable to find appropriate sentences using the word (&ie;: No grammar, not enough words in your active lexicon, &etc;) it will just prompt you for the word alone. </para>
<para
>Although Simon ensures that the automatically generated examples are valid, you can always override its suggestions. Just switch to the <guilabel
>Examples</guilabel
> tab on the <guilabel
>Define Word</guilabel
> page. <screenshot>
<screeninfo
>Modifica di esempi di parole</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add_word_3.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Sei libero di modificare questi esempi a piacimento. Puoi anche andare oltre ed usare le parole che non sono ancora nel tuo lessico attivo fino a quando vengono aggiunte prima di sincronizzare il modello, anche se questo non è consigliato. </para>

<para
>Tutto ciò che rimane è quello di registrare gli esempi. <screenshot>
<screeninfo
>Registrazione</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add_word_4.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
<para
>Assicurati di seguire le linee guida elencate nella <link linkend="recording"
>sezione registrazione</link
>.</para>
</sect3>

</sect2>

<sect2 id="edit_word">
<title
>Modificare una parola</title>
<para
>Per modificare una parola, selezionala semplicemente dal vocabolario, e fai clic su <guibutton
>Modifica</guibutton
>. </para>

<para>
  <screenshot>
    <screeninfo
>Modifica parola</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="edit_word.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>There you can change name, category and pronunciation of the selected word. </para>
</sect2>

<sect2 id="remove_word">
<title
>Rimuovere una parola</title>

<para
>Per rimuovere una parola dal tuo modello di pronuncia, selezionala nella vista vocabolario e fai clic su <guibutton
> Rimuovi </guibutton
>. <screenshot>
<screeninfo
>Registrazione</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="delete_word.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot
></para>

<para
>La finestra di dialogo offre quattro scelte: <itemizedlist>
  <listitem>
    <para
>Move the word to the <guilabel
>Unused</guilabel
> category.</para>
    <para
>Because you (hopefully) don't use the category <guilabel
>Unused</guilabel
> in your grammar, the word will no longer be considered for recognition. In fact, it will be removed from the active vocabulary before compiling the model because no grammar sentence references it.</para>
    <para
>If you want to use the category <guilabel
>Unused</guilabel
> in your grammar, you can of course use a different category for unused words. Just set the category through the <link linkend="edit_word"
>Edit word</link
> dialog.</para>
    <para
>To use the word again, just set the right category again. No data will be lost.</para>
  </listitem>
  <listitem>
    <para
>Sposta la parola al lessico ombra</para>
    <para
>In questo modo rimuoverai la parola selezionata dal lessico attivo (e quindi dal riconoscimento), ma conserverà una copia nel vocabolario ombra. Tutte le registrazioni che contengono la parola saranno conservate.</para>
    <para
>Per utilizzare di nuovo la parola, aggiungila di nuovo nel vocabolario attivo. Quando aggiungi una nuova <quote
> parola </quote
> con lo stesso nome, ti verranno proposti i valori della parola spostata. In questo modo, non perdi nessun dato.</para>
  </listitem>
  <listitem>
    <para
>Eliminare la parola, ma mantieni i campioni</para>
    <para
>Rimuove completamente la parola, ma mantiene i campioni associati. Ogni volta che aggiungi un'altra parola con lo stesso nome i campioni verranno ri-associati.</para>
    <para
>Be careful with this option as the new word you add again might be transcribed differently and this difference cannot be taken into account automatically (Simon will then try to force the new transcription on the old recordings during the model compilation).</para>
    <para
>Non utilizzare questa opzione se i campioni registrati per questa parola erano errati.</para>
  </listitem>
  <listitem
><para
>Rimuovere completamente la parola</para>
  <para
>Basta togliere la parola. Tutte le registrazioni che contengono la parola verranno rimosse.</para>
  <para
>Questa opzione non lascia alcuna traccia né della parola stessa, né dei campioni associati.</para>
  <para
>Poiché i campioni sono globali (non ancora scenari), anche i campioni registrati da sessioni di formazione di altri scenari potrebbero essere rimossi se contengono la parola. Utilizza questa opzione con cautela.</para>
  </listitem>
</itemizedlist>
</para>

</sect2>

<sect2 id="special_training_stub">
<title
>Formazione speciale</title>
<para
>Consulta la <link linkend="special_training"
>sezione formazione speciale nella sezione formazione</link
>.</para>
</sect2>


<sect2 id="import_dictionary">
<title
>Importare un dizionario</title>
<para
>Simon provides the functionality to import large dictionaries as a reference. This reference dictionary is called <link linkend="shadow_dictionary"
>shadow dictionary</link
>. </para>
<para
>Quando l'utente <link linkend="add_word"
>aggiunge una nuova parola</link
> per il modello, deve definire le seguenti caratteristiche per definire tale parola: <itemizedlist>
  <listitem
><para
>Nome della parola</para
></listitem>
  <listitem
><para
>Category</para
></listitem>
  <listitem
><para
>Definizione fonetica</para
></listitem>
</itemizedlist>
</para>
<para
>Queste caratteristiche vengono prese dal dizionario ombra se contiene la parola in questione. Un grande dizionario ombra, di alta qualità può quindi aiutare l'utente nell'aggiungere facilmente nuove parole al modello senza tenere traccia del set di fonemi o - in molti casi - anche fargli dimenticare che la trascrizione fonetica è necessaria per tutti. </para>

<para>
  <screenshot>
    <screeninfo
>Importare un dizionario: Introduzione</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="import_dictionary_0.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>Since version 0.3 you can also import dictionaries directly to the active dictionary. This option is mostly there to make it easier to move to Simon from custom solutions and to encourage importing of older models (for example one used with Simon 0.2). You will <emphasis
>almost never</emphasis
> want to import a very large dictionary as active dictionary.</para>

<para
>You can find a list of available dictionaries that work with Simon on the <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Shadow_dictionary"
>Simon wiki</ulink
>.</para>

<para
>Simon is able to import five different types of dictionaries: <itemizedlist>
  <listitem
><para
>HADIFIX</para
></listitem>
  <listitem
><para
>HTK</para
></listitem>
  <listitem
><para
>PLS</para
></listitem>
  <listitem
><para
>SPHINX</para
></listitem>
  <listitem
><para
>Julius</para
></listitem>
</itemizedlist>
</para>



<sect3 id="import_dict_hadifix">
<title
>Dizionario HADIFIX</title>
<para
>Simon can import HADIFIX dictionaries. </para>
<para
>Un esempio di dizionario HADIFIX è il <ulink url="http://www.sk.uni-bonn.de/forschung/phonetik/sprachsynthese/bomp"
>HADIFIX BOMP</ulink
> tedesco. </para>
<para
>Hadifix dictionaries provide both categories and pronunciation. </para>

<para
>Due to a special exemption in their license the Simon listens team is proud to be able to offer you to download the excellent HADIFIX BOMP directly from within Simon. </para>


<para>
  <screenshot>
    <screeninfo
>Importare dizionario: importazione automatica BOMP</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="import_dictionary_hadifix_1.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>Using the automatic bomp import you can, after providing name and e-Mail address for the team of the University Bonn, directly download and import the dictionary from the Simon listens server.</para>
</sect3>

<sect3 id="import_dict_htk">
<title
>Dizionario HTK</title>
<para
>Simon can import HTK lexica. </para>
<para
>Un esempio di lessico HTK è il <ulink url="http://www.repository.voxforge1.org/downloads/SpeechCorpus/Trunk/Lexicon/"
>Dizionario Voxforge</ulink
> inglese. </para>
<para
>Hadifix dictionaries provide pronunciation information but no categories. All words will be assigned to the category <guilabel
>Unknown</guilabel
>. </para>
</sect3>

<sect3 id="import_dict_pls">
<title
>Dizionario PLS</title>
<para
>Simon can import PLS dictionaries. </para>
<para
>Un esempio di dizionario PLS è il <ulink url="http://www.repository.voxforge1.org/downloads/de/Trunk/Lexicon/"
>dizionario tedesco GPL fornito da Voxforge</ulink
>. </para>
<para
>PLS dictionaries provide pronunciation information but no categories. All words will be assigned to the category <guilabel
>Unknown</guilabel
>. </para>
</sect3>

<sect3 id="import_dict_sphinx">
<title
>Dizionario SPHINX</title>
<para
>Simon can import SPHINX dictionaries. </para>
<para
>Un esempio di dizionario SPHINX è il <ulink url="http://speech.mty.itesm.mx/~jnolazco/proyectos.htm"
>dizionario per lo spagnolo messicano</ulink
>. </para>
<para
>SPHINX dictionaries provide pronunciation information but no categories. All words will be assigned to the category <guilabel
>Unknown</guilabel
>. </para>
</sect3>

<sect3 id="import_dict_julius">
<title
>Dizionario Julius</title>
<para
>Simon can import Julius vocabularies. </para>
<para
>One example of a Julius vocabularies are the word lists of Simon 0.2. </para>
<para
>Julius dictionaries provide pronunciation information as well as category information. </para>
</sect3>
</sect2
> <!-- End Import Dict -->

<sect2 id="create_language_profile">
<title
>Create language profile</title>
<para
>Here, you can build a <link linkend="language_profile_general"
>language profile</link
> from your shadow dictionary.</para>

<para>
<screenshot>
<screeninfo
>Create language profile</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="create_language_profile.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>After selecting <guibutton
>Create profile</guibutton
>, &kmyapplication; will analyze your current shadow dictionary and try to deduce the transcription rules from it.</para>
<para
>This is generally a very length process and can, depending on the size of your shadow dictionary, take up to several hours.</para>
<para
>The created profile will be selected automatically after the process completes.</para>

</sect2>

</sect1
> <!-- End Vocabulary -->


<sect1 id="grammar">
<title
>Grammatica</title>

<para
>Simon provides an easy to use text based interface to change the grammar. You can simply list all the allowed sentences (without any punctuation marks, obviously) like described above. <screenshot>
<screeninfo
>Grammatica</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="grammar.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Selezionando una frase a sinistra, il riquadro destro mostra automaticamente le possibili frasi reali con le parole del vostro vocabolario sulla destra.</para>

<para
>La sezione d'esempio elencherà al massimo 35 esempi, quindi se esiste una quantità maggiore di frasi che corrisponde alla voce grammaticale selezionata, l'elenco potrebbe non essere completo.</para>

<sect2>
<title
>Importare una grammatica</title>
<para
>Additionally to simply entering your desired grammar sentence by sentence, Simon is able to automatically deduce allowed grammar structures by reading plain text using the Import Grammar wizard. <screenshot>
<screeninfo
>Importare una grammatica</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="import_grammar.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Simon can read and import text files but also provides an input field if you want to simply type the text into Simon.</para>

<para
>Supponiamo di avere un vocabolario come nella sezione generale di cui sopra: <table frame='all'
><title
>Esempio migliorato di vocabolario</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
  <entry
>Parola</entry>
  <entry
>Category</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>Computer</entry>
  <entry
>Attivazione</entry>
</row>
<row>
  <entry
>Internet</entry>
  <entry
>Comando</entry>
</row>
<row>
  <entry
>Posta</entry>
  <entry
>Comando</entry>
</row>
<row>
  <entry
>chiudi</entry>
  <entry
>Comando</entry>
</row>
</tbody>
</tgroup>
</table
></para>

<para
>We want Simon to recognize the sentence <quote
>Computer Internet!</quote
>. So we either enter the text using the <guibutton
>Import text</guibutton
> option or create a simple text file with this content <quote
>Computer Internet!</quote
> (any punctuation mark would work) and save it as <filename
>simongrammar.txt</filename
> to use the <guibutton
>Import files</guibutton
> option. <screenshot>
<screeninfo
>Importare una grammatica: Inserisci testo</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="import_grammar1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Importare una grammatica: File di testo</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="import_grammar2.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Importare una grammatica: Seleziona file</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="import_grammar3.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Simon will then read the entered text or all the given text files (in this case the only given text file is <filename
>simongrammar.txt</filename
>) and look up every single word in both active and shadow dictionary (the definition in the active dictionary has more importance if the word is available in both). It will then replace the word with its category.</para>
<para
>In our example this would mean that he would find the sentence <quote
>Computer Internet</quote
>. Simon would find out that <quote
>Computer</quote
> is of the category <guilabel
>Trigger</guilabel
> and <quote
>Internet</quote
> of the category <guilabel
>Command</guilabel
>. Because of this Simon would <quote
>learn</quote
> that <quote
>Trigger Command</quote
> is a valid sentence and add it to its grammar.</para>
<para
>The import automatically segments the input text by punctuation marks (<quote
>.</quote
>, <quote
>-</quote
>, <quote
>!</quote
>, &etc;) so any natural text should work. The importer will automatically merge duplicate sentence structures (even across different files) and add multiple sentence (all possible combinations) when a word has multiple categories assigned to it.</para>
<para
>L'importazione ignorerà frasi in cui una o più parole non possono essere trovate nel modello di linguaggio a meno che non spunti la casella di controllo <guilabel
>importa anche frasi sconosciute</guilabel
>, in questo caso le parole verranno sostituite con <guilabel
>sconosciuto</guilabel
>.</para>

</sect2>





<sect2>
<title
>Renaming Categories</title>
<para
>The rename category wizard allows you to rename categories in both your active vocabulary, your shadow dictionary and the grammar. <screenshot>
<screeninfo
>Rename Category</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="rename_category.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect2>

<sect2>
<title
>Merging Categories</title>
<para
>The merge category wizard allows you to merge two categories into one new category in both your active vocabulary, your shadow dictionary and the grammar. <screenshot>
<screeninfo
>Merge Category</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="merge_category.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
<para
>Questa funzionalità è particolarmente utile se desideri semplificare le strutture grammaticali.</para>
</sect2>


</sect1>



<sect1 id="training">
<title
>Formazione</title>

<para
>Usando il modulo Formazione, puoi migliorare il tuo <link linkend="acoustic_model"
>modello acustico</link
>. </para>

<para
>L'interfaccia elenca tutti i testi di allenamento installati in una tabella con tre colonne: <itemizedlist>
<listitem
><para
>Nome</para
><para
>Un nome descrittivo del testo.</para
></listitem>
<listitem
><para
>Pagine</para
><para
>Il numero di <quote
>pagine</quote
> che costituisce il testo. Ogni pagina rappresenta una registrazione.</para
></listitem>
<listitem
><para
>Tasso di riconoscimento</para
><para
>Analogue to the vocabulary; represents how likely Simon will recognize the words (higher is better). The recognition rate of the training text is the average recognition rate of all the words in the text.</para
></listitem>
</itemizedlist>

<screenshot>
<screeninfo
>Formazione</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="training.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>To improve the acoustic model - and thus the recognition rate - you have to record training texts. This means that Simon gets essentially two needed parts: </para>

<itemizedlist>
  <listitem
><para
>I campioni della pronuncia</para
></listitem>
  <listitem
><para
>Le trascrizioni di questi campioni</para
></listitem>
</itemizedlist>

<para
>The active dictionary is used to transcribe the words (mapping them from the actual word to its phonetic transcription) that make up the text so every word contained in the training text you want to read (train) has to be contained in your active dictionary. Simon will warn you if this is not the case and provide you with the possibility to add all the missing words in one go. </para>

<screenshot>
<screeninfo
>Formazione: Avvertimento in caso di parole mancanti</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="training_warning.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>The procedure is the same as if you would <link linkend="add_word"
>add a single word</link
> but the wizard will prompt you for details and recordings for all the missing words automatically. This procedure can be aborted at any time and Simon will provide both a way to add the already completely defined words and to undo all changes done so far. When the user has added all the words he is prompted for (all the words missing) the changes to the active dictionary / vocabulary are saved and the training of the previously selected text starts automatically. </para>

<para
><anchor id="training_in_progress"/> La formazione (lettura) del testo di formazione funziona esattamente come la formazione iniziale quando aggiungi una nuova parola.</para>

<para
>Assicurati di seguire le linee guida elencate nella <link linkend="recording"
>sezione registrazione</link
>.</para>
<para>
<screenshot>
<screeninfo
>Formazione in corso</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="training_running.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>



<sect2 id="training_storage">
<title
>Cartelle di archiviazione</title>
<para
>I testi di formazione sono memorizzati in due diverse posizioni: <itemizedlist>
  <listitem
><para
>In Linux: <filename
>~/.kde/share/apps/simon/texts</filename
></para>
            <para
>In Windows: <filename
>%appdata%\.kde\share\apps\simon\texts</filename
></para>
          <para
>The texts of the current user. Can be deleted and added with Simon (see below).</para
></listitem>
  <listitem
><para
>In Linux: <filename
>`kde4-config --prefix`/share/apps/simon/texts</filename
></para>
            <para
>In Windows: <filename
>(install folder)\share\apps\simon\texts</filename
></para>
          <para
>System-wide texts. They will appear on every user account using Simon on this machine and cannot be deleted from within Simon because of the obvious permission restrictions on system-wide files.</para>
          <para
>Questa cartella può essere utilizzata dagli amministratori sistema per poter fornire un insieme comune di testi di formazione per tutti gli utenti sul sistema.</para>
          </listitem>
</itemizedlist>
</para>
<para
>I file XML (uno per ogni testo) possono essere spostati solo da una cartella all'altra, ma è molto probabile che servano i privilegi di amministratore.</para>
</sect2>


<sect2 id="add_texts">
<title
>Aggiunta di testi</title>
<para>
<screenshot>
<screeninfo
>Procedura guidata per importazione testi</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="import_text_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
The add texts wizard provides a simple way to add new training texts to Simon. </para>

<para
>When importing text files, Simon will automatically try to recognize individual sentences and split the text into appropriate <quote
>pages</quote
> (recordings). The algorithm treats text between <quote
>normal</quote
> punctuation (<quote
>.</quote
>, <quote
>!</quote
>, <quote
>?</quote
>, <quote
>...</quote
>, <quote
>"</quote
>,...) and line breaks as <quote
>sentences</quote
>. Each <quote
>sentence</quote
> will be on its own page.</para>

<para
>Simon supports two different sources for new training texts. </para>

<sect3>
  <title
>Aggiungere testi di formazione</title>
            <para>
      <screenshot>
      <screeninfo
>Procedura guidata per importazione testi: aggiungere testi di formazione</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="import_text_4.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
Basta inserire il testo di formazione in un campo di input.</para>
</sect3>
<sect3>
  <title
>File di testo locali</title>

    <para>
      <screenshot>
      <screeninfo
>Procedura guidata per importazione testi: file di testo locali</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="import_text_3.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
Simon can import normal text files to use them as training texts.</para>
</sect3>

</sect2>

<sect2 id="special_training">
<title
>Formazione «al volo»</title>
<para
>In addition to training texts, Simon also allows to train individual words or word combinations from your dictionary on-the-fly.</para>

<para
>This feature is located in the vocabulary menu of Simon.</para>

<para>
<screenshot>
<screeninfo
>Formazione speciale: selezione delle parole</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="special_training.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Seleziona le parole per la formazione dal vocabolario a sinistra e semplicemente trascinale nell'elenco della selezione a destra (potresti anche selezionarli nella tabella a sinistra e aggiungerli facendo clic su <guibutton
>Aggiungi alla formazione</guibutton
>) .</para>

<para
>Avvia la formazione selezionando <guibutton
>formazione parole selezionate</guibutton
>. La formazione stessa è esattamente identica come se fosse un testo di esercitazione pre-composto.</para>

<para>
<screenshot>
<screeninfo
>Formazione speciale: formazione delle parole</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="special_training_2.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>If there are more than 9 words to train Simon will automatically split the text evenly across multiple pages.</para>

<para
>Of course you are free to add words from the shadow lexicon to the list of words to train but Simon will prompt you to add the words before the training starts just like he would if you would train a text that contains unknown words (see above).</para>
</sect2>

</sect1>

<sect1 id="context">
<title
>Context</title>
<para
>&kmyapplication; includes a context layer that allows you to let Simon automatically adjust its configuration depending on its context.</para>

<para
>For example, you could set up &kmyapplication; to only allow commands like "New tab" if Mozilla Firefox is running and the currently active window.</para>

<para
>There are three major areas that contextual information can influence: <itemizedlist>
<listitem
><para
>Scenario selection</para
></listitem>
<listitem
><para
>Sample groups</para
></listitem>
<listitem
><para
>Active microphones</para
></listitem>
</itemizedlist>
</para>

<sect2 id="context_scenarios">
<title
>Scenario selection</title>
<para
>Scenarios can specify to only be active during certain contextual situations. If these situations are not met, &kmyapplication; will temporarily deactivate the affected scenario.</para>

<para>
<screenshot>
<screeninfo
>Scenario context</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="context.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>The local context conditions of this scenario are shown in the list of <guilabel
>Activation Requirements</guilabel
> and can be added, edited and deleted through the respective buttons.</para>
<para
>The context conditions respect a possible <link linkend="scenario_hierarchies"
>hierarchy of scenarios</link
>: The activation requirements of all direct or indirect parent scenarios also apply to the child scenario(s). This condition "inheritance" is shown on the right side.</para>

<para
>The &kmyapplication; main window also shows a list of currently used scenarios. Scenarios that are deactivated because of their activation requirements (context conditions) are listed in light gray and italic. The screenshot below, for example, shows a temporarily deactivated Amarok scenario.</para>

<para>
<screenshot>
<screeninfo
>Identifying deactivated scenarios</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="context_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>The same visual hints (gray, italic font for unmet activation criteria) also apply to the individual context conditions in the context menu.</para>
</sect2>

<sect2 id="sample_group">
<title
>Sample groups</title>
<para
>Every sample recorded with Simon is assigned a sample group. Sample groups can be configured to only be used for the building of the acoustic models if certain contextual conditions are met. If this is not the case, all samples tagged with the deactivated sample group will be temporarily removed from the training corpus.</para>

<para
>For more information, an example use-case and instructions on how to work with sample groups, please refer to the section on <link linkend="configuration_sound_context"
>sample groups</link
>.</para>
</sect2>

<sect2 id="context_conditions">
<title
>Context conditions</title>

<para
>In Simon, context is monitored through a set of context condition plugins.</para>
<para
>In general, context conditions are combined through an "and" association. For example, if the activation of resource is bound by two conditions A and B, it will only be activated if both A and B see their conditions met. To instead model alternatives ("A or B or both"), use an <link linkend="or_condition_association"
>Or Condition Association</link
>.</para>

<para
>All conditions can optionally be inverted. Inverting a condition means that it will evaluate to true if it would otherwise evaluate to false and vice versa.</para>

<sect3 id="active_window_condition">
<title
>Active window</title>
<para
>True, if the title of the currently active foreground window matches the provided window title.</para>

<para>
<screenshot>
<screeninfo
>Active window condition</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="active_window_condition.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect3>

<sect3 id="dbus_condition">
<title
>D-Bus</title>
<para
>The D-Bus condition plugin allows to monitor 3rd party applications that export state information on D-Bus.</para>

<para
>The monitored application needs to provide two methods: One signal to notify of changes and another method that returns the current state.</para>

<para>
<screenshot>
<screeninfo
>D-Bus condition</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="dbus_condition1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>The screenshot above, for example, configures a D-Bus condition that will evaluate to true while the music player "Tomahawk" is playing and to false otherwise.</para>
</sect3>

<sect3 id="face_detection_condition">
<title
>Face detection</title>

<para
>The face detection condition will evaluate to true, if &kmyapplication;'s vision layer has identified a person sitting in front of the <link linkend="webcam_configuration"
>configured webcam</link
>.</para>

<para>
<screenshot>
<screeninfo
>Face detection condition</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="face_detection_condition.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect3>

<sect3 id="file_content_condition">
<title
>File content</title>
<para
>This condition plugin will return true, if the given file contains the provided content.</para>

<para
>The file will be monitored for changes.</para>

<para>
<screenshot>
<screeninfo
>File content condition</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="file_content_condition.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect3>

<sect3 id="lip_detection_condition">
<title
>Lip detection</title>

<para
>The lip detection condition will evaluate to true, if &kmyapplication;'s vision layer has identified a person sitting in front of the <link linkend="webcam_configuration"
>configured webcam</link
> and is speaking something (lip movements). </para>

<para>
<screenshot>
<screeninfo
>Lip detection condition</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="lip_detection_condition.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
<para
>The lip detection training will try to determine the optimal value of sensitivity of the detection by monitoring your lip movements. For better accuracy of lip detection condition, stop training when the sensitivity value on the slider during training becomes almost constant. </para>
</sect3>

<sect3 id="or_condition_association">
<title
>Or condition association</title>
<para
>The or condition association allows you to configure a meta-condition that reports to be satisfied as soon as one or more of its child conditions evaluates to true.</para>

<para
>Or condition associations can have an arbitrary number of child conditions that may even also be or condition associations.</para>

<para>
<screenshot>
<screeninfo
>Or condition association</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="or_condition_association.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect3>

<sect3 id="process_opened_condition">
<title
>Process opened</title>

<para
>Is satisfied if there is a running process with the provided executable name.</para>

<para>
<screenshot>
<screeninfo
>Process opened condition</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="process_opened_condition.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect3>

</sect2>
</sect1>

<sect1 id="commands">
<title
>Comandi</title>
<para
>When Simon is active and recognizes something, the recognition result is given to the loaded command plug-ins (in order) for processing.</para>

<para>
<screenshot id="command_dialog">
<screeninfo
>Simon's Command Dialog</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_main.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>The command system can be compared with a group of factory workers. Each one of them knows how to perform one task (&eg; <quote
>Karl</quote
> knows how to start a program and <quote
>Joe</quote
> knows how to open a folder, &etc;). Whenever Simon recognizes something it is given to <quote
>Karl</quote
> who then checks if this instruction is meant for him. If he doesn't know what to do with it, it is handed over to <quote
>Joe</quote
> and so on. If none of the loaded plugins know how to process the input it is ignored. The order in which the recognition result is given to the individual commands (people) is configurable in the command options (<guibutton
>Commands</guibutton
> 
> <guibutton
>Manage plugins</guibutton
>).</para>


<para>
<screenshot>
<screeninfo
>Simon's Action Configuration</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_actions_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Ogni estensione può essere associata con una <quote
>attivazione</quote
>. Utilizzando le attivazioni, la responsabilità di ogni estensione può essere facilmente divisa. </para>
<para
>Usando l'astrazione operai di fabbrica dall'alto, potrebbe essere paragonata ad enunciare il nome di chi intendi possa elaborare la richiesta. Così, invece di <quote
>Apri la mia cartella home</quote
> tu dici <quote
>Joe, apri la mia cartella home</quote
> e <quote
>Joe</quote
> (l'estensione per la gestione delle cartelle) saprà immediatamente che la richiesta è diretta a lui.</para>
<para
>In pratica potresti avere comandi come il comando eseguibile <quote
>Firefox</quote
> per aprire il popolare browser e il comando <quote
>Google</quote
> per aprire il motore di ricerca web. Se assegni l'attivazione <quote
>Inizio</quote
> all'eseguibile dell'estensione e l'attivazione <quote
>Apri</quote
> al comando posto, dovresti dire <quote
>Inizio Firefox</quote
> (invece del solo <quote
>Firefox</quote
>, se non utilizzi un'attivazione per l'eseguibile dell'estensione) e <quote
>Apri Google</quote
> per aprire il motore di ricerca (invece di <quote
>Google</quote
>).</para>
<para
>Triggers are of course no requirement and you can easily use Simon without defining any plugin triggers (although many plugins come with a default trigger of <quote
>Computer</quote
> set which you would have to remove). But even if you use just one trigger for all your commands (like <quote
>Computer</quote
> to say <quote
>Computer, Firefox</quote
> and <quote
>Computer, Google</quote
> like) it has the advantage of greatly limiting the number of false-positives.</para>

<para
>Simon's <link linkend="command_dialog"
>command dialog</link
> displays the complete phrase associated with a command in the upper right corner of the command configuration.</para>

<para
>È possibile caricare più istanze di un'estensione, anche in uno scenario. Ogni istanza può naturalmente anche avere un diverse attivazioni per la stessa estensione.</para>

<para
>Ogni comando ha un nome (che attiva la sua invocazione), un'icona e piùcampi a seconda del tipo di estensione (vedi sotto). </para>

<para
>Some command plugins might provide a configuration of the plugin itself (not the commands it contains). These configuration pages will be plugged directly into the action configuration dialog (below the <guimenuitem
>General</guimenuitem
> menu item) when you load the associated plugin. </para>

<para
>Plugins that provide a graphical user interface (like for example the <link linkend="input_number"
>input number command plugin</link
>) can be configured by configuring <guilabel
>Voice commands</guilabel
>. You can, for example, change the associated word that will trigger the button, but also change the displayed icon, &etc; If you remove all voice interface commands from a graphical element, the element will be hidden automatically. </para>

<para
>I comandi dell'interfaccia vocale vengono aggiunti come normali comandi attraverso la configurazione del comando.</para>

<para>
<screenshot>
<screeninfo
>Configurare i comandi di interfaccia vocale</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="voice_interface_command_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Per aggiungere un nuovo comando di interfaccia a una funzione, è sufficiente selezionare l'azione che desideri associare a un comando, fare clic su <guibutton
>Crea azione da modello</guibutton
> e adattare il comando risultante alle tue esigenze.</para>

<para
>Some plugins (for example the <link linkend="desktopgrid"
>desktop grid</link
> or the <link linkend="calculator_command_plugin"
>calculator</link
>) might also provide a menu item in the <guimenu
>Actions</guimenu
> menu. </para>

<para>
<screenshot>
<screeninfo
>Comando inserito nella finestra principale</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_plug.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Scenarios can optionally define one command that will immediately be run when the scenario is initialized. If you require more than one command to run automatically, consider the use of a <link linkend="composite_commands"
>composite command</link
>. <screenshot>
<screeninfo
>Autorun command</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_autorun.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>


<anchor id="command_arguments"/>
<para
>Command triggers can contain placeholders in the form of "%&lt;index&gt;", referring to any one word, or "%%&lt;index&gt;" describing one or more left out words. For example the recognition result "Next window" will be matched by the triggers "Next %1", "Next %%1" and "%%1" but <emphasis
>not</emphasis
> by the triggers "%1", "Next window %1", "%%1 Next window".</para>

<sect2 id="executable_commands">
<title
>Comandi eseguibili</title>

<para
>I comandi eseguibili sono associati ad un file eseguibile (<quote
>Programma</quote
>), che viene avviato quando il comando viene richiamato.</para>

<screenshot>
<screeninfo
>Comandi eseguibili</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_program.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>Sono supportati gli argomenti per i comandi. Se il percorso del file eseguibile o dei parametri contengono spazi <emphasis
>devono</emphasis
> essere racchiusi tra virgolette.</para>

<para
>Dato il file eseguibile <filename
>C:\Program Files\Mozilla Firefox\firefox.exe</filename
>, il file locale html <filename
>C:\test file.html</filename
> la riga corretta per l'<guilabel
>eseguibile</guilabel
> dovrebbe essere: <filename
>"C:\Program Files\Mozilla Firefox\firefox.exe" "C:\test file.html"</filename
>.</para>

<para
>La cartella di lavoro definisce la posizione da dove dovrebbe essere lanciato il processo. Data la cartella di lavoro <filename
>C:\folder</filename
>, il comando <filename
>"C:\Program Files\Mozilla Firefox\firefox.exe" file.html</filename
> farà in modo che Firefox cerchi il file <filename
>C:\folder\file.html</filename
>.</para>

<para
>La cartella di lavoro in genere non deve essere impostata e può essere lasciata vuota per la maggior parte del tempo.</para>

<sect3 id="importing_executable_commands">
<title
>Importazione di programmi</title>
<para
>For even easier configuration Simon provides an import dialog which allows you to select programs directly from the KDE menu.</para>

<note
><para
>Questa opzione non è disponibile per Microsoft Windows.</para
></note>

<screenshot>
<screeninfo
>Importa programmi</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_program_import_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>La finestra di dialogo elenca tutti i programmi che hanno una voce nel menu di KDE nelle loro rispettive categorie.</para>

<para
>Le sotto categorie non sono supportate e sono quindi elencate sullo stesso livello delle categorie di livello superiore.</para>

<para
>Just select the program you wish to start with Simon and press <guibutton
>Ok</guibutton
>. The correct values for the executable and the working folder as well as an appropriate command name and description will automatically be filled out for you.</para>

</sect3>

</sect2>

<sect2 id="place_commands">
<title
>Posizione dei comandi</title>
<para
>With place commands you can allow Simon to open any given URL. Because Simon just hands the address over to the platforms URL handler, special Protocols like <quote
>remote:/</quote
> (on &Linux;/&kde;) or even &kde;'s <quote
>Web-Shortcuts</quote
> are supported.</para>
<para
>Invece delle cartelle, puoi anche impostare i file come URL dei comandi farai si che il file debba essere aperto con l'applicazione a esso associata, quando il comando viene richiamato.</para>

<screenshot>
<screeninfo
>Risorse</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_place.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>Per associare un URL specifico con un comando, puoi inserirlo manualmente nel campo URL (seleziona prima <guibutton
>manuale</guibutton
>) o importalo con la procedura guidata di importazione delle risorse.</para>


<sect3 id="importing_place_commands">
<title
>Importa risorse</title>

<para
>La finestra di dialogo di importazione risorse permette di creare facilmente l'URL corretto per il comando.</para>

<para
>Per aggiungere una cartella locale, seleziona <guibutton
>Risorsa locale</guibutton
> e poi seleziona la cartella o il file con il selettore di file. <screenshot>
<screeninfo
>Importa risorse: locale</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_place_import_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Per aggiungere un URL remoto, (HTTP, FTP, &etc;) seleziona <guibutton
>URL remoto</guibutton
>.</para>

<screenshot>
<screeninfo
>Importa risorse: remoto</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_place_import_2.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>Ricorda che per gli URL con informazioni di autenticazione, la password verrà memorizzata in chiaro.</para>

</sect3>
</sect2>

<sect2 id="shortcut_commands">
<title
>Comandi scorciatoia</title>
<para
>Utilizzando i comandi scorciatoia l'utente può associare i comandi con combinazioni di tasti.</para>

<para
>The command will simulate keyboard input to trigger shortcuts like <keycombo
>&Ctrl;<keycap
>C</keycap
></keycombo
> or <keycombo
>&Alt;<keycap
>F4</keycap
></keycombo
>.</para>
<para
>The plugin can press, release or press and release the configured key combination. <screenshot>
<screeninfo
>Definire comandi scorciatoia</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_shortcut.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Per selezionare la scorciatoia che desideri simulare devi solo spostare il pulsante di scelta rapida e premere la combinazione di tasti sulla tastiera.</para>
<para
>Simon will capture the shortcut and associate it with the command.</para>
<para
>Due to technical limitations there are several shortcuts on Microsoft Windows that cannot be captured by Simon (this includes &eg; <keycombo
>&Ctrl;&Alt;<keycap
>Del</keycap
></keycombo
> and <keycombo
>&Alt;<keycap
>F4</keycap
></keycombo
>). These special shortcuts can be selected from a list below the aforementioned shortcut button.</para>

<note
><para
>This selection box is not visible in the screenshot above as the list is only displayed in the Microsoft Windows version of Simon.</para
></note>
</sect2>

<sect2 id="text_macro_commands">
<title
>Comandi macro testuali</title>
<para
>Usando comandi macro testuali, puoi associare un testo a un comando. Quando il comando viene richiamato, il testo associato sarà <quote
>scritto</quote
> simulando sequenze di tasti.</para>

<para>
<screenshot>
<screeninfo
>Definire comandi macro testuali</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_text-macro.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect2>

<sect2 id="list_command">
<title
>Elenco dei comandi</title>
<para
>L'elenco dei comandi è progettato per combinare più comandi (tutti i tipi di comandi sono supportati) in un unico elenco. L'utente può quindi selezionare l'n-esima voce dicendo il numero associato (1-9).</para>

<para
>Ciò è molto utile per limitare la quantità di formazione richiesta e fornisce la possibilità di mantenere il vocabolario al minimo.</para>

<para>
<screenshot>
<screeninfo
>Definire elenco dei comandi</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_list_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>L'elenco dei comandi è particolarmente utile quando utilizzi i comandi con attivazioni difficili o comandi che possono essere raggruppati in un tema generale. Un esempio tipico potrebbe essere un comando <quote
>Startmenu</quote
> per presentare un elenco di programmi da lanciare. In questo modo i comandi eseguibili specifici possono conservare ancora nomi molto descrittivi (come <quote
> OpenOffice.org Writer 3.1</quote
>) senza che l'utente debba includere queste parole nel suo vocabolario e di tenerne conto nella grammatica solo per il loro innesco.</para>

<para
>Comandi di tipo diverso possono naturalmente essere miscelati.</para>

<sect3 id="list_command_display">
<title
>Visualizza elenco comandi</title>

<para
>Quando viene richiamato, il comando visualizza l'elenco al centro dello schermo. L'elenco si espande automaticamente per accompagnare i propri elementi.</para>
<screenshot>
<screeninfo
>Definire elenco dei comandi</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_list_2.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
<para
>Puoi richiamare i comandi contenuti nell'elenco semplicemente dicendo il numero associato (in questo esempio: <quote
> Uno </quote
> per avviare Mozilla Firefox). </para>

<para
>Mentre un elenco di comandi è attivo (visualizzato), tutti gli input che non sono diretti all'elenco stesso (altri comandi, &etc;) saranno respinti. Il processo può essere annullato premendo il pulsante <guibutton
>Annulla</guibutton
> o pronunciando <quote
>Annulla</quote
>.</para>

<para
>If there are more than 9 items Simon will add <quote
>Next</quote
> and <quote
>Back</quote
> options to the list (<quote
>Zero</quote
> will be associated with <quote
>Back</quote
> and <quote
>Nine</quote
> with <quote
>Next</quote
>). <screenshot>
<screeninfo
>Elenco dei comandi con molte voci</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_list_3.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect3>

<sect3 id="list_command_configure">
<title
>Configurazione dell'elenco degli elementi</title>

<para
>Per impostazione predefinita, l'elenco di comandi usa le parole seguenti come attivazione. Per utilizzare l'elenco di comandi al loro pieno potenziale, fai in modo che la tua lingua ed il modello acustico contengano e permettano le seguenti <quote
>frasi</quote
>: <itemizedlist>
<listitem
><para
><quote
>Zero</quote
></para
></listitem>
<listitem
><para
><quote
>Uno</quote
></para
></listitem>
<listitem
><para
><quote
>Due</quote
></para
></listitem>
<listitem
><para
><quote
>Tre</quote
></para
></listitem>
<listitem
><para
><quote
>Quattro</quote
></para
></listitem>
<listitem
><para
><quote
>Cinque</quote
></para
></listitem>
<listitem
><para
><quote
>Sei</quote
></para
></listitem>
<listitem
><para
><quote
>Sette</quote
></para
></listitem>
<listitem
><para
><quote
>Otto</quote
></para
></listitem>
<listitem
><para
><quote
>Nove</quote
></para
></listitem>
<listitem
><para
><quote
>Annulla</quote
></para
></listitem>
</itemizedlist>
</para>

<para
>Of course you can also configure these words in your Simon configuration: <itemizedlist>
    <listitem>
      <para
><guimenuitem
> Comandi </guimenuitem
> 
> <guibutton
> Gestione estensioni </guibutton
> 
> <guimenuitem
> Generale </guimenuitem
> 
> <guimenuitem
> Elenchi </guimenuitem
> per una ampia configurazione dello scenario degli elenchi.</para>
    </listitem>
    <listitem>
      <para
><guimenu
>Settings</guimenu
> 
> <guimenuitem
>Configure Simon...</guimenuitem
> 
> <guimenuitem
>Actions</guimenuitem
> 
> <guimenuitem
>Lists</guimenuitem
> for the global configuration. When creating a new scenario, the scenario configuration will be initialized with a copy of this list configuration.</para>
    </listitem>
  </itemizedlist>
</para>

<para
>List commands are internally also used by other plugins like for example the <link linkend="desktopgrid"
>desktop grid</link
>. The configuration of the triggers also affects their displayed lists. </para>

</sect3>

</sect2>

<sect2 id="composite_commands">
<title
>Comandi composti</title>
<para
>I comandi composti ti consentono di raggruppare più comandi in una sequenza.</para>

<para
>Quando richiamati, i comandi saranno eseguiti nell'ordine. Puoi inserire anche ritardi tra i comandi.</para>

<para
>Composite commands can also work as "transparent wrappers" by selecting <guibutton
>Pass recognition result through to other commands</guibutton
>. In that case, the recognition result will be treated as "unprocessed" even if the composite command was executed.</para>
<para
>For example, suppose you have a command to turn on the light in one scenario. Additionally to turning on the light, you now want to add some kind of reporting to the activity by invoking a script through a <link linkend="executable_commands"
>program plugin</link
>. You could then set up a reporting scenario that contains a transparent composite command with the same trigger as the command to turn on the light and make sure that this scenario is set before the original one in the scenario list. You can then activate and deactivate the reporting simply by loading and unloading this scenario.</para>

<para>
<screenshot>
<screeninfo
>Definire comandi composti</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_composite_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Utilizzando comandi composti puoi comporre macro <quote
>complesse</quote
>. La schermata qui sopra - per esempio - esegue le seguenti operazioni: <itemizedlist>
<listitem
><para
>Avvia Kopete (comando eseguibile)</para
></listitem>
<listitem
><para
>Aspetta 2000ms per avviare Kopete</para
></listitem>
<listitem
><para
>Scrive <quote
>Mathias</quote
> (Comando macro testuale) che selezionerà Mathias nell'elenco dei contatti</para
></listitem>
<listitem
><para
>Preme Invio (Comando scorciatoia)</para
></listitem>
<listitem
><para
>Aspetta 1000ms per far apparire la finestra di chat</para
></listitem>
<listitem
><para
>Scrivi <quote
>Ciao</quote
> (Comando macro testuale): il testo associato a questo comando contiene un carattere «nuova riga» alla fine in modo che il messaggio verrà inviato.</para
></listitem>
<listitem
><para
>Preme <keycombo
>&Alt;<keycap
>F4</keycap
></keycombo
> (Comando scorciatoia) per chiudere la finestra di chat</para
></listitem>
<listitem
><para
>Preme <keycombo
>&Alt;<keycap
>F4</keycap
></keycombo
> (Comando scorciatoia) per chiudere la finestra di kopete</para
></listitem>
</itemizedlist>
</para>

</sect2>

<sect2 id="desktopgrid">
<title
>Desktop grid</title>
<para
>The desktop grid allows the user to control his mouse with his voice.</para>

<para>
<screenshot>
<screeninfo
>Il desktop a griglia</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_desktopgrid.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
The desktop grid divides the screen into nine parts which are numbered from 1-9. Saying one of these numbers will again divide the selected field into 9 fields again numbered from 1-9, &etc; This is repeated 3 times. After the fourth time the desktop grid will be closed and Simon will click in the middle of the selected area.</para>

<para
>The exact click action is configurable but defaults to asking the user. Therefore you will be presented with a list of possible click modes. When selecting Drag and Drop, the desktop grid will be displayed again to select the drop point.</para>

<para>
<screenshot>
<screeninfo
>Desktop a griglia: clic della selezione</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="desktop_grid_click_selection.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>While the desktop grid is active (displayed), all input that is not directed at the desktop grid itself (other commands, &etc;) will be rejected. Say <quote
>Cancel</quote
> at any time to abort the process. </para>

<para
>The desktop grid plugin registers a configuration screen right in the command configuration when it is loaded.</para>

<para>
<screenshot>
<screeninfo
>Configura il desktop a griglia</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="desktopgrid_configure.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
The trigger that invokes the desktop grid is of course completely configurable. Moreover the user can use <quote
>real</quote
> or <quote
>fake</quote
> transparency. If your graphical environment allows for compositing effects (<quote
>desktop effects</quote
>) then you can safely use <quote
>real</quote
> transparency which will make the desktop grid transparent. If your platform does not support compositing Simon will simulate transparency by taking a screenshot of the screen before displaying the desktop grid and display that picture behind the desktop grid. </para>

<para
>If the desktop grid is configured to use real transparency and the system does not support compositing it will display a solid gray background.</para>

<para
>Tuttavia, quasi tutti i sistemi aggiornati supporteranno il composito (trasparenza reale). </para>
<para
>Questo comprende: <itemizedlist>
<listitem
><para
>Microsoft Windows 2000 o superiore (XP, Vista, 7)</para
></listitem>
<listitem
><para
>GNU/Linux tramite un gestore di composito come Compiz, KWin4, xcompmgr, &etc;</para
></listitem>
</itemizedlist>
</para>


<para
>By default the desktop grid uses numbers to select the individual fields. To use the desktop grid, make sure that your language and acoustic model contains and allows for the following <quote
>sentences</quote
>: <itemizedlist>
<listitem
><para
><quote
>Uno</quote
></para
></listitem>
<listitem
><para
><quote
>Due</quote
></para
></listitem>
<listitem
><para
><quote
>Tre</quote
></para
></listitem>
<listitem
><para
><quote
>Quattro</quote
></para
></listitem>
<listitem
><para
><quote
>Cinque</quote
></para
></listitem>
<listitem
><para
><quote
>Sei</quote
></para
></listitem>
<listitem
><para
><quote
>Sette</quote
></para
></listitem>
<listitem
><para
><quote
>Otto</quote
></para
></listitem>
<listitem
><para
><quote
>Nove</quote
></para
></listitem>
<listitem
><para
><quote
>Annulla</quote
></para
></listitem>
</itemizedlist>
</para>

<para
>Per configurare queste attivazioni, basta configurare i comandi associati all'estensione.</para>

<para>
<screenshot>
<screeninfo
>Desktop a griglia: configurazione dell'elenco degli elementi</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="desktop_grid_configure_list_elements.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

</sect2>

<sect2 id="input_number">
<title
>Numero in ingresso</title>
<para
>Utilizzando l'estensione «input-number» puoi immettere numeri di grandi dimensioni facilmente.</para>


<para
>Utilizzando le estensioni per la dettatura o per le macro testuali potrai associare i numeri con le loro cifre e usarli come metodo di input. Tuttavia, per input di grandi numeri esistono due modi, entrambi hanno svantaggi significativi: <itemizedlist>
<listitem
><para
><emphasis
>Aggiungendo le parole <quote
>undici</quote
>, <quote
>dodici</quote
>, &etc;</emphasis
></para>
<para
>Anche se questo sembra la soluzione più elegante, dato che ti consentirebbe dire <quote
>cinquecentosettantadue</quote
> puoi facilmente intuire che sarebbe un bel problema aggiungere tutte queste parole - per non parlare della loro formazione. Che dire di<quote
>duemilanovecentodue</quote
>? Dove fermarsi?</para
></listitem>
<listitem
><para
><emphasis
>Definire il numero utilizzando le singole cifre</emphasis
></para>
<para
>Anche se questo modo non è elegante, come indicare il numero completo, è molto più pratico.</para>
<para
>Tuttavia, molte applicazioni (come il grande addon per la navigazione senza mouse di firefox) si basano sull'utente per inserire i numeri di grandi dimensioni senza passare troppo tempo tra le singole battute (la navigazione senza mouse, ad esempio si aspetta esattamente 500 ms di default prima di considerare l'ingresso del numero completo). Quindi, se vuoi inserire 52 dovresti prima dire <quote
>cinque (pausa) due</quote
>. A causa della pausa necessaria, l'applicazione (come l'estensione per la navigazione senza mouse) potrebbe prendere in considerazione l'ingresso di <quote
>cinque</quote
> come completo.</para
></listitem>
</itemizedlist>
</para>

<para
>L'estensione numero in ingresso - se attivato - presenta una interfaccia come una calcolatrice per l'inserimento di un numero. L'ingresso può essere corretto dicendo <quote
>Indietro</quote
>. Dispone di un punto decimale accessibile dicendo <quote
>Virgola (Comma)</quote
>. Dicendo <quote
>Ok</quote
> il numero verrà digitato. Come tutti, la voce di ingresso e la correzione vengono gestite dall'estensione stessa per l'applicazione che riceve alla fine l'input, ottenendo solo un paio di millisecondi tra le singole cifre. <screenshot>
<screeninfo
>Estensione del numero in ingresso</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_input_number.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Mentre l'estensione del numero in ingresso è attivo (l'utente realmente inserisce un numero), tutti gli input che non sono diretti all'estensione del numero in ingresso (altri comandi, &etc;) saranno respinti. Pronuncia <quote
>Annulla</quote
>, in qualsiasi momento per interrompere il processo. </para>

<para
>Dato che questa estensione non può creare istanze del comando, non viene elencata nella finestra di dialogo <guilabel
>Nuovo comando</guilabel
>. Tuttavia, l'estensione del numero in ingresso registra una configurazione propria nel comando di configurazione quando viene caricata.</para>

<screenshot>
<screeninfo
>Estensione del numero in ingresso</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="input_number_configure.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>L'attivazione definisce quale parola o frase che attivi la visualizzazione dell'interfaccia. </para>


<para
>Per impostazione predefinita, l'estensione del numero in ingresso utilizza i numeri per selezionare la singola cifra ed un paio di parole di controllo. Per utilizzare l'estensione del numero in ingresso, assicurati che la lingua ed il modello acustico contenga e permetta le seguenti <quote
>frasi</quote
>: <itemizedlist>
<listitem
><para
><quote
>Zero</quote
></para
></listitem>
<listitem
><para
><quote
>Uno</quote
></para
></listitem>
<listitem
><para
><quote
>Due</quote
></para
></listitem>
<listitem
><para
><quote
>Tre</quote
></para
></listitem>
<listitem
><para
><quote
>Quattro</quote
></para
></listitem>
<listitem
><para
><quote
>Cinque</quote
></para
></listitem>
<listitem
><para
><quote
>Sei</quote
></para
></listitem>
<listitem
><para
><quote
>Sette</quote
></para
></listitem>
<listitem
><para
><quote
>Otto</quote
></para
></listitem>
<listitem
><para
><quote
>Nove</quote
></para
></listitem>
<listitem
><para
><quote
>Indietro</quote
></para
></listitem>
<listitem
><para
><quote
>Virgola</quote
></para
></listitem>
<listitem
><para
><quote
>Ok</quote
></para
></listitem>
<listitem
><para
><quote
>Annulla</quote
></para
></listitem>
</itemizedlist>
</para>

<para
>Per configurare queste attivazioni, basta configurare i comandi associati all'estensione.</para>

<para>
<screenshot>
<screeninfo
>Estensione del numero in ingresso</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_number_input_elements.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

</sect2>

<sect2 id="dictation_command_plugin">
<title
>Dettatura</title>
<para
>L'estensione dettatura scrive il risultato del riconoscimento che ottiene utilizzando i tasti simulati.</para>

<para
>Assumendo che non hai definito un'attivazione per l'estensione dettatura, accetterà tutti i risultati del riconoscimento e li scriverà semplicemente. La trascrizione sarà considerata come <quote
>input trattato</quote
> e quindi non sarà inoltrata ad altre estensioni. Questo significa che se è caricata l'estensione dettatura e non hai definito alcuna attivazione, tutte le estensioni <emphasis
>al di sotto</emphasis
> nell'elenco <guilabel
>Estensioni selezionate</guilabel
> nella configurazione dei comandi non riceveranno mai alcun input.</para>

<para
>Dato che questa estensione non può creare istanze del comando, non viene elencata nella finestra di dialogo <guilabel
>Nuovo comando</guilabel
>.</para>

<para
>L'estensione dettatura può essere configurata per aggiungere testi dopo i risultati del riconoscimento, per aggiungere ad esempio uno spazio dopo ogni parola riconosciuta.</para>

<para>
<screenshot>
<screeninfo
>Configura dettatura</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_dictation.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect2>

<sect2 id="ai_command_plugin">
<title
>Intelligenza artificiale</title>
<para
>L'estensione Intelligenza artificiale, è una estensione «per puro divertimento» che simula una conversazione umana.</para>

<para
>Using the <link linkend="text-to-speech_config"
>text to speech system</link
>, the computer can <quote
>talk</quote
> with the user.</para>

<para
>L'estensione utilizza AIMLs per l'intelligenza <quote
>reale</quote
>. La maggior parte dei set di AIML dovrebbe essere supportata. Con l'estensione vengono forniti il <ulink url="http://www.pandorabots.com/pandora/talk?botid=f5d922d97e345aa1"
>popolare bot ALICE</ulink
> e una versione tedesca funzionante.</para>

<screenshot>
<screeninfo
>Estensione IA</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="ai_configure.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>L'estensione registra una schermata di configurazione nel menu di configurazione dei comandidove è possibile scegliere quali AIML impostare per il caricamento. </para>

<para
>Simon will look for AIML sets in the following folder: <itemizedlist
> <listitem
><para
>GNU/Linux: <filename
>`kde4-config --prefix`/share/apps/ai/aimls/</filename
></para
></listitem
> <listitem
><para
>Microsoft Windows: <filename
>[installation folder (C:\Program Files\simon 0.2\ by default)]\share\apps\ai\aimls\</filename
></para
></listitem
> </itemizedlist
> To add a new set just create a new folder with a descriptive name and copy the .aiml files into it. </para>

<para
>Per modificare la personalità dei bot dai un'occhiata ai file bot.xml e vars.xml nella seguente cartella: <itemizedlist>
<listitem
><para
>GNU/Linux: <filename
>`kde4-config --prefix`/share/apps/ai/util/</filename
></para
></listitem>
<listitem
><para
>Microsoft Windows: <filename
>[cartella d'installazione predefinita (C:\Program Files\simon 0.2\)]\share\apps\ai\util\</filename
></para
></listitem>
</itemizedlist>
</para>

<para
>Dato che questa estensione non può creare istanze del comando, non viene elencata nella finestra di dialogo <guilabel
>Nuovo comando</guilabel
>.</para>

<para
>It is recommended to not use any trigger for this plugin to provide a more natural <quote
>feel</quote
> for the conversation.</para>
</sect2>

<sect2 id="calculator_command_plugin">
<title
>Calcolatrice</title>
<para
>L'estensione calcolatrice è una semplice calcolatrice a controllo vocale.</para>

<para>
<screenshot>
<screeninfo
>Estensione calcolatrice</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="calculator.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>La calcolatrice estende l'estensione del <link linkend="input_number"
>numero in ingresso</link
> aggiungendo altre funzionalità.</para>

<para
>Quando carichi l'estensione, viene aggiunta una schermata di configurazione alla configurazione dell'estensione.</para>

<para>
<screenshot>
<screeninfo
>Estensione calcolatrice: configurazione</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="calculator_configuration.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Puoi anche configurare la modalità di controllo della calcolatrice. Cambiando l'impostazione della modalità a qualcosa di diverso da <guimenuitem
>calcolatrice completa</guimenuitem
> nasconderà le opzioni dall'oggetto visualizzato.</para>

<para>
<screenshot>
<screeninfo
>Estensione calcolatrice: minimale</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="calculator_minimal.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Tuttavia, i controlli nascosti, in contrasto con la semplice rimozione di tutti i comandi associati alle funzioni, reagirà ancora ai comandi vocali configurati.</para>

<para
>Selezionando <guibutton
>Ok</guibutton
>, la calcolatrice predefinita chiederà cosa fare del risultato generato. È possibile, ad esempio visualizzare il calcolo, il risultato, entrambi, &etc; Inoltre sempre selezionando dall'elenco visualizzato, dopo aver selezionato il pulsante <guibutton
>Ok</guibutton
>, questo può anche essere impostato nelle opzioni di configurazione.</para>

<para>
<screenshot>
<screeninfo
>Estensione calcolatrice: modalità di selezione uscita</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="calculator_output_mode_selection.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

</sect2>

<sect2 id="filter_command_plugin">
  <title
>Filtro</title>
  <para
>Utilizzando l'estensione filtro, puoi intercettare i risultati del riconoscimento prima di essere trasmessi ad una estensione come ulteriore comando. Con questa estensione puoi ad esempiodisattivare il riconoscimento della voce.</para>
  <para
>L'estensione filtro dei comandi registra una schermata di configurazione nella configurazione del comando in cui è possibile cambiare come i risultati devono essere filtrati. </para>

  <para>
  <screenshot>
  <screeninfo
>Estensione filtro: configurazione</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="filter_configuration.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Il modello è un'espressione regolare che verrà valutata di volta in volta che i risultati del riconoscimento ricevono l'estensione per l'elaborazione.</para>

  <para
>L'estensione registra anche i comandi per l'interfaccia vocale per attivare e disattivare il filtro.</para>

  <para
>In total, the filter therefore has three states: <itemizedlist>
      <listitem>
        <para
>Inattivo</para>
        <para
>Lo stato predefinito. Tutti i risultati del riconoscimento li attraverseranno.</para>
      </listitem>
      <listitem>
        <para
>Half-active (if <guibutton
>Two stage activation</guibutton
> is selected)</para>
        <para
><itemizedlist>
	<listitem
><para
>If the next command is the "Deactivate filter" command, the filter will enter the "Inactive" state.</para
></listitem>
	<listitem
><para
>If, however, the next result is something else and <guibutton
>Relay results in stage one of two stage activation</guibutton
> is selected, this result will be passed on to other plugins. The filter will reset to "Active" afterwards.</para
></listitem>
	</itemizedlist
></para>
      </listitem>
      <listitem>
        <para
>Attivo</para>
        <para
>When activated, the filter will <quote
>eat</quote
> all results that match the configured pattern. By default this means every result that Simon recognizes will be accepted by the filter and therefore not relayed to any of the plugins following the filter plugin.</para>
	<para
>If <guibutton
>Two stage activation</guibutton
> is enabled and the filter plugin receives the command to directly enter the "Inactive" state, this command is ignored. In other ways: If two stage activation is enabled, the filter can only be disabled by going through the intermediate stage.</para>
      </listitem>
    </itemizedlist>
  </para>
</sect2>

<sect2 id="pronunciation_training_command_plugin">
  <title
>Addestramento alla pronuncia</title>

  <para
>L'addestramento alla pronuncia, se combinato con un buon <link linkend="base_model"
>modello statico di base</link
>, può diventare uno strumento molto potente per migliorare la pronuncia di una nuova lingua.</para>

  <para>
  <screenshot>
  <screeninfo
>Addestramento alla pronuncia</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="pronunciation_training.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Essentially, the plugin will prompt you to say specific words. The recognition will then recognize your pronunciation of the word and compare it to your speech model which should be a base model of native speakers for this to work correctly. Then Simon will display the recognition rate (how similar your version was to the stored base model).</para>

  <para
>Più è vicino alla madrelingua, più alto è il punteggio.</para>

  <para
>L'estensione aggiunge una voce al menu <guimenu
>Comandi</guimenu
> per avviare la finestra di dialogo di formazione della pronuncia.</para>

  <para
>The training itself consists of multiple pages. Each page contains one word fetched from your active vocabulary. They are identified by a category which needs to be selected in the command configuration before starting the training.</para>

  <para>
  <screenshot>
  <screeninfo
>Addestramento alla pronuncia: configurazione</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="pronunciation_training_configuration.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>
</sect2>

<sect2 id="keyboard_command_plugin">
  <title
>Tastiera</title>

  <para
>L'estensione visualizza una tastiera virtuale, una tastiera a comando vocale.</para>

  <para>
  <screenshot>
  <screeninfo
>Tastiera</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="keyboard_1.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>La tastiera è composta da più schede, ognuna delle quali possono contenere molti tasti. L'insieme delle schede e dei tasti vengono raccolti <quote
>in set</quote
>.</para>

  <para
>È possibile selezionare i set nella configurazione, ma anche crearne di nuovi partendo da zero nella configurazione comando da tastiera.</para>

  <para>
  <screenshot>
  <screeninfo
>Tastiera: configurazione</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="keyboard_2.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>I tasti sono di solito associati a singoli caratteri, ma possono anche contenere testi lunghi e anche scorciatoie. Per questo, i set della tastiera possono contenere tasti speciali come un tasto <quote
>seleziona tutto</quote
> o un tasto <quote
>password</quote
> (digitare la password).</para>

  <para
>Accanto alle schede che contengono i tasti del tuo set, la tastiera può anche mostrare tasti speciali come &Ctrl;, &Shift;, &etc; Questi tasti sono forniti come i comandi vocali dell'interfaccia e vengono visualizzati indipendentemente dalla scheda del set che è attualmente attivo.</para>
  <para
>Come per tutte le attivazioni vocali, rimuovendo il comando associato, nasconderai anche i pulsanti.</para>

  <para
>Inoltre, la tastiera dispone di un tastierino numerico che può essere visibile selezionando l'apposita opzione nella configurazione della tastiera.</para>

  <para>
  <screenshot>
  <screeninfo
>Tastiera: il tastierino numerico</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="keyboard_3.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Accanto ai tasti numerici e al tasto di cancellazione per il campo di immissione del numero (<guibutton
>Numero indietro</guibutton
>), il tastierino numerico fornisce due opzioni su cosa fare del numero inserito.</para>
  <para
>Selezionando <guibutton
>Scrivi numero</guibutton
>, il numero immesso verrà scritto utilizzando i tasti premuti simulati. Selezionando <guibutton
>Selezionare il numero</guibutton
> cerca di trovare un tasto o una scheda attualmente attiva nel set che ha questo numero come attivazione. In questo modo è possibile controllare un tastiera completa usando solo i numeri.</para>

  <para>
  <screenshot>
  <screeninfo
>Tastiera: basata su numeri</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="keyboard_4.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>I tasti del tastierino numerico sono comandi di interfaccia vocale configurabili.</para>
</sect2>

<sect2 id="dialog_command_plugin">
  <title
>Dialog</title>
  
  <para
>The dialog plugin enables users to engage in a scripted dialog with &kmyapplication;.</para>

  <sect3 id="dialog_design">
  <title
>Dialog design</title>

  <para
>&kmyapplication; treats dialogs as a succession of different states. Each state can have a text and several associated options.</para>

  <para>
  <screenshot>
  <screeninfo
>Dialog design</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="dialog_design.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>


  <para
>Dialogs can have more than one text variants - one of which will be randomly picked when the dialog is displayed. This can help to make dialogs feel more natural by providing several, alternative formulations.</para>

  <para
>The texts can use <link linkend="dialog_bound_values"
>bound values</link
> and <link linkend="dialog_template_options"
>template options</link
>.</para>

  <para>
  <screenshot>
  <screeninfo
>Dialog design: Options</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="dialog_design_options.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Dialog options capsule the logic of the conversation. They are the active components of the dialog.</para>

  <para>
  <screenshot>
  <screeninfo
>Dialog design: Adding an option</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="dialog_design_options_new.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Similar to commands, dialog options have a name (trigger) that, when recognized while the dialog is active and in the option's parent state, will cause this option to activate. Alternatively, options can also be configured to trigger automatically after a set time period. This time is relative to when the state is entered.</para>

  <para
>Dialog options, when shown through the <link linkend="dialog_output"
>graphical output module</link
> can show an arbitrary text (that will most likely be equivalent to the trigger but doesn't have to be) and, optionally, an icon. If the text-to-speech output module is used, the text (not the trigger) will be read aloud unless this is disabled by selecting the <guibutton
>Silent</guibutton
> option.</para>

  <para
>Every state can also optionally have an avatar that will be displayed when using the <link linkend="dialog_output"
>graphical output module</link
>.</para>

  <para>
  <screenshot>
  <screeninfo
>Dialog design: Avatar</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="dialog_design_avatar.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  </sect3>

  <sect3 id="dialog_bound_values">
  <title
>Dialog: Bound values</title>
  <para
>The text of dialog states can contain variables - so called "bound values" - that will be filled in during runtime.</para>

  <para
>For example, the dialog text "This is a $variable$" would replace "$variable$" with the result of a bound value called "variable".</para>

  <para>
  <screenshot>
  <screeninfo
>Bound values</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="dialog_bound_values.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>There are four types of bound values: <itemizedlist>
  <listitem>
    <para
>Static</para>
    <para>
    <screenshot>
    <screeninfo
>Bound values: Static</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="dialog_bound_value_add_static.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
    </para>
    <para
>Static bound values will always be resolved to the same text. They are useful to provide configuration options to be filled in to personalize the dialog (&eg;, the name of the user).</para>
  </listitem>
  <listitem>
    <para
>QtScript</para>
    <para>
    <screenshot>
    <screeninfo
>Bound values: QtScript</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="dialog_bound_value_add_qtscript.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
    </para>
    <para
>QtScript bound values resolve to the result of the entered <ulink url="http://doc.qt.digia.com/qt/ecmascript.html"
>QtScript</ulink
> code.</para>
  </listitem>
  <listitem>
    <para
>Command arguments</para>
    <para>
    <screenshot>
    <screeninfo
>Bound values: Command arguments</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="dialog_bound_value_add_argument.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
    </para>
    <para
>If the dialog trigger command (the &kmyapplication; command that initiates the dialog) uses <link linkend="command_arguments"
>placeholders</link
>, they can be accessed through command argument bound values. The <guilabel
>Argument</guilabel
> number refers to the index of the placeholder you want to access.</para>
    <para
>For example, if your dialog is started with the command "Call %1", and "name" is a command argument bound value, then launching the dialog by recognizing "Call Peter", will turn the dialog text "Are you sure you want to call $name$?" into "Are you sure you want to call Peter?".</para>
  </listitem>
  <listitem>
    <para
>Plasma data engine</para>
    <para>
    <screenshot>
    <screeninfo
>Bound values: Plasma data engine</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="dialog_bound_value_add_plasma.png" format="PNG"/>
        </imageobject>
      </mediaobject>
    </screenshot>
    </para>
    <para
>This type of bound value can readily access a wide array of high-level information through plasma data engines.</para>
  </listitem>
  </itemizedlist>
  </para>
  </sect3>

  <sect3 id="dialog_template_options">
  <title
>Template options</title>
  <para
>Dialog texts can further be parametrized through template options.</para>

  <para>
  <screenshot>
  <screeninfo
>Template options</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="dialog_template_options.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>
  <para
>These boolean values choose between different or optional text snippets.</para>

  <para
>For example, the template option "formal" above, would change the dialog text "Would you please {{{formal}}be quiet{{elseformal}}shut up{{endformal}}" to "Would you please be quit" or "Would you please shut up" depending on if the template option is set to true or false. The else-path can be omitted if it is not required (&eg; "Would you {{formal}}please {{endformal}}be quiet").</para>
  </sect3>

  <sect3 id="dialog_avatars">
  <title
>Avatars</title>
  <para
>Every state can potentially show a different avatar.</para>

  <para
>These images can range from the picture of a (simulated) speaker to an image of something topically appropriate.</para>

  <para>
  <screenshot>
  <screeninfo
>Dialog: Avatars</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="dialog_avatars.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>
  <para
>To use an avatar, first add it here and later define where to use it in the <link linkend="dialog_design"
>dialog design section</link
>.</para>
  </sect3>

  <sect3 id="dialog_output">
  <title
>Output</title>
  <para
>Dialogs can be displayed graphically, use text-to-speech or combine both approaches.</para>

  <para>
  <screenshot>
  <screeninfo
>Dialog: Output</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="dialog_output.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>The <guilabel
>Separator to options</guilabel
> will be spoken between the dialog text and the current state's options (if there are any). If there are no options to this state or all are configured to be silent, this will not be said. The option to listen to the whole announcement again is triggered when saying one of the configured <guilabel
>Repeat on trigger</guilabel
>. Additionally, the text-to-speech output can optionally be configured to repeat the listing of the available options (including the configured separator) when the user says a command that does not match any of the available dialog options.</para>
  </sect3>
</sect2>

<sect2 id="akonadi_command_plugin">
  <title
>Akonadi</title>
  
  <para
>The Akonadi plugin allows &kmyapplication; to plug into KDE's PIM infrastructure.</para>

  <para>
  <screenshot>
  <screeninfo
>Akonadi command configuration</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="akonadi_command_configuration.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>The plugin fulfills two major purposes: <itemizedlist>
    <listitem>
      <para
>Execute Simon commands at scheduled times</para>
      <para
>The Akonadi plugin can monitor a specific collection (calendar) and react on entries whose summary start with a specific prefix. Per default, this prefix is "[simon-command]", meaning that events of the form "[simon-command] &lt;plugin name&gt;//&lt;command name&gt;" will trigger the appropriate &kmyapplication; command at the "start time" of the event.</para>

      <para
>The name of the plugins and commands are equivalent to the ones shown in the <link linkend="commands"
>command dialog</link
> and do not necessarily need to reference commands in the same scenario as the Akonadi plugin instance.</para>
    </listitem>
    <listitem>
      <para
>Show reminders for events in the given calendar</para>
      <para
>If configured to do so, the Akonadi plugin can show reminders for calendar events with a set alarm flag. These reminders will be shown through the &kmyapplication; <link linkend="dialog_command_plugin"
>dialog engine</link
>.</para>
   </listitem>
    </itemizedlist>
  </para>
</sect2>

<sect2 id="dbus_command_plugin">
  <title
>D-Bus</title>
  
  <para
>With the D-Bus command, Simon can call exported methods in 3rd party applications directly.</para>

  <para
>The screenshot below, for example, calls the "Pause" method of the MPRIS interface of the Tomahawk music playing software.</para>

  <para>
  <screenshot>
  <screeninfo
>D-Bus command</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="dbus_command.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>
</sect2>

<sect2 id="json_command_plugin">
  <title
>JSON</title>
  
  <para
>Similar to the <link linkend="dbus_command_plugin"
>D-Bus command plugin</link
>, the JSON plugin also allows to contact 3rd party applications to directly invoke functionality (instead of simulating user activity).</para>

  <para>
  <screenshot>
  <screeninfo
>JSON command</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="json_command.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>
</sect2>

<!--
     Not included in this version of Simon
<sect2 id="atspi_command_plugin">
  <title
>AT-SPI</title>
  
</sect2>
-->

</sect1>



</chapter>



<chapter id="faq">
<title
>Domande e risposte</title>

<para
>Nel tentativo di mantenere questa sezione sempre aggiornata, è disponibile presso il nostro <ulink url="http://www.simon-listens.org/wiki/index.php/English:_Troubleshooting"
>online wiki</ulink
>. </para>

</chapter>

<chapter id="credits">

<title
>Riconoscimenti e licenza</title>

<para
>&kmyapplication; </para>
<para
>Copyright Programma 2006-2009 Peter Grasch <email
>peter.grasch@bedahr.org</email
>, Phillip Goriup, Tschernegg Susanne, Bettina Sturmann, Martin Gigerl </para>

<para
>Copyright Documentazione &copy; 2009 Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

<para
>Innocenzo Ventre <email
>innocenzo.ventre@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installazione</title>
<para
>Consulta il <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Installation"
>wiki</ulink
> per le istruzioni sull'installazione.</para>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->
