# Manuel utilisateur de &kmouth;

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

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

## Utiliser &kmouth;

### Le paramétrage pour le premier démarrage

Lors du premier lancement de &kmouth;, un assistant apparait, dans lequel vous pouvez le configurer.

Configuration de la synthèse vocale Configuration de la synthèse vocale

Avec la première page de l'assistant, vous spécifiez le moteur et la voix à utiliser pour la synthèse vocale. Pour plus de détails, veuillez consulter la description de la boite de dialogue de configuration.

Complètement automatique Complètement automatique

Avec la troisième page, 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 capture d'écran) et un historique de phrases prononcées (La zone blanche supérieure dans la capture d'écran).

La fenêtre principale de &kmouth; La fenêtre principale de &kmouth;

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 boite de dialogue de configuration

En utilisant l'entrée de menu Configuration Configurer &kmouth;..., vous pouvez ouvrir la boite de dialogue de configuration de &kmouth;. Cette boite de configuration contient les pages Options générales contenant deux onglets Préférences et Synthèse vocale, la page Complètement des mots.

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

L'onglet Préférences Capture 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 Sélection des phrases dans le carnet de phrases, vous spécifiez l'option à déclencher 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é à la fermeture de la fenêtre pour la modification 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 Synthèse vocale

L'onglet Synthèse vocale Capture d'écran

En sélectionnant Utiliser le service de synthétiseur par défaut, vous indiquez à &kmouth; d'essayer d'utiliser d'abord le service de synthétiseur vocal avant d'appeler le synthétiseur vocal directement. Si cela réussit, les autres entrées de configuration sur cet onglet sont ignorées. Le service de synthèse vocale est une bibliothèque &Qt; intégrant le synthétiseur vocal dans &Linux; et les systèmes vocaux natifs sur d'autres plate-formes. Sur un système conçu à partir de Debian, vous devez installer les paquets « speech-dispatcher », « libqt5texttospeech5 » et un des modules de synthèse vocale, en général espeak.

Utiliser un outil en ligne de commandes `spd-conf` (paquet Debian « python3-speechd ») pour ajuster les paramètres comme le taux, le pas, le volume, le type de voix, le langage, &etc; pour le système de synthèse par défaut. De plus, `spd-conf` vous permettra de choisir parmi tous les modules installés pour les synthétiseurs vocaux, comme &pex; espeak, festival, flite, mbrola &etc;

Il est également possible de sélectionner Moteur et Voix pour le système de synthèse vocale.

Lorsque l'élément Utiliser un système de synthèse vocale par défaut est non sélectionné, vous pouvez saisir la commande d'appel au synthétiseur vocal, dans le champ de saisie du panneau Alternative. Avec la liste déroulante en dessous de la zone de saisie, 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 contient 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.

#### La page « Complètement automatique »

La page Complètement automatique Capture 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 boite 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 boite 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 boite 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 parcourra 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 le clavier GNOME GOK en plein é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 apparait. 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 Capture 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-papier. S'il y a du texte sélectionné dans la zone d'édition, il est placé dans le presse-papier. Autrement, les phrases sélectionnées dans l'historique (s'il y en a) sont placées dans le presse-papier.

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

&kmouth; possède les éléments de menus Configuration et Aide communs de &kde;. Pour plus d'informations, veuillez consulter les sections sur le menu « Configuration » et le menu « Aide » des fondamentaux de &kde;.

### 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;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

Les éléments de ce menu sont les mêmes que ceux de la fenêtre principale

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

&Ctrl;X Couper

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

&Ctrl;C Copier

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

&Ctrl;O Coller

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

Supprimer

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

## Remerciements et licence

&kmouth;

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

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

Traduction française par &RobertJacolin; et &LudovicGrossard;.

&underFDL; &underGPL;