# Manuel de &jovie;

## Introduction

&jovie; est un sous-système de synthèse vocale (TTS) dans &kde;. Il fournit une API commune aux programmeurs de &kde; pour fournir des fonctionnalités de synthèse vocale à leurs programmes. Il offre également des fonctionnalités sympathiques aux utilisateurs finals.

Fonctionnalités utilisateur :

- Prononcer le contenu d'un fichier texte.

- Prononcer les notifications d'évènement de &kde; (KNotify).

- Prononcer le texte ou une partie du texte d'une page web dans &konqueror;.

- Prononcer le texte ou une partie du texte dans l'éditeur de texte &kate;, y compris les instances de &kate; embarquées dans d'autres programmes &kde;.

- Les paroles sont prononcées via un speech-dispatcher, ce qui fait que n'importe quel moteur peut être utilisé (espeak, festival, &etc;)

- Des filtres configurables par l'utilisateur pour remplacer les mots mal prononcés, choisir le synthétiseur vocal et transformer des documents XHTML et &XML;.

Fonctionnalités du programme :

- Système de priorités pour les sorties, avertissements et messages des lecteurs d'écran, sans arrêter la lecture du texte en cours.

- Permet la synthèse vocale depuis la ligne de commande (ou via des scripts shell), en utilisant l'utilitaire &qdbus;.

- Fournit une interface légère et facilement utilisable pour que les programmes puissent synthétiser de la voix.

- Les programmes n'ont pas besoin de s'occuper des conflits d'accès au périphérique de synthèse.

- À VENIR : fournir la gestion des langages de synthèse balisés, comme VoiceXML, Sable, &Java; Speech Markup Language (JSML) et Speech Markup Meta-language (SMML).

- À VENIR : fournir une gestion limitée des marqueurs de synthèse embarqués.

- Asynchrone, pour éviter le blocage du système.

&jovie; comporte plusieurs programmes :

`jovie`

- le démon de synthèse vocale de &kde;, qui est un programme qui fournit les services de synthèse vocale aux applications via &DBus;. Il est aussi présent dans la boîte à miniatures.

`libkhtmlkttsdplugin`

- Une extension pour le navigateur web &konqueror; qui permet la synthèse vocale d'une page ou portion de page web.

`ktexteditor_kttsd`

- Une extension pour l'éditeur de texte &kate; qui permet la synthèse vocale d'un fichier ou d'une portion de fichier texte.

### Support

En plus de la base de bogues Bugzilla de &kde; (http://bugs.kde.org/), les discussions sur &jovie; ont actuellement lieu sur la liste de diffusion kde-accessibility. Inscrivez-vous là : https://mail.kde.org/mailman/listinfo/kde-accessibility. Les programmeurs traînent aussi sur IRC (irc.kde.org, salon #kde-accessibility).

## Utilisation de &jovie;

Avant de pouvoir utiliser &jovie;, vous devez installer un speech-dispatcher et vous assurer qu'il fonctionne. Reportez-vous à installation.

### Démarrage de `jovie`

Pour lancer le système &jovie;, tapez la commande suivante dans une &konsole;

`jovie`

ou cliquez sur &jovie; dans le menu de &kde;.

Si c'est la première fois que vous lancez `jovie`, ou si vous n'avez encore configuré aucun locuteur, l'écran Locuteurs apparaît. Reportez-vous à configure-talkers. Si vous avez déjà configuré au moins un locuteur, l'écran Général apparaît. Reportez-vous à general.

### Configuration des locuteurs

La plupart des synthétiseurs vocaux offrent de nombreuses langues et voix et plusieurs genres, volumes et débits. Vous pouvez configurer plusieurs instances d'un synthétiseur. Chaque combinaison de langue, synthétiseur, voix, genre, volume et débit est appelée un locuteur. Vous devriez en configurer au moins un avant de pouvoir utiliser &jovie;, sinon, le speech-dispatcher utilisera une voix par défaut.

La définition de plusieurs locuteurs pour le même synthétiseur est similaire à celle de plusieurs files d'attente pour une même imprimante physique.

Lorsque vous cliquez sur l'onglet Locuteurs dans `jovie`, l'écran Locuteurs apparaît. Cet écran apparaît également automatiquement si vous lancez `jovie` sans avoir configuré de locuteur.

Le gestionnaire de synthèse vocale de &kde; (onglet Locuteurs). Le gestionnaire de synthèse vocale de &kde; (onglet Locuteurs).

- Cliquez pour ajouter un nouveau locuteur.

- Tous les Locuteurs configurés sont listés ici. Les Locuteurs ayant la plus haute priorité sont listés en haut. Le locuteur le plus haut dans la liste sera utilisé par tous les programmes qui ne spécifient pas de locuteur.

- Cliquez sur un locuteur dans la liste pour le sélectionner puis cliquez sur ce bouton pour le supprimer.

- Cliquez sur un locuteur dans la liste pour le sélectionner puis cliquez sur ce bouton pour changer sa configuration. Voir ci-dessous.

- Cliquez sur un locuteur dans la liste pour le sélectionner puis cliquez sur ce bouton pour le déplacer d'un rang vers le bas dans la liste. Plus un locuteur apparaît bas dans la liste, plus sa priorité est faible.

- Cliquez sur un de ces boutons pour appliquer les changements que vous avez fait au système &jovie; en cours.

Quand vous cliquez sur le bouton Ajouter, l'écran Ajouter un locuteur apparaît.

Écran Ajouter un locuteur. Écran Ajouter un locuteur.

- Vous devriez donner un nom au locuteur, au moins une chaîne quelconque.

- Choisissez la langue et le synthétiseur ici.

- Choisissez le type de voix ici. Vous devez choisir parmi trois voix d'hommes, trois de femmes, une de garçon et une de fille.

- Définissez ici les paramètres de voix personnalisés.

- Lorsque vous cliquez ici, votre nouveau locuteur apparaîtra dans la liste de l'écran Locuteurs. Cliquez sur le bouton Édition pour modifier la configuration du locuteur.

À présent, vous pouvez presque utiliser &jovie;. Retournez à l'onglet Général et cochez la case Activer le système de synthèse vocale (Jovie). Ceci démarrera le démon de synthèse vocale de &kde;. Reportez-vous à general. Vous pouvez maintenant commencer à utiliser &jovie; pour prononcer des textes. Cliquez sur l'onglet Tâches pour créer et gérer les tâches. Reportez-vous à jobmgr.

### Démarrage de &jovie; et choix des options générales

Une fois que vous avez configuré au moins un locuteur, vous pouvez démarrer le système de synthèse vocale de &kde;. Cliquez sur l'onglet Général. L'écran Général apparaît. Vous pouvez aussi définir certaines options générales dans cette fenêtre.

Le gestionnaire de synthèse vocale de &kde; (onglet Général). Le gestionnaire de synthèse vocale de &kde; (onglet Général).

- Cochez cette case pour activer le système &jovie;. Ceci démarre le démon de synthèse vocale de &kde; (Jovie). Si Jovie démarre correctement, l'onglet Tâches apparaît. Une fois &jovie; lancé, vous pouvez commencer à créer des tâches et écouter des textes. Reportez-vous à jobmgr. Décocher cette case arrêtera Jovie et désactivera le système de synthèse vocale de &kde;.

- Assurez-vous de cliquer ici pour enregistrer votre configuration.

### Gestion des tâches

Lorsque vous cliquez sur l'onglet Tâches dans `jovie`, l'écran Tâches apparaît.

Le gestionnaire de synthèse vocale de &kde; (onglet Tâches). Le gestionnaire de synthèse vocale de &kde; (onglet Tâches).

- Ce contrôle vous permet de changer les attributs de la voix qui parle actuellement. Ceci ne fonctionne que si vous n'avez aucune voix configurée dans l'onglet des locuteurs.

- Les boutons de cette ligne vous permettent d'arrêter, annuler, mettre en pause et reprendre la tâche actuelle.

- Les boutons de cette ligne vous permettent d'entendre le texte actuellement dans le presse-papier de &kde; ou d'ouvrir un fichier à prononcer.

- Lorsque vous cliquez sur le bouton Ok ou Appliquer, tous les changements, s'il y en a, seront appliqués.

L'onglet Tâches n'apparaît que lorsque &jovie; est en fonctionnement. Si vous ne voyez pas cet onglet, cliquez sur l'onglet Général et cochez la case Activer le système de synthèse vocale (Jovie).

### Prononcer des textes depuis des pages web

Lorsque vous utilisez le navigateur &konqueror; de &kde;, vous pouvez entendre le texte de la page web affichée. Pour ce faire, assurez-vous que &jovie; est lancé. Sélectionnez le texte que vous voulez entendre et choisissez Outils Prononcer le texte dans le menu principal. Après un moment, le texte sélectionné devrait être prononcé.

C'est généralement une bonne idée de sélectionner le texte de la page que vous voulez entendre. Vous pouvez sauter cette étape, mais vous entendrez alors beaucoup d'en-têtes &HTML; et d'autres balises invisibles.

### Prononcer du texte depuis l'éditeur de texte &kate;

Lorsque vous utilisez l'éditeur de texte avancé (&kate;) de &kde;, vous pouvez entendre le texte affiché. Pour ce faire, assurez-vous que &jovie; est lancé et activez l'extension Extension de synthèse vocale Jovie de KTextEditor dans la fenêtre de configuration de &kate;. Sélectionnez le texte que vous voulez entendre puis choisissez Outils Prononcer le texte dans le menu principal. Après un moment, le texte sélectionné devrait être prononcé.

Il n'est pas indispensable de sélectionner du texte. Si vous ne le faites pas, tout le fichier sera prononcé.

Ceci fonctionne aussi lorsque &kate; est embarqué dans d'autres programmes, comme &konqueror; ou &quanta;.

### Prononcer des notifications (KNotify)

KNotify est le sous-système de notifications de &kde;, qui vous prévient lorsque les évènements que vous configurez dans &kde; se produisent. Vous pouvez configurer &jovie; pour entendre ces notifications.

Par exemple, &konversation;, un client IRC pour &kde;, vous permet de configurer un grand nombre de notifications. Ainsi, vous pouvez demander à &konversation; de vous prévenir lorsqu'un message comportant votre nom apparaît dans un salon IRC. Avec &jovie;, vous pouvez demander à &kde; de prononcer pour vous le texte de ce message.

En général, si un programme &kde; gère KNotify, un élément de menu Notifications apparaîtra dans le menu Configuration. Les paramètres spécifiques de configuration de KNotify varient d'un programme à l'autre.

Les filtres de remplacement de chaîne sont un bon moyen de nettoyer les messages envoyés par les programmes s'ils sont mal prononcés ou mal dits dans &jovie;. Le fichier `kmail.xml` qui est fourni avec &jovie; en est un bon exemple. Il supprime les balises `br` et `b` des messages de notification et supprime aussi la phrase `/local/inbox` car elle peut être comprise implicitement dans la plupart des cas. Reportez-vous à stringreplacer.

### Filtres (avancé)

Les filtres sont une fonctionnalité avancée de &jovie;. Ils ne sont pas utiles pour effectuer les opérations de base avec &jovie;.

Les filtres sont utilisés pour prétraiter le texte avant qu'il soit envoyé au speech-dispatcher. Ils sont utiles pour améliorer la prononciation, substituer des mots ou abréviations mal prononcés, choisir la langue ou le locuteur appropriés ou contourner certaines limitations des synthétiseurs vocaux et de leurs voix.

#### Types de messages de &jovie;

Pour comprendre comment utiliser les filtres, il est utile de comprendre comment le texte est traité par le speech-dispatcher. Quatre types de texte peuvent être prononcés par &jovie;.

- Sortie de lecteur d'écran.

- Avertissements.

- Messages

- Tâches de texte

Le type est déterminé par le programme qui envoie le texte à &jovie;.

La sortie du lecteur d'écran a la plus haute priorité. Son usage est réservé aux logiciels de lecture d'écran. La sortie du lecteur d'écran préempte tous les autres messages, ce qui signifie que leurs tâches seront mises en pause le cas échéant. Une fois que le texte du lecteur d'écran a été prononcé, les messages mis en pause seront automatiquement repris.

Les avertissements ont la priorité suivante. Ce type est réservé aux messages de haute priorité, comme « le processeur surchauffe ». Un avertissement préemptera les messages et le texte conventionnel, et les mettra donc en pause. Une fois que l'avertissement aura été prononcé, les messages mis en pause seront automatiquement repris.

Les messages ont ensuite la priorité la plus haute. Un message préemptera les tâches concernant texte conventionnel. &kmouth; est un exemple de programme qui utilise les messages. Par exemple, lorsqu'il lit le texte d'une page web, &kmouth; peut être utilisé pour accueillir quelqu'un qui entre dans la pièce. Les notifications de &kde; sont aussi des messages (reportez-vous à knotify).

Le reste est constitué de tâches ordinaires. Tout travail que vous lancez dans l'onglet Tâches est une tâche de texte. KSayit est un exemple de programme qui utilise ce genre de tâches. Ces tâches sont destinées aux longs textes dont la lecture n'est pas urgente.

Les quatre types de tâches sont mises en file d'attente, sauf les sorties de lecteur d'écran. Si une sortie de lecteur d'écran est envoyée par un programme alors que &jovie; lit une autre sortie de lecteur d'écran, le message en cours de lecture est arrêté et rejeté.

#### Types de filtres

La première chose que vous devez savoir à propos des filtres est qu'ils ne sont jamais appliqués aux sorties des lecteurs d'écran. Ils sont appliqués aux avertissements, messages et tâches de texte ainsi qu'aux notifications de &kde; (KNotify).

Les filtres traitent le texte et le passent au filtre suivant. Il y a actuellement trois types de filtres.

- Remplacement de chaîne

- Transformation de XML

- Choix du locuteur

Les filtres sont implémentés en utilisant une architecture d'extension. D'autres types de filtres pourront être ajoutés dans le futur.

Les filtres de remplacement de chaîne remplacent des parties de texte par un autre texte. Les parties remplacées doivent correspondre à des mots ou à des expressions rationnelles. &jovie; est livré avec des filtres de remplacement prédéfinis pour prononcer les abréviations, lire les émoticônes de discussion en ligne ou retravailler les messages de &konversation; ou &kmail; pour leur donner une forme plus compréhensible.

La transformation &XML; utilise un fichier de transformation de langage &XML; (XSLT) pour convertir le &XML; depuis un format vers un autre. &jovie; est livré avec des fichiers XSLT permettant de convertir le &XHTML; en SSML.

Le sélecteur de locuteur vous permet de rediriger des tâches vers un autre locuteur, en fonction du contenu du texte, ou selon le programme qui envoie le texte à &jovie;. Par exemple, si vous avez configuré une locutrice dans l'onglet Locuteurs, vous pouvez diriger vers elle les textes venant de KSayIt. Reportez-vous à configure-talkers.

Chaque type de filtre a ses propres règles configurables pour déterminer quand le filtre doit s'appliquer au texte à prononcer. Si le filtre détermine qu'il ne doit pas s'appliquer, le texte est passé tel quel au filtre suivant.

Lorsqu'une tâche de texte, un message, un avertissement ou une notification de &kde; est envoyé à &jovie;, il passe à travers chaque filtre activé que vous avez configuré dans l'écran ci-dessous. L'ordre est de haut en bas.

#### Configuration des filtres

Pour utiliser les filtres, cliquez sur l'onglet Filtres dans `jovie`.

Le gestionnaire de synthèse vocale de &kde; (onglet Filtres). Le gestionnaire de synthèse vocale de &kde; (onglet Filtres).

- Voici la liste des filtres ordinaires configurés. Si un filtre est décoché, il est inactif et sera ignoré. Les filtres sont appliqués dans l'ordre spécifié ici, du haut vers le bas.

- Cliquez ici pour ajouter un nouveau filtre. Une fenêtre de dialogue vous demandera le type de filtre à ajouter. Après avoir choisi le type, regardez la boîte de dialogue de configuration ci-dessous.

- Cliquez ici pour retirer un filtre.

- Cliquez ici pour changer la configuration d'un filtre. Regardez la boîte de dialogue de configuration ci-dessous.

- Cliquez sur ces boutons pour déplacer un filtre vers le haut ou vers le bas dans la liste.

- Assurez-vous de ne pas oublier de cliquez ici, afin que vos choix soient vraiment pris en compte.

#### Configuration des filtres de remplacement de chaînes

Configurez les filtres de remplacement de chaîne en leur fournissant une liste de mots ou d'expressions rationnelles à repérer. Lorsque ces mots ou expressions sont trouvés dans le texte, chacun est remplacé par la chaîne de substitution que vous avez fournie.

Remplacement de chaîne Remplacement de chaîne

- Saisissez un nom pour votre filtre. Utilisez n'importe quel nom qui vous permette de distinguer ce filtre des autres.

- Voici la liste des mots et expressions rationnelles. Le filtre cherche les motifs correspondants à chaque chaîne de la colonne Correspondance et remplace la chaîne trouvée par celle de la colonne Remplacer par. La liste est traitée dans l'ordre dans lequel elle apparaît : de haut en bas.

- Cliquez ici pour ajouter un autre mot ou une autre expression rationnelle à la liste.

- Cliquez ici pour déplacer le mot ou l'expression rationnelle actuellement sélectionné(e) vers le haut ou vers le bas dans la liste.

- Cliquez ici pour changer un mot ou une expression rationnelle de la liste.

- Cliquez ici pour retirer de la liste le mot ou l'expression rationnelle actuellement sélectionné(e).

- Utilisez ces boutons pour charger une liste de mots ou d'expressions rationnelles depuis un fichier, enregistrer la liste actuelle dans un fichier ou vider toute la liste. Lorsque vous chargez des éléments depuis un fichier, ceux-ci seront ajoutés à la liste existante.

- Si ce champ n'est pas vide, le filtre ne s'appliquera que si la langue du locuteur correspond à la langue que vous saisissez ici. Cliquez sur le bouton pour afficher une liste des langues. Vous pouvez sélectionner plus d'une langue en appuyant sur &Ctrl; pendant que vous cliquez.

- Si ce champ n'est pas vide, le filtre ne s'appliquera que si le texte provient d'un des programmes listés. Vous pouvez saisir plus d'un programme ici, en séparant leurs noms par des virgules. Exemple: ``konversation,kmail``

  Vous pouvez découvrir l'Identifiant de programme des programmes en cours d'exécution en utilisant la commande `&qdbus;`. Vous devez ignorer les nombres &DBus;. Par exemple, si &qdbus; affiche comme identifiant `kopete-3432`, vous devez saisir simplement ``kopete``.

Le filtre de remplacement de chaîne ne s'appliquera au texte que si toutes les conditions non vides dans Appliquer ce filtre quand s'appliquent. Si tous les champs sont vides, le filtre s'appliquera à tout texte.

Lorsqu'il analyse des mots, le filtre de remplacement de chaîne utilise en interne une expression rationnelle de la forme `\s`mot`\s`. En d'autres termes, le mot doit comporter des espaces de part et d'autre dans le texte analysé.

Les explications sur l'écriture d'expressions rationnelles seraient hors-sujet dans ce manuel. Si l'éditeur d'expressions rationnelles de &kde; est installé sur votre système, un bouton est disponible sur les écrans Ajouter ou Édition pour vous aider à construire les expressions rationnelles. L'éditeur d'expressions rationnelles de &kde; fait partie du module Git Utils dans le dépôt playground.

&jovie; est livré avec quelques fichiers de listes de mots, y compris une liste d'émoticônes, comme « :-) », des abréviations utilisées notamment sur IRC ou dans les logiciels de messagerie instantanée et une liste d'autres abréviations. Il y a aussi une liste de caractères spéciaux que la voix polonaise de Festival de peut pas gérer. Si vous créez une liste de mots utile, utilisez le bouton Enregistrer pour l'enregistrer vers un fichier et envoyez-la à l'équipe de développement de &jovie; pour qu'elle soit incluse dans la prochaine versions.

#### Configuration des filtres de transformation &XML;

Le filtre de transformation &XML; utilise XSLT pour transformer du &XML; depuis un format vers un autre. XSLT, le langage de transformation de style &XML; est un langage standard W3C pour effectuer de telles transformations. Il ne peut être appliqué qu'à du &XML; syntaxiquement correct. L'utilitaire `xsltproc` doit être installé.

Transformation &XML; Transformation &XML;

- Saisissez un nom pour votre filtre. Utilisez n'importe quel nom qui vous permette de distinguer ce filtre des autres.

- Saisissez l'emplacement complet d'un fichier XSLT existant, qui effectuera la transformation.

- Spécifiez l'emplacement de l'utilitaire `xsltproc`. Si xsltproc est dans votre variable d'environnement PATH, saisissez simplement ``xsltproc``.

- Si ce champ n'est pas vide, le filtre ne s'appliquera que si le document &XML; possède l'élément racine spécifié ou une spécification `<!DOCTYPE` débutant par la chaîne saisie. Ceci permet de distinguer un format &XML; d'un autre. Par exemple, ``html`` dans le champ DOCTYPE correspondra à `<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" >`.

- Si ce champ n'est pas vide, le filtre ne s'appliquera que si le texte provient d'un des programmes listés. Vous pouvez saisir plus d'un programme ici, en séparant leurs noms par des virgules. Exemple: ``konversation,kmail``

  Vous pouvez découvrir l'Identifiant de programme des programmes en cours d'exécution en utilisant la commande `&qdbus;`. Vous devez ignorer les nombres &DBus;. Par exemple, si &qdbus; affiche comme identifiant `kopete-3432`, vous devez saisir simplement ``kopete``.

Le filtre de transformation &XML; ne s'appliquera au texte que si l'élément racine ou DOCTYPE correspondent et si l'identifiant de programme correspond à celui du champ Appliquer ce filtre quand. Si un des éléments de ce champ est vide, le test ne sera pas effectué. Donc, si tous les champs sont vides, le filtre s'appliquera à tout texte. Cependant, vous devez renseigner au moins un des champs, car beaucoup de tâches ne seront pas au format &XML;.

#### Configuration des filtres de choix de locuteur

Les filtres de choix de locuteur sont utilisés pour diriger le texte vers le locuteur voulu, configuré dans l'onglet Locuteurs ou vers tout locuteur ayant des attributs spécifiés. Par exemple, vous pouvez spécifier que le texte provenant de `kmail` doit être prononcé par un locuteur configuré avec une voix féminine. Reportez-vous à configure-talkers.

Juste avant que &jovie; commence à envoyer le texte à chacun des filtres, il sélectionne un locuteur pour prononcer le texte. Le choix du locuteur se fait en fonction des attributs du locuteur spécifiés par le programme qui envoie le texte à &jovie; et des attributs des locuteurs que vous avez configurés dans l'onglet Locuteurs. Le filtre de choix du locuteur vous permet de passer outre le choix du locuteur.

Sélecteur de locuteur Sélecteur de locuteur

- Saisissez un nom pour votre filtre. Utilisez n'importe quel nom qui vous permette de distinguer ce filtre des autres.

- Si ce champ n'est pas vide, le filtre s'appliquera seulement au texte contenant l'expression rationnelle saisie. Si le programme est installé, cliquez sur le bouton correspondant pour lancer l'éditeur d'expressions rationnelles de &kde; qui vous aidera à saisir l'expression rationnelle.

  Pour de meilleures performances, essayez d'« ancrer » l'expression rationnelle au début de la chaîne. En d'autres termes, commencez votre expression rationnelle par ``^``.

- Si ce champ n'est pas vide, le filtre ne s'appliquera que si le texte provient d'un des programmes listés. Vous pouvez saisir plus d'un programme ici, en séparant leurs noms par des virgules. Exemple: ``konversation,kmail``

  Vous pouvez découvrir l'Identifiant de programme des programmes en cours d'exécution en utilisant la commande `&qdbus;`. Vous devez ignorer les nombres &DBus;. Par exemple, si &qdbus; affiche comme identifiant `kopete-3432`, vous devez saisir simplement ``kopete``.

- Spécifiez ici les attributs du locuteur que vous voulez entendre prononcer le texte. Si le texte correspond aux conditions du filtre au-dessus, le locuteur dont les attributs correspondent le mieux à ceux que vous spécifiez ici sera choisi. Cliquez sur le bouton à droite pour afficher l'écran Sélection d'un locuteur.

- Utilisez ces boutons pour enregistrer votre configuration de choix de locuteur, charger des paramètres depuis un fichier enregistré ou effacer la configuration.

Le filtre de choix d'un locuteur ne s'appliquera au texte que si toutes les conditions des champs non vides sont remplies dans le champ Appliquer ce filtre quand. Vous devez remplir au moins un des champs.

## Guide du développeur de &jovie;

&jovie; a deux interfaces de programmation d'application (API)

- L'API de synthèse vocale de &kde; est utilisée par les programmeurs pour donner à leurs programmes des fonctionnalités de synthèse vocale. Les programmes communiquent avec &jovie; via &DBus;.

- L'extension d'API de synthèse vocale &jovie;, qui est utilisée pour ajouter des extensions de synthèse vocale à &jovie;, de telle sorte que &jovie; puisse fonctionner avec un nouveau moteur de synthèse vocale.

La section suivante donne une courte description de l'interface &DBus; de l'API de synthèse vocale de &kde;. Une documentation complète pour les deux API est disponible sur le site web de &kde; Accessibility (http://accessibility.kde.org).

### L'interface &DBus; de jovie

Les programmes communiquent les requêtes de synthèse vocale via l'interface &DBus; de &kde; pour créer des objets `KSpeech` de `jovie`.

Saisissez les commandes suivantes dans une &konsole;.

Si &jovie; n'est pas encore lancé

`jovie`

Pour ajouter en file d'attente une tâche de texte à prononcer

`qdbus org.kde.jovie /KSpeech say "`texte`" "`options`"`

où ``texte`` est le texte à prononcer et ``options`` est un code de langue, comme ``en``, ``fr``, &etc;

Exemple.

`qdbus org.kde.jovie /KSpeech say "Ceci est un test." "fr"`

De nombreuses autres commandes peuvent être envoyées. Pour voir une liste des commandes possibles, saisissez

`qdbus org.kde.jovie /KSpeech`

ou lisez en ligne l'API de synthèse vocale de &kde;.

## Questions et réponses

&reporting.bugs; &updating.documentation;

J'ai besoin de recommencer. Comment quitter complètement &jovie; ?

Saisissez les commandes suivantes dans une &konsole; :

    kquitapp jovie

Comment puis-je voir les informations de débogage de `jovie` ?

Ouvrez une &konsole;. Lancez la commande `jovie`.

Aucun des moteurs de synthèse vocale gérés ne gère la langue dont j'ai besoin. Où puis-je obtenir un synthétiseur pour ma langue ?

Google(tm) est votre ami. Ce lien peut aussi aider. Si vous trouvez un moteur de synthèse gratuit qui gère la langue que vous désirez et que vous voulez que &jovie; le gère, veuillez contacter l'équipe de développement. Les moteurs dont le code source est ouvert sont particulièrement les bienvenus. Si vous connaissez un synthétiseur commercial, peut-être pourrez-vous persuader le vendeur d'offrir une copie gratuite à l'équipe de développement de &jovie;. Cependant, vous pourrez peut-être utiliser le synthétiseur grâce aux commandes de speech-dispatcher.

J'ai un filtre de transformation&HTML; &XML; configuré, mais les pages web ne sont pas lues du tout avec l'extension Festival.

En raison d'un bug dans Festival 1.95 beta, vous devez installer la voix `rab_diphone` (homme britannique) pour SABLE pour que cela fonctionne, même si vous n'utilisez pas cette voix pour prononcer les pages web. Vérifiez aussi que l'utilitaire `xsltproc` est installé et ajouté dans le PATH.

Certains caractères ou signes de ponctuation semblent produire des erreurs dans le synthétiseur, le faisant sauter des phrases entières ou dire n'importe quoi. Que puis-je faire ?

Assurez-vous d'abord que l'option Encodage des caractères dans la boîte de dialogue de configuration du locuteur est correctement définie pour la langue concernée. Si certains mots ou caractères posent toujours problème, un filtre de remplacement de chaîne peut aider. Reportez-vous à filters.

## Crédits et licence

&jovie;

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

Mainteneur actuel : Jeremy Whiting jpwhiting@kde.org

Contributeurs :

- Gary Cramblitt garycramblitt@comcast.net

- Olaf Schmidt ojschmidt@kde.org

- Gunnar Schmi Dt gunnar@schmi-dt.de

- Paul Giannaros ceruleanblaze@gmail.com

Documentation : Copyright © 2009 Jeremy Whiting jpwhiting@kde.org © 2004 Gary R. Cramblitt garycramblitt@comcast.net

Traduction française par &PeterPotrowl;.

&underFDL; &underGPL;

Les moteurs de synthèse vocale utilisés par &jovie; ont leurs propres licences. Voir la documentation ou le site web de chaque moteur pour plus d'informations. Certaines voix ont également leur propre licence.

## Installation

### Comment obtenir &jovie;

&install.intro.documentation;

Commande d'installation sous Debian : `apt-get install jovie`

Vous trouverez des liens vers la source et les paquetages binaires sur le site web &kde; Accessibility (http://accessibility.kde.org).

Si vous avez accès au dépôt du code de &kde;, vous pouvez télécharger &jovie; en copiant le module `jovie`. &jovie; se trouve dans le dossier `jovie`. Vous pouvez aussi télécharger les fichiers .tar du code source de &jovie; depuis http://download.kde.org/stable/.

### Dépendances

Dépendances indispensables

- &kde; version 4.8 ou plus récente.

- speech-dispatcher version 0.67 ou plus récente.

- Un synthétiseur vocal. Les synthétiseurs et langues suivants sont actuellement gérés.

  Espeak | La plupart des langues. Lisez http://espeak.sourceforge.net/languages.html pour la liste des langues actuellement gérées
  Festival | Anglais américain, anglais britannique, espagnol, allemand, finnois, tchèque, polonais, russe, italien, français canadien, kiswahili, zoulou, et ibibio

  Ceci fonctionne aussi avec tout moteur de synthèse vocale pouvant être lancé depuis une commande dans une &konsole;.

  La liste des langues au-dessus peut ne pas être exhaustive ni à jour. Vérifiez les spécifications de chaque moteur pour une liste complète des langues gérées. Vérifiez aussi le site web de &jovie; pour plus d'informations qui pourraient être absentes de ce manuel.

  speech-dispatcher utilise une architecture d'extension flexible pour les moteurs de synthèse vocale. Si vous voulez améliorer &jovie; pour qu'il gère un autre moteur, contactez l'équipe de développement.

  Reportez-vous à configurationpour les instructions spécifiques à chacun de ces moteurs.

Composants optionnels :

- L'utilitaire `xsltproc` est nécessaire à la gestion du SSML et au filtre de transformation &XML; mais n'est pas obligatoire. Les utilisateurs de Debian peuvent installer xsltproc avec la commande `apt-get install xsltproc`.

### Compilation et installation

Pour compiler &jovie;, vous devez disposer d'une copie récente (&kde; 4.8 au moins) des fichiers de développement de &kde;, y compris kdelibs et les fichiers de développement pour speech-dispatcher.

Si vous avez téléchargé le code source de &jovie; depuis le module de dépôt de code de `kdeaccessibility` ou téléchargé le fichier .tar de la nuit, utilisez les commandes suivantes pour compiler et installer.

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

### Configuration

Veuillez vous assurer que speech-dispatcher fonctionne avec votre moteur de synthèse vocale avant d'utiliser &jovie;. Le script shell spd-conf peut être utilisé pour cela.

&jovie;, dans &kde; 4.5, est un renommage de KTTSD et kttsmgr. Dans le futur, &jovie; sera capable de configurer un speech-dispatcher directement, sans spd-conf.

&documentation.index;