# El manual del &jovie;

## Introducció

El &jovie; es un subsistema dins de &kde; per a produir text-a-veu (Text-To-Speech en anglès, o TTS). Proveeix una API comuna als programadors del &kde; per a donar capacitats TTS a les seves aplicacions. També proporciona algunes capacitats interessants per als usuaris finals.

Característiques per als usuaris:

- Parla el contingut d'un fitxer de text.

- Parla les notificacions d'esdeveniment de &kde; (KNotify).

- Parla tot o part del text d'una pàgina web en &konqueror;.

- Parla tot o part del text en l'editor de text &kate;, incloent les instàncies en les que &kate; estigui encastat en una altra aplicació &kde;.

- La veu es pronuncia via «speech-dispatcher», per tant, es pot utilitzar qualsevol dorsal a «speech-dispatcher» (espeak, festival, &etc;)

- Filtres configurables per l'usuari per a substituir les paraules que no es poden llegir, escollint els sintetitzadors de veu i transformant els documents XHTML/&XML;.

Característiques per als programadors:

- Sistema de prioritats per a la lectura de sortides per pantalla, avisos i missatges, mentre s'estan reproduint texts normals.

- Permet la generació de veu des de la línia d'ordres (o a través d'scripts shell) usant la utilitat &qdbus;.

- Proveeix una interfície lleugera i fàcil d'usar per a que les aplicacions generin sortides de veu.

- Les aplicacions no necessiten saber com funciona el dispositiu de veu.

- FUTUR: Proveir la implementació per a llegir llenguatges de marques, com ara VoiceXML, Sable, &Java; Speech Markup Languaje (JSML), i Speech Markup Meta-language (SMML).

- FUTUR: Proveir la implementació limitada per a marques de veu encastades.

- Asincronisme per a prevenir blocats del sistema.

Realment, el &jovie; consisteix de diversos programes:

`jovie`

- el dimoni text-a-veu del &kde;, que és una aplicació que proporciona serveis TTS a les aplicacions a través de &DBus;. També resideix a la safata del sistema.

`libkhtmlkttsdplugin`

- Un connector per al navegador web &konqueror; que us permetrà escoltar tot o una part del text en una pàgina web.

`ktexteditor_kttsd`

- Un connector per a l'editor de text &kate; que us permetrà escoltar tot o una part d'un fitxer de text.

### Suport

A més de la base de dades Bugzilla de &kde; (http://bugs.kde.org/ ), és possible seguir els debats actuals sobre el &jovie;; a través de la llista de correu kde-accessibility. Subscriviu-vos a https://mail.kde.org/mailman/listinfo/kde-accessibility. Els desenvolupadors també poden usar l'IRC (irc.kde.org, al canal #kde-accessibility).

## Utilitzar el &jovie;

Abans d'utilitzar el &jovie; almenys haureu d'instal·lar «speech-dispatcher» i assegurar-vos que funciona. Mireu installation.

### Iniciar `jovie`

Per a iniciar el sistema &jovie;, escriviu l'ordre següent en una &konsole;

`jovie`

o feu clic sobre &jovie; en el menú &kde;.

Si és la primera vegada que executeu `jovie`, o si encara no heu configurat cap parlador, apareixerà la finestra Parladors. Mireu configure-talkers. Si ja en teniu un de configurat, apareixerà la finestra General. Mireu general.

### Configurar els parladors

La majoria dels sintetitzadors de text-a-veu (TTS) ofereixen múltiples idiomes i veus i poden oferir múltiples gèneres, volums i tons per parlar. Podeu configurar més d'una instància del sintetitzador. Cada combinació d'idioma, sintetitzador, veu, gènere, volum i to és el que s'anomena un parlador. Al menys haureu de configurar un parlador abans de poder iniciar el &jovie;, en cas contrari «speech-dispatcher» utilitzarà una veu per defecte.

Tenir múltiples parladors per al mateix sintetitzador és equivalent a tenir múltiples cues de la impressió per a una mateixa impressora física.

Quan feu clic sobre la pestanya Parladors en `jovie`, apareixerà la finestra Parladors. Aquesta finestra també apareixerà automàticament si inicia `jovie` i encara no heu configurat cap parlador.

El gestor de text-a-veu del &kde; (pestanya Parladors). El gestor de text-a-veu del &kde; (pestanya Parladors)

- Feu clic per afegir un nou parlador.

- Aquí es llistaran tots els Parladors. Els Parladors amb la prioritat més alta es troben al començament. El que estigui a dalt de tot serà l'usat per a parlar quan una aplicació no especifiqui un parlador.

- Feu clic sobre un parlador de la llista per a ressaltar-lo i a continuació feu clic sobre aquest botó per a eliminar-lo.

- Feu clic sobre un parlador de la llista per a ressaltar-lo i tot seguit feu clic sobre aquest botó per canviar la configuració. Mireu a continuació.

- Feu clic sobre un parlador per a ressaltar-lo i tot seguit feu clic sobre aquest botó per a moure'l un lloc cap a amunt en la llista. Contra més avall estigui el parlador en la llista, més petita serà la seva prioritat.

- Feu clic sobre aquests botons per aplicar els canvis realitzats en el sistema &jovie; que s'estigui executant.

Quan feu clic sobre el botó Afegeix, apareixerà la finestra Afegeix parlador.

Finestra per afegir un parlador. Finestra per afegir un parlador

- Haureu de proporcionar un nom al parlador nou, pot ser qualsevol.

- Aquí s'escull l'idioma i el sintetitzador.

- Seleccioneu aquí el tipus de veu: hi ha tres veus masculines, tres femenines, una masculina infantil i un femenina infantil per a escollir.

- Definiu aquí els paràmetres de veu personalitzats.

- Quan feu clic aquí, apareixerà un nou parlador en la llista de la pestanya Parladors. Feu clic sobre el botó Edita per editar la configuració del parlador.

Gairebé estarà llest per a començar a usar el &jovie;. Ara aneu a la pestanya General i marqueu la casella Habilita el sistema de text a veu (Jovie). Això iniciarà el dimoni TTS del &kde;. Mireu general. Ara podeu començar a usar el &jovie; per a escoltar text. Feu clic sobre la pestanya Treballs per a crear i gestionar treballs de text. Mireu jobmgr.

### Iniciar el Jovie i configurar les opcions generals

Una vegada heu configurat almenys un parlador, podeu iniciar el sistema text-a-veu de &kde;. Feu clic en la pestanya General. Apareixerà la pantalla General. Podreu establir algunes opcions generals en aquesta pantalla.

El gestor de text-a-veu de &kde; (pestanya General). El gestor de text-a-veu de &kde; (pestanya General)

- Marqueu aquesta casella per a activar el sistema &jovie;. Això inicia el dimoni TTS del &kde; (Jovie). Si el Jovie s'inicia correctament, apareixerà la pestanya Treballs. Una vegada iniciat Jovie, es pot començar a crear i parlar treballs de text. Mireu jobmgr. Desmarcar aquesta caixa aturarà el Jovie i es desactivarà el sistema TTS del &kde;.

- Assegureu-vos de fer clic aquí per a desar les vostres opcions.

### Gestionar treballs de text

Quan feu clic a la pestanya Treballs en `jovie`, apareixerà la pantalla Treballs.

El gestor de text-a-veu de &kde; (pestanya Treballs). El gestor de text-a-veu de &kde; (pestanya Treballs)

- Aquest controls us permeten canviar els atributs de la veu de pronunciació actual.

- Els botons en aquesta fila us permetran aturar, cancel·lar, fer una pausa i continuar el treball de text actual.

- Els botons en aquesta fila us permetran parlar el text que es trobi actualment en el porta-retalls de &kde;, o obrir un fitxer de text per a parlar-lo. També podeu canviar el parlador per a un treball.

- Quan feu clic en D'acord o Aplica, s'aplicaran tots els canvis a les opcions en les altres pantalles (si n'hi ha).

La pestanya Treballs tan sols apareixerà quan s'estigui executant el Jovie. Si no veieu la pestanya Treballs, feu clic en la pestanya General i marqueu la casella Habilita el sistema de text a veu (Jovie).

### Pronunciar text des de les pàgines web

Mentre s'estigui executant el navegador web &konqueror; del &kde;, es podrà pronunciar el text que es mostri en la pàgina web. En primer lloc haureu d'assegurar-vos que el &jovie; estigui en execució. Ressalteu el text a pronunciar i seleccioneu Eines Pronuncia el text en el menú principal. Després d'un instant es pronunciarà el text ressaltat.

És una bona idea ressaltar en la pàgina web el text que voleu pronunciar. Podeu saltar aquesta passa, però aleshores escoltareu moltes de les capçaleres &HTML; així com d'altres etiquetes no visibles.

### Pronunciar text des de l'editor de text &kate;

Mentre s'estigui executant l'editor de text avançat del &kde; (&kate;), podeu pronunciar el text que es mostri. En primer lloc assegureu-vos que el &jovie; estigui en execució i habiliteu el Connector de text a veu KTextEditor del Jovie en el diàleg d'arranjament del &kate;. Ressalteu el text que voleu que sigui pronunciat i escolliu Eines Pronuncia el text en el menú principal. Després d'un instant es pronunciarà el text ressaltat.

No és necessari que ressalteu cap text, però en aquest cas es pronunciarà tot el fitxer.

Això també funcionarà quan &kate; estigui encastat en una altra aplicació, com &konqueror; o &quanta;.

### Pronunciar les notificacions (KNotify)

El KNotify és el subsistema de notificació del &kde;, el qual us alerta dels esdeveniments amb els que s'ha configurat el sistema &kde;. Podeu configurar el &jovie; per a pronunciar el text de les notificacions.

Per exemple, el &konversation;, una aplicació IRC pel &kde;, permet configurar una àmplia varietat de notificacions. Podeu indicar al &konversation; que us avisi quan un missatge en un canal de l'IRC aparegui el vostre àlies. Conjuntament amb el &jovie; podeu fer que el &kde; pronunciï el text del missatge IRC que us està adreçat.

En general, si una aplicació &kde; implementa KNotify, apareixerà un element de menú anomenat Notificacions dins del menú Arranjament de l'aplicació. Les configuracions específiques de cada aplicació amb KNotify varien d'una aplicació a una altra.

Els filtres que substitueixen cadenes són una bona manera per aclarir els missatges que envien les aplicacions encara que siguin impronunciables o il·legibles en el &jovie;. El fitxer `kmail.xml`, que ve amb el &jovie;, és un bon exemple. Elimina les etiquetes `br` i `b` dels missatges de les notificacions del &kmail; i també elimina la frase `/local/inbox/`, ja que s'assumeix que això és correcte en la majoria dels casos. Mireu stringreplacer.

### Filtres (Avançat)

Els filtres són una característica avançada del &jovie;. Per a les operacions bàsiques del &jovie; no són necessaris.

Els filtres s'usen per a preprocessar el text abans que aquest sigui enviat al «speech-dispatcher». Són d'utilitat per al realç de la veu, substitució de paraules que no es poden llegir o abreujaments, escollint l'idioma i el parlador adequats per a fer la pronunciació, o treballant al voltant de certes limitacions dels sintetitzadors de veu i les seves veus.

#### Tipus de missatges del &jovie;

Per a entendre com usar els filtres, en primer lloc és d'ajuda entendre com es processat el text per «speech-dispatcher». El text pronunciat pel &jovie; és de quatre tipus possibles.

- Lectura de sortides per pantalla.

- Avisos.

- Missatges

- Treballs de text

El tipus es determina per l'aplicació que envia el text al &jovie;.

La lectura de sortides per pantalla tenen la màxima prioritat. Estan reservades per a la utilització per part de aplicacions que llegeixen la sortida de la pantalla. La lectura de sortides per pantalla deixarà en segon pla tots els demés missatges, causant que aquests siguin pausats. Una vegada la lectura de sortides per pantalla ha finalitzat, es continuarà amb els treballs que s'estaven pronunciant.

Els avisos són els següents en quant a prioritat més alta. Estan reservats per a missatges de prioritat alta, com ara «La CPU s'ha sobrecalentat». Un avís deixarà en segon pla tant els missatges com el text normal. Una vegada s'hagi pronunciat l'avís, es continuarà amb els treballs que s'estaven pronunciant.

Els missatges són els següents en quant prioritat més alta. Un missatge deixarà en segon pla els treballs de text normal. &kmouth; és un exemple d'una aplicació que usa missatges. Per exemple, mentre s'està llegint un text llarg en una pàgina web, &kmouth; es pot usar per a saludar a algú que camina és a l'habitació. Les notificacions de &kde; també són missatges (mireu knotify).

La resta són treballs de text normals. Qualsevol treball que inicieu des de la pestanya Treballs és un treball de text. KSayit és un exemple d'una aplicació que usa els treballs de text. Els treballs de text estan pensats per a discursos llargs que no siguin urgents.

Tots els tipus de treball es posen a la cua, excepte la lectura de sortides per pantalla. Si s'envia una lectura de sortides per pantalla des d'una aplicació mentre el &jovie; està ocupat amb una altra lectura de sortides per pantalla, el missatge que s'està pronunciant serà aturat i descartat.

#### Tipus de filtres

El primer que hauríeu de conèixer sobre els filtres és que mai s'apliquen a les lectura de sortides per pantalla. S'apliquen als avisos, missatges, i treballs de text, i també a les notificacions del &kde; (KNotify).

Els filtres processen el text i el passen al següent filtre. Actualment hi ha tres tipus de filtres.

- Substituïdors de cadenes.

- Transformadors &XML;

- Selectors de parladors.

Els filtres estan implementats usant una arquitectura de connectors. En el futur, és possible que puguin existir més tipus de filtres.

Els filtres per a substituir cadenes substitueixen pedaços de text amb un altre text. Els pedaços de text substituïts poden coincidir amb paraules o amb expressions regulars. El &jovie; té predefinits filtres per omissió per a substituir cadenes que permeten pronunciar abreujaments, emoticones dels xat, com ara ":-)", o reformatar missatges de notificació des del &konversation; o &kmail; a un format més comprensible.

Els transformadors d'&XML; usen un Llenguatge d'estil &XML; -usa un fitxer (XSLT) per a convertir &XML; d'un format a l'altre-. El &jovie; inclou un parell de fitxers XSLT per a convertir &XHTML; en SSML.

El filtre Selector del parlador us permetrà redirigir treballs cap a un parlador basant-se en el contingut del text, o en l'aplicació que els envien al &jovie;. Per exemple, si heu configurat un parlador amb veu de dona en la pestanya Parladors, podeu dirigir el text que prové de KSayIt cap a aquest parlador. Mireu configure-talkers.

Cada un d'aquests tipus de filtres té regles configurables que indiquen quan han de ser aplicats al text que se va a pronunciar. Si el filtre determina que no s'ha d'aplicar, el text serà passat al següent filtre sense cap alteració.

Quan un treball de text, avís, o un missatge de notificació del &kde; s'envia al &jovie;, passa per cada filtre que actiu que heu configurat a la pantalla següent. L'ordre és des de dalt cap a baix.

#### Configurar els filtres

Per a usar els filtres, feu clic sobre la pestanya Filtres en `jovie`.

El gestor de text-a-veu de &kde; (pestanya Filtres). El gestor de text-a-veu de &kde; (pestanya Filtres)

- Aquesta és la llista dels filtres normals que estan configurats. Si està sense marcar, el filtre estarà inactiu i no serà tingut en compte. Els filtres s'aplicaran seguint l'ordre que s'hagi especificat aquí, de dalt cap avall.

- Feu-hi clic per afegir un nou filtre. Se us demanarà pel tipus de filtre que a afegir. Després d'escollir el tipus, mireu els següents diàlegs de configuració.

- Feu-hi clic per eliminar un filtre.

- Feu clic aquí per a canviar la configuració d'un filtre. Mireu els següents diàlegs de configuració.

- Feu clic en aquests botons per a moure un filtre cap a amunt o cap avall en la llista.

- Assegureu-vos de fer clic aquí, en cas contrari les vostres configuracions no tindran efecte.

#### Configurar els filtres de substitució de cadenes

Podeu configurar els filtres de substitució de cadenes subministrant una llista de paraules o expressions regulars amb les que han de coincidir. Quan es troben aquestes paraules o expressions regulars en el text, cadascuna d'elles serà substituïda per aquella cadena que s'hagi subministrat.

Substituïdor de cadenes Substituïdor de cadenes

- Introduïu un nom per al vostre filtre. Useu qualsevol nom que voleu i que el diferenciï de tots els altres filtres.

- Aquesta és la llista de paraules i expressions regulars. El filtre cerca coincidències amb cadascuna de les cadenes de la columna Coincidència, substituint les cadenes coincidents amb les de la columna Substitueix amb. La llista serà processada en el mateix ordre en el que es mostra, de dalt cap avall.

- Feu clic aquí per afegir una altra paraula o expressió regular a la llista.

- Feu clic aquí per a moure la paraula o expressió regular ressaltada actual cap amunt o cap avall en la llista.

- Feu clic aquí per a canviar una paraula o expressió regular existent en la llista.

- Feu clic aquí per eliminar de la llista la paraula o expressió regular ressaltada.

- Useu aquests botons per a carregar una llista de paraules o expressions regulars des d'un fitxer, desar la llista actual a un fitxer, o netejar la llista sencera. Quan es carrega des d'un fitxer, els elements existents en el fitxer s'afegeixen als existents en la llista.

- Si no està buit, el filtre tan sols s'aplicarà si l'idioma dels parladors del treball de text coincideixen amb l'idioma que introduïu aquí. Feu clic sobre el botó per a mostrar una llista d'idiomes. Podeu seleccionar més d'un idioma usant la tecla &Ctrl; mentre feu clic.

- Si no està buit, tan sols s'aplicarà el filtre si el text prove d'una de les aplicacions llistades. Podeu introduir més d'una aplicació separant-les amb comes. Exemple: ``konversation,kmail``

  Podeu esbrinar l'ID de l'aplicació dels programes en execució usant el programa `&qdbus;`. No incloure els números &DBus;. Per exemple, si &qdbus; mostra un ID d'aplicació com `kopete-3432`, tan sols haureu d'introduir ``kopete``.

El filtre Substituïdor de cadenes tan sols s'aplicarà al text si no hi ha cap condició buida en la casella Aplica aquest filtre quan. Si totes les caselles estan buides, el filtre s'aplicarà a tot el text.

Quan coincideixen les paraules, el filtre Substituïdor de cadenes usa internament una expressió regular del tipus `\s`paraula`\s`. En d'altres paraules, la paraula haurà de tenir límits (espais) per ambdós costats.

Està fora de l'abast d'aquest manual fer una explicació sobre com escriure expressions regulars. Si teniu instal·lat l'editor d'expressions regulars del &kde;, hi ha un botó disponible en les pantalles Afegeix o Edita que us ajudarà a construir expressions regulars. L'editor d'expressions regulars del &kde; forma part del paquet `kdeutils`.

El &jovie; inclou uns quants fitxers de llista de paraules, inclouen una llista d'emoticones, com «:-)», alguns abreujaments usats habitualment en el IRC o en aplicacions de missatgeria instantània, i una llista d'altres abreujaments. També hi ha una llista de caràcters especials que amb la versió actual de Festival en polonès no es poden gestionar. Si desenvolupeu llistes de paraules útils per al vostre ús, useu el botó Desa per a desar-les a un fitxer i enviar-les a l'equip del &jovie; per a la seva inclusió en la propera versió.

#### Configurar els filtres Transformador &XML;

El filtre Transformador &XML; usa fitxers XSLT per a transformar &XML; d'un format a l'altra. XSLT, el llenguatge d'estil &XML;, és un llenguatge estàndard del W3C per a interpretar les transformacions. Tan sols es poden usar sobre el format &XML; format correctament. Haureu de tenir instal·lada la utilitat `xsltproc`.

Transformador &XML; Transformador &XML;

- Introduïu un nom per al vostre filtre. Useu qualsevol nom que voleu i que el diferenciï de tots els altres filtres.

- Introduïu el camí complet d'un fitxer XSLT existent, que realitzi la transformació.

- Especifiqueu la ruta de la utilitat `xsltproc`. Si xsltproc està en la vostra variable d'entorn PATH, simplement introduïu ``xsltproc``.

- Si no està buit, el filtre tan sols s'aplicarà si l'&XML; té al començament del mateix l'especificació `<!DOCTYPE]]</command > amb la cadena introduïda. Això distingeix un format &XML; de l'altra. Per exemple, <command ><userinput >html</userinput ></command > en el quadre <guilabel >DOCTYPE</guilabel > coincidirà amb <command ><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" >`.

- Si no està buit, tan sols s'aplicarà el filtre si el text prove d'una de les aplicacions llistades. Podeu introduir més d'una aplicació separant-les amb comes. Exemple: ``konversation,kmail``

  Podeu esbrinar l'ID de l'aplicació dels programes en execució usant el programa `&qdbus;`. No incloure els números &DBus;. Per exemple, si &qdbus; mostra un ID d'aplicació com `kopete-3432`, tan sols haureu d'introduir ``kopete``.

El filtre Transformador &XML; tan sols s'aplicarà al text si es troba l'element arrel o DOCTYPE especificat i si es troba l'ID de l'aplicació en la casella Aplica aquest filtre quan. Si un element en aquesta casella està buit, no es realitzarà la prova, si totes les caselles són buides, el filtre serà aplicat a tot el text. De tota manera, hauríeu d'omplir almenys una casella, atès que alguns treballs de text poden no estar en format &XML;.

#### Configurar els filtres Selectors del parlador

Els filtres selectors del parlador s'usen per a dirigir el text cap a un parlador configurat en la pestanya Parladors, o cap al parlador que tingui atributs específics. Per exemple, podeu especificar que el text que provingui des de `kmail` sigui llegit usant el parlador configurat amb una veu de dona. Mireu configure-talkers.

Abans que el &jovie; comenci a enviar text a cadascun dels filtres, s'haurà d'haver escollit un parlador per a llegir el text. El parlador escollit es basa en els atributs especificats al parlador per part de l'aplicació que envia el text al &jovie; i pels atributs especificats dels parladors que heu configurat sobre la pestanya Parladors. El filtre Selector del parlador us permet substituir el parlador escollit.

Selector del parlador Selector del parlador

- Introduïu un nom per al vostre filtre. Useu qualsevol nom que voleu i que el diferenciï de tots els altres filtres.

- Si no està buit, el filtre tan sols s'aplicarà si el text conté l'expressió regular introduïda. Si està instal·lat, feu clic sobre el botó de navegar per iniciar l'editor d'expressions regulars de &kde; per a que us ajudi a introduir l'expressió regular.

  Per a millorar el rendiment, intenteu «ancorar» l'expressió regular al començament de la cadena. En d'altres paraules, comenceu la vostra expressió regular amb ``^``.

- Si no està buit, tan sols s'aplicarà el filtre si el text prove d'una de les aplicacions llistades. Podeu introduir més d'una aplicació separant-les amb comes. Exemple: ``konversation,kmail``

  Podeu esbrinar l'ID de l'aplicació dels programes en execució usant el programa `&qdbus;`. No incloure els números &DBus;. Per exemple, si &qdbus; mostra un ID d'aplicació com `kopete-3432`, tan sols haureu d'introduir ``kopete``.

- Especifiqueu aquí els atributs dels parladors que preferiu per a pronunciar el text. Si el text conté condicions sobre el filtrat, s'escollirà el parlador amb els atributs el més semblant possible als que s'hagin especificat. Feu clic al botó de la dreta per a mostrar la pantalla Selector del parlador.

- Useu aquests botons per a desar les vostres preferències per al Selector del parlador, carregar les preferències des d'un fitxer desat, o netejar totes les preferències.

El filtre Selector del parlador tan sols s'aplicarà al text si no hi ha cap condició buida dins de la casella Aplica aquest filtre quan. Almenys hauríeu d'omplir una de les caselles.

## Referència d'ordres

TODO

## Guia del &jovie; per a desenvolupadors

El &jovie; té dues interfícies per a programadors d'aplicacions (les API):

- L'API Text-to-Speech del &kde;, és usada pels programadors d'aplicacions per a donar-les-hi capacitats TTS. Aquestes aplicacions es comunicaran amb el &jovie; a través del &DBus;.

- L'API del connector de text a veu del &jovie;, s'usa per afegir connectors de síntesi de veu al &jovie; de manera que aquest funcioni amb un nou motor de síntesi de veu.

La següent secció dóna una petita descripció de la interfície &DBus; per a la API Text-to-Speech de &kde;. Tota la documentació per a totes dues API està disponible en línia al lloc web de &kde; Accessibility (http://accessibility.kde.org).

### La interfície &DBus; del &jovie;

Les aplicacions comuniquen les peticions dels serveis text-a-veu a través de la interfície &DBus; del &kde; per programant l'objecte `KSpeech` de `jovie`.

Introduïu les ordres següents en una &konsole;.

Si el &jovie; encara no s'està executant

`jovie`

Per a posar en la cua el treball de text que serà pronunciat

`qdbus org.kde.jovie /KSpeech say «`text`» «`opcions`»`

a on ``text`` serà el text que es parlarà, i ``opcions`` serà un codi d'idioma, com ``en``, ``cy``, &etc;

Exemple.

`qdbus org.kde.jovie /KSpeech say "This is a test." "en"`

Hi ha algunes ordres més que es poden enviar. Per a veure una llista de les ordres possibles,

`qdbus org.kde.jovie /KSpeech`

o llegiu la &kde; Text-to-Speech API en línia.

## Preguntes i respostes

&reporting.bugs; &updating.documentation;

Necessito més. Com puc fer que el &jovie; finalitzi del tot?

Introduïu les ordres següents en una &konsole;:

    kquitapp jovie

Com puc veure la sortida de depuració de `jovie`?

Obriu una finestra del &konsole;. Inicieu `jovie`.

Cap dels sintetitzadors de veu accepta l'idioma que em cal. A on puc aconseguir un sintetitzador per al meu idioma?

Google(tm) és el vostre amic. Aquest enllaç també us pot ajudar. Si cerqueu un motor de síntesi lliure que accepti l'idioma desitjat, i voleu afegir la implementació al &jovie;, si us plau, contacteu amb l'equip de desenvolupament. S'agraeixen en especial els motors de codi obert. Si coneixeu algun sintetitzador comercial, potser pugui persuadir al venedor per a donar una còpia lliure a l'equip de desenvolupament del &jovie;. Per ara, hauríeu de poder aconseguir que funcioni el sintetitzador usant les ordres del dorsal «speech-dispatcher».

Tinc configurat el filtre transformador &HTML; a &XML;, però les pàgines web no es llegeixen quan s'usa el connector Festival.

Degut a un error en Festival 1.95 beta, haureu d'instal·lar la veu `rab_diphone` (home britànic) per a que SABLE funcioni, fins i tot quan no useu aquesta veu per a llegir les pàgines web. També us haureu d'assegurar que la utilitat `xsltproc` estigui instal·lada i a la vostra variable d'entorn PATH.

Alguns caràcters de puntuació poden produir errors en el sintetitzador, fent que se salti frases senceres, o que pronunciï un veritable galimaties. Què puc fer?

Primer, assegureu-vos que l'opció Codificació de caràcters en el diàleg de configuració del parlador tingui establert l'idioma adequat. Si algunes paraules o caràcters provoquen problemes us pot ajudar un filtre substituïdor de cadenes. Mireu filters.

## Crèdits i llicència

&jovie;

Copyright del programa © 2002 José Pablo Ezequiel «Pupeno» Fernández pupeno@kde.org

Current Maintainer: Jeremy Whiting jpwhiting@kde.org

Col·laboradors:

- Gary Cramblitt garycramblitt@comcast.net

- Olaf Schmidt ojschmidt@kde.org

- Gunnar Schmi Dt gunnar@schmi-dt.de

- Paul Giannaros ceruleanblaze@gmail.com

Copyright de la documentació © 2009 Jeremy Whiting jpwhiting@kde.org © 2004 Gary R. Cramblitt garycramblitt@comcast.net

Traductor de la documentació: &credits.Antoni.Bella;

&underFDL; &underGPL;

Els motors de síntesi de veu usats pel &jovie; tenen les seves pròpies llicències. Mireu la documentació de cada motor o el lloc web per obtenir més detalls. Algunes veus tenen les seves pròpies llicències.

## Instal·lació

### Com obtenir el &jovie;

&install.intro.documentation;

Ordre d'instal·lació en Debian: `apt-get install kdeaccessibility`

Podeu trobar enllaços al codi font i als paquets binaris en el lloc web &kde; Accesibility (http://accessibility.kde.org).

Si teniu accés al repositori de codi del &kde;, podeu descarregar el &jovie; marcant el mòdul `kdeaccesibility`. El &jovie; es pot trobar en la carpeta `jovie`. També podeu descarregar arxius tar del codi font de kdeaccessibility des de ftp://ftp.kde.org/pub/kde/

### Requeriments

Requeriments obligatoris:

- Versió 4.4 de &kde; o posterior.

- Versió 3.2 de «speech-dispatcher» o posterior.

- Un sintetitzador de veu. Actualment estan acceptats els sintetitzadors i idiomes següents.

  Espeak | Molts idiomes, comproveu a http://espeak.sourceforge.net/languages.html la llista actual dels llenguatges implementats
  Festival | Anglès americà, anglès britànic, espanyol, alemany, finès, txec, polonès, rus, italià, francès canadenc, suahili, zulu i ibibio

  També funcionarà amb qualsevol motor de síntesi que pugui ser executat des de la línia d'ordres en una &konsole;.

  La llista anterior no és exhaustiva ni està actualitzada. Verifiqueu les especificacions per a cada motor amb la finalitat d'obtenir una llista amb els idiomes acceptats. També podeu fer un cop d'ull al lloc web del &jovie; per obtenir informació addicional que pot no haver estat inclosa en aquest manual.

  «speech-dispatcher» usa una arquitectura de connectors flexible per a sintetitzadors de veu. Si voleu millorar el &jovie; per a que accepti un altre motor, contacteu amb l'equip de desenvolupament.

  Mireu configuration per a instruccions específiques de cadascun d'aquests motors.

Components opcionals:

- La utilitat d'àudio `xsltproc` és necessària per a la implementació SSML i per al filtre transformador &XML;, però no és imprescindible. Els usuaris de Debian poden instal·lar xsltproc amb l'ordre `apt-get install xsltproc`.

### Compilació i instal·lació

Per a compilar el &jovie;, haureu de tenir una còpia recent (&kde; 4.4 o posterior) dels fitxers de desenvolupament del &kde;, incloent kdelibs i els fitxers de desenvolupament de «speech-dispatcher».

Si descarregueu el codi font del &jovie; des del mòdul `kdeaccessibility` del repositori de codi, o des d'un arxiu tar, useu les següents ordres per a compilar i instal·lar:

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

### Configuració

Comproveu que el «speech-dispatcher» funcioni amb els motors de síntesi de veu abans d'utilitzar el &jovie;. Per això, es pot utilitzar l'script de terminal «spd-conf».

El &jovie; en el &kde; 4.5 és un canvi de nom del KTTSD i el kttsmgr. En el futur, el jovie podrà configurar el «speech-dispatcher» directament sense «spd-conf».

&documentation.index;