# El manual de &ktts;

Jeremy
Whiting
jpwhiting@kde.org
Gary
R.
Cramblitt
garycramblitt@comcast.net
Santiago
Fernández Sancho

    santi@kde-es.org

Traductor
Franco
Mariluis

    fmariluis@gmail.com

Traductor
Adrián
Martínez

    sfxgt3@gmail.com

Traductor
2009
Jeremy Whiting
2004-2005
Gary R. Cramblitt
&FDLNotice;
2009-12-25
0.5.0 (&kde; 4.4)

&ktts; - el sistema texto a voz de &kde; - es un servicio basado en extensiones que permite a cualquier aplicación &kde; (o no &kde;) hablar utilizando la interfaz &DBus;.

&ktts; pretende ser una implementación para el API texto a voz de &kde;.

KDE
accesibilidad
kdeaccessibility
TTS
Texto a voz
KTTSD
kttsmgr
festival
flite
hadifix
MBROLA
freetts
epos
SSML

## Introducción

&ktts; es un subsistema dentro 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 dice vía speech-dispatcher, por lo que se puede utilizar cualquier

- 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.

&ktts; en estos momentos está compuesto por varios programas:

`kttsd`

  el demonio de &kde; de texto a voz, el cuál no es una aplicación &GUI; que proporciona servicios TTS a las aplicaciones vía &DBus;.

`kttsmgr`

  una aplicación &GUI; para configurar y controlar kttsd. kttsmgr se coloca en la bandeja del sistema.

`libkhtmlkttsdplugin`

  Una extensión para el navegador web &konqueror; que permitirá escuchar todo o una parte del texto de una página web.

`ktexteditor_kttsd`

  Una extensión para el editor de texto &kate; que le permirá 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 las discusiones actuales sobre &ktts; 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).

## Utilizar &ktts;

Antes de que pueda utilizar &ktts; deberá instalar speech-dispatcher y asegurarse de que funciona. Véa .

### Iniciar `kttsmgr`

Para iniciar el sistema &ktts;, teclee la siguiente orden en una &konsole;.

`kttsmgr`

o pulse sobre kttsmgr en el menú &kde;.

Si es la primera vez que ejecuta `kttsmgr`, o si no ha configurado todavía ningún lector, aparecerá la ventana Lectores. Véa . Si ya ha configurado, al menos un lector, aparecerá la ventana General. Véa .

### Configurando los filtros

La mayor parte de los sintetizadores de texto a voz (TTS) ofrecen múltiples idiomas y voces y pueden ofrecer múltiples 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 &ktts;, de otra forma speech-dispatcher utilizará la voz por defecto.

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 `kttsmgr`, aparecerá la ventana Lectores. Esta ventana también aparecerá automáticamente si inicia `kttsmgr` 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. Véa 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 sobre este botón para aplicar los cambios efectuados en el sistema &ktts; 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 &ktts;. Ahora vuelva a la pestaña General y marque la casilla Activar el sistema texto a voz (KTTSD). Esto iniciará el demonio TTS de &kde;. Véa . Ahora puede comenzar a utilizar &ktts; para hablar texto. Haga clic sobre la pestaña Trabajos para crear y administrar trabajos de textos. Véa .

### Iniciando KTTSD y configurando 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 &ktts;. Esto inicia el demonio TTS de &kde; (KTTSD). Si KTTSD se inicia correctamente, aparecerá la pestaña Trabajos. Una vez arrancado KTTSD, puede comenzar a crear y leer textos. Véa . Desmarcar esta casilla parará KTTSD y desactivará el sistema TTS de &kde;.

Cuando se marque esta casilla, aparecerá un icono en la bandeja del sistema siempre que `kttsmgr` se esté ejecutando. En este modo, pulsando Aceptar o Cancelar no se saldrá de `kttsmgr`. Todo lo contrario, la pantalla desaparecerá pero `kttsmgr` seguirá ejecutándose desde la bandeja del sistema. Pulse sobre el icono para restablecer la pantalla. Para salir de `kttsmgr`, pulse con el botón derecho en el icono de la bandeja del sistema y seleccione Salir. En caso de que esté desmarcado no aparecerá ningún icono en la bandeja del sistema. Pulsando Aceptar o Cancelar se saldrá de `kttsmgr`.

Al salir de `kttsmgr`, &ktts; permanece ejecutándose si la casilla Activar sistema texto a voz está marcada.

Esta opción no tiene efecto hasta la siguiente vez que se inicie `kttsmgr`.

Esta opción no tendrá efectos mientras se esté ejecutando `kttsmgr` en el &kcontrol;.

Cuando esta casilla está marcada, y `kttsmgr` aparezca automáticamente en la bandeja del sistema al leer, deseparecerá automáticamente cuando la lectura haya finalizado.

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

### Administrar trabajos de texto

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

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

Los controles de aquí, le permiten cambiar atributos de la voz actualmente en uso.

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 KTTSD se esté ejecutando. Si no ve la pestaña Trabajos, pinche en la pestaña General y marque la casilla Activar texto a voz (KTTSD).

### 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 &ktts; se esté ejecutando. Resalte el texto que desee que sea leído y seleccione Herramientas Leer texto en el menú principal. Después de un instante se leerá el texto resaltado.

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 que &ktts; se esté ejecutando. Resalte el texto que desee que sea leído y seleccione Herramientas Leer texto en el menú principal. Después de un instante se leerá el texto resaltado.

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 &ktts; 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 &ktts; puede hacer que &kde; léa 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 &ktts;. El archivo `kmail.xml`, que se incorpora en &ktts;, 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 ésto es correcto en la mayoría de los casos. Véa .

### Filtros (Avanzados)

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

Los filtros se utilizan para preprocesar el texto antes de que éste sea enviado a speech-dispatcher. Son muy útiles para mejorar la voz, sustituyendo palabras mal expresadas o abreviaturas, elegiendo 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 &ktts;

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

- Lectura de las salidas de la pantalla.

- Avisos.

- Mensajes.

- Trabajos de texto.

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

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 (véa ).

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.

Todos los tipos de trabajo 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 &ktts; está ocupado con otra lectura de salida de la pantalla, el mensaje que se está leyendo se para 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 extensiones. 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. &ktts; tiene incorporados filtros predeterminados para reemplazar cadenas que permiten leer abreviaturas, leer emoticonos de los chat, como «:-)», o reformatear mensajes de notificación desde &konversation; o &kmail; a un formato más inteligible.

Los conversores de &XML; utilizan un Lenguaje de estilo &XML; - Utiliza un archivo (XSLT) para convertir &XML; de un formato a otro. &ktts; 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 &ktts;. 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. Véa .

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, mensaje, advertencia, o mensaje de notificación de &kde; es enviado a &ktts;, pasará por los filtros habilitados que haya configurado en la pantalla de debajo. El orden es de arriba hacia abajo.

#### Configurar los filtros

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

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, véa cómo configurarlo en el apartado siguiente.

Pulse aquí para eliminar un filtro.

Pulse aquí para cambiar la configuración de un filtro. Véa 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 le 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`, sólo 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.

Una discusión 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 `kdeutils`.

&ktts; incluye unos cuantos archivos de listas de palabras, incluyendo 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 enviarlas al equipo de &ktts; 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 le 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 una 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`, sólo 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. Véa .

Antes de que &ktts; comience a enviar texto a cualquiera de los filtros, elegirá un lector para leer el texto. El lector elegido se basa en los atributos específicados para el lector por parte de la aplicación que ha de enviar texto a &ktts; 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 le 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`, sólo 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.

## Referencia de órdenes

PENDIENTE

## Guía para desarrolladores de &ktts;

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

- El API Texto a voz de &kde;, que es utilizado por los programadores de aplicaciones que pretenden dar a sus aplicaciones capacidades TTS. Estas aplicaciones se comunican con KTTSD vía &DCOP;.

- El API de extensiones de KTTSD, que se utiliza para añadir extensiones de síntesis de voz a KTTSD, por tanto, &ktts; podrá 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 &ktts;

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

Escriba las siguientes órdenes en una &konsole;.

Si KTTSD no se está ejecutando todavía:

`kttsd`

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

`qdbus org.kde.kttsd /KSpeech say "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.kttsd /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.kttsd /KSpeech`

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

## Preguntas y respuestas

&reporting.bugs; &updating.documentation;

¿Cómo puedo hacer que &ktts; finalice del todo?

Introduzca las siguientes órdenes en &konsole;:

    killall kttsd
    killall kttsmgr

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

Abra dos ventanas de &konsole;. Primero inicie `kttsd` en una ventana, a continuación inicie `kttsmgr` en la segunda.

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 soporte su idioma deseado, y quiere añadir soporte para él en &ktts;, por favor, 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 regalar una copia libre al equipo de desarrollo de &ktts;. Por ahora, debería ser capaz de conseguir que funcione el sintetizador utilizando el comando speech-dispatchers.

Tengo configurado el filtro conversor &HTML; &XML;, pero las páginas web no se leen al utilizar la extensión 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. Véa .

## Créditos y Licencia

&ktts;

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.

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

Santiago Fernándezsanti@kde-es.org

Franco Mariluisfmariluis@gmail.com

Adrián Martínezsfxgt3@gmail.com

&underFDL; &underGPL;

Los motores de síntesis de voz utilizados por &ktts; tienen sus propias licencias. Véa 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 &ktts;

&install.intro.documentation;

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

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

Si tiene acceso al repositorio del código de &kde;, puede descargar &ktts; marcando el módulo `kdeaccesibility`. &ktts; se puede encontrar en la carpeta `kttsd`. También puede descargar un archivo comprimido con todo el código fuente de kdeaccessibility de ftp://ftp.kde.org/pub/kde/.

### Requisitos

Requisitos obligatorios:

- &kde; versión 4.4 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 &ktts; para obtener información adicional que puede no haber sido incluída en este manual.

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

  Véa 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 &ktts;, debe tener una copia reciente (&kde; 4.4 o posterior) de los archivos de desarrollo de &kde;, incluyendo kdelibs y los archivos de desarrollo para speech-dispatcher.

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

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

### Configuración

Asegúrese de que speech-dispatcher está trabajando con su motor de sintetizador de voz antes de usar &ktts;. El script de shell spd-conf puede utilizarse para esto.

&ktts; en &kde; 4.4 es un primer intento para portar &ktts; para usar speech-dispatcher. En el futuro, kttsmgr será capaz de configurar speech-dispatcher directamente sin spd-conf.

&documentation.index;