# Manuel de &kmouth;

Gunnar Schmi Dt

    gunnar@schmi-dt.de

&traducteurRobertJacolin;
2002 2003 Gunnar Schmi Dt
&FDLNotice;
2004-05-31
1.1.1

&kmouth; est une application qui permet aux personnes qui ne peuvent pas parler de laisser parler leur ordinateur à leur place.

KDE kdeutils KMouth Synthèse vocale personnes mutuelles

## Introduction

&kmouth; est une application qui permet aux personnes qui ne peuvent pas parler de laisser parler leur ordinateur à leur place. Il contient un historique des phrases prononcées, dans lequel l'utilisateur peut piocher des phrases pour les faire prononcer à nouveau.

Notez que &kmouth; ne contient pas de synthétiseur vocal. En revanche, il nécessite un synthétiseur vocal installé sur le système.

Veuillez rapporter tout problème et toute demande d'amélioration à l'auteur de &kmouth;.

## Utiliser &kmouth;

### Le premier démarrage

Lors du premier lancement de &kmouth;, un assistant apparaît, dans lequel vous pouvez choisir une configuration de base.

L'assistant

L'assistant

Avec la première page de l'assistant (la copie d'écran de gauche), vous spécifiez la commande qui sera utilisée plus tard pour la synthèse vocale. Pour de plus amples détails, consultez la description de la boîte de dialogue de configuration.

Avec la seconde page, vous choisissez les carnets de phrases standard dont vous avez besoin. Plus tard, à partir des carnets de phrases, vous pourrez sélectionner des phrases souvent utilisées pour que vous n'ayez pas besoin de les saisir. Évidemment, &kmouth; possède aussi une boîte de dialogue d'édition pour le cas où vous voudriez plus tard modifier vos carnets de phrases.

Avec la troisième page (la capture d'écran à droite) vous pouvez définir le dictionnaire pour compléter un mot. &kmouth; cherchera dans la documentation de KDE de la langue choisie pour détecter la fréquence des mots. De manière optionnelle, vous pouvez comparer la liste de mots avec un dictionnaire OpenOffice.org afin de n'ajouter que des mots correctement écrits au complètement des mots.

### La fenêtre principale

La fenêtre principale de &kmouth; est plutôt simple. Elle consiste en un champ d'édition dans lequel vous saisissez vos phrases (le champ blanc le plus bas dans la copie d'écran) et un historique de phrases prononcées (la zone blanche supérieure dans la copie d'écran).

La fenêtre principale de &kmouth;

Copie d'écran

En supposant que vous ayez configuré &kmouth; correctement, vous pouvez utiliser le champ d'édition pour saisir des phrases que vous voulez entendre. Une fois une phrase prononcée, elle sera ajoutée à l'historique. À partir de l'historique, vous pouvez sélectionner des phrases pour qu'elles soient prononcées à nouveau.

À partir du carnet de phrases (situés dans la zone en dessous de la barre d'outils), vous pouvez sélectionner des phrases souvent utilisées.

### La boîte de dialogue de configuration

En utilisant l'entrée de menu Configurations Configurer &kmouth;..., vous pouvez ouvrir la boîte de dialogue de configuration de &kmouth;. Cette boîte de configuration contient deux onglets, Synthèse vocale et Préférences.

#### L'onglet Synthèse vocale

L'onglet Synthèse vocale

Copie d'écran

Dans le champ d'édition de l'onglet de Synthèse vocale, vous pouvez saisir la commande pour appeler le synthétiseur vocal. Avec la liste déroulante en dessous de la zone d'édition, vous pouvez spécifier l'encodage des caractères qui est utilisé pour passer le texte au synthétiseur vocal.

&kmouth; connaît deux manières de passer du texte. Si la commande attend du texte dans l'entrée standard, vous devez cocher la case.

L'autre manière est de passer le texte par un paramètre. Avant d'appeler la commande, &kmouth; remplace certaines expressions remplaçables avec le contenu réel :

Des expressions remplaçables | Remplacer avec
--- | ---
%t | Ce texte doit être parlé
%f | Le nom d'un fichier temporaire qui contiens ce texte qui doit être parlé
%l | Le code du langage associé au mot courant dans le dictionnaire des compléments
%% | Un symbole de pourcentage

Évidemment, la commande pour prononcer du texte dépend du synthétiseur vocal que vous utilisez. Veuillez consulter la documentation de votre synthétiseur vocal pour la commande de prononciation de texte. Vous pouvez trouver des exemples pour la commande dans l'appendice.

En sélectionnant Utiliser le service de synthétiseur KTTSD si possible, vous ordonnez à &kmouth; d'essayer d'envoyer d'abord le texte au service de synthétiseur vocal KTTSD. Si cela réussit, les autres entrées de configuration sur cet onglet sont ignorées. Le service de synthèse KTTSD est un démon &kde;qui donne aux applications &kde; une interface standardisée de synthétiseur vocal et qui est en cours de développement sous CVS. Il n'y a pas de danger à sélectionner cette option même si KTTSD n'est pas installé.

#### L'onglet Préférences

L'onglet Préférences

Copie d'écran

L'onglet Préférences contient des options qui modifient le comportement de &kmouth; dans certaines situations.

Avec la première liste déroulante, La sélection des phrases dans le carnet de phrases :, vous spécifiez l'option qui est déclenchée lors de la saisie d'un raccourci d'une phrase ou en sélectionnant une phrase dans le menu Carnet de phrasesou dans la barre de carnet de phrases.

En sélectionnant Prononce tout de suite, la phrase sélectionnée est immédiatement prononcée et est insérée dans l'historique. Si vous sélectionnez Insère dans le champ d'édition, la phrase est simplement insérée dans le champ d'édition.

Avec la seconde liste déroulante Fermeture de la fenêtre d'édition du carnet de phrases, vous spécifiez si le carnet de phrases est enregistré quand vous fermez la fenêtre d'édition du carnet de phrases.

En sélectionnant Enregistrer le carnet de phrases, le carnet de phrases est enregistré. Si vous sélectionnez Abandonne les modifications, les changements sont abandonnés et le carnet de phrases ne sera pas enregistré. Si vous sélectionnez Demande s'il faut enregistrer, &kmouth; vous demandera s'il faut enregistrer le carnet de phrases.

#### L'onglet Auto-complètement des mots

L'onglet Auto-complètement des mots

Copie d'écran

La page de l'auto-complètement des mots contient une liste de dictionnaires qui sont utilisés pour le complètement des mots. (&kmouth;affichera une boîte de dialogue à côté du champ d'édition de la fenêtre principale si la liste contient plus d'un seul dictionnaire. Vous pouvez utiliser cette boîte de dialogue pour sélectionner le dictionnaire qui est utilisé pour le complètement des mots).

Avec les boutons à la droite de la page vous pouvez ajouter et éliminer des dictionnaires, changer l'ordre des dictionnaires ou exporter des dictionnaires vers un fichier. Avec le champ édition et la boîte de dialogue en dessous de la liste vous pouvez changer le nom et la langue associés au dictionnaire.

Quand vous ajoutez un nouveau dictionnaire vous pouvez choisir entre plusieurs sources :

- Créer un nouveau dictionnaire à partir de la documentation de KDE

  SI vous utilisez cette source, &kmouth; vous demandera une choix de langage et après il parcourira la documentation KDE. La fréquence de chaque mot est déterminée tout simplement en comptant sa présence. De manière optionnelle vous pouvez comparer la liste des mots à un dictionnaire de OpenOffice.org pour ajouter uniquement les mots qui ont une écriture correcte au nouveau dictionnaire.

- Créer un nouveau dictionnaire à partir d'un fichier

  SI vous utilisez cette source &kmouth; vous demandera le fichier en question. Vous pouvez sélectionner soit un fichier XML, un fichier de texte usuel ou bien un dictionnaire de complètement créé par&kmouth; ou GOK (le clavier GNOME en écran). Si vous sélectionnez un fichier de texte ou un fichier XML la fréquence de chaque mot est déterminée en comptant le nombre de fois qu'il apparaît. De manière optionnelle, vous pouvez comparer la liste des mots avec un dictionnaire OpenOffice.org pour ajouter seulement les mots qui ont une écriture correcte au nouveau dictionnaire.

- Créer un nouveau dictionnaire à partir d'un dossier

  Si vous utilisez cette source &kmouth; vous demandera pour le dossier en question. &kmouth; ouvrira tous les fichiers dans ce dossier et ses sous-dossiers. Chaque fichier est chargé soit comme un dictionnaire de complètement, comme un fichier XML ou comme un fichier texte. Dans les deux derniers cas la présence de chaque mot est comptée. De manière optionnelle, vous pouvez comparer la liste des mots avec un dictionnaire OpenOffice.org pour ajouter seulement les mots qui ont une écriture correcte au nouveau dictionnaire.

- Fusionner les dictionnaires

  Vous pouvez utiliser cette option pour fusionner les dictionnaires disponibles. &kmouth; vous demandera quels sont les dictionnaires à fusionner et comment les dictionnaires individuels doivent être pris en compte.

- Créer un liste

  Vous pouvez utiliser cette option pour créer un dictionnaire vide sans aucune entrée. Puisque &kmouth; ajoute de manière automatique chaque mot nouveau aux dictionnaires, il apprendra le vocabulaire avec le temps.

### La fenêtre d'édition du carnet de phrases

En utilisant l'entrée de menu Carnets de phrases Éditer... vous ouvrez la fenêtre d'édition du carnet de phrases.

La fenêtre d'édition du carnet de phrases

Copie d'écran

La zone principale de la fenêtre d'édition du carnet de phrases est divisée en deux parties. Dans la partie supérieure, les carnets de phrases sont affichées dans une structure arborescente.

Dans la partie inférieure, vous pouvez modifier un élément sélectionné. Si vous avez sélectionné une phrase, vous pouvez modifier le contenu de la phrase ainsi que son raccourci. Si vous avez sélectionné un carnet de phrases, vous pouvez seulement changer son nom.

Des actions comme l'ajout de nouvelles phrases ou de nouveaux carnets, la suppression de phrases sélectionnées ou de carnets peuvent être effectuées en les sélectionnant soit dans la barre de menu, soit dans la barre d'outils, soit dans le menu contextuel.

Vous pouvez modifier l'ordre des carnets de phrases et des phrases en les déplaçant vers leur nouvel emplacement ou en utilisant les touches fléchées avec la touche &Alt; enfoncée.

## Référence des commandes

### Commandes de la fenêtre principale

#### Le menu Fichier

&Ctrl;O Fichier Ouvrir en tant historique...

  Ouvre un fichier texte dans l'historique des phrases prononcées.

&Ctrl;S Fichier Enregistrer l'historique sous...

  Enregistre l'historique dans un fichier texte.

&Ctrl;P Fichier Imprimer l'historique...

  Imprime l'historique.

&Ctrl;Q Fichier Quitter

  Quitte &kmouth;

#### Le menu Édition

&Ctrl;X Édition Couper

  Coupe la section sélectionnée et la place dans le presse-papiers. S'il y a du texte sélectionné dans la zone d'édition, il est placé dans le presse-papiers. Autrement, les phrases sélectionnées dans l'historique (s'il y en a) sont placées dans le presse-papiers.

&Ctrl;C Édition Copier

  Copie la section sélectionnée dans le presse-papiers. S'il y a du texte sélectionné dans le champ d'édition, il est copié dans le presse-papiers. Autrement, les phrases sélectionnées dans l'historique (s'il y en a) sont copiées dans le presse-papiers.

&Ctrl;V Édition Coller

  Colle le contenu du presse-papiers au niveau du curseur dans le champ d'édition.

Édition Parler

  Prononce les phrases actives. S'il y a du texte dans le champ d'édition, il est prononcé. Autrement, les phrases sélectionnées dans l'historique (s'il y en a) sont prononcées.

#### Le menu Carnets de phrases

Carnets de phrases Éditer...

  Ouvre la fenêtre d'édition du carnet de phrases.

#### Le menu Configuration

Configuration Afficher la barre de menus

  Si coché ceci montrera la barre des outils. Dans le cas contraire la barre des outils sera cachée.

Configuration Afficher la barre d'outils

  Si cochée, cette option affiche une barre d'outils mobile contenant des boutons utilisés pour lancer des commandes fréquemment utilisées. La barre d'outils est située la plupart du temps en haut de l'éditeur, juste sous le menu. Lorsqu'elle n'est pas cochée, la barre d'outils est cachée. Un clic sur la poignée striée cache ou affiche la barre [NdT - Non. Mais vous pouvez réduire la barre en cliquant du &BDS; sur la zone striée et en choisissant Orientation- / Réduite]. Un clic puis un déplacement sur cette poignée permet à l'utilisateur de déplacer la barre.

Configuration Afficher la barre des carnets de phrases

  Si cochée, cette option affiche une barre de carnet de phrases mobile contenant des boutons pour les éléments du carnet de phrases. La barre de carnet de phrases est située la plupart du temps en haut de l'éditeur, juste sous la barre d'outils. Lorsqu'elle n'est pas cochée, la barre de carnet de phrases est cachée. Un clic sur la poignée striée cache ou affiche la barre [NdT - Non. Mais vous pouvez réduire la barre en cliquant du &BDS; sur la zone striée et en choisissant Orientation- / Réduite]. Un clic puis un déplacement sur cette poignée permet à l'utilisateur de déplacer la barre.

Configuration Afficher la barre d'état

  Lorsqu'elle est cochée, cette option affiche une petite barre sur le bas de la fenêtre principale contenant des informations sur l'état de &kmouth;. Lorsqu'elle n'est pas cochée, la barre d'état est cachée.

Configuration Configurer KMouth...

  Ouvre la boîte de dialogue de configuration du synthétiseur vocal et d'autres paramètres de &kmouth;.

#### Le menu Aide

&help.menu.documentation;

#### Le menu contextuel des éléments de l'historique

Prononcer

  Les phrases sélectionnées sont prononcées.

Supprimer

  Les phrases sélectionnées sont supprimées de l'historique.

Couper

  Les phrases sélectionnées sont supprimées et placées dans le presse-papiers.

Copier

  Les phrases sélectionnées sont copiées dans le presse-papiers.

Sélectionner tous les éléments

  Tous les éléments de l'historique sont sélectionnés.

Désélectionner toutes les entrées

  Tous les éléments de l'historique ne sont plus sélectionnés.

&Ctrl;O Ouvrir en tant qu'historique...

  Ouvre un fichier texte dans l'historique des phrases prononcées.

&Ctrl;S Enregistrer l'historique sous...

  Enregistre l'historique dans un fichier texte.

### Commandes dans la fenêtre d'édition des carnets de phrases

#### Le menu Fichier

Fichier Nouvelle phrase

  Ajoute une nouvelle phrase.

Fichier Nouveau carnet de phrases

  Ajoute un nouveau carnet de phrases.

&Ctrl;S Fichier Enregistrer

  Enregistre le carnet de phrases.

Fichier Importer...

  Importe un fichier et ajoute son contenu au carnet de phrases

Fichier Importer un carnet de phrases standard

  Importe un carnet de phrases standard et ajoute son contenu au carnet de phrases

Fichier Exporter...

  Exporte les phrases ou des carnets de phrases en cours de sélection dans un fichier

&Ctrl;P Fichier Imprimer...

  Imprime des phrases ou des carnets de phrases en cours de sélection

&Ctrl;W Fichier Fermer

  Ferme la fenêtre

#### Le menu Édition

&Ctrl;X Édition Couper

  Coupe les éléments sélectionné et les place dans le presse-papiers.

&Ctrl;C Édition Copier

  Copie les éléments sélectionnés dans le presse-papiers.

&Ctrl;V Édition Coller

  Colle le contenu du presse-papiers dans le carnet de phrases.

Édition Supprimer

  Supprime les éléments sélectionnés.

#### Le menu Aide

&help.menu.documentation;

#### Le menu contextuel

Nouvelle phrase

  Ajoute une nouvelle phrase.

Nouveau carnet de phrases

  Ajoute un nouveau carnet de phrases.

Importer...

  Importe un fichier et ajoute son contenu au carnet de phrases

Importer un carnet de phrases standard

  Importe un carnet de phrases standard et ajoute son contenu au carnet de phrases

Exporter...

  Exporte les phrases ou des carnets de phrases en cours de sélection dans un fichier

Couper

  Coupe les éléments sélectionné et les place dans le presse-papiers.

Copier

  Copie les éléments sélectionnés dans le presse-papiers.

Coller

  Colle le contenu du presse-papiers à cet emplacement dans le carnet de phrases.

Supprimer

  Supprime les éléments sélectionnés.

## Questions et réponses

&reporting.bugs; &updating.documentation;

Je n'entends rien.

Il y a de fortes chances que vous n'ayez pas configuré correctement (ou pas du tout ?), la commande de synthèse vocale. Utilisez Configuration Synthèse vocale et saisissez la commande pour prononcer du texte (consultez la section sur la boîte de dialogue de configuration de synthèse vocale pour de plus amples détails).

## Remerciements et licence

&kappname;

Programme sous copyright 2002-2004 Gunnar Schmi Dtgunnar@schmi-dt.de

Documentation sous copyright 2002-2004 Gunnar Schmi Dt gunnar@schmi-dt.de

Traduction française par &RobertJacolin;.

&underFDL; &underGPL;

## Exemples pour la configuration de la synthèse vocale

Festival

Festival est un système de transformation de texte en parole écrit par l'université d'Edinburgh. Il supporte l'anglais, l'espagnol et la langue Welsh. Sa licence permet d'utiliser et de distribuer Festival sans aucun frais et sans restrictions.

Pour créer l'exemple de commande en ligne pour la configuration de texte vers la parole nous supposons que Festival est installé dans le dossier `/usr/local/festival/`. La commande pour textes parlants est la suivante :

    /usr/local/festival/bin/festival --tts

L'option Envoyer les données comme une entrée standard doit être activée.

FreeTTS

FreeTTS est un synthétiseur de voix écrit entièrement dans le langage de programmation Java™. Il supporte seulement la prononciation anglais. Sa licence permet d'utiliser et de distribuer FreeTTS sans aucun frais et sans restrictions.

Pour créer l'exemple de commande en ligne pour la configuration de texte vers la parole nous supposons que FreeTTS est installé dans le dossier `/usr/local/freetts/`. La commande pour des textes parlants est une des choix suivantes :

    java -jar /usr/local/freetts/lib/freetts.jar -text %t

    java -jar /usr/local/freetts/lib/freetts.jar -file %f

    java -jar /usr/local/freetts/lib/freetts.jar

Pour le troisième exemple l'option Envoyer les données comme entrée standard doit être activée. (Ceci est l'exemple préféré pour son utilisation avec FreeTTS).

MBROLA

MBROLA est un synthétiseur pour un grand nombre de langages. Il transforme une liste de phonemes dans un fichier audio donc vous avez besoin d'un outil pour convertir le texte dans une liste de phonemes. La licence MBROLA permet d'utiliser MBROLA sans aucun frais pour une utilisation non-commerciale et non-militaire.

Pour nôtre exemple nous allons utiliser Hadifax pour convertir des textes en allemand dans une liste de phonemes appropriés pour MBROLA. Nous allons supposer qu'Hadifax et MBROLA sont installés dans `/usr/local/hadifax/` et `/usr/local/mbrola/`.

Malheureusement Hadifax a une tendance a bouffer le dernier caractère dans un texte donc nous voudrions ajouter un caractère additionnel à la fin du texte. La commande complète est donc plus compliquée que dans les exemples précédents :

    (cat -; echo " ") | /usr/local/hadifax/txt2pho -f
              | /usr/local/mbrola/mbrola -e
              /usr/local/mbrola/de1/de1 - /tmp/tmp.wav;
              artsplay /tmp/tmp.wav; rm /tmp/tmp.wav

Tous les parties de cette commande doivent être écrites dans une seule ligne. L'option Envoyer les données comme entrée standard doit être activée.

Le démon de synthèse vocale de KDE

Le démon KDE du texte vers la parole (KTTSD) est un service &kde; de texte vers la parole qui donne aux logiciels &kde; une interface standard pour la synthèse de voix et est actuellement développée en CVS. Ce service utilise des modules d'extension pour supporter divers systèmes de transformation de texte vers la parole.

Lorsque la configuration du synthétiseur de voix est faite dans KTTSD la seule option spécifique &kmouth; que vous devez activer est Utiliser le service de voix KTTSD si possible.

Bien sûr vous devez configurer KTTSD. Vous pouvez faire cela avec la page de configuration Service de voix KTTSD qui est ajoutée a la boîte de configuration de &kmouth; si KTTSD est installé.

## Installation

### Comment obtenir &kmouth;

&install.intro.documentation;

### Prérequis

Pour utiliser &kmouth; avec succès, il vous faut un synthétiseur vocal (et bien sûr &kde; 3.x). &kmouth; utilise environ 15 Mo de mémoire pour fonctionner (plus la quantité de mémoire nécessaire pour faire la synthèse vocale), mais cela peut varier selon votre plate-forme et votre configuration.

### Compilation et installation

&install.compile.documentation;