<?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
>Handbok &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
>Stefan</firstname
> <surname
>Asserhäll</surname
> <affiliation
><address
><email
>stefan.asserhall@comhem.se</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> <othercredit role="translator"
> <firstname
>Arve</firstname
> <surname
>Eriksson</surname
><affiliation
><address
><email
>031299870@telia.com</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 
</authorgroup>

<abstract>
<para
>&kmyapplication; är ett verktyg för taligenkänning med öppen källkod. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>igenkänning</keyword>
<keyword
>tal</keyword>
<keyword
>röst</keyword>
<keyword
>kommando</keyword>
<keyword
>kontroll</keyword>
<keyword
>Scenarier</keyword>
<keyword
>akustisk</keyword>
<keyword
>handikappstöd</keyword>
</keywordset>

</bookinfo>

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

<para
>&kmyapplication; är det huvudsakliga gränssnittet för Simon, ett program för taligenkänning med öppen källkod. Det är en Simond-klient och tillhandahåller ett grafiskt användargränssnitt för att hantera talmodellen och kommandona. Dessutom kan Simon köra alla möjliga kommandon, baserat på den indata som kommer från servern: Simond. </para>

<para
>Som kontrast till befintliga kommersiella lösningar erbjuder Simon en unik gör-det-själv-metod för taligenkänning. Istället för fördefinierade, förinlärda talmodeller, levereras inte Simon med någon modell överhuvudtaget. Istället tillhandahåller det ett lättanvänt slutanvändargränssnitt för att skapa språk- och akustiska modeller från grunden. </para>

<para
>Dessutom kan slutanvändare enkelt ladda ner skapade användarfall från andra användare och dela med sig av sina egna. </para>

<para
>Den aktuella utgåvan kan användas för att skapa lösningar för styrning och kontroll som är särskilt lämpade för handikappade. Dock är inte kontinuerlig, fri diktering vare sig stödd eller realistisk med den nuvarande versionen av Simon, på grund av mängden inlärning som är nödvändig. </para>

<para
>På grund av dess arkitektur kan samma version av Simon användas med alla språk och dialekter. Man kan till och med blanda språk inom en modell om det skulle behövas. </para>
</chapter>


<chapter id="overview">
<title
>Översikt</title>

<sect1 id="architecture">
<title
>Arkitektur</title>
<para
>Den huvudsakliga igenkänningsarkitekturen i Simon består av tre program. <itemizedlist>
  <listitem
><para
>&kmyapplication;</para
><para
>Detta är det huvudsakliga grafiska gränssnittet.</para
><para
>Det fungerar som en klient för Simond-servern.</para
></listitem>
  <listitem
><para
>Simond</para
><para
>Igenkänningsservern.</para
></listitem>
  <listitem
><para
>Ksimond</para
><para
>Ett grafiskt gränssnitt för 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
>Förutom Simon, Simond och Ksimond, ingår andra mer specialiserade program också i den här integrerade distributionen av Simon. <itemizedlist>
  <listitem
><para
>Sam</para
><para
>Tillhandahåller mer djupgående kontroll över talmodeller och gör det möjligt att prova den akustiska modellen.</para
></listitem>
  <listitem
><para
>SSC och SSCd</para
><para
>Dessa två program kan användas för att enklare samla in stora mängder talsamplingar från olika personer.</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
>Se de individuella handböckerna för dessa program för detaljerad information. </para>


<para>
<screenshot>
<screeninfo
>Arkitektur</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; använder därefter igenkänningsresultatet för att utföra kommandon som att starta program, följa länkar, 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
>Nödvändiga resurser för en fungerande &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
>Talmodeller beskriver hur en röst låter, vilka ord som finns, hur de låter, och vilka ordkombinationer (<quote
>meningar</quote
> eller <quote
>strukturer</quote
>) som finns.</para>

<para
>En talmodell består egentligen av två delar: <itemizedlist>
<listitem
><para
>Språkmodell: Beskriver alla befintliga ord och vilka meningar som är grammatiskt riktiga </para
></listitem>
<listitem
><para
>Akustisk modell: Beskriver hur ord låter </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
>Scenarier</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
>Typer av basmodeller</title>

<para
>Det finns tre typer av basmodeller: <itemizedlist>
<listitem
><para
>Statiska basmodeller</para>
</listitem>
<listitem
><para
>Anpassad basmodell</para>
</listitem>
<listitem
><para
>Modell skapad av användare</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
>Statisk basmodell</title>

<para
>Statiska basmodeller använder helt enkelt en förkompilerad akustisk modell utan att ändra den.</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
>Anpassad basmodell</title>

<para
>Genom att anpassa en förkompilerad akustisk modell kan du förbättra noggrannheten genom att anpassa den till din röst.</para>

<para
>Insamlad inlärningsdata kommer att kompileras i en anpassningsmatris som sedan appliceras på den valda basmodellen.</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
>Modell skapad av användare</title>

<para
>När användarskapade modeller används, är användaren ansvarig för upplärning av den egna modellen. Ingen basmodell kommer att användas.</para>

<para
>Inlärningsdata som kommer att användas för att kompilera en egen akustisk modell låter dig skapa ett system som direkt motsvarar din egen röst.</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
>Var man hämtar basmodeller</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
>Problem med fonemuppsättningar</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
>Första körningsguiden</title>

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

<para>
  <screenshot>
    <screeninfo
>Första körning: Välkommen</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="first_run_1.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>Inställningarna består av fem enkla steg som gås igenom nedan. Du kan hoppa över varje steg, och till och med hela guiden om du vill. I så fall ställs systemet in med standardvärden.</para>

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

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

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

<para>
  <screenshot>
    <screeninfo
>Första körning: Scenarier</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
>Första körning: Hämta scenarier</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
>Basmodeller</title>

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

<para>
  <screenshot>
    <screeninfo
>Första körning: Basmodeller</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
>Första körning: 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
>Efter att ha slutfört eller avbrutit guiden för första körning kan du ändra inställningsalternativen som definieras här i <link linkend="configure_server"
>serverinställningarna</link
>.</para>

</sect2>

<sect2 id="first_run_sound_configuration">
<title
>Ljudinställning</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
>Första körning: Ljudinställning</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
>Efter att ha slutfört eller avbrutit guiden för första körning kan du ändra inställningsalternativen som definieras här i <link linkend="soundconfiguration_device"
>ljudinställningarna</link
>.</para>

</sect2>

<sect2 id="first_run_volume_calibration">
<title
>Volymkalibrering</title>

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

<para>
  <screenshot>
    <screeninfo
>Första körning: Volymkalibrering</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
>En skärmbild av &kmyapplication;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot_main.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Skärmbild</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
>Scenarier</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
>Mer information om enskilda scenarier hittar du i listalternativens verktygstips.</para>

<sect2 id="import_scenario">
  <title
>Importera 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
>Ladda ner scenarier</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
>Ta bort scenario</title>

<para
>Markera ett scenario och klicka på knappen <guibutton
>Ta bort</guibutton
> för att ta bort det.</para>

<para
>Eftersom scenarier synkroniserar mot igenkänningsservern kan du återställa raderade scenarier genom <link linkend="configure_synchronization"
>säkerhetskopiering av modellsynkronisering</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
>Volym</title>
<para
>Det är viktigt att du kontrollerar mikrofonvolymen innan några samplingar spelas in.</para>

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

<para
>Den nuvarande versionen av &kmyapplication; innehåller ett enkelt sätt att försäkra sig om att volymen är riktigt inställd.</para>

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

<para
>Normalt visas volymkalibreringen innan någon inspelning startas i &kmyapplication;.</para>

<para
>Läs helt enkelt upp texten som visas för att kalibrera.</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
>Försök att tala normalt under kalibrering. Skrik inte, men var inte heller överdrivet tyst. Ta hänsyn till att samma volyminställning i allmänhet ska användas för all inlärning, och även för igenkänningen. Du kan (omedvetet) tala lite högre när du är upprörd eller vid ett annat klockslag, så försök att höja rösten en aning för att föregripa det. Det är mycket bättre att ha något tystare samplingar än att orsaka överstyrning.</para>

<para
>Både texten som visas och nivåerna som anses korrekta kan ändras i &kmyapplication;s inställningar. Om du lämnar texten tom, visas standardtexten. Du kan också inaktivera kalibreringen helt och hållet i inställningarna. Se <link linkend="soundconfiguration_training"
>inställningsavsnittet</link
> för mer detaljerad information.</para>
</sect3>

<sect3>
<title
>Kalibrering med Audacity</title>

<para
>Annars kan du använda ett ljudredigeringsverktyg, som det fria verktyget <ulink url="http://audacity.sourceforge.net"
>Audacity</ulink
> för att övervaka inspelningsvolymen.</para>

<para
>För tyst: <screenshot>
<screeninfo
>Volym: För tyst</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="too_quiet.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>För hög: <screenshot>
<screeninfo
>Volym: För hög</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="too_loud.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

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

</sect2>

<sect2 id="silence">
<title
>Tystnad</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
>Vänta</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="pause_control_wait.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>... innan du ber användaren att tala: <screenshot>
<screeninfo
>Tala</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="pause_control_speak.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Det här sättet med visuell återkoppling visade sig vara särskilt värdefull vid inspelning med personer som inte kan läsa den efterfrågade texten själva, och därför behöver någon som talar om för dem vad de ska säga. Den färgrika visuella anvisningen talar om för dem när de ska börja repetera vad handledaren sagt, utan behov av otillförlitliga handgester. </para>
</sect2>


<sect2 id="recording_content">
<title
>Innehåll</title>
<para
>Generally we recommend to record roughly the same sentences that Simon should recognize later.</para>
<para
>(Uppenbarligen gäller det inte omfattande samplingsinsamlingar där andra egenskaper som fonetisk balans är viktigare)</para>

<para
>Se till att undvika inspelningar som <quote
>Ett ett ett</quote
> för att snabbt öka egenskapen <quote
>igenkänningsfrekvens</quote
>. Sådana inspelningar minskar ofta igenkänningsprestanda, eftersom uttalet varierar stort från att säga ordet för sig självt.</para>
</sect2>


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

<para
>Dock åstadkommer även ganska billiga headsets (omkring 300 kr) mycket bra resultat - flera magnituder bättre än interna mikrofoner.</para>

<para
>För maximal kompatibilitet rekommenderar vi USB-headsets, eftersom de i regel har stöd för den nödvändiga samplingsfrekvensen 16 kHz, har bra stöd både i Microsoft Windows och GNU/Linux, och i normala fall inte behöver speciella, användarspecifika drivrutiner för att fungera.</para>
</sect2>


<sect2 id="sample_quality_assurance">
<title
>Kvalitetssäkring av samplingar</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
>Toppvolymen hos samplingen</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
>Signal-brusförhållande (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
>Det kan ofta vara ett resultat av antingen en mikrofon av dålig kvalitet, hög nivå av bakgrundsljud, eller en låg inspelningsvolym tillsammans med alternativet <quote
>microfone boost</quote
> i systemets mixer. </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
>Tom sampling som utlöser SNR-varningen</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
>Import av inlärningssamplingar</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
>Funktionen är mycket specifik. Använd den med försiktighet och försäkra dig om att du vet exakt vad du gör innan du fortsätter. </para>
</note>

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

<para
>När du använder frågebaserade transkriberingar måste frågefilen (UTF-8) innehålla rader med följande innehåll: <quote
>[filnamn] [innehåll]</quote
>. Filnamn skrivs utan filändelser, och innehållet måste använda stora bokstäver. Exempelvis: <userinput
>demo_2007_03_20 DEMO</userinput
> för att importera filen <filename
>demo_2007_03_20.wav</filename
> som innehåller det inlästa ordet <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
>När filbaserade transkriberingar används <emphasis
>måste</emphasis
> en fil med namnet detta_är_ett_test.wav innehålla <quote
>Detta är ett test</quote
> och inget annat. Siffror och specialtecken (<quote
>.</quote
>, <quote
>-</quote
>, ...) i filnamnet ignoreras och tas bort. </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
>Importerade filer och deras transkribering läggs därefter till i inlärningsmaterialet. </para>

<para
>Markera bara katalogen att importera och beroende på typ av import också frågefilen, för att importera en katalog som innehåller inlärningssamplingar. <screenshot>
<screeninfo
>Import training data wizard</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="import_training_data_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Katalogen sökes igenom rekursivt. Det betyder att den angivna katalogen och alla dess underkataloger sökes igenom efter .wav-, .flac-, .mp3-, och .ogg-filer. Alla filer som hittas importeras. </para>

<para
>När ljudfilerna importeras tillämpas alla inställda <link linkend="soundconfiguration_postprocessing"
>efterbehandlingsfilter</link
>. </para>
<para
>Om du importerar något annat än WAV-filer ansvarar du för att de avkodas under importprocessen (exempelvis via efterbehandlingsfilter), annars <emphasis
>misslyckas</emphasis
> skapandet av modellen. </para>

</sect2>

</sect1>

<sect1 id="configuration">
<title
>Inställning</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
>Allmän inställning</title>
<para
>Den allmänna inställningssidan listar några grundinställningar.</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
>Allmän inställning</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
>Om du avmarkerar alternativet för att varna dig när det finns problem med samplingar, inaktiveras <link linkend="sample_quality_assurance"
>kvalitetssäkring av samplingar</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
>Enhetsinställning</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
>För varje enhet kan du bestämma vad du vill använda den till: Inlärning eller igenkänning (det senare gäller bara inenheter).</para>

<para
>Om du använder fler än en enhet för inlärning kommer du skapa flera ljudfiler varje gång du läser in något. När du använder flera enheter för igenkänning ger var och en en separat ljudindataström till servern, och du får då igenkänningsresultat för varje ström.</para>

<para
>Om du använder flera utenheter sker uppspelning av inlärningssamplingarna på alla inställda ljudenheter.</para>

<para
>När du använder olika samplingsfrekvenser för inenheter spelas utdata bara upp på matchande utenheter. Om du till exempel har en inenhet inställd att använda 16 kHz, och den andra att använda 48 kHz, sker uppspelning av samplingar som skapats av den första bara via 16 kHz-utgångar, och den andra bara via 48 kHz-enheter.</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
>Upptäckt av röstaktivitet</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
>Upptäckt av röstaktivitet</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="vad.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Här kan du anpassa segmenteringen via följande parametrar: <itemizedlist>
      <listitem>
        <para
><guilabel
>Gränsnivå</guilabel
></para>
        <para
>Allt under denna nivå anses vara <quote
>tystnad</quote
> (bakgrundsbrus).</para>
      </listitem>
      <listitem>
        <para
><guilabel
>Nivåmarginal</guilabel
></para>
        <para
>Lagra ända till nivåmarginalen för att börja betrakta det som en riktig sampling. Under denna period måste innivån vara ovanför gränsnivån.</para>
      </listitem>
      <listitem>
        <para
><guilabel
>Avslutningsmarginal</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
>Hoppa över samplingar kortare än</guilabel
></para>
        <para
>Samplingar som är kortare än detta värde skickas inte vidare för igenkänning (hostningar, etc.).</para>
      </listitem>
    </itemizedlist>
  </para>
</sect3>

<sect3 id="soundconfiguration_training">
  <title
>Inlärningsinställningar</title>

  <para>
  <screenshot>
  <screeninfo
>Inlärningsinställningar</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
>Teckensnittsinställningen här gäller texten som spelas in för att träna den akustiska modellen (genom explicit träning eller när ett ord läggs till).</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
>På den här inställningssidan kan du också ange parametrarna för <link linkend="volume_calibration"
>volymkalibreringen</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
>Den visade texten kan anpassas genom att skriva in text i inmatningsfältet därunder. Om redigeringsrutan är tom används en förvald text.</para>
</sect3>

<sect3 id="soundconfiguration_postprocessing">
<title
>Efterbehandling</title>
<para
>Alla inspelade (inlärning) och importerade (genom import av inlärningsdata) samplingar kan behandlas med en serie efterbehandlingskommandon. Efterbehandlingskedjor är en avancerad funktion och ska inte behövas av vanliga användare.</para>

<para>
<screenshot>
<screeninfo
>Efterbehandling av ljudinställning</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_sound_4.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Efterbehandlingskommandon kan ses som en kedja av filter som inspelningarna måste passera igenom. Genom att använda dessa <quote
>filter</quote
> kan man definiera kommandon för att dämpa bakgrundsljud i inlärningsdata eller normalisera inspelningarna.</para>

<para
>Givet programmet <application
>process_audio</application
>, som tar in- och utdatafiler som argument (t.ex.: <command
>process_audio in.wav ut.wav</command
>) skulle efterbehandlingskommandot vara: <userinput
>process_audio %1 %2</userinput
>. De två platsmarkörerna %1 och %2 ersätts av respektive in- och utdatafilnamn.</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
>Talmodell</title>
<para
>Här kan du justera talmodellens parametrar.</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
>Samplingsfrekvensen som anges här är målfrekvensen för den akustiska modellen. Den har inget att göra med inspelningens samplingsfrekvens, och det är användarens ansvar att kontrollera att samplingarna verkligen finns tillgängliga med detta format (oftast genom att spela in i just den samplingsfrekvensen, eller genom att använda efterbehandlingskommandon som samplar om filerna. Se <link linkend="soundconfiguration"
>avsnittet om ljudinställningar</link
> för mer information).</para>

<para
>Oftast byggs och används antingen 16 kHz- eller 8 kHz-modeller. 16 kHz-modeller har bättre noggrannhet än 8 kHz-modeller. Att gå högre än 16 kHz rekommenderas inte eftersom det är väldigt processorkrävande, och i praktiken antagligen inte leder till bättre igenkänningsfrekvens.</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
>Modellutökningar</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
>Modellutökningar</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_model_extensions.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect2>

<sect2 id="configure_recognition">
<title
>Igenkänning</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
>Allmänt</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
>Anpassa server: Allmänt</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
>Nätverk</title>
<para
>Simon connects to Simond using TCP/IP.</para>

<para>
<screenshot>
<screeninfo
>Anpassa server: Nätverk</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
>För att lägga till en server, ange värdnamn eller IP-adress och portnummer (åtskilda av <quote
>:</quote
>) eller använd dialogrutan som visas när du klickar på den blåa pilen intill inmatningsfältet.</para>

</sect4>
</sect3>

<sect3 id="configure_synchronization">
<title
>Synkronisering och säkerhetskopiering av modeller</title>
<para
>Här kan du ställa in modellsynkroniseringen och återställa äldre versioner av talmodellen.</para>

<para>
<screenshot>
<screeninfo
>Synkronisering och säkerhetskopiering av modeller</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
>Efter du har anslutit till servern kan du välja en av de tillgängliga modellerna och återställa den genom att klicka på <guimenuitem
>Välj modell</guimenuitem
>.</para>

</sect3>
</sect2>



<sect2 id="configure_actions">
<title
>Åtgärder</title>

<para
>I åtgärdsinställningarna kan du anpassa reaktionerna på igenkänningsresultaten.</para>

<sect3 id="configure_actions_recognition">
  <title
>Igenkänning</title>

  <para
>The recognition of Simon computes not only the most likely result but rather the top ten results.</para>
  <para
>Varje resultat tilldelas ett konfidensvärde mellan 0 och 1 (där 1 är 100 % säkert).</para>
  <para
>Med <guilabel
>Minsta konfidens</guilabel
> kan du ange ett minsta konfidensvärde för att igenkänningsresultat ska anses giltiga.</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
>Menade du ...?</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="did_you_mean.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Rutan kan inaktiveras genom att använda kryssrutan <guibutton
>Visa informationsruta för val av tvetydiga resultat</guibutton
>.</para>
</sect3>
<sect3>
  <title
>Dialogrutans teckensnitt</title>
  <para
>Many plugins of Simon have a graphical user interface.</para>
  <para
>Teckensnitten i dessa gränssnitt kan anpassas centralt här, oberoende av systemets teckensnittsinställningar.</para>

  <para>
  <screenshot>
    <screeninfo
>Nummerinmatning med eget teckensnitt</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="input_number_huge_font.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>
</sect3>

<sect3>
  <title
>Listor</title>
  <para
>Här hittar du inställningar för globala listelement. Det utgör en mall för nya scenarier, men används också direkt för <link linkend="configure_actions_recognition"
>rutan för tvetydiga igenkänningsresultat</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
>Socialt skrivbord</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
>Om du redan har ett konto på <ulink url="http://opendesktop.org"
>opendesktop.org</ulink
> kan du mata in användarinformationen här. Annars kan du registrera dig direkt från inställningsmodulen.</para>

<para
>Registreringen är förstås utan avgift.</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
>Det finns i princip två delar i inställningarna av Julius som kan justeras: <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
>Sökvägen till Julius inställningsfiler beror på plattformen: <table frame='all'
><title
>Julius inställningsfiler</title>
<tgroup cols='3' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<colspec colname='c3'/>
<thead>
<row>
  <entry
>Fil</entry>
  <entry
>Microsoft Windows</entry>
  <entry
>GNU/Linux</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>adin.jconf (system)</entry>
  <entry
>(installationssökväg)\share\apps\simon\adin.jconf</entry>
  <entry
>`kde4-config --prefix`/share/apps/simon/adin.jconf</entry>
</row>
<row>
  <entry
>adin.jconf (användare)</entry>
  <entry
>%appdata%\.kde\share\apps\simon\adin.jconf</entry>
  <entry
>~/.kde/share/apps/simon/adin.jconf</entry>
</row>
<row>
  <entry
>julius.jconf (mall)</entry>
  <entry
>(installationssökväg)\share\apps\simond\default.jconf</entry>
  <entry
>`kde4-config --prefix`/share/apps/simond/default.jconf</entry>
</row>
<row>
  <entry
>julius.jconf (användare)</entry>
  <entry
>%appdata%\.kde\share\apps\simond\models\(användare)\active\julius.jconf</entry>
  <entry
>~/.kde/share/apps/simond/models/(användare)/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
>Inledning</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
>Taligenkänningssystem tar röstindata (ofta från en mikrofon) och försöker översätta den till skriven text. För att göra det förlitar de sig på statistiska representationer av mänskliga röster. Enkelt uttryckt: Datorn lär sig hur ord låter, eller snarare ljuden som orden består av. </para>

<para
>En talmodell består av två distinkta delar: <itemizedlist>
  <listitem
><para
>Språkmodell</para
></listitem>
  <listitem
><para
>Akustisk modell</para
></listitem>
</itemizedlist>
</para>

<sect2 id="language_model">
<title
>Språkmodell</title>

<para
>Språkmodellen definierar ordförrådet och grammatiken du vill använda.</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
>Terminal</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
>Exempel på ordförråd (observera att ordklasserna har med avsikt satts till substantiv/verb här för att göra det lätt att förstå. Se <link linkend="grammar"
>grammatikavsnittet</link
> om varför det kanske inte är en god idé): <table frame='all'
><title
>Ordförrådsexempel</title>
<tgroup cols='3' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<colspec colname='c3'/>
<thead>
<row>
  <entry
>Ord</entry>
  <entry
>Ordklass</entry>
  <entry
>Uttal</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>Computer (dator)</entry>
  <entry
>Substantiv</entry>
  <entry
>k ax m p y uw t er</entry>
</row>
<row>
  <entry
>Internet</entry>
  <entry
>Substantiv</entry>
  <entry
>ih n t er n eh t</entry>
</row>
<row>
  <entry
>Mail (brev)</entry>
  <entry
>Substantiv</entry>
  <entry
>m ey l</entry>
</row>
<row>
  <entry
>close (stäng)</entry>
  <entry
>Verb</entry>
  <entry
>k l ow s</entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<sect4 id="active_dictionary">
<title
>Aktiv ordlista</title>
<para
>Ordlistan som används vid igenkänning kallas den aktiva ordboken eller ordlistan.</para>
</sect4>

<sect4 id="shadow_dictionary">
<title
>Skuggordbok</title>
<para
>Som nämndes tidigare bör användaren se till att ordförråd/ordbok är så sparsamma som möjligt. Eftersom ett ord i ordförrådet också måste ha information om uttal skulle det dock även vara bra att ha en stor ordbok där det går att slå upp uttal och andra egenskaper hos orden. </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
>Grammatik</title>
<para
>Grammatiken definiera vilka kombinationer av ord som är riktiga. </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
> för att öppna en webbläsare</para
></listitem>
  <listitem
><para
><quote
>Computer, Mail</quote
></para
><para
>För att öppna ett e-postprogram</para
></listitem>
  <listitem
><para
><quote
>Computer, close</quote
></para
><para
>För att stänga det nuvarande fönstret</para
></listitem>
</itemizedlist>
</para>
<para
>Ordlistan skulle innehålla följande, om engelsk grammatik följs: <table frame='all'
><title
>Ordförrådsexempel</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
  <entry
>Ord</entry>
  <entry
>Ordklass</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>Computer (dator)</entry>
  <entry
>Substantiv</entry>
</row>
<row>
  <entry
>Internet</entry>
  <entry
>Substantiv</entry>
</row>
<row>
  <entry
>Mail (brev)</entry>
  <entry
>Substantiv</entry>
</row>
<row>
  <entry
>close (stäng)</entry>
  <entry
>Verb</entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<para
>To allow the sentences defined above Simon would need the following grammar: <itemizedlist>
  <listitem
><para
><quote
>Substantiv Substantiv</quote
> för meningar som <quote
>Computer Internet</quote
></para
></listitem>
  <listitem
><para
><quote
>Substantiv Verb</quote
> för meningar som <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
>I exemplet ovan är det exempelvis inte relevant att <quote
>close</quote
> är ett verb, eller att <quote
>Computer</quote
> och <quote
>Internet</quote
> är substantiv. Varför inte istället definiera dem som något som bättre stämmer överens med vad vi vill att de ska vara: <table frame='all'
><title
>Förbättrad exempelordlista</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
  <entry
>Ord</entry>
  <entry
>Ordklass</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>Computer (dator)</entry>
  <entry
>Utlösare</entry>
</row>
<row>
  <entry
>Internet</entry>
  <entry
>Kommando</entry>
</row>
<row>
  <entry
>Mail (brev)</entry>
  <entry
>Kommando</entry>
</row>
<row>
  <entry
>close (stäng)</entry>
  <entry
>Kommando</entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<para
>Nu ändrar vi grammatiken till följande: <itemizedlist
> <listitem
><para
><quote
>Trigger Command</quote
></para
></listitem
> </itemizedlist
> Det möjliggör alla kombinationer som beskrevs ovan, men det begränsar också möjligheterna till exakt dessa tre meningar. Särskilt i större modeller kan en väl genomtänkt grammatik och ordförråd innebära en enorm skillnad för igenkänningsresultaten. </para>
</sect3>


</sect2>

<sect2 id="acoustic_model">
<title
>Akustisk modell</title>
<para
>Den akustiska modellen representerar ditt uttal på ett maskinläsbart format.</para>

<para
>Låt oss ta en titt på följande ordförrådsexempel: <table frame='all'
><title
>Ordförrådsexempel</title>
<tgroup cols='3' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<colspec colname='c3'/>
<thead>
<row>
  <entry
>Ord</entry>
  <entry
>Ordklass</entry>
  <entry
>Uttal</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>Computer (dator)</entry>
  <entry
>Substantiv</entry>
  <entry
>k ax m p y uw t er</entry>
</row>
<row>
  <entry
>Internet</entry>
  <entry
>Substantiv</entry>
  <entry
>ih n t er n eh t</entry>
</row>
<row>
  <entry
>Mail (brev)</entry>
  <entry
>Substantiv</entry>
  <entry
>m ey l</entry>
</row>
<row>
  <entry
>close (stäng)</entry>
  <entry
>Verb</entry>
  <entry
>k l ow s</entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<para
>Uttalet av varje ord består av separata ljud som delas upp av mellanrum. Exempelvis består ordet <quote
>close</quote
> (stäng) av följande ljud: <itemizedlist
> <listitem
><para
>k</para
></listitem
> <listitem
><para
>l</para
></listitem
> <listitem
><para
>ow</para
></listitem
> <listitem
><para
>s</para
></listitem
> </itemizedlist
> Den akustiska modellen använder sig av det faktum att talade ord består av ljud i stort sätt som skrivna ord består av bokstäver. Genom att använda denna kunskap kan vi dela upp ord i ljud (som representeras av uttalet) och sätta ihop dem igen vid igenkänning. Dessa byggblock kallas <quote
>fonem</quote
>. </para>

<para
>Eftersom den akustiska modellen faktiskt representerar hur du säger ordens fonem, delas inlärningsmaterial mellan alla ord som använder samma fonem. </para>
<para
>Det betyder att om du lägger till ordet <quote
>clothes</quote
> (kläder) i språkmodellen har den akustiska modellen redan en idé om hur delen <quote
>clo</quote
> kommer låta, eftersom de delar samma fonem (<quote
>k</quote
>, <quote
>l</quote
>, <quote
>ow</quote
>) i början. </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
>Scenarier</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
>Lägga till ett nytt scenario</title>
  <para
>Använd knappen <guibutton
>Lägg till</guibutton
> för att lägga till ett nytt scenario. En ny dialogruta visas då.</para>

<para>
  <screenshot>
    <screeninfo
>Lägg till scenario</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="add_scenario.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para
>När ett nytt scenario skapas, ge det helst ett begripligt namn. Om du senare laddar upp det till <ulink url="http://kde-files.org/index.php?xcontentmode=692"
>KDE files</ulink
>, ber vi dig följa en viss namngivningspraxis, även om det givetvis inte är ett krav: <quote
>[&lt;språk&gt;/&lt;basmodell&gt;] &lt;namn&gt;</quote
>. Om du till exempel skapar ett scenario på engelska som fungerar med basmodellen Voxforge och styr Mozilla Firefox blir det: <quote
>[EN/VF] Firefox</quote
>. Om scenariet inte är anpassat till en fonemuppsättning (basmodell), utelämna bara den andra beteckningen på detta vis: <quote
>[EN] Firefox</quote
>.</para>

<para
>Scenarioversionen är bara ett versionsnummer som räknas upp och gör det lättare att skilja på olika utgåvor av ett 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
>Scenariets licens kan anges via kombinationsrutan. Du kan naturligtvis också lägga till en godtycklig licenstext i inmatningsfältet.</para>

<para
>Därefter kan du lägga till ditt namn (eller alias) i listan med scenarioupphovsmän. Där blir du också tillfrågad om kontaktinformation. Fältet tillhandahålls enbart som ett bekvämt sätt att kontakta en scenarioupphovsman angående ändringar, problem, beundrarbrev, etc. Om du inte känner dig bekväm med att tillhandahålla din e-postadress kan du helt enkelt skriva in ett streck <quote
>-</quote
> som anger att du inte är villig att dela med dig av denna information.</para>

</sect2>

<sect2 id="edit_scenario">
<title
>Redigera scenario</title>
<para
>Använd bara <guibutton
>Redigera</guibutton
> i dialogrutan <guilabel
>Hantera scenarier</guilabel
> för att redigera scenarier.</para>
<para
>Dialogrutan fungerar på exakt samma sätt som dialogrutan <link linkend="add_scenario"
>lägg till scenario</link
>.</para>
</sect2>

<sect2 id="export_scenario">
  <title
>Exportera 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
>För att ladda upp till OpenDesktop-sidor måste du ha ett konto där. <ulink url="http://opendesktop.org/usermanager/new.php"
>Registrering</ulink
> är mycket enkel, och naturligtvis utan kostnad.</para>

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

<para>
  <screenshot>
    <screeninfo
>Guiden för uppladdning av scenarier: 1 av 4</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="upload_scenario_1.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para>
  <screenshot>
    <screeninfo
>Guiden för uppladdning av scenarier: 2 av 4</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="upload_scenario_2.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para>
  <screenshot>
    <screeninfo
>Guiden för uppladdning av scenarier: 3 av 4</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="upload_scenario_3.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
</para>

<para>
  <screenshot>
    <screeninfo
>Guiden för uppladdning av scenarier: 4 av 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
>Normalt visas den aktiva ordlistan. För att visa skuggordlistan, välj fliken <guilabel
>Skuggordlista</guilabel
>.</para>

<para
>Varje ord visar dess <quote
>igenkänningsfrekvens</quote
>, vilket för närvarande bara är en räknare av hur ofta ordet har spelats in (ensamt eller tillsammans med andra ord). </para>

<para>
<screenshot>
<screeninfo
>Skuggordförråd</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="vocabulary1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>


</para>

<sect2 id="add_word">
<title
>Lägga till ord</title>
<para
>Använd ordtilläggsguiden för att lägga till nya ord i den aktiva ordlistan.</para>
<para
>Adding words to Simon is basically a two step procedure: <itemizedlist>
<listitem
><para
>Definiera ordet</para
></listitem>
<listitem
><para
>Inledande inlärning</para
></listitem>
</itemizedlist>
</para>

<sect3 id="add_word_define">
<title
>Definiera ordet</title>
<para
>Först blir användaren tillfrågad om viket ord som ska läggas till. <screenshot>
<screeninfo
>Välj ordet att lägga till</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 (Terminal and Pronunciation). <screenshot>
<screeninfo
>Fält som automatiskt fylls i av skuggordboken</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add_word_2.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
<para
>Alla förslag från skuggordboken räknas upp i tabellen <guilabel
>Liknande ord</guilabel
>. Normalt visas bara exakta ordträffar. Det kan dock ändras genom att markera kryssrutan <guilabel
>Inkludera liknande ord</guilabel
> under förslagstabellen. Genom att använda liknande ord kan du snabbt gissa dig till det korrekta uttalet av ordet du faktiskt försöker lägga till. Se <link linkend="manual_transcription"
>nedan</link
> för detaljerad information.</para>

<para
>Detta beror förstås i själva verket på skuggordboken. Om skuggordboken inte innehåller ordet du försöker lägga till måste de nödvändiga fälten fyllas i manuellt.</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 terminal <guilabel
>Unknown</guilabel
>. You should change this to something appropriate when adding those words. </para>

<sect4>
<title
>Välja en ordklass manuellt</title>
<para
>Ordets ordklass definieras som den grammatiska kategori ordet tillhör. Det kan vara <guilabel
>Substantiv</guilabel
>, <guilabel
>Verb</guilabel
> eller helt nya kategorier, som <guilabel
>Kommando</guilabel
>. För mer information, se <link linkend="grammar"
>grammatikavsnittet</link
>.</para>
<para
>Listan innehåller alla ordklasser som används både i den aktiva och skuggordboken samt i grammatiken. </para>
<para
>Du kan lägga till nya ordklasser i kombinationsrutan genom att använda det gröna plustecknet intill den. </para>
</sect4>

<sect4 id="manual_transcription">
<title
>Manuellt tillhandahålla en fonetisk transkribering</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
>Om du inte vet hur ett ord ska transkriberas själv kan du enkelt ta hjälp av skuggordboken, även om ordet inte listas i den. Låt oss säga att vi vill lägga till ordet <quote
>Firefox</quote
> (för att starta Firefox), vilket förstås inte finns i vår skuggordbok. </para>

<para
>(Jag importerade den engelska voxforge HTK-ordboken från <ulink url="http://voxforge.org/home/downloads"
>voxforge</ulink
> som skuggordbok.) </para>

<para
><quote
>Firefox</quote
> listas inte i vår skuggordbok, så vi får inga förslag alls. <screenshot>
<screeninfo
>Lägga till ett okänt ord</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
>Byt till skuggordlistan genom att klicka på fliken <guilabel
>Skuggordlista</guilabel
>.</para>
<para
>Använd rutan <guilabel
>Filter</guilabel
> ovanför listan för att söka efter <quote
>Fire</quote
>: <screenshot>
<screeninfo
>Lägga till ett okänt ord: Sök efter uttalet</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add_word_2_3.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Vi kan se att ordet <quote
>Fire</quote
> transkriberas som <quote
>f ay r</quote
>. Filtrera nu för <quote
>fox</quote
> istället för <quote
>Fire</quote
> så ser vi att <quote
>Fox</quote
> transkriberas som <quote
>f ao k s</quote
>. Vi kan anta att firefox då bör transkriberas som <quote
>f ay r f ao k s</quote
>. </para>

<para
>Att använda den här metoden för att sluta sig till uttalet från ordets delar har den definitiva fördelen att vi inte bara får en transkribering av hög kvalitet, utan också automatiskt använder samma fonemuppsättning som de andra orden som hämtades korrekt ur skuggordboken. </para>

<para
>Nu kan vi mata in uttalet och ändra ordklassen till någonting lämpligt. <screenshot>
<screeninfo
>Helt definierat ord</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add_word_2_4.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

</sect4>

</sect3>

<sect3 id="add_word_record">
<title
>Inlärning av ordet</title>
<para
>För att slutföra guiden kan vi nu lära in ordet två gånger. Om du inte vill göra det, eller exempelvis använder en <link linkend="base_model_static"
>statisk basmodell</link
>, kan du hoppa över dessa två sidor. </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 terminal of the word and substitute the generic terminals 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 terminal <quote
>Trigger</quote
> in your vocabulary. You then add a new word <quote
>Firefox</quote
> of the terminal <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
>Redigera ordexempel</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add_word_3.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Du får ändra de exemplen till vad du än vill. Du kan till och med gå så långt som att använda ord som ännu inte finns i den aktiva ordboken, förutsatt att du lägger till dem innan du synkroniserar modellen, även om det inte rekommenderas. </para>

<para
>Allt som återstår är att spela in exemplen. <screenshot>
<screeninfo
>Inspelning</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add_word_4.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
<para
>Försäkra dig om att du följer riktlinjerna angivna i <link linkend="recording"
>inspelningsavsnittet</link
>.</para>
</sect3>

</sect2>

<sect2 id="edit_word">
<title
>Redigera ett ord</title>
<para
>Markera helt enkelt ett ord i ordlistan och klicka på <guibutton
>Redigera</guibutton
> för att redigera ett ord. </para>

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

<para
>Där kan du ändra namn, ordklass och uttal av det valda ordet. </para>
</sect2>

<sect2 id="remove_word">
<title
>Ta bort ett ord</title>

<para
>Markera ett ord i ordlistevyn och klicka på <guibutton
>Ta bort</guibutton
> för att ta bort det från språkmodellen. <screenshot>
<screeninfo
>Inspelning</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="delete_word.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot
></para>

<para
>Dialogrutan erbjuder fyra val: <itemizedlist>
  <listitem>
    <para
>Flytta ordet till ordklassen <guilabel
>Oanvänd</guilabel
>.</para>
    <para
>Eftersom du (förhoppningsvis) inte använder ordklassen <guilabel
>Oanvänd</guilabel
> i grammatiken, kommer ordet inte längre användas vid igenkänning. Det kommer i själva verket tas bort från det aktiva ordförrådet innan modellen kompileras, eftersom ingen grammatisk mening hänvisar till det.</para>
    <para
>Om du vill använda ordklassen <guilabel
>Oanvänd</guilabel
> i grammatiken kan du förstås använda en annan ordklass för oanvända ord. Ange då ordklassen i dialogrutan <link linkend="edit_word"
>Redigera ord</link
>.</para>
    <para
>Ange bara rätt ordklass igen för att återanvända ordet. Ingen data går förlorad.</para>
  </listitem>
  <listitem>
    <para
>Flytta ordet till skuggordboken</para>
    <para
>Det tar bort det markerade ordet från den aktiva ordboken (och därigenom från igenkänningen) men behåller en kopia i skuggordboken. Alla inspelningar som innehåller ordet bevaras.</para>
    <para
>Lägg åter till ordet i det aktiva ordförrådet för att använda det igen. När ett <quote
>nytt</quote
> ord med samma namn läggs till, visas värdena för det flyttade ordet som ett förslag. Därför kommer ingen data att gå förlorad.</para>
  </listitem>
  <listitem>
    <para
>Ta bort ordet men behåll samplingarna</para>
    <para
>Tar bort ordet fullständigt men behåller associerade samplingar. Så fort du lägger till ett annat ord med samma ordnamn associeras samplingarna igen.</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
>Använd inte alternativet om samplingarna du spelade in för ordet var felaktiga.</para>
  </listitem>
  <listitem
><para
>Ta bort ordet fullständigt</para>
  <para
>Ta bara bort ordet. Alla inspelningar som innehåller ordet kommer också att tas bort.</para>
  <para
>Alternativet lämnar inga spår av vare sig ordet själv eller de associerade samplingarna.</para>
  <para
>Eftersom samplingar är globala (inte tilldelade till scenarier), kan också samplingar som spelats in vid inlärningssessioner för andra scenarier tas bort om de innehåller ordet. Använd alternativet med försiktighet.</para>
  </listitem>
</itemizedlist>
</para>

</sect2>

<sect2 id="special_training_stub">
<title
>Särskild inlärning</title>
<para
>Se <link linkend="special_training"
>avsnittet om särskild inlärning i inlärningsavsnittet</link
>.</para>
</sect2>


<sect2 id="import_dictionary">
<title
>Importera en ordbok</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
>När användaren <link linkend="add_word"
>lägger till ett nytt ord</link
> i modellen, måste följande karaktäristik definieras för att definiera ordet: <itemizedlist>
  <listitem
><para
>Ordnamn</para
></listitem>
  <listitem
><para
>Ordklass</para
></listitem>
  <listitem
><para
>Fonetisk definition</para
></listitem>
</itemizedlist>
</para>
<para
>Dessa egenskaper tas ur skuggordboken om det innehåller ordet ifråga. En stor skuggordbok av hög kvalitet kan därför hjälp användaren att enkelt lägga till nya ord i modellen utan att behöva hålla ordning på fonemuppsättningen, och i många fall till och med göra det möjligt att glömma att den fonetiska transkriptionen över huvud taget behövs. </para>

<para>
  <screenshot>
    <screeninfo
>Importera ordbok: Inledning</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
>HADIFIX ordbok</title>
<para
>Simon can import HADIFIX dictionaries. </para>
<para
>Ett exempel på en HADIFIX-ordbok är den tyska <ulink url="http://www.sk.uni-bonn.de/forschung/phonetik/sprachsynthese/bomp"
>HADIFIX BOMP</ulink
>. </para>
<para
>HADIFIX ordböcker tillhandahåller både ordklasser och uttal. </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
>Importera ordbok: Automatisk import från 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
>HTK-ordbok</title>
<para
>Simon can import HTK lexica. </para>
<para
>Ett exempel på en HTK-ordbok är den engelska <ulink url="http://www.repository.voxforge1.org/downloads/SpeechCorpus/Trunk/Lexicon/"
>Voxforge ordboken</ulink
>. </para>
<para
>HADIFIX-ordböcker tillhandahåller uttalsinformation men inga ordklasser. Alla ord blir tilldelade ordklassen <guilabel
>Okänd</guilabel
>. </para>
</sect3>

<sect3 id="import_dict_pls">
<title
>PLS-ordbok</title>
<para
>Simon can import PLS dictionaries. </para>
<para
>Ett exempel på en PLS-ordbok är den <ulink url="http://www.repository.voxforge1.org/downloads/de/Trunk/Lexicon/"
>tyska GPL-ordboken från Voxforge</ulink
>. </para>
<para
>PLS-ordböcker tillhandahåller uttalsinformation men inga ordklasser. Alla ord blir tilldelade ordklassen <guilabel
>Okänd</guilabel
>. </para>
</sect3>

<sect3 id="import_dict_sphinx">
<title
>SPHINX-ordbok</title>
<para
>Simon can import SPHINX dictionaries. </para>
<para
>Ett exempel på en SPHINX-ordbok är den här <ulink url="http://speech.mty.itesm.mx/~jnolazco/proyectos.htm"
>ordboken för mexikansk spanska</ulink
>. </para>
<para
>SPHINX-ordböcker tillhandahåller uttalsinformation men inga ordklasser. Alla ord blir tilldelade ordklassen <guilabel
>Okänd</guilabel
>. </para>
</sect3>

<sect3 id="import_dict_julius">
<title
>Julius-ordbok</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-ordböcker tillhandahåller uttalsinformation samt information om ordklasser. </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
>Grammatik</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
>Grammatik</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="grammar.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>När en mening markeras till vänster, visar högerrutan automatiskt möjliga riktiga meningar med orden i din ordlista till höger.</para>

<para
>Exempelavsnittet listar som mest 35 exempel, så om fler meningar än så matchar det markerade grammatikobjektet kanske listan inte är fullständig.</para>

<sect2>
<title
>Importera en grammatik</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
>Importera grammatik</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
>Låt oss säga att vi har en ordlista som den i det allmänna avsnittet ovan: <table frame='all'
><title
>Förbättrad exempelordlista</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
  <entry
>Ord</entry>
  <entry
>Ordklass</entry>
</row>
</thead>
<tbody>
<row>
  <entry
>Computer (dator)</entry>
  <entry
>Utlösare</entry>
</row>
<row>
  <entry
>Internet</entry>
  <entry
>Kommando</entry>
</row>
<row>
  <entry
>Mail (brev)</entry>
  <entry
>Kommando</entry>
</row>
<row>
  <entry
>close (stäng)</entry>
  <entry
>Kommando</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
>Importera grammatik: Ange text</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="import_grammar1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Importera grammatik: Textfil</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="import_grammar2.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Importera grammatik: Välj filer</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 terminal.</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 terminal <guilabel
>Trigger</guilabel
> and <quote
>Internet</quote
> of the terminal <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
>Importen segmenterar automatiskt indatatexten enligt skiljetecken (<quote
>.</quote
>, <quote
>-</quote
>, <quote
>!</quote
>, etc.), så vilken vanlig text som helst bör fungera. Importen sammanfogar automatiskt duplicerade meningsstrukturer (till och med mellan olika filer) och lägger till flera meningar (alla möjliga kombinationer) när ett ord har flera ordklasser tilldelade till sig.</para>
<para
>Importen ignorerar meningar där ett eller flera ord inte kunde hittas i språkmodellen om du inte markerar kryssrutan <guilabel
>Importera också okända meningar</guilabel
>, i vilket fall dessa ord ersätts med <guilabel
>Okänd</guilabel
>.</para>

</sect2>





<sect2>
<title
>Byta namn på ordklasser</title>
<para
>Guiden för namnbyte av ordklasser låter dig byta namn på ordklasser både i den aktiva ordlistan, skuggordboken och grammatiken. <screenshot>
<screeninfo
>Byt namn på ordklass</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="rename_terminal.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect2>

<sect2>
<title
>Sammanfoga ordklasser</title>
<para
>Guiden för att sammanfoga ordklasser låter dig sammanfoga två ordklasser till en ny ordklass i både den aktiva ordboken, skuggordboken och grammatiken. <screenshot>
<screeninfo
>Sammanfoga ordklass</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="merge_terminal.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
<para
>Funktionen är särskilt användbar om du vill förenkla grammatikstrukturen.</para>
</sect2>


</sect1>



<sect1 id="training">
<title
>Inlärning</title>

<para
>Genom att använda inlärningsmodulen kan du förbättra den <link linkend="acoustic_model"
>akustiska modellen</link
>. </para>

<para
>Gränssnittet listar alla installerade inlärningstexter i en tabell med tre kolumner: <itemizedlist>
<listitem
><para
>Namn</para
><para
>Ett beskrivande namn på texten.</para
></listitem>
<listitem
><para
>Sidor</para
><para
>Antal <quote
>sidor</quote
> texten består av. Varje sida representerar en inspelning.</para
></listitem>
<listitem
><para
>Igenkänningsfrekvens</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
>Inlärning</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
>Samplingar av din röst</para
></listitem>
  <listitem
><para
>Transkriberingar av samplingarna</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
>Inlärning: Varning om saknade ord</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"/> Inlärningen (uppläsningen) av inlärningstexten fungerar på exakt samma sätt som den inledande inlärningen när ett nytt ord läggs till.</para>

<para
>Försäkra dig om att du följer riktlinjerna angivna i <link linkend="recording"
>inspelningsavsnittet</link
>.</para>
<para>
<screenshot>
<screeninfo
>Inlärning pågår</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="training_running.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>



<sect2 id="training_storage">
<title
>Lagringskataloger</title>
<para
>Inlärningstexter lagras på två olika ställen: <itemizedlist>
  <listitem
><para
>Linux: <filename
>~/.kde/share/apps/simon/texts</filename
></para>
            <para
>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
>Linux: <filename
>`kde4-config --prefix`/share/apps/simon/texts</filename
></para>
            <para
>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
>Katalogen kan användas av systemadministratörer för att tillhandahålla en gemensam uppsättning inlärningstexter för alla användare på ett system.</para>
          </listitem>
</itemizedlist>
</para>
<para
>XML-filerna (en för varje text) kan bara flyttas från en plats till en annan, men det kräver troligtvis rättighet som systemadministratör.</para>
</sect2>


<sect2 id="add_texts">
<title
>Lägga till texter</title>
<para>
<screenshot>
<screeninfo
>Guiden för import av inlärningstexter</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
>Lägg till inlärningstexter</title>
            <para>
      <screenshot>
      <screeninfo
>Guiden för import av inlärningstexter: Lägg till inlärningstexter</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="import_text_4.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </screenshot>
Skriv helt enkelt in inlärningstexten i ett inmatningsfält.</para>
</sect3>
<sect3>
  <title
>Lokala textfiler</title>

    <para>
      <screenshot>
      <screeninfo
>Guiden för import av inlärningstexter: Lokala textfiler</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
>Inlärning i farten</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
>Särskild inlärning: Välja orden</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="special_training.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Välj orden att lära in från ordförrådet till vänster och dra dem helt enkelt till markeringslistan till höger (du skulle också kunna markera dem i tabellen till vänster och lägga till dem genom att klicka på <guibutton
>Lägg till i inlärning</guibutton
>).</para>

<para
>Starta inlärningen genom att välja <guibutton
>Lär valda ord</guibutton
>. Inlärningen själv är exakt samma som om den vore en förberedd inlärningstext.</para>

<para>
<screenshot>
<screeninfo
>Särskild inlärning: Inlärning av orden</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
>Kommandon</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
>Varje insticksprogram kan associeras med en <quote
>utlösare</quote
>. Genom att använda utlösare kan ansvaret hos varje insticksprogram enkelt delas upp. </para>
<para
>Med fabriksarbetarabstraktionen ovan kan det jämföras med att säga namnet på den som ska behandla din begäran. Så istället för <quote
>Öppna min hemkatalog</quote
> säger du <quote
>Johan, öppna min hemkatalog</quote
>, och <quote
>Johan</quote
> (insticksprogrammet som ansvarar för att öppna kataloger) vet omedelbart att begäran är riktad till honom.</para>
<para
>I praktiken skulle du kunna göra så att kommandon som det körbara kommandot <quote
>Firefox</quote
> öppnar den välkända webbläsaren, och att platskommandot <quote
>Google</quote
> öppnar söktjänsten på Internet. Om du tilldelar utlösaren <quote
>Start</quote
> till insticksprogrammet för körning och utlösaren <quote
>Open</quote
> till platskommandot, skulle du behöva säga <quote
>Start Firefox</quote
> (istället för bara <quote
>Firefox</quote
> om du inte använder en utlösare för insticksprogrammet för körning)och <quote
>Open Google</quote
> för att gå till söktjänsten (istället för bara <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
>Du kan ladda flera instanser av ett insticksprogram, till och med i ett scenario. Varje instans kan naturligtvis också ha olika insticksprogramutlösare.</para>

<para
>Varje kommando har ett namn (för utlösning av dess utförande), en ikon och fler fält beroende på insticksprogrammets typ (se nedan). </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
>Kommandon för röstgränssnittet läggs till precis som normala kommandon via kommandoinställningen.</para>

<para>
<screenshot>
<screeninfo
>Anpassa röstgränssnittets kommandon</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="voice_interface_command_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>För att lägga till ett nytt gränssnittskommando till en funktion, välj den åtgärd du vill associera med ett kommando, klicka på <guibutton
>Skapa från åtgärdsmall</guibutton
> och anpassa det resulterade kommandot enligt dina behov.</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
>Kommando inläst i huvudfönstret</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
>Körbara kommandon</title>

<para
>Körbara kommandon associeras med en körbar fil (<quote
>program</quote
>), som startas när kommandot utförs.</para>

<screenshot>
<screeninfo
>Körbara kommandon</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_program.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>Argument till kommandon stöds. Om antingen sökvägen till den körbara filen eller parametrarna innehåller mellanslag, <emphasis
>måste</emphasis
> de omslutas av citationstecken.</para>

<para
>Givet den körbara filen <filename
>C:\Program\Mozilla Firefox\firefox.exe</filename
> och den lokala HTML-filen <filename
>C:\test fil.html</filename
> skulle den korrekta raden för <guilabel
>Körbar fil</guilabel
> vara: <filename
>"C:\Program\Mozilla Firefox\firefox.exe" "C:\test fil.html"</filename
>.</para>

<para
>Arbetskatalogen definierar var processen ska startas från. Med arbetskatalogen <filename
>C:\katalog</filename
> skulle kommandot <filename
>"C:\Program\Mozilla Firefox\firefox.exe" fil.html</filename
> få Firefox att leta efter filen <filename
>C:\katalog\fil.html</filename
>.</para>

<para
>Arbetskatalogen behöver oftast inte ställas in och kan för det mesta lämnas tom.</para>

<sect3 id="importing_executable_commands">
<title
>Importera program</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
>Alternativet är inte tillgängligt på Microsoft Windows.</para
></note>

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

<para
>Dialogrutan listar alla program som har ett alternativ i KDE:s programmeny i sina respektive kategorier.</para>

<para
>Delkategorier stöds inte, och listas sålunda på samma nivå som toppnivåkategorierna.</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
>Platskommandon</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
>Istället för kataloger kan filer också anges som kommandots webbadress, vilket gör att filen öppnas med programmet som är associerat med den när kommandot utförs.</para>

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

<para
>För att associera en särskild webbadress med kommandot kan du skriva in den manuellt i webbadressfältet (välj först <guibutton
>Manuell</guibutton
>) eller importera den med platsimportguiden.</para>


<sect3 id="importing_place_commands">
<title
>Importera platser</title>

<para
>Dialogrutan för att importera platser låter dig enkelt skapa rätt webbadress för kommandot.</para>

<para
>Välj <guibutton
>Lokal plats</guibutton
> och välj katalogen eller filen med filväljaren för att lägga till en lokal katalog eller fil. <screenshot>
<screeninfo
>Importera platser: Lokal</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_place_import_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>För att lägga till en webbadress (HTTP, FTP, etc.) välj <guibutton
>Webbadress</guibutton
>.</para>

<screenshot>
<screeninfo
>Importera platser: Fjärr</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_place_import_2.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>Observera att för webbadresser med behörighetsinformation kommer lösenordet att lagras som klartext.</para>

</sect3>
</sect2>

<sect2 id="shortcut_commands">
<title
>Genvägskommandon</title>
<para
>Genom att använda genvägskommandon kan användaren associera kommandon med tangentbordskombinationer.</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
>Definiera genvägskommandon</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_shortcut.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Växla bara genvägsknappen och tryck på tangentkombinationen på tangentbordet för att välja genväg som du vill simulera.</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
>Textmakro-kommandon</title>
<para
>Med textmakro-kommandon kan användaren associera text med ett kommando. När kommandot utförs <quote
>skrivs</quote
> den associerade texten genom att simulera tangenttryckningar.</para>

<para>
<screenshot>
<screeninfo
>Definiera textmakro-kommandon</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_text-macro.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect2>

<sect2 id="list_command">
<title
>Listkommandon</title>
<para
>Listkommandot är utformat för att kombinera flera kommandon (alla typer av kommandon stöds) i en lista. Användaren kan sedan välja det n:te alternativet genom att säga motsvarande siffra (1-9).</para>

<para
>Det är mycket användbart för att begränsa mängden inlärning som krävs och ger möjlighet att hålla ordlistan till ett minimum.</para>

<para>
<screenshot>
<screeninfo
>Definiera listkommandon</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_list_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Listkommandon är särskilt praktiska vid användning av kommandon med komplicerade utlösare, eller kommandon som kan grupperas i ett allmänt tema. Ett typiskt exempel skulle kunna vara kommandot <quote
>Startmeny</quote
> för att visa en lista över program att starta. På så sätt kan de specifika körbara kommandona fortfarande behålla tydligt beskrivande namn (som <quote
>OpenOffice.org Writer 3.1</quote
>), utan att användaren måste inkludera dessa ord i ordförrådet och ta hänsyn till dem i grammatiken bara för att utlösa dem.</para>

<para
>Kommandon av olika typer kan förstås blandas.</para>

<sect3 id="list_command_display">
<title
>Visa listkommandon</title>

<para
>När kommandot utförs, visar det listan centrerad på skärmen. Listan expanderas automatiskt för att följa sina alternativ.</para>
<screenshot>
<screeninfo
>Definiera listkommandon</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_list_2.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
<para
>Användaren kan köra kommandona som finns i listan genom att helt enkelt säga den motsvarande siffran. (I detta exempel <quote
>Ett</quote
> för att starta Mozilla Firefox). </para>

<para
>Medan en lista är aktiv (visas) ignoreras all indata som inte riktas till själva listan (andra kommandon, etc.). Processen kan avbrytas genom att trycka på knappen <guibutton
>Avbryt</guibutton
> eller genom att säga <quote
>avbryt</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
>Listkommandon med många poster</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_list_3.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>
</sect3>

<sect3 id="list_command_configure">
<title
>Anpassa listelement</title>

<para
>I standardutförandet använder listkommandot följande utlösningsord. För att dra full nytta av listkommandon, se till att språket och den akustiska modellen innehåller och tillåter följande <quote
>meningar</quote
>: <itemizedlist>
<listitem
><para
><quote
>Noll</quote
></para
></listitem>
<listitem
><para
><quote
>Ett</quote
></para
></listitem>
<listitem
><para
><quote
>Två</quote
></para
></listitem>
<listitem
><para
><quote
>Tre</quote
></para
></listitem>
<listitem
><para
><quote
>Fyra</quote
></para
></listitem>
<listitem
><para
><quote
>Fem</quote
></para
></listitem>
<listitem
><para
><quote
>Sex</quote
></para
></listitem>
<listitem
><para
><quote
>Sju</quote
></para
></listitem>
<listitem
><para
><quote
>Åtta</quote
></para
></listitem>
<listitem
><para
><quote
>Nio</quote
></para
></listitem>
<listitem
><para
><quote
>Avbryt</quote
></para
></listitem>
</itemizedlist>
</para>

<para
>Of course you can also configure these words in your Simon configuration: <itemizedlist>
    <listitem>
      <para
><guimenuitem
>Kommandon</guimenuitem
> - <guibutton
>Hantera insticksprogram</guibutton
> - <guimenuitem
>Allmänt</guimenuitem
> - <guimenuitem
>Listor</guimenuitem
> för scenarioomfattande listinställningar.</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
>Sammansatta kommandon</title>
<para
>Sammansatta kommandon låter användaren gruppera flera kommandon i en följd.</para>

<para
>När de utförs körs kommandona i tur och ordning. Fördröjningar mellan kommandon kan infogas.</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
>Definiera sammansatta kommandon</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_composite_1.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Med ett sammansatt kommando kan användaren skapa komplicerade <quote
>makron</quote
>. Som ett exempel gör skärmbilden ovan följande: <itemizedlist>
<listitem
><para
>Starta Kopete (körbart kommando)</para
></listitem>
<listitem
><para
>Vänta 2000 ms på att Kopete ska startas</para
></listitem>
<listitem
><para
>Skriv <quote
>Mathias</quote
> (text-makrokommando), vilket kommer välja Mathias i min kontaktlista</para
></listitem>
<listitem
><para
>Tryck på Enter (genvägskommando)</para
></listitem>
<listitem
><para
>Vänta 1000 ms för att chattfönstret ska visas</para
></listitem>
<listitem
><para
>Skriv <quote
>Hi!</quote
> (text-makrokommando); texten associerad med kommandot innehåller en radbrytning i slutet, så att meddelandet skickas.</para
></listitem>
<listitem
><para
>Tryck <keycombo
>&Alt;<keycap
>F4</keycap
></keycombo
> (genvägskommando) för att stänga chattfönstret</para
></listitem>
<listitem
><para
>Tryck på <keycombo
>&Alt;<keycap
>F4</keycap
></keycombo
> (genvägskommando) för att stänga Kopetes huvudfönster</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
>Skrivbordsrutnätet</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
>Skrivbordsrutnät: Markering med klick</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
>Anpassa skrivbordsrutnätet</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
>Dock har i stort sett alla moderna system stöd för sammansatt grafik (äkta genomskinlighet). </para>
<para
>Det omfattar: <itemizedlist>
<listitem
><para
>Microsoft Windows 2000 eller senare (XP, Vista, 7)</para
></listitem>
<listitem
><para
>GNU/Linux som använder en sammansättningshanterare som 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
>Ett</quote
></para
></listitem>
<listitem
><para
><quote
>Två</quote
></para
></listitem>
<listitem
><para
><quote
>Tre</quote
></para
></listitem>
<listitem
><para
><quote
>Fyra</quote
></para
></listitem>
<listitem
><para
><quote
>Fem</quote
></para
></listitem>
<listitem
><para
><quote
>Sex</quote
></para
></listitem>
<listitem
><para
><quote
>Sju</quote
></para
></listitem>
<listitem
><para
><quote
>Åtta</quote
></para
></listitem>
<listitem
><para
><quote
>Nio</quote
></para
></listitem>
<listitem
><para
><quote
>Avbryt</quote
></para
></listitem>
</itemizedlist>
</para>

<para
>För att anpassa dessa utlösare, anpassa bara kommandona som är associerade med insticksprogrammet.</para>

<para>
<screenshot>
<screeninfo
>Skrivbordsrutnät: Anpassa listelement</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="desktop_grid_configure_list_elements.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

</sect2>

<sect2 id="input_number">
<title
>Nummerinmatning</title>
<para
>Genom att använda insticksprogrammet nummerinmatning kan användaren enkelt mata in stora tal.</para>


<para
>Med insticksprogrammen för diktering eller text-makron skulle man kunna associera nummer med motsvarande siffror, och använda det som inmatningsmetod. För att mata in större nummer finns det då två sätt som båda har stora nackdelar: <itemizedlist>
<listitem
><para
><emphasis
>Lägga till orden <quote
>elva</quote
>, <quote
>tolv</quote
>, etc.</emphasis
></para>
<para
>Även om det verkar vara den elegantaste lösningen, eftersom det låter användaren säga <quote
>femhundrasjuttiotvå</quote
> kan vi lätt se att det skulle bli väl problematiskt att lägga till alla dessa ord, för att inte tala om att lära in dem. Hur blir det med <quote
>tvåtusenniohundratvå</quote
>? Var ska man sluta?</para
></listitem>
<listitem
><para
><emphasis
>Dela upp talet genom att använda de enskilda siffrorna</emphasis
></para>
<para
>Medan det inte är lika elegant som att ange det fullständiga numret är det mycket mer praktiskt.</para>
<para
>Dock förlitar sig många program (som det fantastiska tilläggsprogrammet för musfri webbläsning för Firefox) på att användaren kan mata in stora nummer utan alltför mycket tid mellan separata tangenter (musfri webbläsning väntar exempelvis exakt 500 ms som förval innan det anser att inmatningen av numret är färdig). Så om du vill skriva 52 skulle du först säga <quote
>Fem (paus) Två</quote
>. På grund av den nödvändiga pausen skulle programmet (som tilläggsprogrammet för musfri webbläsning) betrakta inmatningen av <quote
>Fem</quote
> som färdig.</para
></listitem>
</itemizedlist>
</para>

<para
>Insticksprogrammet för nummerinmatning visar ett miniräknarliknande gränssnitt för att mata in ett nummer när det utlöses. Inmatningen kan rättas genom att säga <quote
>bakåt</quote
>. Det har ett decimaltecken som du använder genom att säga <quote
>komma</quote
>. När du säger <quote
>okej</quote
> skrivs numret ut. Eftersom all röstinmatning och korrigering hanteras av själva insticksprogrammet, kommer programmet som till slut tar emot inmatningen bara märka några millisekunder mellan de enskilda siffrorna. <screenshot>
<screeninfo
>Insticksprogrammet för nummerinmatning</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="command_input_number.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Medan insticksprogrammet för nummerinmatning är aktivt (användaren håller på att mata in ett nummer) ignoreras all indata som inte riktas till nummerinmatningen (andra kommandon, etc.). Säg <quote
>avbryt</quote
> när som helst för att avbryta processen. </para>

<para
>Eftersom inga kommandoinstanser ska skapas för det här insticksprogrammet, listas det inte i dialogrutan <guilabel
>Nytt kommando</guilabel
>. Dock placerar insticksprogrammet för nummerinmatning en inställningsskärm direkt i kommandoinställningarna när det laddas.</para>

<screenshot>
<screeninfo
>Insticksprogrammet för nummerinmatning</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="input_number_configure.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>Utlösaren definierar vilket ord eller vilken fras som utlöser visningen av gränssnittet. </para>


<para
>Normalt använder insticksprogrammet för nummerinmatning siffror för att välja de enskilda siffrorna och ett par kontrollord. För att använda insticksprogrammet, se till att språket och den akustiska modellen innehåller och tillåter följande <quote
>meningar</quote
>: <itemizedlist>
<listitem
><para
><quote
>Noll</quote
></para
></listitem>
<listitem
><para
><quote
>Ett</quote
></para
></listitem>
<listitem
><para
><quote
>Två</quote
></para
></listitem>
<listitem
><para
><quote
>Tre</quote
></para
></listitem>
<listitem
><para
><quote
>Fyra</quote
></para
></listitem>
<listitem
><para
><quote
>Fem</quote
></para
></listitem>
<listitem
><para
><quote
>Sex</quote
></para
></listitem>
<listitem
><para
><quote
>Sju</quote
></para
></listitem>
<listitem
><para
><quote
>Åtta</quote
></para
></listitem>
<listitem
><para
><quote
>Nio</quote
></para
></listitem>
<listitem
><para
><quote
>Bakåt</quote
></para
></listitem>
<listitem
><para
><quote
>Komma</quote
></para
></listitem>
<listitem
><para
><quote
>Ok</quote
></para
></listitem>
<listitem
><para
><quote
>Avbryt</quote
></para
></listitem>
</itemizedlist>
</para>

<para
>För att anpassa dessa utlösare, anpassa bara kommandona som är associerade med insticksprogrammet.</para>

<para>
<screenshot>
<screeninfo
>Insticksprogrammet för nummerinmatning</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure_number_input_elements.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

</sect2>

<sect2 id="dictation_command_plugin">
<title
>Diktering</title>
<para
>Dikteringsinsticksprogrammet skriver igenkänningsresultat det får med simulerade tangenttryckningar.</para>

<para
>Med antagandet att du inte definierade en utlösare för dikteringsinsticksprogrammet, tar det emot alla igenkänningsresultat och skriver ut dem. Utskriven inmatning betraktas som <quote
>behandlad indata</quote
> och skickas därför inte vidare till andra insticksprogram. Det innebär att inga av insticksprogrammen <emphasis
>nedanför det</emphasis
> i listan <guilabel
>Valda insticksprogram</guilabel
> i kommandoinställningarna kommer att ta emot någon indata, om du laddade dikteringsinsticksprogrammet men aldrig definierade en utlösare för det.</para>

<para
>Eftersom inga kommandoinstanser ska skapas för det här insticksprogrammet, listas det inte i dialogrutan <guilabel
>Nytt kommando</guilabel
>.</para>

<para
>Dikteringsinsticksprogrammet kan ställas in att lägga till text sist i igenkänningsresultatet för att exempelvis lägga till ett mellanslag efter varje igenkänt ord.</para>

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

<sect2 id="ai_command_plugin">
<title
>Artificiell intelligens</title>
<para
>Insticksprogrammet för artificiell intelligens är mest för nöjes skull, och emulerar ett vanligt mänskligt samtal.</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
>Insticksprogrammet använder AIML:er för den faktiska <quote
>intelligensen</quote
>. De flesta AIML-uppsättningar bör kunna användas. Den populära <ulink url="http://www.pandorabots.co/pandora/talk?botid=f5d922d97e345aa1"
>roboten A.L.I.C.E</ulink
> och en tysk version fungerar, och levereras med insticksprogrammet.</para>

<screenshot>
<screeninfo
>AI-insticksprogram</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="ai_configure.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>

<para
>Insticksprogrammet placerar en inställningsskärm i kommandoinställningsmenyn där du kan välja vilken AIML-uppsättning som ska laddas. </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
>Ta en titt på filerna bot.xml och vars.xml i följande katalog för att justera botens personlighet: <itemizedlist>
<listitem
><para
>GNU/Linux: <filename
>`kde4-config --prefix`/share/apps/ai/util/</filename
></para
></listitem>
<listitem
><para
>Microsoft Windows: <filename
>[installationskatalog (normalt C:\Program Files\simon 0.2)]\share\apps\ai\util\</filename
></para
></listitem>
</itemizedlist>
</para>

<para
>Eftersom inga kommandoinstanser ska skapas för det här insticksprogrammet, listas det inte i dialogrutan <guilabel
>Nytt kommando</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
>Miniräknare</title>
<para
>Insticksprogrammet Miniräknare är en enkel röststyrd räknare.</para>

<para>
<screenshot>
<screeninfo
>Insticksprogrammet Miniräknare</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="calculator.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Miniräknaren utökar insticksprogrammet för <link linkend="input_number"
>nummerinmatning</link
> genom att erbjuda ytterligare funktioner.</para>

<para
>När insticksprogrammet laddas läggs en inställningsskärm till i insticksprogrammets inställningar.</para>

<para>
<screenshot>
<screeninfo
>Insticksprogrammet Miniräknare: Inställning</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="calculator_configuration.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Där kan du också anpassa miniräknarens kontrollmöjlighet. Anger du den som något annat än <guimenuitem
>Fullständig miniräknare</guimenuitem
> döljs vissa möjligheter från den visade grafiska komponenten.</para>

<para>
<screenshot>
<screeninfo
>Insticksprogrammet Miniräknare: Minimal</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="calculator_minimal.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

<para
>Dock kommer de dolda kontrollerna fortfarande reagera på de inställda röstkommandona, i stället för att helt enkelt ta bort alla associerade kommandon från funktionerna.</para>

<para
>När du klickar på <guibutton
>Ok</guibutton
> frågar miniräknaren normalt vad du vill göra med det beräknade resultatet. Du kan till exempel mata ut beräkningen, resultatet, både och, etc. Förutom att alltid välja det i den visade listan efter att ha klickat på knappen <guibutton
>Ok</guibutton
>, kan det också anges med de inställda alternativen.</para>

<para>
<screenshot>
<screeninfo
>Insticksprogrammet Miniräknare: Lägesval för utmatning</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="calculator_output_mode_selection.png" format="PNG"/>
    </imageobject>
  </mediaobject>
</screenshot>
</para>

</sect2>

<sect2 id="filter_command_plugin">
  <title
>Filter</title>
  <para
>Genom att använda filtreringsinsticksprogrammet kan du hejda igenkänningsresultat från att skickas vidare till ytterligare kommandoinsticksprogram. Genom att använda detta insticksprogram kan du till exempel inaktivera igenkänningen med rösten.</para>
  <para
>Insticksprogrammet för kommandofiltrering placerar en inställningsskärm i kommandoinställningarna där du kan ändra vilka resultat som ska filtreras. </para>

  <para>
  <screenshot>
  <screeninfo
>Filterinsticksprogram: Inställning</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="filter_configuration.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Mönstret är ett reguljärt uttryck som utvärderas varje gång ett igenkänningsresultat tas emot av insticksprogrammet för behandling.</para>

  <para
>Insticksprogrammet lägger också till röstgränssnittskommandon för aktivering och inaktivering av filtret.</para>

  <para
>In total, the filter therefore has three states: <itemizedlist>
      <listitem>
        <para
>Inaktiv</para>
        <para
>Normaltillståndet. Alla igenkänningsresultat skickas vidare.</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
>Aktiv</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
>Uttalsövning</title>

  <para
>Uttalsövningen, kombinerad med en bra <link linkend="base_model"
>statisk basmodell</link
>, kan vara ett kraftfullt verktyg för att förbättra ditt uttal av ett nytt språk.</para>

  <para>
  <screenshot>
  <screeninfo
>Uttalsövning</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
>Ju närmare den infödda talaren, desto högre poäng.</para>

  <para
>Insticksprogrammet lägger till ett alternativ i menyn <guimenu
>Kommandon</guimenu
> för att visa dialogrutan med uttalsövningen.</para>

  <para
>Själva övningen består av flera sidor. Varje sida innehåller ett ord som hämtas ur det aktiva ordförrådet. De identifieras med en ordklass som måste väljas i kommandoinställningarna innan övningen startas.</para>

  <para>
  <screenshot>
  <screeninfo
>Uttalsövning: Inställning</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="pronunciation_training_configuration.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>
</sect2>

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

  <para
>Tangentbordsinsticksprogrammet visar ett virtuellt, röststyrt, tangentbord.</para>

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

  <para
>Tangentbordet består av flera flikar, som var och en kan innehålla flera tangenter. Helheten av flikar och tangenter samlas i <quote
>uppsättningar</quote
>.</para>

  <para
>Du kan välja uppsättningar i inställningarna, men också skapa nya från grunden i inställningen av tangentbordskommandon.</para>

  <para>
  <screenshot>
  <screeninfo
>Tangentbord: Inställning</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="keyboard_2.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Tangenter avbildas i regel till enstaka tecken, men kan också innehålla långa texter och till och med genvägar. Därför kan tangentbordsuppsättningar innehålla specialtangenter, som en tangent för att <quote
>markera alla</quote
> eller en <quote
>lösenordstangent</quote
> (skriver ditt lösenord).</para>

  <para
>Intill flikarna som innehåller tangenterna i en uppsättning kan tangentbordet också visa specialtangenter, som &Ctrl;, &Shift;, etc. Dessa tangenter tillhandahålls som kommandon för röstgränssnittet, och visas oavsett vilken flik i uppsättningen som för närvarande är aktiv.</para>
  <para
>Som med alla röstutlösare döljs även knapparna när det associerade kommandot tas bort.</para>

  <para
>Dessutom tillhandahåller tangentbordet ett numeriskt tangentbord som kan visas genom att välja lämpligt alternativ i tangentbordsinställningarna.</para>

  <para>
  <screenshot>
  <screeninfo
>Tangentbord: Numeriskt tangentbord</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="keyboard_3.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Intill de numeriska tangenterna och delete-tangenten för det numeriska inmatningsfältet (<guibutton
>numeriskt baksteg</guibutton
>), tillhandahåller det numeriska tangentbordet två alternativ för vad som ska hända med det inmatade numret.</para>
  <para
>När <guibutton
>Skriv nummer</guibutton
> används skrivs det inmatade numret med simulerade tangenttryckningar. När <guibutton
>Välj nummer</guibutton
> används görs ett försök att hitta en tangent eller flik i den aktiva uppsättningen som har just det här numret som utlösare. På så sättet kan du kontrollera ett fullständigt tangentbord genom att bara använda nummer.</para>

  <para>
  <screenshot>
  <screeninfo
>Tangentbord: Nummerbaserat</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="keyboard_4.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Tangenterna på det numeriska tangentbordet är inställningsbara kommandon för röstgränssnittet.</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
>Frågor och svar</title>

<para
>För att alltid försöka hålla avsnittet uppdaterat är det tillgängligt på vår <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Troubleshooting_Guide"
>wiki</ulink
>. </para>

</chapter>

<chapter id="credits">

<title
>Tack till och licens</title>

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

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

<para
>Översättning Stefan Asserhäll <email
>stefan.asserhall@comhem.se</email
></para
> <para
>Översättning Arve Eriksson <email
>031299870@telia.com</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installation</title>
<para
>Se vår <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Installation"
>wiki</ulink
> för installationsinstruktioner.</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;
-->
