<?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">
  <!ENTITY % Catalan "INCLUDE">
]>

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

<bookinfo>

&traductor.Antoni.Bella; 

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

<abstract>
<para
>&kmyapplication; és el component de servidor de l'eina per a l'adquisició de mostres de SSC. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>mostra</keyword>
<keyword
>pronuncia</keyword>
<keyword
>veu</keyword>
<keyword
>adquisició</keyword>
<keyword
>enregistrament</keyword>
<keyword
>accessibilitat</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
>El manual de &kmyapplication;</title>
</bookinfo>

<chapter id="introduction">
<title
>Introducció</title>

<para
>&kmyapplication; és el component de servidor de l'eina per a l'adquisició de mostres de SSC. </para>
<para
>Gestiona les dades dels parladors (usuaris, institucions), així com les metadades de la mostra utilitzant una base de dades i emmagatzemant les mostres. </para>
<para
>Rep l'entrada des del client(s) SSC que es connecten al servidor utilitzant TCP/IP. </para>

<para
>Per a més informació sobre l'arquitectura general de la suite de Simon consulteu el <ulink url="help:/simon/overview.html#architecture"
>manual de Simon</ulink
>. Per obtenir informació sobre el client SSC, referiu-vos al <ulink url="help:/ssc"
>manual de SSC</ulink
>.</para>
</chapter>

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

<para
>&kmyapplication; és una aplicació de línia d'ordres que no disposa de cap interfície d'usuari. No hi ha paràmetres especials pel llançament.</para>


<sect1 id="sscd_folder">
  <title
>Carpeta base</title>
  <para
>La carpeta de base de &kmyapplication; conté el fitxer de configuració <filename
>sscd.conf</filename
> i un registre d'errors en cas que alguna cosa vagi malament. Aquesta carpeta també conté la subcarpeta <filename
>samples</filename
> on s'emmagatzemaran totes les mostres.</para>

<para
>La ubicació de la carpeta SSCd depèn del vostre sistema operatiu: <table frame='all'
><title
>Carpeta base de 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
><filename
>Carpeta d'instal·lació de sscd.exe (usualment: 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
>Configurar</title>

  <para
>No hi ha cap configuració gràfica de SSCd, però hi ha un fitxer de configuració (<filename
>sscd.conf</filename
>) emmagatzemat a la <link linkend="sscd_folder"
>carpeta de SSCd</link
>.</para>

  <para
>El fitxer de configuració per omissió està molt comentat i per tant és auto-explicatiu.</para>

  <para
>Abans d'executar SSCd, almenys voldreu canviar les entrades DatabaseUser i DatabasePassword del fitxer de configuració. Veure <link linkend="database"
>la secció base de dades</link
> per obtenir més informació.</para>

  <screen
>; Aquest és un exemple de fitxer de configuració i mostra els valors per
; omissió. SSCd cercarà aquest fitxer a:
; Linux:
;    /usr/share/sscd/sscd.conf
; Windows:
;    &lt;camí d'instal·lació de sscd&gt;\sscd.conf

[General]
; Canvieu aquesta opció per utilitzar una base de dades diferent. Perquè
; SSCd utilitza ordres específiques de la base de dades en els llocs, només
; QMYSQL és compatible en aquest moment. El suport per a d'altres DBMS
; es pot afegir amb molta facilitat, encara que, si us plau, no dubteu en
; sol·licitar ajuda a través de kde-accessibility@kde.org
DatabaseType=QMYSQL

; La màquina de la DBMS
DatabaseHost=127.0.0.1

; El port de la DBMS, 3306 és el port per omissió de MySQL
DatabasePort=3306

; La base de dades a utilitzar. Assegureu-vos que s'executa l'script de
; creació subministrat abans d'utilitzar SSCd
DatabaseName=ssc

; El nom d'usuari a utilitzar per connectar-vos a la DBMS
DatabaseUser=sscuser

; La base de dades de les contrasenyes. La per omissió, òbviament,
; no funciona en la majoria dels casos.
DatabasePassword=CANVIEU-ME ARA

; Les opcions de la base de dades. Consulteu la documentació de Qts de
; QSqlDatabase per a més detalls
DatabaseOptions=MYSQL_OPT_RECONNECT=1

; El port del servidor on escolta, per omissió: 4440
Port=4440

; Enllaça el servidor a una adreça IP del client. Si això és cert (true), el
; servidor ignorarà totes les peticions dels BoundHost (veure més a sota)
Bind=false

; IP de la BoundHost (si està actiu «Bind»)
BindHost=127.0.0.1
  </screen>
</sect1>

<sect1 id="database">
  <title
>La base de dades</title>

  <para
>&kmyapplication; emmagatzema les dades dels parladors i les dades de la mostra (però no les pròpies mostres) en una base de dades. De moment, només les bases de dades MySQL estan completament suportades. Afegir suport per a una nova base de dades és trivial, però. Poseu-vos en contacte amb <ulink url="mailto:kde-accessibility@kde.org"
>l'equip de Simon</ulink
> si voleu ajudar.</para>

  <para
>Per configurar les taules requerides &kmyapplication; vé amb un script apropiat que crea <filename
>mysql_create_script.sql</filename
> instal·lat a la <link linkend="sscd_folder"
>carpeta de base</link
> de &kmyapplication;.</para>


  <para
>Els errors de la base de dades es poden trobar al fitxer <filename
>error.log</filename
>, el qual també resideix a la carpeta base.</para>

</sect1>

<sect1 id="locked_mode">
  <title
>El mode bloquejat</title>


  <para
>De manera opcional SSCd prendrà l'argument de la línia d'ordres «-l» (o «- locked») per activar el mode «bloquejat» (per omissió desactivat).</para>

  <para
>En el mode bloquejat, els clients encara es poden connectar i publicar les mostres, així com crear nous micròfons i targetes de so, però no tenen cap accés (de lectura o escriptura) a les dades de caràcter personal o institucional, a part del nom o ID d'usuari. Això pot ser útil per a limitar la quantitat d'informació passiva privada que es mostrarà als equips d'enregistrament.</para>

  <para
>Mentre està actiu el mode bloquejat, tampoc hi haurà cerca d'usuaris per assegurar-vos que el vostre equip d'enregistrament és proporcionat amb una llista dels ID d'usuari al davant.</para>
</sect1>

<sect1 id="extracting_samples">
  <title
>Extreure les mostres col·leccionades</title>

  <para
>Per construir els models utilitzant les mostres col·leccionades amb &kmyapplication; primer les haureu d'extreure de la base de dades.</para>

  <warning>
    <para
>Com que &kmyapplication; està dissenyat per a l'adquisició de mostres a gran escala aquest no acaba de ser fàcil d'utilitzar. La documentació a continuació es proporciona principalment per a professionals tècnicament qualificats. </para>
    <para
>La majoria dels següents scripts requereixen les eines de GNU (usualment disponibles per omissió sobre GNU/Linux). </para>
  </warning>

  <para
>Podeu utilitzar la següent consulta (seran necessaris petits ajustaments en funció de quines mostres necessiteu exactament): <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
>Aquesta consulta mostrarà una llista de totes les mostres de la institució 3 que es van enregistrar amb el micròfon 1.</para>

  <para
>Per exemple podeu utilitzar aquest script per crear un fitxer d'indicacions: <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
>Aquest fitxer d'indicacions es pot <ulink url="help:/simon/training.html#import_training-data"
>importar a Simon</ulink
>. </para>

  <para
>Per construir el diccionari adequat per compilar el model també podríeu desitjar llistar totes les frases contingudes al fitxer d'indicacions. Podeu fer-ho amb aquest script: <screen
>#!/bin/bash
      cat $1 | sed -e 's/[0-9\/]* //' | sort | uniq
    </screen>
  </para>
</sect1>
</chapter>


<chapter id="faq">
<title
>Preguntes i respostes</title>

<para
>En un esforç per mantenir aquesta secció sempre actualitzada està disponible al nostre <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Troubleshooting_Guide"
>wiki en línia</ulink
>. </para>

</chapter>

<chapter id="credits">
<title
>Crèdits i llicència</title>

<para
>&kmyapplication; </para>
<para
>Copyright del programa 2008-2010 Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

<para
>Copyright de la documentació &copy; 2009-2010 Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

<para
>Traductor de la documentació: &credits.Antoni.Bella;</para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instal·lació</title>
<para
>Si us plau, consulteu el <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Installation"
>nostre wiki</ulink
> per a les instruccions d'instal·lació.</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;
-->
