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

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

<bookinfo>

<othercredit role="translator"
><firstname
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@smail.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 

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

<abstract>
<para
>&kmyapplication; on SSC näidete kogumise tööriista server. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>näidis</keyword>
<keyword
>kõne</keyword>
<keyword
>hääl</keyword>
<keyword
>hankimine</keyword>
<keyword
>salvestamine</keyword>
<keyword
>hõlbustus</keyword>
</keywordset>

<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
>&kmyapplication; käsiraamat</title>
</bookinfo>

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

<para
>&kmyapplication; on SSC näidete kogumise tööriista server. </para>
<para
>See haldab nii kõnelejaandmeid (kasutajad, asutused) kui ka näidiste metaandmeid (andmebaasi abil) ning salvestab näidiseid. </para>
<para
>Server saab sisendi SSC klientidelt, mis loovad ühenduse serveriga TCP/IP vahendusel. </para>

<para
>Täpsemat teavet Simoni tarkvarakomplekti üldise ülesehituse kohta annab <ulink url="help:/simon/overview.html#architecture"
>Simoni käsiraamat</ulink
>. Täpsemat teavet SSC kliendi kohta pakub <ulink url="help:/ssc"
>SSC käsiraamat</ulink
>.</para>
</chapter>

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

<para
>&kmyapplication; on käsurearakendus, millel puudub kasutajaliides. Samuti pole rakendusel erilisi käivitamisparameetreid.</para>


<sect1 id="sscd_folder">
  <title
>Baaskataloog</title>
  <para
>&kmyapplication; baaskataloog sisaldab seadistusfaili <filename
>sscd.conf</filename
> ja vealogi võimalike vigade puhuks. Samuti sisaldab see alamkataloogi <filename
>samples</filename
>, kuhu salvestatakse kõik näidised.</para>

<para
>SSCd kataloogi asukoht sõltub operatsioonisüsteemist: <table frame='all'
><title
>SSC baaskataloog</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
>sscd.exe paigalduskataloog (tavaliselt: C:\Program Files\simon 0.3\bin\sscd.exe</filename
>)</entry>
  <entry
><filename
>/usr/share/sscd</filename
></entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</sect1>

<sect1 id="configuration">
  <title
>Seadistamine</title>

  <para
>Graafiliselt SSCd seadistada ei saa, küll on olemas seadistusfail (<filename
>sscd.conf</filename
>), mis paikneb <link linkend="sscd_folder"
>SSCd kataloogis</link
>.</para>

  <para
>Vaikimisi seadistus on korralikult kommenteeritud, nii et see peaks olema hõlpsasti mõistetav.</para>

  <para
>Enne SSCd käivitamist oleks mõttekas muuta seadistusfailis vähemalt andmebaasi kasutaja ja parooli kirjeid (DatabaseUser ja DatabasePassword). Täpsemalt kõneleb sellest <link linkend="database"
>andmebaasi käsitlev osa</link
>.</para>

  <screen
>; This is an example config file and displays the built-in defaults
; SSCd will look for this file in:
; Linux:
;    /usr/share/sscd/sscd.conf
; Windows:
;    &lt;sscd installation path&gt;\sscd.conf

[General]
; Change this to use a different database; Because SSCd uses db-specific
; commands in places, only QMYSQL is supported at the moment.
; Support for other DBMS can be added extremely easily, though so please
; feel free to request support through kde-accessibility@kde.org
DatabaseType=QMYSQL

; The host of the DBMS
DatabaseHost=127.0.0.1

; The port of the DBMS; 3306 is the default port of MySQL
DatabasePort=3306

; The database to use; Make sure that you run the supplied create script
; before you use SSCd
DatabaseName=ssc

; The username to use when connecting to the DBMS
DatabaseUser=sscuser

; Database password. The default one will obviously not work in most cases
DatabasePassword=CHANGE ME NOW

; Database options. Refer to Qts documentation of QSqlDatabase for details
DatabaseOptions=MYSQL_OPT_RECONNECT=1

; The port the server will listen to; Default: 4440
Port=4440

; Bind the server to a specific client IP; If this is true, the server
; will ignore requests from all but the BoundHost (see below)
Bind=false

; IP of the bound host (if Bind is active)
BindHost=127.0.0.1
  </screen>
</sect1>

<sect1 id="database">
  <title
>Andmebaas</title>

  <para
>&kmyapplication; salvestab kõneleja- ja näidiseandmed (aga mitte näidiseid endid) andmebaasi. Praegu on täielikult toetatud ainult MySQL-i andmebaasid. Siiski pole uue andmebaasi toetuse lisamine kuigi raske. Kui soovid selles osas kaasa aidata, võta ühendust <ulink url="mailto:kde-accessibility@kde.org"
>Simoni meeskonnaga</ulink
>.</para>

  <para
>Vajalike tabelite loomiseks pakub &kmyapplication; omalt poolt loomisskirpti <filename
>mysql_create_script.sql</filename
>, mis paikneb &kmyapplication; <link linkend="sscd_folder"
>baaskataloogis</link
>.</para>


  <para
>Andmebaasi vead leiab failist <filename
>error.log</filename
>, mis paikneb samuti baaskataloogis.</para>

</sect1>

<sect1 id="locked_mode">
  <title
>Lukustatud režiim</title>


  <para
>Soovi või vajaduse korral võib SSCd-le anda käsureal argumendi "-l" (või "--locked"), mis lülitab sisse niinimetatud lukustatud režiimi (vaikimisi seda ei kasutata).</para>

  <para
>Lukustatud režiimis saavad kliendid küll ühenduda ning laadida näidiseid üles ja luua uusi mikrofone ja helikaarte, kuid neil pole enam ligipääsu (ei kirjutamiseks ega isegi lugemiseks) mingitele isiklikele või asutuste andmetele peale nende, mida näeb ette nende kasutaja nimi ja ID. See võib olla abiks, kui on soov piirata patsientide erateabe näitamist salvestamismeeskondadele.</para>

  <para
>Kui kehtib lukustatud režiim, ei saa ka kasutajaid otsida, mistõttu oleks kasulik, kui salvestamismeeskondadel oleks juba eelnevalt käepärast kasutajate ID-de nimekiri.</para>
</sect1>

<sect1 id="extracting_samples">
  <title
>Kogutud näidiste väljavõtmine</title>

  <para
>Mudelite loomiseks kogutud näidiste põhjal &kmyapplication; abil tuleb need kõigepealt andmebaasist välja võtta.</para>

  <warning>
    <para
>Kuna &kmyapplication; on loodud ulatuslikuks näidete kogumiseks, ei ole see just kasutajasõbralik. Allpool toodud kirjeldus on peamiselt mõeldud tehniliste teadmistega professionaalidele. </para>
    <para
>Enamik allpool toodud skripte nõuavad GNU tööriistu (mis on tavaliselt saadaval kõigis GNU/Linuxi operatsioonisüsteemides). </para>
  </warning>

  <para
>Kasutada võib järgmist päringut (sõltuvalt sellest, milliseid näidiseid konkreetselt vaja läheb, võib olla vaja seda kergelt kohandada): <screen
>use ssc;

select s.Path, s.Prompt
  from Sample s inner join User u
    on s.UserId = u.UserId inner join UserInInstitution uii
      on u.UserId = uii.UserId inner join SampleType st
        on s.TypeId = st.SampleTypeId inner join Microphone m
          on m.MicrophoneId = s.MicrophoneId
  WHERE st.ExactlyRepeated=1 and uii.InstitutionId = 3
    and (m.MicrophoneId = 1);
    </screen>
  </para>

  <para
>See päring annab tulemuseks kõigi asutuse 3 näidiste nimekirja, mis on salvestatud mikrofoniga 1.</para>

  <para
>Seejärel võib luua kõneviibafaili näiteks järgmise skriptiga: <screen
>#!/bin/bash
      sed '1d' $1 
> temp_out
      sed -e 's/\\\\/\//g' -e 's/.*Samples\///g' -e 's/\.wav\t/ /' temp_out 
> $1
      rm temp_out
    </screen>
  </para>

  <para
>Kõneviibafaili võib seejärel <ulink url="help:/simon/training.html#import_training-data"
>importida Simonisse</ulink
>. </para>

  <para
>Korraliku sõnaraamatu loomiseks, mis aitab mudelit kompileerida, võib samuti olla kasulik loetleda kõik kõneviibafailis leiduvad laused. Seda saab teha järgmise skriptiga: <screen
>#!/bin/bash
      cat $1 | sed -e 's/[0-9\/]* //' | sort | uniq
    </screen>
  </para>
</sect1>
</chapter>


<chapter id="faq">
<title
>Küsimused ja vastused</title>

<para
>Et see osa oleks alati võimalikult värske, on see kättesaadav meie <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Troubleshooting_Guide"
>wikis</ulink
>. </para>

</chapter>

<chapter id="credits">
<title
>Autorid ja litsents</title>

<para
>&kmyapplication; </para>
<para
>Rakenduse autoriõigus 2008-2010: Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

<para
>Dokumentatsiooni autoriõigus &copy; 2009-2010: Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

<para
>Tõlge eesti keelde: Marek Laane <email
>bald@smail.ee</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Paigaldamine</title>
<para
>Paigaldamisjuhised leiab meie <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Installation"
>wikist</ulink
>.</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;
-->
