# Das Handbuch zu &kmouth;

## Einführung

Mit dem Programm &kmouth; können stumme Benutzer den Computer für sich sprechen lassen. Der Benutzer kann aus einer Liste mit dem Gesprächsverlauf Sätze wählen, die erneut gesprochen werden sollen.

Beachten Sie, dass &kmouth; keinen Sprachsynthesizer beinhaltet Auf dem Rechner muss ein Sprachsynthesizer installiert sein.

## Arbeiten mit &kmouth;

### Einstellungen beim ersten Start

Beim ersten Start von &kmouth; erscheint ein Assistent für die Einstellungen.

Einrichtung der Sprachausgabe Einrichtung der Sprachausgabe

Auf der ersten Seite des Assistenten geben Sie den Befehl ein, der für die Sprachausgabe von Text verwendet wird. Weitere Einzelheiten finden Sie in der Beschreibung des Einrichtungsdialogs.

Erstes Textpassagen-Buch Erstes Textpassagen-Buch

Auf der zweiten Seite wählen Sie das Standard-Textpassagen-Buch. Aus den Textpassagen-Büchern können Sie oft verwendete Textpassagen wählen, ohne sie eintippen zu müssen. Die Textpassagen können natürlich bearbeitet werden.

Wortergänzung Wortergänzung

Auf der dritten Seite bestimmen Sie das Wörterbuch für die Wortergänzung. &kmouth; liest die KDE-Dokumentation der gewählten Sprache ein, um die Häufigkeit der einzelnen Worte zu bestimmen. Zusätzlich können Sie die Wortlisten mit einem OpenOffice.org-Wörterbuch abgleichen, damit nur richtig buchstabierte Worte in die Wortergänzung aufgenommen werden.

### Das Hauptfenster

Das Hauptfenster von &kmouth; ist übersichtlich und enthält im Wesentlichen ein Eingabefeld für die Tastatureingabe Ihrer Sätze (das untere weiße Feld im Bildschirmfoto) und einen Verlaufsspeicher der schon gesprochenen Sätze (das obere weiße Feld im Bildschirmfoto).

Das Hauptfenster von &kmouth; Das Hauptfenster von &kmouth;

Wenn Sie &kmouth; richtig einrichtet haben, können Sie im Eingabefeld die Sätze eingeben, die Sie hören wollen. Jeder gesprochene Satz wird an den Verlaufsspeicher angehängt. Sie können daraus Sätze auswählen, die erneut gesprochen werden sollen.

Im Textpassagen-Buch (in der Zeile unter der Werkzeugleiste) können Sie oft benutzte Textpassagen wählen.

### Der Einrichtungsdialog

Mit dem Menü-Eintrag Einstellungen&kmouth; einrichten ... öffnen Sie den Einstellungsdialog von &kmouth;. Dieser Dialog besteht aus der Seite Allgemeine Einstellungen mit den zwei Karteikarten Persönliche Einstellungen und Sprachausgabe und der Seite Wortergänzung.

#### Die Karteikarte Persönliche Einstellungen

Die Karteikarte Persönliche Einstellungen Bildschirmfoto

Auf der Karteikarte Persönliche Einstellungen kann das Verhalten von &kmouth; eingestellt werden.

Mit dem ersten Auswahlfeld Aktion nach der Auswahl einer Textpassage bestimmen Sie, welche Aktion durch das Tastenkürzel oder durch die Wahl einer Textpassage im Menü Textpassagen-Buch oder in der Leiste für Textpassagen-Bücher ausgelöst wird.

Mit der Auswahl von Sofort sprechen wird die gewählte Textpassage direkt gesprochen und zusätzlich in den Verlaufsspeicher eingefügt. Mit der Auswahl von In das Eingabefeld übertragen wird die gewählte Textpassage zunächst nur in das Eingabefeld eingetragen.

Mit dem zweiten Auswahlfeld Schließen des Bearbeitungsfensters für Textpassagen-Buch können Sie festlegen, ob das Textpassagen-Buch beim Schließen des Bearbeitungsfensters automatisch gespeichert werden soll.

Mit der Auswahl von Textpassagen-Buch speichern wird das Buch gespeichert. Wenn Sie Änderungen verwerfen wählen, wird das Textpassagen-Buch nicht gespeichert. Wählen Sie Vor Speichern nachfragen, wird &kmouth; fragen, ob das Textpassagen-Buch gespeichert werden soll.

#### Die Karteikarte Sprachausgabe

Die Karteikarte Sprachausgabe Bildschirmfoto

Mit Voreingestelltes Sprachausgabesystem verwenden wird als erstes versucht, den Sprachausgabedienst des Systems zu benutzen, dann erst direkt den Sprachsynthesizer. Wenn das erfolgreich ist, werden die weiteren Einstellungen auf dieser Seite ignoriert. Der Sprachausgabedienst des Systems ist eine &Qt;-Bibliothek, die eine standardisierte Schnittstelle für Sprachausgabe zu speech-dispatcher unter &Linux; und zu den nativen Sprachausgabesystemen auf anderen Plattformen zur Verfügung stellt. Auf einen Debian basierten System benötigen Sie die Pakete speech-dispatcher, libqt5texttospeech5 und ein Modul für speech-dispatcher wie normalerweise espeak.

Mit dem Befehlszeilenprogramm `spd-conf` (Debian-Paket python3-speechd) können Sie Einstellungen wie Geschwindigkeit, Tonlage, Lautstärke, Stimmtyp und Sprache &etc; für das Standard-Sprachsystem ändern. Außerdem können Sie mit `spd-conf` zwischen allen installierten speech-dispatcher-Modulen &ie; espeak, festival, flite, mbrola &etc; wechseln.

Im Eingabefeld der Karteikarte Sprachausgabe geben Sie den Befehl zum Aufruf des Sprachgenerators ein. Im Auswahlfeld unter dem Eingabefeld legen Sie die Zeichenkodierung fest, mit der Text an den Sprachgenerator weitergegeben wird.

&kmouth; kennt zwei Arten, den Text weiterzugeben. Wählen Sie das Ankreuzfeld, wenn der Text unverändert als Standardeingabe an den Sprachgenerator weitergegeben werden soll.

Ist das Ankreuzfeld nicht ausgewählt, wird der Text als Parameter weitergegeben. Sie können dabei die folgenden Platzhalter verwenden:

Platzhalter | Ersetzt durch
%t | Der aktuelle Text, der gesprochen werden soll
%f | Der Name der temporären Datei mit dem Text, der gesprochen werden soll
%l | Der Sprachcode für das aktuelle Wortergänzungsbuch
%% | Ein Prozentzeichen

Natürlich hängt der Befehl zur Sprachausgabe von Ihrem Sprachgenerator ab. Diesen Befehl finden Sie in der Dokumentation zu Ihrem Sprachgenerator.

#### Die Seite Wortergänzung

Die Seite Wortergänzung Bildschirmfoto

Die Seite Wortergänzung enthält eine Liste von Wörterbüchern für die Wortergänzung. Im Hauptfenster neben dem Eingabefeld zeigt &kmouth; ein Auswahlfeld an, wenn diese Liste mehr als ein Wörterbuch enthält. Mit diesem Auswahlfeld können Sie das aktuell benutzte Wörterbuch zur Wortergänzung wählen.

Mit den Knöpfen rechts auf der Seite können Sie Wörterbücher löschen oder hinzufügen, die Reihenfolge der Bücher ändern oder sie in eine Datei exportieren. Unterhalb der Liste können Sie im Eingabefeld den Namen und im Auswahlfeld die Sprache für das Wörterbuch einstellen.

Wenn Sie ein neues Wörterbuch einfügen, können Sie dafür mehrere Quellen benutzen:

- Neues Wörterbuch aus der Dokumentation von &kde; erstellen

  Wählen Sie für diese Quelle die gewünschte Sprache; &kmouth; liest daraufhin die &kde;-Dokumentation ein. Die Häufigkeit der einzelnen Worte wird einfach durch Abzählen des Auftretens ermittelt. Zusätzlich können Sie die Wortliste mit einem OpenOffice.org-Wörterbuch vergleichen, um nur richtig geschriebene Worte in das neue Wörterbuch einzufügen.

- Neues Wörterbuch aus einer Datei erstellen

  Wählen Sie für diese Quelle die gewünschte Datei. Sie können entweder eine &XML;-Datei, eine Textdatei oder eine Wörterbuchdatei angeben, die entweder mit &kmouth; oder mit GOK (GNOME On-Screen-Keyboard) erzeugt wurde. Bei einer Textdatei oder einer &XML;-Datei wird die Häufigkeit der einzelnen Worte einfach durch Abzählen des Auftretens ermittelt. Zusätzlich können Sie die Wortliste mit einem OpenOffice.org-Wörterbuch vergleichen, um nur richtig geschriebene Worte in das neue Wörterbuch einzufügen.

- Neues Wörterbuch aus einem Ordner erstellen

  Wählen Sie für diese Quelle den gewünschten Ordner. &kmouth; öffnet alle Dateien in dem Ordner und in den Unterordnern. Jede Datei wird als Wörterbuch, als &XML;-Datei oder als Textdatei geladen. In den letzten beiden Fällen wird die Häufigkeit der Worte in den Dateien gezählt. Zusätzlich können Sie die Wortliste mit einem OpenOffice.org-Wörterbuch vergleichen, um nur richtig geschriebene Worte in das neue Wörterbuch einzufügen.

- Wörterbücher zusammenführen

  Mit dieser Option können Sie die verfügbaren Wörterbücher zusammenführen. &kmouth; fragt dann, welche Wörterbücher zusammengeführt, und wie diese gewichtet werden sollen.

- Leere Wortliste erstellen

  Mit dieser Option legen Sie ein neues, leeres Wörterbuch ohne Einträge an. Da &kmouth; neu eingegebene Worte automatisch in das Wörterbuch einfügt, erzeugen Sie im Laufe der Zeit ein Wörterbuch mit Ihren Vokabeln.

### Das Bearbeitungsfenster für Textpassagen-Bücher

Mit dem Menüeintrag Textpassagen-Buch Bearbeiten ... öffnen Sie das Bearbeitungsfenster für Textpassagen-Bücher.

Das Bearbeitungsfenster für Textpassagen-Bücher Bildschirmfoto

Der Hauptbereich des Fensters zur Bearbeitung von Textpassagen-Büchern ist zweigeteilt. Im oberen Teil werden die Textpassagen-Bücher als Baumstruktur dargestellt.

Im unteren Teil können Sie einen ausgewählten Eintrag bearbeiten. Wenn Sie eine Textpassage ausgewählt haben, können Sie die Textpassage oder das zugehörige Tastenkürzel ändern. Wenn Sie ein Textpassagen-Buch ausgewählt haben, können Sie nur dessen Namen ändern.

Aktionen wie neue Textpassagen oder Bücher hinzufügen oder ausgewählte Textpassagen und Bücher löschen können Sie entweder über die Auswahl in der Menüleiste, in der Werkzeugleiste oder über ein Aufklappmenü erreichen.

Die Reihenfolge von Textpassagen-Büchern oder Textpassagen können Sie durch Ziehen mit der Maus an die neue Stelle oder mit den Pfeiltasten und der &Alt;-Taste ändern.

## Befehlsreferenz

### Befehle im Hauptfenster

#### Das Menü Datei

&Ctrl;O Datei Öffnen als Verlauf ...

- Öffnet eine Textdatei als Verlaufsspeicher für die gesprochenen Sätze.

&Ctrl;S Datei Verlauf speichern unter ...

- Speichert den Verlauf in eine Textdatei.

&Ctrl;P Datei Verlauf drucken ...

- Druckt den Verlaufsspeicher.

&Ctrl;Q Datei Beenden

- Beendet &kmouth;.

#### Das Menü Bearbeiten

&Ctrl;X Bearbeiten Ausschneiden

- Der gewählte Text wird ausgeschnitten und in die Zwischenablage kopiert. Falls im Eingabefeld ein Textabschnitt ausgewählt ist, wird dieser verwendet, anderenfalls die ausgewählten Bereiche des Verlaufsspeichers.

&Ctrl;C Bearbeiten Kopieren

- Der gewählte Text wird in die Zwischenablage kopiert. Falls im Eingabefeld ein Textabschnitt ausgewählt ist, wird dieser verwendet, anderenfalls die ausgewählten Bereiche des Verlaufsspeichers.

&Ctrl;V Bearbeiten Einfügen

- Fügt den Inhalt der Zwischenablage an der aktuellen Cursor-Position in das Eingabefeld ein.

Bearbeiten Sprechen

- Der momentan aktive Satz wird gesprochen. Falls sich Text im Eingabefeld befindet, wird dieser verwendet, anderenfalls die ausgewählten Sätze des Verlaufsspeichers.

#### Das Menü Textpassagen-Bücher

Textpassagen-Bücher Bearbeiten ...

- Öffnet das Bearbeitungsfenster für Textpassagen-Bücher.

&kmouth; benutzt die bekannten &kde;-Menüeinträge Einstellungen und Hilfe. Mehr dazu erfahren Sie in den Abschnitten zu den Menüs Einstellungen und Hilfe in den &kde;-Grundlagen.

### Befehle im Bearbeitungsfenster für Textpassagen-Bücher

#### Das Menü Datei

Datei Neue Textpassage

- Fügt eine neue Textpassage hinzu

Datei Neues Textpassagen-Buch

- Fügt eine neues Textpassagen-Buch hinzu

&Ctrl; S Datei Speichern

- Speichert das Textpassagen-Buch.

Datei Importieren ...

- Importiert eine Datei und fügt ihren Inhalt in das Textpassagen-Buch ein

Datei Textpassagen-Buch mit Standardtexten importieren

- Importiert ein Textpassagen-Buch mit Standardtexten und fügt seinen Inhalt in das Textpassagen-Buch ein

Datei Exportieren ...

- Exportiert die ausgewählten Textpassagen oder Textpassagen-Bücher in eine Datei

&Ctrl; W Datei Schließen

- Schließt das Fenster

#### Das Menü Bearbeiten

&Ctrl;X Bearbeiten Ausschneiden

- Schneidet den gewählten Bereich aus und kopiert ihn in die Zwischenablage.

&Ctrl;C Bearbeiten Kopieren

- Kopiert den ausgewählten Bereich in die Zwischenablage.

&Ctrl;V Bearbeiten Einfügen

- Fügt den Inhalt der Zwischenablage wird in das Textpassagen-Buch ein.

Bearbeiten Löschen

- Entfernt die ausgewählten Einträge.

#### Das Menü Hilfe

Dieses Menü hat die gleichen Einträge wie im Hauptfenster.

#### Das Kontextmenü

Neue Textpassage

- Fügt eine neue Textpassage hinzu

Neues Textpassagen-Buch

- Fügt eine neues Textpassagen-Buch hinzu

Importieren ...

- Importiert eine Datei und fügt ihren Inhalt in das Textpassagen-Buch ein

Standard-Textpassagen-Buch importieren

- Importiert ein Textpassagen-Buch mit Standardtexten und fügt seinen Inhalt in das Textpassagen-Buch ein

Exportieren ...

- Exportiert die ausgewählten Textpassagen oder Textpassagen-Bücher in eine Datei

&Ctrl; X Ausschneiden

- Schneidet den gewählten Bereich aus und kopiert ihn in die Zwischenablage.

&Ctrl;C Kopieren

- Kopiert den ausgewählten Bereich in die Zwischenablage.

&Ctrl;V Einfügen

- Fügt den Inhalt der Zwischenablage an der aktuellen Cursor-Position in das Textpassagen-Buch ein.

Löschen

- Entfernt die ausgewählten Einträge.

## Danksagungen und Lizenz

&kmouth;

Programm Copyright 2002-2004 Gunnar Schmi Dt gunnar@schmi-dt.de

Copyright der Dokumentation 2002-2004 Gunnar Schmi Dt gunnar@schmi-dt.de

Übersetzung Burkhard Lück lueck@hube-lueck.de

&underFDL; &underGPL;