<?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
>Юрій</firstname
><surname
>Чорноіван</surname
><affiliation
><address
><email
>yurchor@ukr.net</email
></address
></affiliation
><contrib
>Переклад українською</contrib
></othercredit
> 

<date
>13 грудня 2012 року</date>
<releaseinfo
>0.4</releaseinfo>

<abstract>
<para
>&kmyapplication; — серверний компонент інструмента збирання зразків SSC. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>зразок</keyword>
<keyword
>мовлення</keyword>
<keyword
>голос</keyword>
<keyword
>збирання</keyword>
<keyword
>запис</keyword>
<keyword
>доступність</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;</title>
</bookinfo>

<chapter id="introduction">
<title
>Вступ</title>

<para
>&kmyapplication; — серверний компонент інструмента збирання зразків SSC. </para>
<para
>Призначенням програми є керування даними носіїв мови (користувачів, установ), а також керування метаданими зразків. Програма виконує обробку метаданих у базі даних та зберігає їх у зразках. </para>
<para
>Вхідні дані отримуються від клієнтських програм SSC, які встановлюють з’єднання з сервером за допомогою протоколу TCP/IP. </para>

<para
>Щоб дізнатися більше про загальну архітектуру комплексу програм Simon, ознайомтеся з <ulink url="help:/simon/overview.html#architecture"
>підручником з Simon</ulink
>. Щоб дізнатися більше про роботу клієнтської частини SSC, зверніться до <ulink url="help:/ssc"
>підручника з SSC</ulink
>.</para>
</chapter>

<chapter id="using-kapp">
<title
>Користування &kmyapplication;</title>

<para
>&kmyapplication; — керується за допомогою командного рядка, отже не має графічного інтерфейсу користувача. У програми немає особливих параметрів запуску.</para>


<sect1 id="sscd_folder">
  <title
>Базова тека</title>
  <para
>У основній теці &kmyapplication; зберігається файл налаштувань <filename
>sscd.conf</filename
> та журнал повідомлень про помилки, якщо такі було виявлено під час роботи програми. У цій теці також зберігається підтека <filename
>samples</filename
> — сховище всіх зібраних зразків мовлення.</para>

<para
>Розташування теки SSCd залежить від використаної вами операційної системи: <table frame='all'
><title
>Базова тека SSC</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
>Тека встановлення sscd.exe (зазвичай <filename
>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
>Налаштування</title>

  <para
>У складі SSCd не передбачено засобу налаштовування у графічному режимі. Для налаштовування можна скористатися файлом налаштувань (<filename
>sscd.conf</filename
>), який зберігається у <link linkend="sscd_folder"
>теці SSCd</link
>.</para>

  <para
>Типовий файл налаштувань містить повний набір коментарів, отже вам буде просто розібратися з призначенням параметрів.</para>

  <para
>Перш ніж запускати SSCd, варто змінити принаймні значення записів DatabaseUser і DatabasePassword у файлі налаштувань. Докладніший опис можна знайти у <link linkend="database"
>розділі щодо бази даних</link
>.</para>

  <screen
>; Це приклад файла налаштувань з вбудованими типовими значеннями
; SSCd шукатиме цей файла у:
; Linux:
;    /usr/share/sscd/sscd.conf
; Windows:
;    &lt;шлях встановлення sscd&gt;\sscd.conf

[General]
; Змініть значення цього параметра, щоб скористатися іншою базою
; даних. Оскільки SSCd використовує деякі специфічні команди керування,
; у поточній версії передбачено підтримку лише QMYSQL.
; Підтримку інших DBMS може бути реалізовано дуже просто, вам достатньо
; надіслати запит до команди розробників: support@simon-listens.org
DatabaseType=QMYSQL

; Вузол, на якому працює DBMS
DatabaseHost=127.0.0.1

; Порт DBMS; 3306 є типовим портом MySQL
DatabasePort=3306

; База даних, якою слід скористатися. Не забудьте запустити скрипт
; створення записів до використання sscd
DatabaseName=ssc

; Ім’я користувача, яким слід користуватися для зв’язку з DBMS
DatabaseUser=sscuser

; Пароль до бази даних. Типовий пароль може не працювати зі
; зрозумілих причин
DatabasePassword=CHANGE ME NOW

; Параметри бази даних. Докладний опис можна знайти у
; документації Qt щодо QSqlDatabase
DatabaseOptions=MYSQL_OPT_RECONNECT=1

; Порт, на якому сервер очікуватиме на дані. Типовий порт: 4440
Port=4440

; Пов’язати сервер з певною IP-адресою. Якщо вказано значення true,
; сервер ігноруватиме запити від всіх комп’ютерів, окрім вказаного
; за допомогою BoundHost (див нижче)
Bind=false

; IP-адреса пов’язаного вузла (якщо Bind=true)
BindHost=127.0.0.1
  </screen>
</sect1>

<sect1 id="database">
  <title
>База даних</title>

  <para
>&kmyapplication; зберігає дані носіїв мови та зразків мовлення (але не самі зразки мовлення) у базі даних. У поточній версії передбачено повну підтримку лише бази даних MySQL. Втім, додавання підтримки нових баз даних є доволі тривіальним завданням. Якщо вам потрібна підтримка певної бази даних, зв’яжіться з <ulink url="mailto:kde-accessibility@kde.org"
>командою розробників Simon</ulink
>.</para>

  <para
>Для ініціалізації потрібних &kmyapplication; таблиць можна скористатися скриптом <filename
>mysql_create_script.sql</filename
>, який буде встановлено до <link linkend="sscd_folder"
>основної теки</link
> &kmyapplication;.</para>


  <para
>Записи журналу помилок можна знайти у файлі <filename
>error.log</filename
>, який також зберігається у основній теці програми.</para>

</sect1>

<sect1 id="locked_mode">
  <title
>Режим блокування</title>


  <para
>SSCd можна запускати з параметром командного рядка «-l» (або «--locked») з метою переведення програми у режим блокування (типово цей режим вимкнено).</para>

  <para
>У режимі блокування клієнтські програми зможуть встановлювати з’єднання з сервером та вивантажувати зразки, а також створювати нові записи мікрофонів і звукових карток, але не матимуть доступу (до читання чи запису) будь-яких особистих даних або даних установи, окрім імені користувача і ідентифікатора. Такими режимом варто користуватися з метою обмеження об’єму особистих даних пацієнтів, які буде показано тим, хто записуватиме дані.</para>

  <para
>У режимі блокування не передбачено можливості пошуку користувачів з метою надання тим, хто виконуватиме перекодування, попереднього списку ідентифікаторів користувачів.</para>
</sect1>

<sect1 id="extracting_samples">
  <title
>Видобування зібраних зразків</title>

  <para
>Щоб зібрати моделі на основі зразків, зібраних за допомогою &kmyapplication;, вам слід спочатку видобути дані з бази даних.</para>

  <warning>
    <para
>Оскільки &kmyapplication; розроблено для роботи з великими обсягами зібраних зразків, таке видобування може видатися комусь незручним. Нижче наведено настанови для користувачів, які добре обізнані з принципами роботи операційної системи. </para>
    <para
>Для виконання більшості наведених нижче скриптів потрібні програми з комплексу GNU (ці програми є типовою частиною більшості дистрибутивів GNU/Linux). </para>
  </warning>

  <para
>Ви можете скористатися таким запитом (достатньо невеличких змін, пов’язаних з тим, які саме зразки вам потрібні): <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
>За цим запитом буде показано список всіх зразків з установи під номером 3, які було записано за допомогою мікрофона під номером 1.</para>

  <para
>Потім ви можете, наприклад, скористатися цим скриптом для створення файла запитів: <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
>Цей файл запитів потім можна <ulink url="help:/simon/training.html#import_training-data"
>імпортувати до Simon</ulink
>. </para>

  <para
>Щоб зібрати відповідний словник для компіляції моделі, вам може знадобитися список всіх речень, що містяться у файлі запитів. Отримати цей список можна за допомогою такого скрипту: <screen
>#!/bin/bash
      cat $1 | sed -e 's/[0-9\/]* //' | sort | uniq
    </screen>
  </para>
</sect1>
</chapter>


<chapter id="faq">
<title
>Запитання і відповіді</title>

<para
>З метою підтримання цього розділу у актуальному стані його копія зберігається у <ulink url="http://userbase.kde.org/Special:myLanguage/Troubleshooting_Guide"
>інтернет-вікі</ulink
>. </para>

</chapter>

<chapter id="credits">
<title
>Авторські права і ліцензія</title>

<para
>&kmyapplication; </para>
<para
>Авторські права на програму належать Peter Grasch <email
>peter.grasch@bedahr.org</email
>, 2008–2010 </para>

<para
>Авторські права на документацію належать Peter Grasch <email
>peter.grasch@bedahr.org</email
>, 2009–2010. </para>

<para
>Переклад українською: Юрій Чорноіван<email
>yurchor@ukr.net</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Встановлення</title>
<para
>Настанови зі встановлення можна знайти у <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Installation"
>нашій вікі</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;
-->
