<?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
>Kira</firstname
><surname
>J. Fernández</surname
><affiliation
><address
><email
>kirajfdez@gmail.com</email
></address
></affiliation
><contrib
>Traductora</contrib
></othercredit
> <othercredit role="translator"
><firstname
>Javier</firstname
> <surname
>Viñal</surname
> <affiliation
><address
><email
>fjvinal@gmail.com</email
></address
> </affiliation
><contrib
>Traductor</contrib
></othercredit
> 

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

<abstract>
<para
>&kmyapplication; es el componente del servidor de la herramienta de adquisición de muestras de SSC. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>muestra</keyword>
<keyword
>habla</keyword>
<keyword
>voz</keyword>
<keyword
>adquisición</keyword>
<keyword
>grabación</keyword>
<keyword
>accesibilidad</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ón</title>

<para
>&kmyapplication; es el componente del servidor de la herramienta de adquisición de muestras de SSC. </para>
<para
>Gestiona datos del ponente (usuarios, instituciones), además de metadatos de muestra usando una base de datos y almacena las muestras. </para>
<para
>Recibe entrada desde los clientes SSC que se conectan al servidor usando TCP/IP. </para>

<para
>Para más información sobre la arquitectura general de la suite Simon, por favor consulte el <ulink url="help:/simon/overview.html#architecture"
>Manual de Simon</ulink
>. Para información sobre el cliente SSC, por favor consulte el <ulink url="help:/ssc"
>Manual de SSC</ulink
>.</para>
</chapter>

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

<para
>&kmyapplication; es una aplicación de línea de órdenes que no tiene interfaz de usuario. No hay parámetros especiales de ejecución.</para>


<sect1 id="sscd_folder">
  <title
>Carpeta base</title>
  <para
>La carpeta base de &kmyapplication; contiene el archivo de configuración <filename
>sscd.conf</filename
> y un registro de errores en el caso de que algo vaya mal. Esta carpeta también contiene la subcarpeta <filename
>muestras</filename
>, donde se almacenan todas las muestras.</para>

<para
>La ubicación de la carpeta de SSCd depende de su sistema operativo: <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 de instalación de sscd.exe (generalmente: C:\Archivos de programa\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
>Configuración</title>

  <para
>No hay configuración gráfica de SSCd, pero hay un archivo de configuración (<filename
>sscd.conf</filename
>) almacenado en la <link linkend="sscd_folder"
>Carpeta SSCd</link
>.</para>

  <para
>El archivo de configuración predeterminado está comentado en detalle y debería explicarse por sí mismo.</para>

  <para
>Antes de ejecutar SSCd, querrá al manos cambiar la base de datos de usuario y la entrada de contraseña de la base de datos en el archivo de configuración. Consulte <link linkend="database"
>la sección de base de datos</link
> para más información.</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
>Base de datos</title>

  <para
>&kmyapplication; almacena los datos del ponente y de las muestras (pero no las muestras en sí mismas) en una base de datos. Por el momento, solo se admiten completamente las bases de datos en MySQL. Sin embargo, añadir compatibilidad para una nueva base de datos es muy sencillo. Contacte con el <ulink url="mailto:kde-accessibility@kde.org"
>Equipo de Simon</ulink
> si quiere ayudar.</para>

  <para
>Para configurar las tablas requeridas, &kmyapplication; viene con un guion <filename
>mysql_create_script.sql</filename
> instalado en la <link linkend="sscd_folder"
>carpeta base</link
> de &kmyapplication;.</para>


  <para
>Los errores de la base de datos se pueden encontrar en <filename
>error.log</filename
>, que también reside en la carpeta base.</para>

</sect1>

<sect1 id="locked_mode">
  <title
>Modo bloqueado</title>


  <para
>SSCd toma opcionalmente el argumento de línea de órdenes «-l» (0 «--locked») para activar el modo «bloqueado» (desactivado por omisión).</para>

  <para
>En el modo bloqueado, los clientes todavía pueden conectarse y enviar muestras, así como crear nuevos micrófonos y tarjetas de sonido, pero no disponen de otros accesos (lectura o escritura) a datos personales o institucionales más allá del usuario e id. Esto puede ser útil para limitar la cantidad de información privada de pacientes mostrada a los equipos de grabación.</para>

  <para
>Mientras el modo bloqueado está activo, tampoco se dispone de búsqueda de usuarios por lo que debe asegurase que a su equipo de grabación se le proporciona con una lista de ids de usuario de antemano.</para>
</sect1>

<sect1 id="extracting_samples">
  <title
>Extraer muestras recogidas</title>

  <para
>Para generar modelos usando las muestras recogidas con &kmyapplication;, primero debe extraerlas de la base de datos.</para>

  <warning>
    <para
>Como &kmyapplication; está diseñado para la adquisición a gran escala de muestras, no es amigable para el usuario final. La documentación de abajo se proporciona principalmente a profesionales con habilidades técnicas. </para>
    <para
>La mayoría de los guiones de abajo necesitan las herramientas GNU (habitualmente disponibles por omisión en GNU/Linux). </para>
  </warning>

  <para
>Puede usar la siguiente consulta (serán necesarios ajustes menores dependiendo de qué muestras necesite exactamente): <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
>Esta consulta listará todas las muestras de la entidad 3 que se grabaron con el micrófono 1.</para>

  <para
>Puede, por ejemplo, usar este guion para crear un archivo de entrada: <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
>Estos archivos de indicaciones pueden <ulink url="help:/simon/training.html#import_training-data"
>importarse en Simon</ulink
>. </para>

  <para
>Para crear el diccionario apropiado para compilar el modelo, puede que también quiera listar todas las frases contenidas en el archivo de entrada. Puede hacerlo con este guion: <screen
>#!/bin/bash
      cat $1 | sed -e 's/[0-9\/]* //' | sort | uniq
    </screen>
  </para>
</sect1>
</chapter>


<chapter id="faq">
<title
>Preguntas y respuestas</title>

<para
>En un esfuerzo por mantener esta sección siempre actualizada, está disponible nuestra <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Troubleshooting_Guide"
>wiki en línea</ulink
>. </para>

</chapter>

<chapter id="credits">
<title
>Créditos y licencia</title>

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

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

<para
>Traducido por Kira J. Fernández <email
>kirajfdez@gmail.com</email
> y Javier Viñal <email
>fjvinal@gmail.com</email
>.</para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalación</title>
<para
>Por favor, consulte nuestra <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Installation"
>wiki</ulink
> para las instrucciones de instalación.</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;
-->
