<?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
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>zepires@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 


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


<abstract>
<para
>O &kmyapplication; é a componente de servidor do pacote de reconhecimento de fala Simon. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>reconhecimento</keyword>
<keyword
>fala</keyword>
<keyword
>voz</keyword>
<keyword
>comando</keyword>
<keyword
>controlo</keyword>
<keyword
>acessibilidade</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
>O Manual do &kmyapplication;</title>
</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>O &kmyapplication; é a componente de servidor do pacote de reconhecimento de fala Simon. Ele lida com o reconhecimento e com a compilação do modelo, recebendo os dados dos clientes do Simon que se ligam através de TCP/IP. </para>
<para
>Para mais informações, veja o <ulink url="help:/simon/overview.html#architecture"
>manual do Simon</ulink
>.</para>
</chapter>

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

<para
>O Simond é uma aplicação da linha de comandos que não tem qualquer interface de utilizador. Não existem parâmetros de lançamento especiais.</para>

<para
>Contudo, o Simond instala um KCM que aparece na configuração do sistema KDE e que poderá ser acedido directamente com a aplicação <command
>kcmshell4</command
>: <itemizedlist
> <listitem
><para
><command
>kcmshell4 simondconfiguration</command
></para
></listitem>
</itemizedlist>
</para>

<para
>Dado que o Simond compila o modelo de fala (se for indicado para o fazer pelos clientes do Simon), a compilação do modelo de fala é também relevante, obviamente, quando administrar o Simond. Podê-la-á abrir se usar o <command
>kcmshell4</command
>: <itemizedlist
> <listitem
><para
><command
>kcmshell4 simonmodelcompilationconfig</command
></para
></listitem>
</itemizedlist>
</para>

<para
>Ao usar num ambiente gráfico (se não souber o que é isto, provavelmente já está a usar um), recomenda-se que use a interface gráfica <command
>ksimond</command
>, que também fornece o acesso aos módulos de configuração através da sua janela de configuração. Veja mais detalhes no manual do KSimond.</para>


<sect1 id="user_configuration">
<title
>Configuração do Utilizador</title>

<para
>Se usar a configuração do utilizador, poderá definir, editar e remover utilizadores, bem como os seus modelos, do servidor.</para>

<para>
<screenshot>
<screeninfo
>Imagem da configuração do utilizador do Simond</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="simond_user_config.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>configuração do utilizador do Simond</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

<para
>O Simond identifica as suas ligações com uma combinação de utilizador / senha que é completamente independente do sistema operativo subjacente e dos seus utilizadores (o que significa que terá de configurar pelo menos um utilizador para o Simond o usar). Todos os clientes do Simon se autenticam no servidor com essa combinação de utilizador / senha que identifica um dado utilizador e, como tal, um único modelo de fala.</para>

<para
>Os utilizadores são guardados numa base de dados em SQLite que é gerida através do KCM <command
>simonduserconfiguration</command
>.</para>

<para
>Esta base de dados é guardada num local que depende do seu sistema operativo: <table frame='all'
><title
>Armazenamento da base de dados de utilizadores do Simond</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
>O Simond vem de facto com um utilizador predefinido, pelo que não terá de adicionar um utilizador antes de poder ligar o Simon ao servidor Simond.</para>

<para
>O utilizador predefinido chama-se "default" e a senha é a "nopassword".</para>

<para
>A senha dos utilizadores será codificada e não poderá ser apresentada em texto simples. Quando um utilizador se esquece da sua senha, não existe nenhuma forma de recuperar a senha original a partir da base de dados do Simond, se bem que a poderá reiniciar com o botão "Mudar a Senha".</para>

<para
>Ao remover um utilizador da base de dados que já tem um modelo de fala associado a ele, ser-lhe-á questionado se deseja remover o modelo. Se responder negativamente e adicionar um utilizador com o mesmo nome mais tarde, ele irá começar com este modelo de fala.</para>

<para
>Ao seleccionar a opção <guibutton
>Manter as amostras do reconhecimento</guibutton
>, as amostras com que o reconhecimento funciona não serão apagadas. Isto significa que, durante uma operação normal, os utilizadores irão recolher tudo o que dizem com a transcrição mais provável devolvida pelo &kmyapplication;. Isto pode ser usado para recolher automaticamente os dados de treino enquanto usa o Simon. As amostras serão guardadas em diferentes locais, dependendo do seu sistema operativo: <table frame='all'
><title
>Armazenamento das amostras de reconhecimento do Simond</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\(utilizador)\recognitionsamples</filename
></entry>
  <entry
><filename
>~/.kde/share/apps/simond/models/(utilizador)/recognitionsamples</filename
></entry>
</row>
</tbody>
</tgroup>
</table>
</para>

<para
>Quando vários clientes se ligam ao Simond com o mesmo utilizador em simultâneo, irão usar uma instância de reconhecimento conjunta. Na prática, isto significa que vários clientes poderão fornecer dados em áudio (vários microfones) e todos os clientes ligados com o mesmo utilizador irão receber todos os resultados destes dados. Para evitar este comportamento, e assim forçar caminhos de reconhecimento separados, active o <guibutton
>Modo Isolado</guibutton
>.</para>
</sect1>

<sect1 id="network_configuration">
<title
>Configuração de Rede</title>
<para
>Ao usar a configuração da rede, o utilizador poderá alterar o porto usado pelo servidor e restringir o acesso a um dado IP.</para>

<note
><para
>Se não souber o que são os servidores, portos ou IP's, é porque provavelmente os valores predefinidos estão bem.</para
></note>
<para>
<screenshot>
<screeninfo
>imagem da configuração de rede do Simond</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="simond_network_config.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>configuração da rede do Simond</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

<para
>O porto poderá ser mudado à vontade. O valor predefinido 4444 normalmente não é ocupado por nenhuma aplicação ou protocolo importante, pelo que é um valor recomendado. Se ajustar aqui o porto, certifique-se que faz também os ajustes necessários nos seus clientes do Simon.</para>

<para
>Se usar a opção "Permitir apenas as ligações de", poderá restringir o acesso ao seu servidor a partir de qualquer lado, exceptuando o endereço IP indicado. Por omissão, este está configurado para permitir apenas as ligações do Simon a partir da máquina local, o que só dá permissões aos clientes locais para se ligarem ao servidor.</para>
<para
>Isto é apenas uma medida de segurança, porque efectivamente bloqueia as ligações de outros pontos quaisquer (mesmo que o atacante saiba o seu utilizador e senha do Simon). Para permitir ligações de outras máquinas, basta desligar a opção.</para>

<para
>Para além disso, o acesso de escrita poderá ser restrito para uma dada máquina. Isto permite executar servidores "públicos", onde os utilizadores se podem ligar e usar o reconhecimento, mas não têm permissão para iniciar qualquer forma de sincronização.</para>

<para
>A encriptação do protocolo ainda não está implementada.</para>
</sect1>

<sect1 id="speech_model_compilation_configuration">
<title
>Configuração da Compilação do Modelo de Fala</title>
<para
>O Simon compila o modelo de fala através da utilização de aplicações externas.</para>

<para
>Embora o Simon descubra os executáveis necessários, caso estejam na PATH do seu sistema, poderá também substituir estes valores automáticos nesta página de configuração.</para>

<para
>Aqui também poderá alterar a infra-estrutura de reconhecimento seleccionada, no caso dos modelos gerados pelo utilizador. Dependendo da sua instalação do Simon, nem todas as infra-estruturas poderão estar disponíveis.</para>

<para>
<screenshot>
<screeninfo
>imagem da configuração da compilação do modelo de fala</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="simond_speech_model_config.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>configuração do modelo de fala do Simond</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

</sect1>

</chapter>


<chapter id="faq">
<title
>Perguntas e Respostas</title>

<para
>Num esforço para manter esta secção sempre actualizada, a mesma está disponível na nossa <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Troubleshooting_Guide"
>Wiki 'online'</ulink
>. </para>

</chapter>

<chapter id="credits">
<title
>Créditos e Licença</title>

<para
>&kmyapplication; </para>
<para
>Programa com 'copyright' 2008-2012 de Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

<para
>Documentação com 'copyright' &copy; 2009-2012 de Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

<para
>Tradução de José Nuno Pires <email
>zepires@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalação</title>
<para
>Por favor, consulte as instruções de instalação na nossa <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Installation"
>Wiki</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;
-->
