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

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

<bookinfo>

<othercredit role="translator"
><firstname
>Peter</firstname
><surname
>Grasch</surname
><affiliation
><address
><email
>peter.grasch@bedahr.org</email
></address
></affiliation
><contrib
>Übersetzung</contrib
></othercredit
> 


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


<abstract>
<para
>&kmyapplication; ist die Serverkomponente der Spracherkennungslösung „Simon“. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>Erkennung</keyword>
<keyword
>Sprache</keyword>
<keyword
>Sprecher</keyword>
<keyword
>Befehl</keyword>
<keyword
>Steuerung</keyword>
<keyword
>Zugangshilfe</keyword>
</keywordset>

<!-- Translators: put here the copyright notice of the translation -->
<!-- Put here the FDL notice.  Read the explanation in fdl-notice.docbook
     and in the FDL itself on how to use it. -->
<legalnotice
>&FDLNotice;</legalnotice>

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

<authorgroup>
<author
><personname
> <firstname
>Peter</firstname
> <othername
>H.</othername
> <surname
>Grasch</surname
> </personname
> <email
>peter.grasch@bedahr.org</email
> </author>
</authorgroup>


<title
>Das Handbuch zu &kmyapplication;</title>
</bookinfo>

<chapter id="introduction">
<title
>Einführung</title>

<para
>&kmyapplication; ist die Serverkomponente der Spracherkennungslösung „Simon“. Es ist für die eigentliche Erkennung und für die Erzeugung des Modells zuständig. Es erhält die Eingabedateien und die Daten vom Mikrofon von den Simon-Programmen über das Netzwerk (TCP/IP). </para>
<para
>Für weitere Informationen lesen Sie bitte das <ulink url="help:/simon/overview.html#architecture"
>Handbuch zu Simon</ulink
>.</para>
</chapter>

<chapter id="using-kapp">
<title
>&kmyapplication; verwenden</title>

<para
>Simond ist ein Befehlszeilenprogramm ohne Benutzerschnittstelle. Es gibt auch keine speziellen Befehlszeilenparameter.</para>

<para
>Allerdings installiert Simond ein Kontrollmodul, das in KDEs-&systemsettings; aufgeführt wird und auch direkt mit <command
>kcmshell4</command
> angezeigt werden kann: <itemizedlist
> <listitem
><para
><command
>kcmshell4 simondconfiguration</command
></para
></listitem>
</itemizedlist>
</para>

<para
>Weil Simond das Sprachmodell kompiliert (wenn Simon-Programme das anfordern) ist die Einrichtung der Sprachmodellkompilierung auch relevant, wenn Simond verwaltet wird. Sie kann mit <command
>kcmshell4</command
> geöffnet werden: <itemizedlist
> <listitem
><para
><command
>kcmshell4 simonmodelcompilationconfig</command
></para
></listitem>
</itemizedlist>
</para>

<para
>Wenn Simond innerhalb einer grafischen Benutzerumgebung ausgeführt wird, (wenn Sie nicht wissen sollten was eine "grafische Benutzerumgebung" ist, verwenden Sie wahrscheinlich eine), wird empfohlen, Simon über das grafische Programm <command
>ksimond</command
> zu benutzen. ksimond bietet Zugriff auf die Einrichtungsmodule über sein Einstellungsmenü. Im Handbuch zu KSimond finden Sie weitere Informationen.</para>


<sect1 id="user_configuration">
<title
>Benutzereinrichtung</title>

<para
>Mit der Benutzereinrichtung können Sie die neue Benutzer anlegen, vorhandene bearbeiten und - auf Wunsch inklusive deren Modell - vom Server entfernen.</para>

<para>
<screenshot>
<screeninfo
>Bildschirmfoto der Simond-Benutzereinrichtung</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="simond_user_config.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Simond-Benutzereinrichtung</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

<para
>Simond identifies its connections with a user / password combination which is completely independent from the underlying operating system and its users (which means you have to have at least one Simond user set up to use it). Every Simon client logs onto the server with a user / password combination which identifies a unique user and thus a unique speech model.</para>

<para
>Die Benutzer werden in einer SQLite-Datenbank gespeichert, die durch das Kontrollmodul <command
>simonduserconfiguration</command
> verwaltet werden.</para>

<para
>Der Speicherort der Datenbank hängt vom Betriebssystem ab: <table frame='all'
><title
>Simond-Benutzerdatenbank</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
  <entry
>Microsoft Windows</entry>
  <entry
>GNU/Linux</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><filename
>%appdata%\.kde\share\apps\simond\simond.db</filename
></entry>
  <entry
><filename
>~/.kde/share/apps/simond/simond.db</filename
></entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<para
>Simond does come with a default user so you don't have to add a user before you can connect Simon to the Simond server.</para>

<para
>Der Standardbenutzer heißt „default“ und das Passwort lautet „nopassword“.</para>

<para
>Aus dem Passwort der Benutzer wird ein Hash-Wert gebildet und deshalb kann das Passwort nicht im Klartext angezeigt werden. Wenn ein Benutzer sein Passwort vergisst, ist es nicht möglich, dass verwendete Passwort aus der Simond-Datenbank zu rekonstruieren. Sie können aber ein neues Passwort mit dem Knopf <guibutton
>Passwort ändern</guibutton
> vergeben.</para>

<para
>Wenn ein Benutzer von der Datenbank entfernt wird, der bereits ein Sprachmodell generiert und gespeichert hat, wird der Benutzer gefragt, ob er neben dem Benutzer-Eintrag in der Datenbank auch das gespeicherte Modell entfernen möchte. Wenn Sie das Sprachmodell gespeichert lassen (mit „Nein“ antworten), wird der nächste Benutzer mit dem gleichen Benutzernamen das Modell „erben“.</para>

<para
>When selecting the <guibutton
>Keep recognition samples</guibutton
> option the samples the recognition works on are not deleted. This means that during normal operation, users will gather everything they say with the most likely transcription returned by &kmyapplication;. This can be used to automatically gather training data while using Simon. The samples will be stored in different locations depending on your operation system: <table frame='all'
><title
>Simond-Aufnahmendatenbank</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'/>
<colspec colname='c2'/>
<thead>
<row>
  <entry
>Microsoft Windows</entry>
  <entry
>GNU/Linux</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><filename
>%appdata%\.kde\share\apps\simond\models\(user)\recognitionsamples</filename
></entry>
  <entry
><filename
>~/.kde/share/apps/simond/models/(user)/recognitionsamples</filename
></entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<para
>When multiple clients connect to Simond with the same username simultaneously, they will use a joint recognition instance. In practice, this means that multiple clients can provide audio data (multiple microphones) and all connected clients with the same username will receive all results of this data. To avoid this behavior and instead force separate recognition paths, activate <guibutton
>Isolated Mode</guibutton
>.</para>
</sect1>

<sect1 id="network_configuration">
<title
>Netzwerkeinrichtung</title>
<para
>Mit der Netzwerkeinrichtung können Sie den Port ändern, auf dem der Server hört und die Zugriffe auf eine spezielle IP-Adresse limitieren.</para>

<note
><para
>Wenn Sie nicht wissen, was "Rechner", "Ports" oder "IPs" sind, dann werden die Standardwerte höchstwahrscheinlich ausreichen.</para
></note>
<para>
<screenshot>
<screeninfo
>Bildschirmfoto der Simond-Netzwerkeinrichtung</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="simond_network_config.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Simond-Netzwerkeinrichtung</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

<para
>Der Port kann natürlich frei geändert werden. Der Standardport (4444) ist allerdings von keinem anderen bekannten Programm verwendet und deshalb empfohlen. Wenn Sie den Port hier ändern, müssen Sie ihn natürlich auch auf allen Simon-Programmen entsprechend anpassen.</para>

<para
>Using the option to "Only allow connections from" you can restrict the access to your server from anywhere but the given IP address. By default this is configured to only allow (Simon) connections from the local host which only allows for local Simon clients to connect to the server.</para>
<para
>This is simply a security measure because it effectively blocks connections from anywhere else (even if the attacker knows your Simon username and password). To allow connections from other hosts simply uncheck the checkbox.</para>

<para
>Furthermore, write access can be restricted to a specific host. This allows to run "public" servers, where users can connect and use the recognition but are not allowed to initiate any form of synchronization.</para>

<para
>Protokollverschlüsselung ist derzeit noch nicht implementiert.</para>
</sect1>

<sect1 id="speech_model_compilation_configuration">
<title
>Einrichtung der Sprachmodell-Kompilierung</title>
<para
>Simon kompiliert das Sprachmodell mit Hilfe externer Software.</para>

<para
>Simon wird die notwendigen Programme automatisch finden, wenn Sie im Systempfad liegen, aber Sie können diese automatischen Werte hier auch überschreiben.</para>

<para
>Here you can also change the selected recognition backend in case of user generated models. Depending on your Simon installation, not all backends might be available.</para>

<para>
<screenshot>
<screeninfo
>Bildschirmfoto der Einrichtung der Sprachmodell-Kompilierung</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="simond_speech_model_config.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Simond-Sprachmodelleinrichtung</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

</sect1>

</chapter>


<chapter id="faq">
<title
>Fragen und Antworten</title>

<para
>Um diesen Abschnitt immer aktuell zu halten, wird dieser Teil des Handbuchs in unserem <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Troubleshooting_Guide"
>Wiki</ulink
> veröffentlicht. </para>

</chapter>

<chapter id="credits">
<title
>Danksagungen und Lizenz</title>

<para
>&kmyapplication; </para>
<para
>Copyright des Programms 2008-2012 Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

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

<para
>Übersetzung Copyright &copy; 2009-2010 Peter Grasch <email
>grasch@simon-listens.org</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installation</title>
<para
>Im <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Installation"
>Wiki</ulink
> finden Sie eine detaillierte Installationsanleitung.</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;
-->
