# Manual de &jovie;

## Introducción

&jovie; es un subsistema interno de &kde; para convertir texto a voz (Texto-To-Speech en inglés, o TTS). Proporciona un API común para los programadores de &kde; con el objetivo de dotar a sus aplicaciones de capacidades TTS. Proporciona algunas capacidades interesantes para los usuarios finales.

Funcionalidades para los usuarios:

- Lee el contenido de un archivo de texto.

- Comunicación hablada de las notificaciones de &kde; (KNotify).

- Lee todo o parte del texto de una página web en &konqueror;.

- Lee todo o parte del texto en el editor de texto &kate;, incluyendo aquellas instancias en las que &kate; esté integrado en otra aplicación &kde;.

- El discurso se pasa a voz a través de speech-dispatcher, por lo que se puede utilizar cualquier motor de speech-dispatcher (espeak, festival, &etc;)

- Filtros configurables por el usuario para sustituir las palabras que no se pueden leer, seleccionando el sintetizador de voz y transformando los documentos XHTML/&XML;.

Funcionalidades para los programadores:

- Sistema de prioridades para la lectura de salidas por pantallas, avisos y mensajes, mientras que se están reproduciendo textos ordinarios.

- Permite la generación de voz en la línea de órdenes (o vía shell scripts) utilizando la utilidad &qdbus; .

- Proporciona una interfaz ligera y fácil de usar para las aplicaciones que necesiten generar salidas de voz.

- Las aplicaciones no necesitan saber cómo funciona el dispositivo de voz.

- FUTURO: Proporcionar soporte para leer lenguajes de marcas, tales como Voice&XML;, Sable, &Java; Speech Markup Languaje (JSML), y Speech Markup Meta-language (SMML).

- FUTURO: Proporcionar soporte limitado para marcas de voz integradas.

- Asincronismo para impedir bloqueos del sistema.

&jovie; está compuesto realmente por varios programas:

`jovie`

- el demonio de &kde; de texto a voz, que es una aplicación que proporciona servicios TTS a las aplicaciones vía &DBus;. Reside en la bandeja del sistema.

`libkhtmlkttsdplugin`

- Un complemento para el navegador web &konqueror; que permitirá escuchar todo o una parte del texto de una página web.

`ktexteditor_kttsd`

- Un complemento para el editor de texto &kate; que le permitirá escuchar todo o una parte de un archivo de texto.

### Soporte

Además de la base de datos del Bugzilla de &kde; ( http://bugs.kde.org/ ), es posible seguir las discusiones actuales sobre &jovie; a través de la lista de correo de kde-accessibility. Suscríbase a https://mail.kde.org/mailman/listinfo/kde-accesibility. Los desarrolladores también puede utilizar el IRC (irc.kde.org, canal #kde-accessibility).

## Uso de &jovie;

Antes de que pueda utilizar &jovie; deberá instalar speech-dispatcher y asegurarse de que funciona. Consulte installation.

### Inicio de `jovie`

Para iniciar el sistema &jovie;, escriba la siguiente orden en una &konsole;.

`jovie`

o pulse sobre &jovie; en el menú de &kde;.

Si es la primera vez que ejecuta `jovie`, o si no ha configurado todavía ningún lector, aparecerá la ventana Lectores. Vea configure-talkers. Si ya ha configurado, al menos un lector, aparecerá la ventana General. Vea general.

### Configurando los filtros

La mayor parte de los sintetizadores de texto a voz (TTS) ofrecen varios idiomas y voces y pueden ofrecer varios géneros, volúmenes y tonos. Podrá configurar más de una instancia del sintetizador. Cada combinación de idioma, sintetizador, voz, género, volumen y tono es lo que se llama un lector. Debería configurar al menos un lector antes de usar &jovie;, de otra forma speech-dispatcher utilizará la voz predeterminada.

Tener múltiples lectores para el mismo sintetizador es equivalente a tener múltiples colas de impresión para la misma impresora física.

Cuando pulse sobre la pestaña Lectores en `jovie`, aparecerá la ventana Lectores. Esta ventana también aparecerá automáticamente si inicia `jovie` y todavía no ha configurado ningún lector.

El administrador texto a voz de &kde; (pestaña Lectores). El administrador texto a voz de &kde; (pestaña Lectores)

- Pulse para añadir un nuevo lector.

- Aquí aparecerán listados todos los lectores. Los lectores con prioridad más alta se encuentran al principio. El que esté arriba del todo será el utilizado para la lectura en el caso de que una aplicación no especifique lector.

- Pulse sobre un lector de la lista para marcarlo y a continuación pulse sobre este botón para eliminarlo.

- Pulse sobre el lector en la lista para marcarlo y a continuación pulse sobre este botón para cambiar su configuración. Vea a continuación.

- Pulse sobre el lector para marcarlo y a continuación pulse sobre este botón para moverlo un lugar hacia abajo en la lista. Mientras más abajo esté el lector en la lista, menor será su prioridad.

- Pulse uno de estos botones para aplicar los cambios efectuados en el sistema &jovie; que se esté ejecutando.

Cuando pulse el botón Añadir, aparecerá la ventana Añadir lector.

Ventana de Añadir lector. Ventana de Añadir lector

- Usted debería darle un nombre al nuevo lector, puede ser cualquier cosa.

- Elija el idioma y el sintetizador aquí.

- Elija el tipo de voz aquí, allí hay voces de tres hombres, tres mujeres, un chico y una chica para elegir.

- Establecer cualquier parámetros personalizados de voz aquí.

- Cuando pulse aquí, su nuevo lector aparecerá en la lista en la ventana Lectores. Haga clic en el botón Editar para editar la configuración del lector.

Usted está casi preparado para comenzar a utilizar &jovie;. Ahora vuelva a la pestaña General y marque la casilla Activar el sistema texto a voz (Jovie). Esto iniciará el demonio TTS de &kde;. Vea general. Ahora puede comenzar a utilizar &jovie; para hablar texto. Haga clic sobre la pestaña Trabajos para crear y administrar trabajos de textos. Vea jobmgr.

### Iniciar &jovie; y configurar las opciones generales

Una vez que haya configurado, al menos un lector, puede iniciar el sistema texto a voz de &kde;. Pulse en la pestaña General. Aparecerá la pestaña General. Podrá modificar algunas opciones generales en esta pantalla.

El administrador texto a voz de &kde; (pestaña General). El administrador texto a voz de &kde; (pestaña General)

- Marque esta casilla para activar el sistema &jovie;. Esto inicia el demonio TTS de &kde; (&jovie;). Si Jovie se inicia correctamente, aparecerá la pestaña Trabajos. Una vez arrancado &jovie;, puede comenzar a crear y leer textos. Consulte jobmgr. Si elimina la marca de esta casilla,detendrá Jovie y desactivará el sistema TTS de &kde;.

- Asegúrese de pulsar aquí para guardar su configuración.

### Administrar trabajos de texto

Cuando pulse la pestaña Trabajos en `jovie`, aparecerá la pantalla Trabajos.

El administrador texto a voz de &kde; (pestaña Trabajos). El administrador texto a voz de &kde; (pestaña Trabajos)

- Estos controles, le permiten cambiar los atributos de la voz que está actualmente en uso. Tenga en cuenta que esto solo funciona si no tiene ninguna voz configurada en la pestaña de Lectores.

- Los botones en esta fila le permitirán parar, cancelar, pausar y continuar el trabajo de texto actual.

- Los botones de esta fila le permitirán escuchar el texto que se encuentren en ese momento en el portapapeles de &kde;, o abrir un archivo de texto para leerlo. También puede cambiar el lector por un trabajo.

- Cuando haga clic en OK o en Aplicar todos los cambios producidos sobre las preferencias en otras pantallas se aplicarán (si hay alguno).

La pestaña Trabajos únicamente aparecerá cuando &jovie; se esté ejecutando. Si no ve la pestaña Trabajos, pulse la pestaña General y marque la casilla Activar texto a voz (Jovie).

### Leer texto de las páginas web

Mientras se esté ejecutando el navegador web de &kde; &konqueror;, podrá leer el texto que se muestre en la página web. En primer lugar, debe asegurarse de que &jovie; se esté ejecutando. Resalte el texto que desee que se lea y seleccione Herramientas Leer texto en el menú principal. Después de un instante, el texto resaltado se empezará a leer.

Es una buena idea resaltar en la página web el texto que desea escuchar. Puede saltarse este paso, pero entonces escuchará muchas de las cabeceras &HTML; así como otras etiquetas invisibles.

### Leer texto en el editor de texto &kate;

Mientras se esté ejecutando el editor de texto avanzado de &kde; (&kate;), podrá leer el texto que se muestre. En primer lugar, debe asegurarse de que &jovie; se esté ejecutando y activar el complemento KTextEditor Jovie texto a voz en el diálogo de preferencias de &kate;. Resalte el texto que desee que se lea y seleccione Herramientas Leer texto en el menú principal. Después de un instante, el texto resaltado se empezará a leer.

No es necesario que resalte ningún texto, pero en este caso se leerá el archivo completo.

Esto también funcionará cuando &kate; esté integrado en otra aplicación, como &konqueror; o &quanta;.

### Leer notificaciones (KNotify)

KNotify es el subsistema de notificación de &kde;, que le alerta de los eventos con los que se haya configurado el sistema &kde;. Puede configurar &jovie; para leer los textos de estas notificaciones.

Por ejemplo, &konversation;, una aplicación IRC de &kde;, permite configurar una amplia variedad de notificaciones. Puede pedir a &konversation; que le avise cuando un mensaje que incluya su apodo aparezca en un canal de IRC. Junto con &jovie; puede hacer que &kde; lea el texto del mensaje del IRC que se dirija a usted.

En general, si una aplicación &kde; soporta KNotify, tendrá un elemento de menú llamado Notificaciones dentro del menú Preferencias de la aplicación. Las configuraciones específicas de cada aplicación con KNotify varían de una aplicación a otra.

Los filtros que reemplazan cadenas son una buena forma de aclarar los mensajes que envían las aplicaciones ya sean impronunciables o ilegibles en &jovie;. El archivo `kmail.xml`, que se incorpora en &jovie;, es un buen ejemplo. Elimina las etiquetas `br` y `b` de los mensajes de las notificaciones de &kmail; y también elimina la frase `/local/inbox/`, ya que se asume que esto es correcto en la mayoría de los casos. Vea stringreplacer.

### Filtros (Avanzados)

Los filtros son características avanzadas de &jovie;. Para las operaciones básicas de &jovie; no son necesarios.

Los filtros se utilizan para preprocesar el texto antes de que este sea enviado a speech-dispatcher. Son muy útiles para mejorar la voz, sustituyendo palabras mal expresadas o abreviaturas, eligiendo el lenguaje apropiado y el lector para realizar la lectura, o trabajar con ciertas limitaciones de los sintetizadores de voz y sus voces.

#### Tipos de mensajes de &jovie;

Para entender cómo se usan los filtros, es preciso en primer lugar entender cómo se procesa el texto por parte de speech-dispatcher. El texto leído por &jovie; es de cuatro tipos posibles.

- Lectura de las salidas de la pantalla.

- Avisos.

- Mensajes.

- Trabajos de texto.

El tipo se determina mediante la aplicación que envía el texto a &jovie;.

La lectura de las salidas de la pantalla tienen la máxima prioridad. Están reservadas para la utilización por parte de aplicaciones que leen la pantalla. La lectura de las salidas de la pantalla detendrá todos los demás mensajes. Una vez que la lectura de la salida de la pantalla ha finalizado, se continuará con los trabajos que se estaba leyendo.

Los avisos son los siguientes en cuanto a prioridad. Están reservados para mensajes de alta prioridad, tales como «La CPU está sobrecalentada». Un aviso detendrá tanto los mensajes como el texto normal. Una vez que se haya leído el aviso, se continuará con los trabajos que se estaba leyendo.

Los mensajes tienen el siguiente nivel de prioridad. Un mensaje parará los trabajos de texto normal. &kmouth; es un ejemplo de una aplicación que utiliza mensajes. Por ejemplo, mientras se está leyendo un texto largo en una página web, &kmouth; puede ser utilizado para saludar a alguien que camina por la habitación. Las notificaciones de &kde; también son mensajes (vea knotify).

El resto son trabajos de texto ordinarios. Cualquier trabajo que inicie desde la pestaña Trabajos es un trabajo de texto. KSayit es un ejemplo de una aplicación que utiliza los trabajos de texto. Los trabajos de texto están pensados para largas lecturas que no sean urgentes.

Los cuatro tipos de trabajos se encolan, excepto la lectura de las salidas de la pantalla. Si se envía una lectura de la salida de la pantalla desde una aplicación mientras &jovie; está ocupado con otra lectura de salida de la pantalla, la lectura del mensaje que se está leyendo se detiene y se descarta.

#### Tipos de filtros

Lo primero que debería conocer sobre los filtros es que nunca se aplican a las lecturas de las salidas de pantalla. Se aplican a los avisos, mensajes, y trabajos de texto, y también a las notificaciones de &kde; (KNotify).

Los filtros procesan el texto y lo pasan al siguiente filtro. En estos momentos existen tres tipos de filtros.

- Filtros que reemplazan cadenas.

- Filtros que transforman &XML;

- Filtros que seleccionan el lector.

Los filtros están implementados utilizando la arquitectura de complementos. En el futuro, es posible que puedan existir más tipos de filtros.

Los filtros que reemplazan cadenas sustituyen partes del texto con otro texto. Los trozos de texto reemplazados pueden coincidir con palabras o con expresiones regulares. &jovie; tiene incorporados filtros predeterminados para reemplazar cadenas que permiten leer abreviaturas, leer emoticonos de los chat, como «:-)», o cambiar el formato de los mensajes de notificación desde &konversation; o &kmail; a un formato más inteligible.

Los conversores de &XML; utilizan un lenguaje de estilo &XML;: utilizan un archivo (XSLT) para convertir &XML; de un formato a otro. &jovie; incluye un par de archivos XSLT para convertir &XHTML; en SSML.

El selector de lector le permite redirigir los trabajos hacia un lector determinado basado en el contenido del texto, o en la aplicación que lo envía a &jovie;. Por ejemplo, si ha configurado un lector con voz de mujer en la pestaña Lectores, puede dirigir el texto proveniente de KSayIt a dicho lector. Vea configure-talkers.

Cada uno de estos tipos de filtros tiene reglas configurables que indican cuándo han de ser aplicados al texto que se va a leer. Si el filtro determina que no debe aplicarse el texto será pasado al siguiente filtro sin ninguna alteración.

Cuando un trabajo de texto, un mensaje, una advertencia o un mensaje de notificación de &kde; se envía a &jovie;, pasará por los filtros habilitados que haya configurado en la pantalla que se ve a continuación. El orden es de arriba hacia abajo.

#### Configurar los filtros

Para utilizar los filtros, pulse sobre la pestaña Filtros en `jovie`.

El administrador texto a voz de &kde; (pestaña filtros). El administrador texto a voz de &kde; (pestaña filtros)

- Esta es la lista de los filtros normales que están configurados. Si está desmarcado, el filtro estará inactivo y no será tenido en cuenta. Los filtros se aplicarán en el orden que se haya especificado aquí, de arriba hacia abajo.

- Pulse aquí para añadir un nuevo filtro. Se le preguntará el tipo de filtro que desea añadir. Después de elegir el tipo, vea cómo configurarlo en el apartado siguiente.

- Pulse aquí para eliminar un filtro.

- Pulse aquí para cambiar la configuración de un filtro. Vea cómo configurarlo en el apartado siguiente.

- Pulse estos botones para mover un filtro hacia arriba o hacia abajo en la lista.

- Asegúrese de pulsar aquí, ya que sino las configuraciones no tendrán efecto.

#### Configurar los filtros que reemplazan cadenas

Podrá configurar los filtros que reemplazan cadenas proporcionando una lista de palabras o expresiones regulares con las que deben coincidir. Cuando se encuentran estas palabras o expresiones regulares en el texto, cada una de ellas es reemplazada por una cadena sustituta que haya proporcionado.

Sustituidor de cadenas Sustituidor de cadenas

- Introduzca un nombre para su filtro. Utilice cualquier nombre que desee y que lo diferencie de los otros filtros.

- Esta es la lista de palabras y expresiones regulares. El filtro busca coincidencias con cada una de las cadenas de la columna Coincidir, reemplazando las cadenas coincidentes con las de la columna Reemplazar con. La lista se procesa en el mismo orden en que se muestra, de arriba hacia abajo.

- Pulse aquí para añadir otra palabra o expresión regular a la lista.

- Pulse aquí para mover hacia arriba o hacia abajo en la lista la palabra o expresión regular resaltada.

- Pulse aquí para cambiar una palabra o expresión regular existente en la lista.

- Pulse aquí para eliminar de la lista la palabra o expresión regular resaltada.

- Utilice estos botones para cargar una lista de palabras o expresiones regulares de un archivo, guardar la lista actual a un archivo, o borrar la lista completa. Cuando se carga un archivo, los elementos existentes en el archivo se añaden a los existentes en la lista.

- Sino está vacío, el filtro se aplicará únicamente si el idioma de los lectores del trabajo coinciden con el idioma que introduzca aquí. Pulse el botón para mostrar una lista de idiomas. Puede seleccionar más de un idioma, pulsando &Ctrl; mientras hace clic.

- Sino está vacío, se aplicará el filtro únicamente al texto proveniente de una de las aplicaciones listadas. Puede introducir más de una aplicación separándolas por comas. Ejemplo: ``konversation,kmail``

  Puede averiguar el ID de la aplicación de los programas en ejecución utilizando el programa `&qdbus;`. No debería dejar fuera los números de &DBus;. Por ejemplo, si &qdbus; muestra un ID de aplicación como `kopete-3432`, solo deberá introducir ``kopete``.

El filtro de reemplazo de cadena únicamente se aplicará al texto si no hay ninguna condición vacía en el cuadro Aplicar este filtro cuando. Si todas las casillas están vacías, el filtro se aplicará a todo el texto.

Cuando coinciden las palabras, el filtro que reemplaza las cadenas utiliza internamente una expresión regular del tipo `\s`palabra`\s`. En otras palabras, la palabra debe tener límites (espacios) por ambos lados.

Las instrucciones sobre cómo escribir expresiones regulares está fuera del alcance de este manual. Si tiene instalado el editor de expresiones regulares de &kde;, existe un botón disponible en las pantallas Añadir o Editar que le ayudará a construir expresiones regulares. El editor de expresiones regulares de &kde; forma parte del paquete Utils Git en playground.

&jovie; incluye unos cuantos archivos de listas de palabras, lo que incluye una lista de emoticonos, como «:-)», algunas abreviaturas utilizadas habitualmente en el IRC o en aplicaciones de mensajería instantánea y una lista de otras abreviaturas. También existe una lista de caracteres especiales que con la versión actual de Festival en polaco no se pueden manejar. Si desarrolla listas de palabras para sí mismo, utilice el botón Guardar para guardarlas en un archivo y envíelas al equipo de &jovie; para su inclusión en la siguiente versión.

#### Configurando los filtros que transforman &XML;

Los filtros que transforman &XML; utilizan archivos XSLT para cambiar &XML; de un formato a otro. XSLT, el lenguaje de transformación de estilo &XML;, es un lenguaje estándar de la W3C para interpretar las transformaciones. Únicamente se pueden utilizar con el formato &XML; correctamente formado. Deberá tener la utilidad `xsltproc` instalada.

Transformador &XML; Transformador &XML;

- Introduzca un nombre para su filtro. Utilice cualquier nombre que desee y que lo diferencie de los otros filtros.

- Introduzca la ruta completa de un archivo XSLT existente, que lleve a cabo la transformación.

- Especifique la ruta de la utilidad `xsltproc`. Si xsltproc está en su variable de entorno PATH, únicamente introduzca ``xsltproc``.

- Si no está vacío, el filtro se aplicará únicamente si el &XML; tiene al comienzo del mismo la especificación `<![CDATA[<!DOCTYPE]]` con la cadena introducida. Esto distingue un formato &XML; de otro. Por ejemplo, ``html`` en el cuadro DOCTYPE habrá de coincidir con `<![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" >]]>`.

- Sino está vacío, se aplicará el filtro únicamente al texto proveniente de una de las aplicaciones listadas. Puede introducir más de una aplicación separándolas por comas. Ejemplo: ``konversation,kmail``

  Puede averiguar el ID de la aplicación de los programas en ejecución utilizando el programa `&qdbus;`. No debería dejar fuera los números de &DBus;. Por ejemplo, si &qdbus; muestra un ID de aplicación como `kopete-3432`, solo deberá introducir ``kopete``.

El filtro que transforma el &XML; únicamente se aplicará al texto si ninguna de las condiciones que se encuentran en el cuadro Aplicar este filtro cuando está vacía. Si están vacíos todos los cuadros se aplicará a todo el texto. Sin embargo, debería rellenar al menos un cuadro, ya que algunos trabajos de texto pueden no estar en formato &XML;.

#### Configurar los filtros que seleccionan el lector

Los filtros que seleccionan el lector se utilizan para dirigir el texto al lector configurado en la pestaña Lectores, o al lector que tenga atributos específicos. Por ejemplo, puede especificar que el texto que provenga de `kmail` sea leído utilizando un lector configurado con una voz de mujer. Vea configure-talkers.

Antes de que &jovie; comience a enviar texto a cualquiera de los filtros, elegirá un lector para leer el texto. El lector elegido se basa en los atributos especificados para el lector por parte de la aplicación que ha de enviar texto a &jovie; y por los atributos especificados por los lectores que se hayan configurado en la pestaña Lectores. El filtro que selecciona el lector permite modificar el lector escogido con los criterios anteriores.

Selector de lector Selector de lector

- Introduzca un nombre para su filtro. Utilice cualquier nombre que desee y que lo diferencie de los otros filtros.

- Si no está vacío, el filtro se aplicará únicamente si el texto contiene la expresión regular introducida. Si está instalado, pulse el botón ver para iniciar el editor de expresiones regulares de &kde; para que le ayude a introducir la expresión regular.

  Para mejorar la ejecución, intente «anclar» la expresión regular al inicio de la cadena. En otras palabras, inicie su expresión regular con ``<![CDATA[^]]>``.

- Sino está vacío, se aplicará el filtro únicamente al texto proveniente de una de las aplicaciones listadas. Puede introducir más de una aplicación separándolas por comas. Ejemplo: ``konversation,kmail``

  Puede averiguar el ID de la aplicación de los programas en ejecución utilizando el programa `&qdbus;`. No debería dejar fuera los números de &DBus;. Por ejemplo, si &qdbus; muestra un ID de aplicación como `kopete-3432`, solo deberá introducir ``kopete``.

- Especifique los atributos de los lectores que prefiera para leer el texto aquí. Si el texto contiene condiciones sobre el filtrado, se elegirá el lector con los atributos lo más parecido posible a los que se hayan especificado. Haga clic sobre el botón de la derecha para mostrar la pantalla Seleccionar lector.

- Utilice estos botones para guardar sus preferencias al seleccionar lector, cargar las preferencias guardadas en un archivo, o borrar todas las preferencias.

El filtro que selecciona el lector únicamente se aplicará al texto si no hay ninguna condición vacía dentro del cuadro Aplicar este filtro cuando. Debería al menos rellenar uno de los cuadros.

## Guía para desarrolladores de &jovie;

&jovie; tiene dos interfaces para programadores de aplicaciones (APIs):

- El API de texto a voz de &kde;, que utilizan los programadores de aplicaciones para obtener capacidades TTS. Estas aplicaciones se comunican con &jovie; a través de &DBus;.

- El API de complementos de &jovie;, que se utiliza para añadir complementos de síntesis de voz a &jovie;, de manera que &jovie; pueda trabajar con un nuevo motor de síntesis de voz.

La siguiente sección da una pequeña descripción de la interfaz de &DBus; texto a voz de &kde; para API. La documentación completa para ambas APIs está disponible en línea en el sitio web de &kde; Accessibility (http://accessibility.kde.org).

### La interfaz &DBus; de &jovie;

Las aplicaciones comunican las peticiones de los servicios texto a voz a través de la interfaz &DBus; de &kde; para programar el objeto `jovie` `KSpeech`.

Escriba las siguientes órdenes en una &konsole;.

Si &jovie; no se está ejecutando todavía:

`jovie`

Para poner en la cola el trabajo de texto que se vaya a leer:

`qdbus org.kde.jovie /KSpeech dice "`texto`" "`opciones`"`

donde ``texto`` es el texto que va a ser reproducido, y ``opciones`` es un código de idioma, como ``en``, ``cy``, &etc;

Ejemplo.

`qdbus org.kde.jovie /KSpeech say "Esto es una prueba." "es"`

Existen algunas órdenes más que se pueden enviar. Para ver una lista de las órdenes posibles:

`qdbus org.kde.jovie /KSpeech`

o lea el API texto a voz de &kde; en línea.

## Preguntas y respuestas

&reporting.bugs; &updating.documentation;

Necesito empezar de nuevo. ¿Cómo puedo hacer que &jovie; finalice del todo?

Introduzca las siguientes órdenes en &konsole;:

    kquitapp jovie

¿Cómo puedo ver la salida de depuración de `jovie`?

Abra una ventana de &konsole; e inicie `jovie`.

Ninguno de los sintetizadores de voz soporta el idioma que necesito. ¿Dónde puedo conseguir un sintetizador para mi idioma?

Google(tm) es su amigo. Este enlace también puede ayudarle. Si encuentra un motor de síntesis libre que admita su idioma y quiere añadir que &jovie; lo admita, contacte con el equipo de desarrollo. Los motores de código abierto son especialmente bienvenidos. Si conoce algún sintetizador comercial, quizá pueda persuadir al vendedor de que regale una copia libre al equipo de desarrollo de &jovie;. Por ahora, debería ser capaz de conseguir que funcione el sintetizador utilizando el motor de órdenes speech-dispatchers.

Tengo configurado el filtro conversor &HTML; &XML;, pero las páginas web no se leen al utilizar el complemento Festival.

Debido a un fallo en Festival 1.95 beta, deberá instalar la voz `rab_diphone` (hombre británico) para que SABLE funcione, incluso aunque no esté utilizando esta voz para leer las páginas web. También deberá asegurarse de que la utilidad `xsltproc` esté instalada y su ruta esté incluida en la variable de entorno PATH.

Algunos caracteres de puntuación pueden producir errores en el sintetizador, haciendo que se salte frases completas, o que pronuncie un verdadero galimatías. ¿Qué puedo hacer?

En primer lugar, asegúrese de que la opción Codificación de caracteres en el diálogo de configuración del lector tenga seleccionado el idioma adecuado. Si algunas palabras o caracteres provocan problemas puede ayudarle un filtro que reemplace cadenas. Vea filters.

## Créditos y Licencia

&jovie;

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

Mantenedor actual: Jeremy Whiting jpwhiting@kde.org

Contribuciones:

- 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ón © 2009 Jeremy Whiting jpwhiting@kde.org © 2004 Gary R. Cramblitt garycramblitt@comcast.net

Traducido por Rocío Gallego traducciones@rociogallego.com, Santiago Fernández santi@kde-es.org, Franco Mariluis fmariluis@gmail.com y Adrián Martínez sfxgt3@gmail.com.

&underFDL; &underGPL;

Los motores de síntesis de voz utilizados por &jovie; tienen sus propias licencias. Vea la documentación de cada motor o su sitio web para obtener más detalles. Algunas voces tienen sus propias licencias.

## Instalación

### Cómo obtener &jovie;

&install.intro.documentation;

Comando de instalación en Debian: `apt-get install jovie`

Puede encontrar enlaces a los fuentes y a los paquetes binarios en el sitio web de Accesibilidad de &kde; (http://accessibility.kde.org).

Si tiene acceso al repositorio del código de &kde;, puede descargar &jovie; marcando el módulo `jovie`. &jovie; se puede encontrar en la carpeta `jovie`. También puede descargar un archivo comprimido con todo el código fuente del código fuente de &jovie; en http://download.kde.org/stable/

### Requisitos

Requisitos obligatorios:

- &kde; versión 4.8 or posterior.

- speech-dispatcher versión 0.67 or posterior.

- Un motor de síntesis de voz. Actualmente están soportados los siguientes motores e idiomas.

  eSpeak | La mayoría de los lenguajes, compruebe http://espeak.sourceforge.net/languages.html para la lista actual de lenguajes soportados list of supported languages
  Festival | Inglés americano, británico, español, alemán, finés, checo, polaco, ruso, italiano, francés canadiense, kiswahili, zulú e ibibio

  También funcionará con cualquier motor de síntesis que pueda ser ejecutado desde la línea de órdenes de &konsole;.

  La anterior lista no es exhaustiva ni está actualizada. Verifique las especificaciones para cada motor con el fin de obtener una lista con los idiomas soportados. También podrá echar un vistazo al sitio web de &jovie; para obtener información adicional que puede no haber sido incluida en este manual.

  speech-dispatcher utiliza una arquitectura de complementos flexible para motores de síntesis de voz. Si desea mejorar &jovie; para que admita otro motor, contacte con el equipo de desarrollo.

  Vea configuration para obtener las instrucciones específicas de cada uno de estos motores.

Componentes opcionales:

- La utilidad `xsltproc` se necesita para el soporte SSML y para el filtro que transforma el &XML;, pero no es imprescindible. Los usuarios de Debian pueden instalar xsltproc con la orden `apt-get install xsltproc`.

### Compilación e instalación

Para compilar &jovie;, debe tener una copia reciente (&kde; 4.8 o posterior) de los archivos de desarrollo de &kde;, incluido kdelibs y los archivos de desarrollo para speech-dispatcher.

Si ya ha descargado los fuentes de &jovie; del módulo `kdeaccessibility` del repositorio de código o de un archivo comprimido, utilice las siguientes órdenes para compilar e instalar:

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

### Configuración

Asegúrese de que speech-dispatcher funciona con su motor de sintetizador de voz antes de usar &jovie;. Para ello, puede usar el script de shell spd-conf.

&jovie; en &kde; 4.5 es un primer intento para portar KTTSD y kttsmgr. Más adelante, &jovie; será capaz de configurar speech-dispatcher directamente sin spd-conf.

&documentation.index;