# O Manual do &jovie;

## Introdução

O &jovie; é um sub-sistema no &kde; para produzir Texto-para-Fala (TTS). Ele oferece uma API comum para os programadores do &kde; usarem as capacidades de TTS para as suas aplicações. Ele oferece algumas capacidades boas também para os utilizadores finais.

Funcionalidades do utilizador:

- Falar o conteúdo de um ficheiro de texto.

- Falar os eventos de notificação do &kde; (KNotify).

- Falar todo ou parte do texto de uma página Web no &konqueror;.

- Falar todo ou parte do texto no editor de texto &kate;, incluindo as instâncias em que o &kate; está incorporado noutra aplicação do &kde;.

- O texto é sintetizado através do 'speech-dispatcher', por isso poderá ser usada qualquer infra-estrutura do 'speech-dispatcher' (espeak, festival, &etc;)

- Filtros configuráveis pelo utilizador para substituir as palavras erradas, escolher os sintetizadores de voz e transformar os documentos em &XML;/XHTML.

Funcionalidades do programador:

- Um sistema de prioridades para o resultado do leitor do ecrã, dos avisos e das mensagens, enquanto reproduz à mesma os textos normais.

- Permite a geração de fala a partir da linha de comandos (ou através de 'scripts'), usando o utilitário &qdbus;.

- Oferece uma interface leve e fácil de usar para as aplicações gerarem conteúdos falados.

- As aplicações não precisam de se preocupar com a contenção sobre o dispositivo de voz.

- FUTURO: Oferecer o suporte para as linguagens de formatação de voz, como o VoiceXML, o Sable, a &Java; Speech Markup Language (JSML) e a Speech Markup Meta-language (SMML).

- FUTURO: Oferecer um suporte limitado para marcadores de voz incorporados.

- Assíncrono, para evitar o bloqueio do sistema.

O &jovie; consiste de facto em vários programas:

`jovie`

- o Servidor de Texto-para-Voz do &kde;, o qual é uma aplicação que oferece os serviços de TTS às aplicações através do &DBus;. Também reside na bandeja do sistema.

`libkhtmlkttsdplugin`

- Um 'plugin' para o navegador Web &konqueror; que lhe permite falar todo ou parte do texto numa página Web.

`ktexteditor_kttsd`

- Um 'plugin' para o editor de texto &kate; que lhe permite falar todo ou parte de um ficheiro de texto.

### Suporte

Para além da base de dados do Bugzilla do &kde; ( http://bugs.kde.org/ ), as discussões sobre o &jovie; tomam lugar de momento na lista de correio 'kde-accessibility'. Subscreva-se em https://mail.kde.org/mailman/listinfo/kde-accessibility. A equipa de desenvolvimento também costuma aparecer no IRC (irc.kde.org, canal #kde-accessibility).

## Usar o &jovie;

Antes de poder usar o &jovie;, deverá instalar pelo menos um motor de síntese de voz e garantir que este funciona. Veja em installation.

### Iniciar o `jovie`

Para iniciar o sistema do &jovie;, escreva o seguinte comando numa &konsole;

`jovie`

ou carregue no &jovie; no Menu do &kde;.

Se for a primeira vez que executar o `jovie`, ou se ainda não configurou nenhuns locutores, o ecrã de Locutores irá aparecer. Veja em configure-talkers. Se já tiver configurado pelo menos um locutor, o ecrã Geral aparece. Veja em general.

### Configurar os Locutores

A maioria dos sintetizadores de texto-para-fala (TTS) oferecem várias línguas e vozes e poderão oferecer vários sexos, volumes e taxas. Poderá configurar mais que uma instância de um sintetizador. Cada combinação de língua, sintetizador, voz, som, volume e taxa chama-se um locutor. É preciso configurar pelo menos um locutor antes de poder iniciar o &jovie;; caso contrário, o 'speech-dispatcher' irá usar uma voz predefinida.

Vários locutores para o mesmo sintetizador é semelhante a várias filas de impressão para uma única impressora física.

Quando carrega na página de Locutores do `jovie`, o ecrã de Locutores aparece. Este ecrã aparece também automaticamente se iniciar o `jovie` e não tiver configurado nenhuns locutores.

O Gestor de Texto-para-Voz do &kde; (página Locutores). O Gestor de Texto-para-Voz do &kde; (página Locutores)

- Carregue para adicionar um novo locutor.

- Todos os Locutores configurados estão aqui indicados. Os Locutores de maior prioridade encontram-se no topo. O Locutor do topo será usado para falar, quando uma aplicação não indicar nenhum locutor específico.

- Carregue num locutor da lista para o seleccionar e carregue neste botão para o remover.

- Carregue num locutor da lista para o seleccionar e carregue neste botão para mostrar a janela de configuração do mesmo. Veja em baixo.

- Carregue num locutor da lista para o seleccionar e carregue neste botão para o descer uma posição na lista. Quanto mais baixo estiver um locutor na lista, menor a sua prioridade.

- Carregue num destes botões para aplicar as alterações que tenha feito ao sistema &jovie; em execução.

Quando carregar no botão Adicionar, o ecrã para Adicionar um Locutor aparece.

O ecrã para Adicionar um Locutor. O ecrã para Adicionar um Locutor

- Deverá dar um nome ao seu novo orador, podendo ser qualquer texto.

- Escolha aqui a língua e o sintetizador.

- Escolha aqui o tipo de voz, existindo três vozes masculinas, três femininas, uma de criança masculina e uma de criança feminina por onde escolher.

- Defina aqui os outros parâmetros de voz personalizados.

- Quando carregar aqui, irá aparecer o seu novo locutor na lista da página Locutores. Carregue no botão Editar para mostrar ou editar a configuração do locutor.

Assumindo que o teste funcionou, já está quase pronto a começar a usar o &jovie;. Volte agora à página Geral e assinale a opção Activar o Sistema de Texto-para-Voz (Jovie). Isto irá iniciar o Servidor de TTS do &kde;. Veja em general. Poderá começar a usar agora o &jovie; para dizer o texto. Carregue na página Tarefas para criar e gerir as tarefas de texto. Veja em jobmgr.

### Iniciar o Jovie e Configurar as Opções Gerais

Logo que tenha configurado pelo menos um Locutor, poderá iniciar o Sistema de Texto-para-Voz do &kde;. Carregue na página Geral. Neste caso, aparecerá o ecrã Geral. Poderá também configurar algumas opções gerais neste ecrã.

O Gestor de Texto-para-Voz do &kde; (página Geral). O Gestor de Texto-para-Voz do &kde; (página Geral)

- Assinale esta opção para activar o sistema &jovie;. Isto irá iniciar o Servidor de TTS do &kde; (Jovie). Se o Jovie iniciar com sucesso, irá aparecer a página de Tarefas. Logo que o Jovie tenha sido iniciado, poderá começar a criar e a falar as tarefas de texto. Veja em jobmgr. Se desligar a opção, irá parar o Jovie e desactivar o sistema de TTS do &kde;.

- Não se esqueça de carregar aqui para gravar a sua configuração.

### Gerir as Tarefas de Texto

Quando carrega na página de Tarefas do `jovie`, o ecrã de Tarefas aparece.

O Gestor de Texto-para-Voz do &kde; (página Tarefas). O Gestor de Texto-para-Voz do &kde; (página Tarefas)

- Os controlos aqui permitem-lhe alterar os atributos da voz usada na fala actual.

- Os botões nesta barra de ferramentas permitem-lhe parar, cancelar, pôr em pausa e prosseguir a tarefa de texto actual.

- Os botões nesta barra de ferramentas permitem-lhe falar o texto na área de transferência do &kde; ou abrir um ficheiro de texto para falar. Poderá também modificar o locutor de uma tarefa.

- Certifique-se que carrega no botão Aplicar ou em OK para gravar todas as alterações da sua configuração (se existirem).

A página de Tarefas só aparece quando o Jovie está em execução. Se não conseguir ver a página Tarefas, vá à página Geral e assinale a opção Activar o Texto-para-Voz (Jovie).

### Falar o Texto das Páginas Web

Ao correr o navegador Web do &kde;, o &konqueror;, poderá falar o texto da página Web apresentada. Primeiro, garanta que o &jovie; está a correr. Seleccione o texto que deseja falar e escolha a opção Ferramentas Falar o Texto do menu principal.Depois de algum tempo, o texto seleccionado irá começar a ser falado.

É quase sempre uma boa ideia seleccionar o texto na página Web que deseja falar. Poderá ignorar este passo, mas irá ouvir um conjunto de cabeçalhos de &HTML; e outras marcas invisíveis.

### Falar o Texto do Editor de Texto &kate;

Ao correr o Editor de Texto Avançado do &kde; (&kate;=, poderá falar o texto apresentado. Primeiro, garanta que o &jovie; está a correr e active o 'Plugin' do Jovie para o KTextEditor na janela de configuração do &kate;. Seleccione o texto que deseja falar e escolha a opção Ferramentas Falar o Texto do menu principal.Depois de algum tempo, o texto seleccionado irá começar a ser falado.

Não tem de seleccionar primeiro o texto. Neste caso, o ficheiro inteiro será falado.

Isto também funciona quando o &kate; estiver incorporado noutra aplicação, como o &konqueror; ou o &quanta;.

### Falar as Notificações (KNotify)

O KNotify é o subsistema de notificações no &kde; que o alerta dos eventos que configurar no sistema do &kde;. Poderá configurar o &jovie; para falar as notificações de texto.

Por exemplo o &konversation;, uma aplicação de IRC para o &kde;, permite-lhe configurar uma variedade grande de notificações. Por exemplo, poderá dizer ao &konversation; para o notificar sempre que uma mensagem apareça num canal de IRC com o seu nome ou alcunha nela. Em conjunto com o &jovie;, poderá fazer com que o &kde; fale o texto da mensagem de IRC para si.

De um modo geral, se uma aplicação do &kde; suportar o KNotify, irá aparecer um item de menu Notificações no menu de Configuração. Os detalhes específicos para configurar cada uma das aplicações com o KNotify variam de aplicação para aplicação.

Os filtros de Substituição de Texto são uma boa forma de limpar as mensagens que são enviadas das aplicações, se forem mal pronunciadas ou mal ditas no &jovie;. O ficheiro `kmail.xml`, que vem com o &jovie;, é um bom exemplo. Ele remove as marcas `br` e `b` das mensagens de notificação do &kmail; e remove também a frase `/local/inbox/`, dado que esta poder-se-á assumir, na maior parte dos casos, em segurança. Veja em stringreplacer.

### Filtros (Avançado)

Os filtros são uma funcionalidade avançada do &jovie;. Para a operação básica do &jovie;, estes não são necessários.

Os filtros são usados para pré-processar o texto antes de ser enviado para o 'speech-dispatcher'. Eles são úteis para melhorar a voz, substituindo palavras ou abreviaturas erradas, escolher a língua e locutor apropriados para a fala ou para contornar certas limitações dos sintetizadores de voz e das suas vozes.

#### Tipos de Mensagens do &jovie;

Para compreender como usar os filtros, é útil compreender primeiro como é que o texto é processado pelo 'speech-dispatcher'. O texto falado pelo &jovie; é de um de quatro tipos possíveis.

- Resultado do Leitor do Ecrã.

- Avisos.

- Mensagens

- Tarefas de Texto

O tipo é determinado pela aplicação que envia o texto para o &jovie;.

O Resultado do Leitor do Ecrã tem a maior prioridade. Está reservado para as aplicações de Leitura do Ecrã. O Resultado do Leitor faz a preempção de todas as outras mensagens, fazendo com que essas tarefas fiquem em pausa. Logo que o Resultado do Leitor do Ecrã tenha sido sintetizado, as tarefas anteriores irão prosseguir automaticamente.

Os avisos são a próxima prioridade mais elevada. Está reservada para as mensagens de alta prioridade, como "o CPU está a aquecer". Um aviso irá interromper as mensagens e o texto normal. Logo que o Aviso tenha sido sintetizado, as tarefas anteriores irão prosseguir automaticamente.

As mensagens são a próxima prioridade. Uma mensagem irá interromper as tarefas de texto normal. O KMouth é um exemplo de uma aplicação que usa as Mensagens. Por exemplo, ao ler um texto longo de uma página Web, o &kmouth; pode ser usado para cumprimentar alguém que ande pela sala. As Notificações do &kde; são também mensagens (veja em knotify).

O restante são as tarefas de texto normais. Qualquer tarefa que iniciar, a partir da página de Tarefas, é uma tarefa de texto. O KSayit é um exemplo de uma aplicação que usa tarefas de texto. As tarefas de texto pretendem ser usadas para um resultado de fala maior e que não seja urgente.

Todos os tipos de tarefas são filas, excepto o Resultado do Leitor do Ecrã. Se um Resultado do Leitor do Ecrã for enviado de uma aplicação enquanto o &jovie; estiver a falar outro Resultado destes, a mensagem a ser falada é interrompida e eliminada.

#### Tipos de Filtros

A primeira coisa que terá de saber acerca dos filtros é que estes nunca são aplicados ao Resultado da Leitura do Ecrã. Eles aplicam-se aos avisos, mensagens e tarefas de texto, assim como as notificações do &kde; (KNotify).

Os filtros processam o texto e passam-no ao próximo filtro. Existem de momento três tipos de filtros.

- Substituição de Texto.

- Transformações de &XML;

- Selecção de Locutores.

Os filtros são implementados numa arquitectura de 'plugins'. No futuro, poderão existir tipos adicionais de filtros.

Os filtros de Substituição de Texto substituem excertos de texto por outros. Os pedaços substituídos são correspondidos quer com palavras quer com expressões regulares. O &jovie; vem com alguns filtros de Substituição de Texto predefinidos para falar abreviaturas, falar os ícones emotivos, como o ":-)" ou para formatar de novo as mensagens de notificação do &konversation; ou do &kmail; num formato mais compreensível.

As Transformações de &XML; usam um ficheiro &XML; Style Language - Transforms (XSLT) para converter o &XML; de um formato noutro formato. O &jovie; vem com um ficheiro XSLT para converter o &XHTML; em SSML.

Os Selectores de Locutores permitem-lhe redireccionar as tarefas para um locutor com base no conteúdo do texto ou na aplicação que enviou o texto para o &jovie;. Por exemplo, se tiver configurado uma locutora feminina na página de Locutores, poderá direccionar o texto que vem do KSayIt para esse locutor. Veja em configure-talkers.

Cada um desses tipos de filtros tem regras configuráveis para quando o filtro se deverá aplicar a si mesmo no texto a falar. Se o filtro determinar que não se deverá aplicar, o texto é passado ao próximo filtro sem alterações.

Quando uma Tarefa de Texto, Mensagem, Aviso ou Notificação do &kde; é enviada para o &jovie;, ela passa por cada um dos filtros activos que tenha configurado no ecrã abaixo. A ordem de cima para baixo.

#### Configurar os Filtros

Para utilizar filtros, carregue na página Filtros do `jovie`.

O Gestor de Texto-para-Voz do &kde; (página Filtros). O Gestor de Texto-para-Voz do &kde; (página Filtros)

- Esta é a lista de filtros normais configurados. Se estiver desligada, o filtro está desactivado e será ignorado. Os filtros são aplicados pela ordem aqui indicada, de cima para baixo.

- Carregue aqui para adicionar um filtro novo. Ser-lhe-á pedido o tipo de filtro a adicionar. Depois de adicionar o tipo, veja as janelas de configuração em baixo.

- Carregue aqui para remover um filtro.

- Carregue aqui para mudar a configuração de um filtro. Veja as janelas de configuração em baixo.

- Carregue nestes botões para subir ou descer um filtro na lista.

- Certifique-se que carrega aqui, caso contrário a sua configuração não fará efeito.

#### Configurar os Filtros de Substituição de Texto

Você configura os filtros de Substituição de Texto, indicando uma lista de palavras ou expressões regulares com as quais faz a correspondência. Quando estas palavras ou expressões forem encontradas no texto, cada uma delas será substituída por uma dada sequência fornecida por si. A correspondência não faz distinção entre maiúsculas e minúsculas.

Substituição de Textos Substituição de Textos

- Indique um nome para o seu filtro. Use qualquer nome que desejar, que lhe permita distinguir de todos os outros filtros.

- Esta é a lista de palavras e expressões regulares. O filtro procura pelas ocorrências de cada uma destas sequências na coluna de Correspondência, substituindo o texto correspondente pelo texto na coluna Substituir Por. A lista é processada pela ordem apresentada, de cima para baixo.

- Carregue para adicionar outra palavra ou expressão regular à lista.

- Carregue aqui para mover a palavra ou expressão regular seleccionada para cima ou para baixo na lista.

- Carregue para alterar uma palavra ou expressão regular existente na lista.

- Carregue para remover a palavra ou expressão regular seleccionada da lista.

- Use estes botões para carregar uma lista de palavras ou expressões regulares de um ficheiro, gravar a lista actual para um ficheiro ou limpar a lista inteira. Ao carregar a partir de um ficheiro, os itens do ficheiro serão adicionados à lista existente.

- Se não estiver em branco, o filtro aplicar-se-á apenas se a língua do locutor da tarefa de texto corresponder à língua indicada aqui. Carregue no botão para mostrar uma lista de línguas. Poderá seleccionar mais que uma língua se mantiver a tecla &Ctrl; carregada enquanto faz a escolha.

- Se não estiver em branco, o filtro aplicar-se-á apenas se o texto vier de uma das aplicações listadas. Poderá indicar mais que uma aplicação, separando-as por vírgulas. Exemplo: ``konversation,knotify``

  Você poderá descobrir o ID da Aplicação dos programas em execução com o programa `&qdbus;`. Deverá retirar os números do &DBus;. Por exemplo, se o &qdbus; mostrar um ID de aplicação igual a `kopete-3432`, você deverá apenas indicar ``kopete``.

O filtro de Substituição de Texto aplicar-se-á apenas se todas as condições preenchidas forem cumpridas na opção Aplicar Este Filtro Quando; se todas as opções estiverem em branco, o filtro aplicar-se-á a todo o texto.

Ao corresponder as palavras, o filtro de Substituição de Texto usa internamente uma expressão regular no formato `\s`palavra`\s`. Doutra forma, a palavra deverá ter limites de palavras (espaços) de cada um dos lados.

A discussão de como criar expressões regulares está fora do âmbito deste manual. Se tiver o Editor de Expressões Regulares do &kde; instalado, existe um botão disponível nos ecrãs Adicionar ou Editar que o irá ajudar a construir expressões regulares. O Editor de Expressões Regulares do &kde; faz parte do pacote `kdeutils`.

O &jovie; vem alguns ficheiros de listas de palavras, incluindo uma lista de ícones emotivos, como o ":-)", algumas abreviaturas usadas tipicamente no IRC ou nas aplicações de mensagens instantâneas, bem como uma lista com outras abreviaturas. Existe também uma lista de caracteres especiais que a versão actual da voz do Festival em polaco não consegue lidar. Se você desenvolver listas de de palavras úteis suas, use o botão Gravar para as gravar num ficheiro e para as enviar para a equipa do &jovie;, de modo a serem incluídas na próxima versão.

#### Configurar os Filtros de Transformação de &XML;

O filtro de Transformação de &XML; usa ficheiros XSLT para transformar o &XML; de um formato noutro. A XSLT, &XML; Style Language - Transforms, é uma linguagem normalizada do W3C para efectuar essas transformações. Só poderá ser usada em &XML; válido. Para além disso, deverá também ter o utilitário `xsltproc` instalado.

Transformação de &XML; Transformação de &XML;

- Indique um nome para o seu filtro. Use qualquer nome que desejar, que lhe permita distinguir de todos os outros filtros.

- Indique a localização completa de um ficheiro XSLT existente, o qual irá efectuar a transformação.

- Indique a localização do utilitário `xsltproc`. Se o 'xsltproc' estiver na sua variável de ambiente PATH, basta indicar ``xsltproc``.

- Se não estiver em branco, o filtro aplicar-se-á apenas se o &XML; tiver uma indicação `<!DOCTYPE` que comece pelo texto indicado. Isto distingue uma forma de &XML; de outra. Por exemplo, o ``html`` irá corresponder ao `<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" >`.

- Se não estiver em branco, o filtro aplicar-se-á apenas se o texto vier de uma das aplicações listadas. Poderá indicar mais que uma aplicação, separando-as por vírgulas. Exemplo: ``konversation,knotify``

  Você poderá descobrir o ID da Aplicação dos programas em execução com o programa `&qdbus;`. Deverá retirar os números do &DBus;. Por exemplo, se o &qdbus; mostrar um ID de aplicação igual a `kopete-3432`, você deverá apenas indicar ``kopete``.

O filtro de Transformação de &XML; aplicar-se-á apenas ao texto se o elemento de raiz ou DOCTYPE indicados corresponderem e se o ID da aplicação corresponder na área Aplicar Este Filtro Quando. Se algum item desta área estiver em branco, o teste não será efectuado, como tal, se todos os campos estiverem em branco, o filtro aplicar-se-á a todo o texto. Contudo, deverá preencher pelo menos um campo, dado que diversas tarefas de texto não estarão no formato &XML;.

#### Configurar os Filtros de Selecção do Locutor

Os filtros de Selecção do Locutor são usados para direccionar o texto para um determinado locutor que esteja configurado na página Locutor ou para qualquer locutor que tenha os atributos indicado. Por exemplo, poderá indicar que o texto que vem do `knotify` deverá ser falado por uma locutora feminina. Veja em configure-talkers.

Antes de o &jovie; começar a enviar o texto para cada um dos filtros, ele selecciona um locutor para falar o texto. O locutor escolhido baseia-se nos atributos de locução indicados pela aplicação que enviou o texto para o &jovie; e os atributos que você tenha configurado na página Locutores. O filtro de Selecção do Locutor permite-lhe sobrepor o locutor escolhido.

Escolha do Locutor Escolha do Locutor

- Indique um nome para o seu filtro. Use qualquer nome que desejar, que lhe permita distinguir de todos os outros filtros.

- Se não estiver em branco, o filtro aplicar-se-á apenas se o texto contiver a expressão regular indicada. Se estiver instalado, carregue no botão de escolha para lançar o Editor de Expressões Regulares do &kde; para o ajudar a introduzir a expressão regular.

  Para uma melhor performance, tente "anexar" a expressão regular ao início do texto. Por outras palavras, inicie a sua expressão regular por um ``^``.

- Se não estiver em branco, o filtro aplicar-se-á apenas se o texto vier de uma das aplicações listadas. Poderá indicar mais que uma aplicação, separando-as por vírgulas. Exemplo: ``konversation,knotify``

  Você poderá descobrir o ID da Aplicação dos programas em execução com o programa `&qdbus;`. Deverá retirar os números do &DBus;. Por exemplo, se o &qdbus; mostrar um ID de aplicação igual a `kopete-3432`, você deverá apenas indicar ``kopete``.

- Indique os atributos do locutor que prefere para falar o texto aqui. Se o texto corresponder às condições do filtro acima indicados, será escolhido o locutor que mais se aproxime aos atributos que indicar aqui. Carregue no botão à direita para mostrar o ecrã para Seleccionar o Locutor.

- Use estes botões para gravar a sua configuração de Selecção do Locutor, carregar a configuração a partir de um ficheiro gravado ou limpar toda a configuração.

O filtro de Selecção do Locutor aplicar-se-á apenas ao texto se todas as condições preenchidas forem cumpridas na opção Aplicar este Filtro Quando. Terá de preencher pelo menos um dos campos.

## Referência de Comandos

A FAZER

## Guia de Programação do &jovie;

O &jovie; tem duas Interfaces de Programação de Aplicações (APIs):

- A API de Texto-para-Voz do &kde;, que é usada pelos programadores das aplicações para oferecerem às suas aplicações capacidades de TTS. As aplicações comunicam com o &jovie; através de &DBus;.

- A API de 'Plugins' do &jovie;, que é usada para adicionar 'plugins' de síntese de voz ao &jovie;, para que o &jovie; funcione com motores novos de síntese de voz.

A secção seguinte dá uma breve descrição da API da Interface em &DBus; de Texto-para-Voz do &kde;. A documentação completa para ambas as APIs está disponível na página Web de Acessibilidade no &kde;.

### A Interface de &DBus; do &jovie;

As aplicações comunicam os pedidos de serviços de Texto-para-Voz através da interface de &DBus; do &kde; para programar o objecto `KSpeech` do `jovie`.

Indique os seguintes comandos numa &konsole;.

Se o &jovie; não estiver já a correr

`jovie`

Para agendar uma tarefa de texto a ser falada

`qdbus org.kde.jovie /KSpeech say "`texto`" "`opções`"`

onde o ``texto`` é o texto que pretende ser sintetizado e as ``opções`` são um código de língua do tipo ``en``, ``pt``, &etc;

Exemplo.

`qdbus org.kde.jovie /KSpeech say "Isto é um teste." "pt"`

Existem muitos mais comandos que poderão ser enviados. Para ver uma lista dos comandos possíveis,

`qdbus org.kde.jovie /KSpeech`

ou leia a página da API de Texto-para-Voz do &kde;.

## Perguntas e Respostas

&reporting.bugs; &updating.documentation;

Preciso de recomeçar tudo. Como é que eu interrompo por completo o &jovie;?

Indique os seguintes comandos numa &konsole;:

    kquitapp jovie

Como é que vejo o resultado de depuração do `jovie`?

Abra uma janela do &konsole;. Depois inicie o `jovie`.

Nenhum dos sintetizadores de voz suportados tem a língua que eu necessito. Onde é que poderei obter um sintetizador para a minha língua?

O Google(tm) é seu amigo. Esta referência também poderá ajudar. Se descobrir um motor aberto que suporte a sua língua desejada e quiser adicionar o suporte para ele no &jovie;, por favor contacte a equipa de desenvolvimento. Os motores abertos são especialmente bem-vindos. Se conhecer algum sintetizador comercial, talvez consiga persuadir o distribuidor a doar uma cópia gratuita à equipa de desenvolvimento do &jovie;. Entretanto, poderá conseguir pôr o sintetizador a funcionar com a infra-estrutura do comando 'speech-dispatcher'.

Tenho o filtro de Transformação de &XML; para &HTML; configurado, mas as páginas Web não são faladas de todo com o 'plugin' do Festival.

Devido a um erro no Festival 1.95 beta, terá de instalar a voz `rab_diphone` (homem Britânico) para o SABLE funcionar de todo, mesmo que não esteja a usar essa voz para falar as páginas Web. Do mesmo modo, verifique se o utilitário `xsltproc` está instalado e na PATH.

Certos caracteres ou pontuações parecem estar a produzir erros no sintetizador, fazendo-o saltar frases inteiras ou pronunciar lixo. O que posso fazer?

Primeiro, certifique-se que a opção de Codificação de caracteres da janela de configuração do locutor está bem definida para a língua. Se algumas palavras ou caracteres estiverem a causar problemas, poderá ajudar ter um filtro de Substituição do Texto. Veja em filters.

## Créditos e Licença

&jovie;

Programa Copyright © 2002 José Pablo Ezequiel "Pupeno" Fernández pupeno@kde.org

Manutenção Actual: Jeremy Whiting jpwhiting@kde.org

Contribuições:

- Gary Cramblitt garycramblitt@comcast.net

- Olaf Schmidt ojschmidt@kde.org

- Gunnar Schmi Dt gunnar@schmi-dt.de

- Paul Giannaros ceruleanblaze@gmail.com

Documentação com 'copyright' © 2009 de Jeremy Whiting jpwhiting@kde.org © 2004 Gary R. Cramblitt garycramblitt@comcast.net

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;

Os motores de síntese de voz usados pelo &jovie; têm as suas próprias licenças. Veja a documentação de cada motor ou a sua página na Web para mais detalhes. Algumas das vozes também têm as suas próprias licenças.

## Instalação

### Como obter o &jovie;

&install.intro.documentation;

Comando de Instalação da Debian: `apt-get install kdeaccessibility`

Poderá encontrar algumas referências para os pacotes de código e binários na página Web de Acessibilidade do &kde; (http://accessibility.kde.org).

Se tiver acesso ao repositório de código do &kde;, poderá obter o &jovie; através do módulo `kdeaccessibility`. O &jovie; encontrar-se-á na pasta `jovie`. Poderá também obter um pacote criado todas as noites em ftp://ftp.kde.org/pub/kde/

### Requisitos

Requisitos obrigatórios:

- &kde; versão 4.4 ou posterior.

- 'speech-dispatcher' versão 0.67 ou posterior.

- Um sintetizador de voz. São suportados os seguintes sintetizadores e línguas faladas.

  Espeak | Maioria das línguas; verifique em http://espeak.sourceforge.net/languages.html a lista actual das línguas suportadas
  Festival | Inglês Americano, Inglês Britânico, Espanhol, Alemão, Finlandês, Checo, Polaco, Russo, Italiano, Francês do Canadá, Kiswahili, Zulu e Ibibio

  Funciona também com qualquer motor de síntese que possa ser executado com um comando numa &konsole;.

  As línguas indicadas acima poderão não ser compreensíveis ou estar desactualizadas. Veja também a página do &jovie; para obter mais informações que possa não ter estado incluída neste manual.

  O 'speech-dispatcher' usa uma arquitectura de 'plugins' flexível para os motores de síntese de voz. Se quiser melhorar o &jovie; de modo a suportar outro motor, contacte a equipa de desenvolvimento.

  Veja em configuration as instruções específicas para cada um destes motores.

Componentes opcionais:

- O utilitário `xsltproc` é necessário para o suporte de SSML e para o filtro de transformação &XML;, mas não é obrigatório. Os utilizadores de Debian poderão instalar o 'xsltproc' com o comando `apt-get install xsltproc`.

### Compilação e Instalação

Para poder compilar o &jovie;, você precisa de ter uma cópia recente (&kde; 4.4 ou superior) dos ficheiros de desenvolvimento do &kde;, incluindo o 'kdelibs' e o 'speech-dispatcher'.

Se obteve o código do &jovie; a partir do módulo do repositório de código `kdeaccessibility` ou através dos pacotes TAR nocturnos do repositório de código, use os seguintes comandos para compilar e instalar.

    cd kdeaccessibility
    mkdir build
    cd build
    cmake ../
    make
    sudo make install

### Configuração

Certifique-se que o 'speech-dispatcher' está a funcionar com o seu motor de síntese de voz antes de usar o &jovie;. O programa 'spd-conf' pode ser usado para isso.

O &jovie;, no &kde; 4.5, é uma mudança de nome do KTTSD e do 'kttsmgr'. No futuro, o &jovie; será capaz de configurar o 'speech-dispatcher' directamente, sem usar o 'spd-conf'.

&documentation.index;