# Das Handbuch zu &jovie;

## Einleitung

&jovie; ist ein Teilsystem in &kde; zur Sprachausgabe (TTS). Es stellt eine gemeinsame Anwendungsschnittstelle für &kde;-Programmierer bereit, mit der deren Anwendungen mit TTS-Fähigkeiten ausgestattet werden können. Auch den Benutzern bietet es interessante Möglichkeiten.

Eigenschaften für Benutzer:

- Vorlesen des Inhalts einer Textdatei.

- Vorlesen von &kde;-Nachrichten (KNotify).

- Vorlesen der Texte (oder Teilen davon) einer Webseite in &konqueror;.

- Vorlesen von Texten (oder Teilen davon) im Texteditor &kate;, auch wenn &kate; in andere &kde;-Anwendungen eingebettet ist.

- Die Sprachausgabe erfolgt über das Programm speech-dispatcher, das verschiedene Hintergrundprogramm wie espeak, festival, &etc; verwendet.

- Einstellbare Filter, um falsch ausgesprochene Worte zu ersetzen, Sprachsynthesizer auszuwählen und &XML;-Dokumente umzuwandeln.

Eigenschaften für Programmierer:

- Prioritätssystem für die Ausgabe von Screen-Readern, Warnungen und Nachrichten, während andere Texte vorgelesen werden.

- Ermöglicht die Erzeugung von Sprachausgaben auf der Befehlszeile (oder mit Shell-Skripten) über das &qdbus;-Hilfsprogramm.

- Stellt für Anwendungen eine einfach zu benutzende Schnittstelle für die Sprachausgabe bereit.

- Anwendungen müssen keine Einzelheiten über das Sprachausgabegerät wissen.

- IN ZUKUNFT: Unterstützung für Speech-Markup-Sprachen wie VoiceXML, Sable, &Java; Speech-Markup-Language (JSML), und Speech-Markup-Meta-Sprache (SMML).

- IN ZUKUNFT: Eingeschränkte Unterstützung für eingebettete Sprachlesezeichen.

- Asynchron zur Vermeidung von Systemblockaden.

&jovie; besteht zurzeit aus mehreren Programmen:

`jovie`

- Der Sprachausgabe-Dienst von &kde;, ein Programm, das TTS-Dienste über &DBus; anbietet und das als Symbol im Systemabschnitt der Kontrollleiste angezeigt wird.

`libkhtmlkttsdplugin`

- Ein Modul für den Webbrowser &konqueror; für das Vorlesen der Texte einer Webseite oder Teilen davon.

`ktexteditor_kttsd`

- Ein Modul für den Texteditor &kate;, mit dem eine Textdatei ganz oder teilweise vorgelesen werden kann.

### Unterstützung

Zusätzlich zur Bugzilla-Datenbank von &kde; (http://bugs.kde.org/) finden Diskussionen über &jovie; in der kde-accessibility Mailingliste statt. Abonnieren können Sie die Liste über https://mail.kde.org/mailman/listinfo/kde-accessibility. Die Entwickler finden Sie auch im IRC (irc.kde.org, Kanal #kde-accessibility).

## Arbeiten mit &jovie;

Ehe Sie &jovie; benutzen können, müssen Sie das Programm speech-dispatcher installieren und richtig einstellen. Siehe auch installation

### Starten von `jovie`

Zum Start des &jovie;-Systems geben Sie folgenden Befehl in einer &konsole; ein:

`jovie`

oder klicken Sie im &kde;-Menü auf &jovie;.

Beim ersten Start von `jovie` oder solange noch keine Sprecher eingerichtet sind, wird die Karteikarte Sprecher angezeigt. Siehe auch configure-talkers. Wenn Sie mindestens einen Sprecher eingerichtet haben, wird die Karteikarte Allgemein angezeigt. Siehe general.

### Einrichtung der Sprecher

Die meisten TTS-Synthesizer bieten verschiedene Sprachen und Stimmen an, so auch verschiedene männlich oder weibliche, oder solche, die sich in Lautstärke oder Geschwindigkeit unterscheiden. Sie können auch mehrere Varianten für einen Synthesizer einrichten. Eine so eingerichtete Kombination aus Sprache, Synthesizer, Stimme, Geschlecht, Lautstärke und Geschwindigkeit wird als Sprecher bezeichnet. Sie sollten zumindest einen Sprecher einrichten, bevor Sie &jovie; benutzen, da das Programm speed-dispatcher ansonsten den Standardsprecher verwendet.

Verschiedene Sprecher für denselben Synthesizer sind vergleichbar mit mehreren Druckerwarteschlangen für denselben Drucker.

Wenn Sie auf den Karteikartenreiter Sprecher in `jovie` klicken, wird die Karteikarte Sprecher angezeigt. Diese erscheint auch dann automatisch, wenn Sie `jovie` starten und noch kein Sprecher eingerichtet ist.

Die Sprachausgabeverwaltung von &kde; (Karteikarte Sprecher) Die Sprachausgabeverwaltung von &kde; (Karteikarte Sprecher)

- Klicken Sie, um einen neuen Sprecher hinzuzufügen.

- Alle bereits eingerichteten Sprecher erscheinen in dieser Liste. Die bevorzugten Sprecher erscheinen oben in der Liste. Der oberste Sprecher wird für die Sprachausgabe benutzt, wenn eine Anwendung keinen Sprecher vorgibt.

- Wählen Sie mit einem Mausklick einen Sprecher aus der Liste, und klicken Sie auf diesen Knopf, um den Sprecher aus der Liste zu entfernen.

- Wählen Sie mit einem Mausklick einen Sprecher aus der Liste, und klicken Sie auf diesen Knopf, um den Einstellungen zu ändern. Siehe unten.

- Wählen Sie mit einem Mausklick einen Sprecher aus der Liste, und klicken Sie auf diesen Knopf, um den Sprecher in der Liste eine Zeile weiter nach unten schieben. Die Reihenfolge der Sprecher in der Liste bestimmt auch ihre Priorität.

- Klicken Sie auf einen dieser Knöpfe, um Ihre Änderungen auf das laufende &jovie;-System anzuwenden.

Wenn Sie auf Hinzufügen klicken, wird die Karteikarte Sprecher hinzufügen angezeigt.

Karteikarte Sprecher hinzufügen. Karteikarte Sprecher hinzufügen

- Sie sollten Ihrem neuen Sprecher einen beliebigen Namen geben.

- Wählen Sie hier die Sprache und den Synthesizer.

- Wählen Sie hier einen Stimmtyp aus, es stehen drei männliche und drei weibliche Stimmen sowie eine Jungen- und Mädchenstimme zur Auswahl.

- Stellen Sie hier benutzerdefinierte Parameter für die Stimme ein.

- Wenn Sie hier klicken, erscheint der neue Sprecher auf der Karteikarte Sprecher. Um die Einstellungen dieses Sprechers zu ändern, klicken Sie auf Bearbeiten.

Nun können Sie &jovie; schon fast benutzen. Gehen Sie zurück zur Karteikarte Allgemein und überprüfen Sie, ob Sprachausgabe aktivieren (Jovie) angekreuzt ist, damit der TTS-Dienst von &kde; startet. Siehe general. Jetzt können Sie &jovie; benutzen, um Text vorlesen zu lassen. Klicken Sie auf die Karteikarte Aufträge, um Textaufträge zu erstellen und zu verwalten. Siehe jobmgr.

### Starten von &jovie; und allgemeine Einrichtung

Wenn Sie mindestens einen Sprecher eingerichtet haben, können Sie das Sprachausgabesystem von &kde; starten. Klicken Sie auf den Karteikartenreiter Allgemein, um diese Karteikarte zu öffnen. Hier können Sie einige allgemeine Optionen einstellen.

Die Sprachausgabeverwaltung von &kde; (Karteikarte Allgemein). Die Sprachausgabeverwaltung von &kde; (Karteikarte Allgemein)

- Markieren Sie dieses Ankreuzfeld, um das &jovie;;-System zu aktivieren. Dies startet den KDE-TTS-Dienst (&jovie;). Ist dieser Start erfolgreich, wird die Karteikarte Aufträge angezeigt, und Sie können Textaufträge erstellen und vorlesen lassen. Siehe jobmgr. Entfernen Sie die Markierung, wird &jovie; angehalten und das TTS-System von &kde; deaktiviert.

- Klicken Sie hier, um Ihre Einstellungen zu speichern.

### Textaufträge verwalten

Wenn Sie auf den Karteikartenreiter Aufträge im `jovie` klicken, wird die Karteikarte Aufträge angezeigt.

Die Sprachausgabeverwaltung von &kde; (Karteikarte Aufträge). Die Sprachausgabeverwaltung von &kde; (Karteikarte Aufträge)

- Mit diesen Einstellungen kann die aktuelle Sprecherstimme verändert werden. Dies funktioniert nur dann, wenn noch keine Stimmen auf der Karteikarte Sprecher eingerichtet sind.

- Mit den Knöpfen in dieser Reihe können Sie Textaufträge starten, abbrechen, anhalten und wieder aufnehmen.

- Mit den Knöpfen in dieser Reihe können Sie den aktuellen Text in der &kde;-Zwischenablage vorlesen lassen oder eine Textdatei zum Vorlesen öffnen. Sie können außerdem den Sprecher für einen Auftrag wechseln.

- Klicken Sie auf Anwenden oder OK, dann werden alle geänderten Einstellungen auf allen Seiten übernommen.

Die Karteikarte Aufträge wird nur angezeigt, wenn &jovie; gestartet wurde. Um Jovie zu starten, klicken Sie auf den Karteikartenreiter Allgemein und kreuzen dort Sprachausgabe aktivieren (Jovie) an.

### Das Vorlesen von Webseiten-Inhalten

In &konqueror;, dem Webbrowser von &kde;, können Sie den Text der angezeigten Webseite vorlesen lassen. Überprüfen Sie zuerst, ob &konqueror; läuft. Markieren Sie dann den Text, der vorgelesen werden soll, und wählen Sie im Hauptmenü Extras Text vorlesen . Nach kurzer Zeit sollte die Sprachausgabe beginnen.

Es ist fast immer sinnvoll, den gewünschten Text einer Webseite zu markieren. Sie können diesen Schritt auch überspringen, aber dann werden viele &HTML;-Vorspannzeilen und andere unsichtbare Marken ebenfalls vorgelesen.

### Sprachausgabe im Texteditor &kate;

In &kate; dem erweiterten Texteditor von &kde;, können Sie angezeigten Text vorlesen lassen. Überprüfen Sie zuerst, ob &jovie; läuft und aktivieren Sie das KTextEditor-Modul Jovie für die Sprachausgabe im Einrichtungsdialog von &kate;. Markieren Sie dann den Text, der vorgelesen werden soll, und wählen Sie im Hauptmenü Extras Text vorlesen . Dann sollte die Sprachausgabe beginnen.

Sie müssen nicht unbedingt Text markieren; in diesem Fall wird die ganze Datei vorgelesen.

Dies funktioniert auch, wenn &kate; in andere Anwendungen eingebettet ist, wie ⪚ in &konqueror; oder in &quanta;.

### Vorlesen von Nachrichten (Knotify)

KNotify ist das Nachrichtensystem von &kde;, das Sie über von Ihnen festgelegte Ereignisse benachrichtigt. Sie können den Text dieser Nachrichten auch von &jovie; vorlesen lassen.

In &konversation;, dem IRC-Programm von &kde;, können Sie verschiedene Arten von Nachrichten einrichten. Sie können &konversation; beispielsweise so einrichten, dass Sie benachrichtigt werden, wenn in einem IRC-Kanal eine Nachricht auftaucht, in der Ihr Spitzname vorkommt. Mit &jovie; können Sie sich dann den IRC-Nachrichtentext vorlesen lassen.

Unterstützt ein &kde;-Programm KNotify, erscheint ein Menüeintrag Benachrichtigungen im Menü Einstellungen dieses Programms. Die hier möglichen Einstellungen für KNotify unterscheiden sich je nach Anwendung.

Filter zur Zeichenkettenersetzung bieten eine gute Möglichkeit in &jovie; falsch betonte oder fehlerhaft ausgesprochene Nachrichten zu korrigieren. Die Datei `kmail.xml`, die zum Lieferumfang von &jovie; gehört, ist ein gutes Beispiel. Sie entfernt die Tags `br` und `b` aus den Nachrichten, die KMail versendet, und zudem den Ausdruck `/local/inbox`, da dieser in den meisten Fälle als vorausgesetzt angenommen werden kann. Lesen Sie dazu auch stringreplacer.

### Filter (Fortgeschrittene)

Filter sind eine der fortgeschrittenen Fähigkeiten von &jovie;. Für die normale Arbeit mit &jovie; sind Filter nicht erforderlich.

In Filtern wird Text bearbeitet, ehe er zum Programm speech-dispatcher geschickt wird. Sie sind nützlich für die Verbesserung der Aussprache, um falsch gesprochene Worte oder Abkürzungen zu ersetzen, eine passende Sprache und Sprecher auszuwählen oder um bestimmte Mängel von Sprachsynthesizern und deren Stimmen zu umgehen.

#### &jovie;-Nachrichtentypen

Um die Arbeitsweise von Filtern zu verstehen, ist es wichtig zu wissen, wie das Programm "speech-dispatcher" mit einem Text arbeitet. &jovie; unterscheidet vier Arten von Texten.

- Ausgaben von Screen-Readern

- Warnungen

- Nachrichten

- Textaufträge

Der Typ wird von der Anwendungen festgelegt, die eine Nachricht an &jovie; verschickt.

Die Ausgabe von Screen-Readern hat die höchste Priorität. Sie wird allen anderen Aufträgen vorgezogen und hält diese Aufträge an. Wenn die Ausgabe der Screen-Reader vorgelesen ist, werden die angehaltenen Aufträge wieder fortgesetzt.

Warnungen haben die nächste Priorität. Diese Stufe ist wichtigen Nachrichten wie ⪚ Prozessor wird zu heiß vorbehalten. Eine Warnung hat Vorrang und hält die Ausgabe von Nachrichten und normalem Text an. Diese Aufträge werden nach der Ausgabe der Warnung wieder fortgesetzt.

Nachrichten haben die nächsthöchste Priorität. Eine Nachricht unterbricht normalen Text. &kmouth; ist ein Beispiel für eine Anwendung, die Nachrichten verwendet. Während Sie ⪚ einen langen Text auf einer Webseite vorlesen lassen, können Sie mit &kmouth; jemanden begrüßen, der gerade den Raum betritt. &kde;-Benachrichtigungen sind ebenfalls Nachrichten. Lesen Sie dazu knotify.

Der Rest sind einfache Textaufträge. Jeder Auftrag, den Sie von der Karteikarte Aufträge anstoßen, ist ein Textauftrag. KSayit ist ein Beispiel für eine Anwendungen, die Textaufträge verwendet. Textaufträge sind für die Ausgabe längerer Texte gedacht, die keine besondere Dringlichkeit besitzen.

Alle vier Auftragsarten werden in Warteschlangen abgearbeitet, mit Ausnahme der Ausgabe von Screen-Readern. Wenn eine Anwendung die Ausgabe eines Screen-Readers schickt, während &jovie; gerade eine solche vorliest, wird diese Ausgabe angehalten und beendet.

#### Filterarten

Zuerst müssen Sie wissen, dass Filter nie auf die Ausgabe von Screen-Readern angewendet werden. Sie werden auf normale Warnungen, Nachrichten und Textaufträge sowie auf &kde;-Nachrichten angewendet.

Filter bearbeiten den Text und geben ihn an den nächsten Filter weiter. Zur Zeit gibt es drei Arten von Filtern.

- Zeichenkettenersetzer

- &XML;-Umformer

- Sprecherauswahl

Filter sind als Module ausgeführt. In Zukunft kann es noch weiter Arten von Filtern geben.

Zeichenkettenersetzer ersetzen Teile eines Textes durch anderen Text. Die zu ersetzenden Teile können Sie entweder als Worte oder als reguläre Ausdrücke angeben. &jovie; wird mit vordefinierten Zeichenkettenersetzerfiltern ausgeliefert, die das Ersetzen von Chat-Emoticons wie :-) durch Text oder für die Umformatierung von Nachrichten aus &konversation; oder &kmail; in eine besser verständliche Form ermöglichen.

&XML;-Umformer verwenden eine XSLT-Datei (&XML; Style Language - Transforms) um &XML; von einem Format in ein anderes Format umzuwandeln. Im Lieferumfang von &jovie; sind einige XSLT-Dateien zur Übersetzung von &XHTML; in SSML enthalten.

Mit Sprecherauswahlfiltern können Sie Aufträge abhängig vom Inhalt des Textes oder abhängig von dem Programm, das den Text an &jovie; geschickt hat, an einen Sprecher schicken. Wenn Sie zum Beispiel auf der Karteikarte Sprecher eine weibliche Stimme eingestellt haben, können Sie Text von KDE-Nachrichten darüber vorlesen lassen. Siehe configure-talkers. darüber vorlesen lassen.

Jeder dieser verschiedenen Filter hat einstellbare Regeln, nach denen er für eine Sprachausgabe angewendet wird. Wenn der Filter feststellt, dass seine Regeln nicht zutreffen, gibt er den Text unverändert an den nächsten Filter weiter.

Wenn ein Textauftrag, eine Meldung, Warnung oder eine &kde;-Benachrichtigung an &jovie; geschickt wird, wird sie durch alle aktivierten Filter bearbeitet, die auf der Seite unten eingerichtet wurden. Die Bearbeitung durch die Filter erfolgt in der Reihenfolge in der Liste von oben nach unten.

#### Einrichtung der Filter

Klicken Sie auf den Karteikartenreiter Filter in `jovie`, um Filter einzurichten.

Die Sprachausgabe-Verwaltung von &kde; (Karteikarte Filter) Die Sprachausgabe-Verwaltung von &kde; (Karteikarte Filter)

- Dies zeigt die Liste der eingerichteten normalen Filter. Ist ein Filter nicht angekreuzt, ist er nicht aktiviert und wird nicht benutzt. Filter werden der Reihe nach von oben nach unten abgearbeitet.

- Klicken Sie hier, um einen neuen Filter einzufügen. Wählen Sie die Art des Filters aus, und es werden die weiter unten folgenden Einrichtungsdialoge angezeigt.

- Klicken Sie hier, um einen Filter zu entfernen.

- Um die Einstellungen für einen Filter zu ändern, klicken Sie hier. Es werden die weiter unten folgenden Einrichtungsdialoge angezeigt.

- Mit einem Klick auf diese Knöpfe können Sie einen Filter in der Liste nach oben oder unten verschieben.

- Klicken Sie hier, sonst werden Ihre Einstellungen nicht übernommen.

#### Einrichtung der Zeichenkettenersetzungsfilter

Für die Einrichtung von Zeichenkettenersetzungsfiltern müssen Sie eine Liste von Worten oder regulären Ausdrücken als Vergleichsmuster eingeben. Werden diese Muster im Text gefunden, dann wird der Text gegen den zugehörigen Ersatztext ausgetauscht. Groß- und Kleinschreibung wird beim Vergleich nicht beachtet.

Zeichenkettenersetzer Zeichenkettenersetzer

- Geben Sie für Ihren Filter einen Namen ein. Diesen Namen können Sie beliebig wählen, er muss sich nur von den Namen der anderen Filter unterscheiden.

- Dies ist die Liste der Worte und regulären Ausdrücke. Der Filter vergleicht den Text mit den Zeichenketten in der Spalte Übereinstimmung und ersetzt ihn bei Übereinstimmung mit der Zeichenkette aus der Spalte Ersetzen durch. Die Liste wird in der angezeigten Reihenfolge von oben nach unten abgearbeitet.

- Klicken Sie hier, um ein anderes Wort oder einen regulären Ausdruck in die Liste einzufügen.

- Klicken Sie hier, um das markierte Wort oder den regulären Ausdruck in der Liste zu verschieben.

- Klicken Sie hier, um ein vorhandenes Wort oder einen regulären Ausdruck in der Liste zu ändern.

- Klicken Sie hier, um das markierte Wort oder den regulären Ausdruck aus der Liste zu entfernen.

- Mit diesen Knöpfen können Sie eine Liste von Worten oder regulären Ausdrücken aus einer Datei laden, die aktuelle Liste speichern oder löschen. Laden Sie eine Liste aus einer Datei, werden die Einträge aus der Datei an die vorhandene Liste angehängt.

- Ist hier eine Sprache eingetragen, wird der Filter nur angewendet, wenn der Sprecher für den Textauftrag eine der hier eingetragenen Sprachen spricht. Klicken Sie auf den Knopf, um eine Liste der Sprachen anzeigen zu lassen. Sie können auch mehrere Sprachen auswählen, wenn Sie beim Mausklick die &Ctrl;-Taste gedrückt halten.

- Ist hier ein Wert eingetragen, wird der Filter nur angewendet, wenn der Text von einer der angegebenen Anwendungen kommt. Sie können mehrere Programme getrennt durch Kommata eingeben. Beispiel: ``konversation,kmail``

  Die Anwendungs-ID laufender Programme erhalten Sie mit dem Programm `&qdbus;`. Die &DBus;-Nummern müssen Sie weglassen. Wenn zum Beispiel &qdbus; die Anwendungs-ID `kopete-3432` anzeigt, dürfen Sie nur ``kopete`` eingeben.

Der Zeichenkettenersetzungsfilter wird nur dann auf den Text angewendet, wenn alle Bedingungen mit einem Eintrag im Kasten Diesen Filter anwenden wenn übereinstimmen. Sind alle Eingabefelder leer, wird der Filter auf alle Texte angewendet.

Beim Vergleich von Worten benutzt der Zeichenkettenersetzungsfilter reguläre Ausdrücke in der Form `\s`Wort`\s`. Die Worte müssen also durch Trennzeichen (Leerzeichen) beidseitig begrenzt sein.

In diesem Handbuch finden Sie keine Anleitung zum Schreiben von regulären Ausdrücken. Wenn Sie aber den &kde;-Editor für reguläre Ausdrücke installiert haben, können Sie ihn in den Dialogen Hinzufügen oder Bearbeiten als Hilfe zum Zusammenstellen dieser Ausdrücke aufrufen. Den &kde;-Editor für reguläre Ausdrücke finden Sie im Git-Modul Utils in playground.

Im Lieferumfang von &jovie; sind einige Dateien mit Wortlisten enthalten; unter anderem eine Liste mit Emoticons wie :-), einige Abkürzungen für IRC oder Messaging-Programme und eine Liste mit weiteren Abkürzungen. Es gibt auch eine Liste mit Sonderzeichen, mit der die aktuelle Version der polnischen Festival-Stimme Probleme hat. Wenn Sie eigene Wortlisten erstellen, können Sie diese mit Speichern in eine Datei schreiben und an das &jovie;-Team schicken, das die Listen dann in die nächste Version aufnimmt.

#### Einrichtung der &XML;-Umformer-Filter

&XML;-Umformer übersetzen &XML; mit Hilfe von XSLT-Dateien aus einem Format in ein anderes Format. XSLT (&XML; Style Language - Transforms) ist ein W3C-Standard für solche Umformungen. Es kann aber nur auf wohlgeformtes XML angewendet werden. Das Hilfsprogramm `xsltproc` muss auf Ihrem System installiert sein.

&XML;-Umformer &XML;-Umformer

- Geben Sie für Ihren Filter einen Namen ein. Diesen Namen können Sie beliebig wählen, er muss sich nur von den Namen der anderen Filter unterscheiden.

- Geben Sie den vollständigen Pfad zur XSLT-Datei für die Umwandlung ein.

- Geben Sie den Pfad für das Programm `xsltproc` ein. Wenn xsltproc über die Umgebungsvariable PATH erreichbar ist, reicht auch ``xsltproc``.

- Wenn hier ein Wert angegeben ist, wird der Filter nur auf &XML;-Dateien mit einer `<!DOCTYPE` Spezifikation mit dem eingegebenen Text am Anfang angewendet. Zum Beispiel ``html`` im Eingabefeld DOCTYPE passt auf `<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" >`..

- Ist hier ein Wert eingetragen, wird der Filter nur angewendet, wenn der Text von einer der angegebenen Anwendungen kommt. Sie können mehrere Programme getrennt durch Kommata eingeben. Beispiel: ``konversation,kmail``

  Die Anwendungs-ID laufender Programme erhalten Sie mit dem Programm `&qdbus;`. Die &DBus;-Nummern müssen Sie weglassen. Wenn zum Beispiel &qdbus; die Anwendungs-ID `kopete-3432` anzeigt, dürfen Sie nur ``kopete`` eingeben.

Der &XML;-Umformerfilter bearbeitet den Text nur dann, wenn das angegebene root-Element oder der DOCTYPE übereinstimmen und die Anwendungs-ID mit dem Eintrag in Diesen Filter anwenden, wenn übereinstimmt. Ist hier nichts eingetragen, wird die Prüfung nicht durchgeführt. Ist überhaupt kein Eintrag vorhanden, wird der Filter auf alle Texte angewendet. Sie sollten aber zumindest ein Eingabefeld ausfüllen, da die meisten Textaufträge nicht im &XML;-Format übermittelt werden.

#### Einrichtung der Sprecherauswahlfilter

Mit dem Sprecherauswahlfilter können Sie Texte an einen bestimmten Sprecher schicken, der auf der Karteikarte Sprecher eingerichtet ist, oder an einen Sprecher mit bestimmten Eigenschaften. Sie können zum Beispiel festlegen, dass Texte von `kmail` von einer weiblichen Stimme vorgelesen werden sollen. Siehe configure-talkers.

Bevor &jovie; einen Text an die Filter übergibt, sucht es einen Sprecher für den Text. Der Sprecher wird anhand der Sprecher-Eigenschaften, die das Programm vorgibt, das den Text an &jovie; schickt, und den Eigenschaften der auf der Karteikarte Sprecher eingerichteten Sprecher ausgewählt. Mit dem Sprecherauswahlfilter können Sie den gewählten Sprecher überschreiben.

Sprecherauswahl Sprecherauswahl

- Geben Sie für Ihren Filter einen Namen ein. Diesen Namen können Sie beliebig wählen, er muss sich nur von den Namen der anderen Filter unterscheiden.

- Ist hier ein Wert eingetragen, wird der Filter angewendet, falls der Text den eingegebenen regulären Ausdruck enthält. Ist auf Ihrem System der &kde;-Editor für reguläre Ausdrücke installiert, können Sie diesen mit einem Klick auf den Knopf aufrufen, um Hilfe bei der Eingabe zu erhalten.

  Um eine schnellere Verarbeitung zu erzielen, sollten Sie versuchen, den regulären Ausdruck am Anfang der Zeichenkette zu verankern, d. h., beginnen Sie den regulären Ausdruck mit ``^``.

- Ist hier ein Wert eingetragen, wird der Filter nur angewendet, wenn der Text von einer der angegebenen Anwendungen kommt. Sie können mehrere Programme getrennt durch Kommata eingeben. Beispiel: ``konversation,kmail``

  Die Anwendungs-ID laufender Programme erhalten Sie mit dem Programm `&qdbus;`. Die &DBus;-Nummern müssen Sie weglassen. Wenn zum Beispiel &qdbus; die Anwendungs-ID `kopete-3432` anzeigt, dürfen Sie nur ``kopete`` eingeben.

- Legen Sie hier die Eigenschaften des von Ihnen gewünschten Sprechers fest. Wenn der Text die oben gezeigten Filterbedingungen erfüllt, wird der Sprecher ausgewählt, der den gewünschten Anforderungen am ehesten entspricht. Klicken Sie auf den Knopf rechts, um den Dialog Sprecherauswahl anzuzeigen.

- Verwenden Sie diese Knöpfe, um Ihre Sprechereinstellungen zu speichern oder zu laden oder alle Einstellungen zu löschen.

Der Sprecherauswahlfilter wird nur dann auf den Text angewendet, wenn alle Bedingungen mit einem Eintrag im Kasten Diesen Filter anwenden wenn zutreffen. Sie müssen mindestens eine Bedingung eintragen.

## Entwicklerhandbuch für &jovie;

&jovie; bietet zwei Schnittstellen für Anwendungsprogrammierer (APIs):

- Die Sprachausgabe-API, von &kde;, mit der Programmierer ihren Anwendungen TTS-Fähigkeiten verleihen können. Anwendungen kommunizieren mit &jovie; über &DBus;.

- Die &jovie;-Modul-API, mit der Sprachsynthesizer zu &jovie; hinzugefügt werden, sodass &jovie; diese Synthesizer benutzen kann.

Der folgende Abschnitt enthält eine kurze Beschreibung der &kde;-&DBus;-Schnittstelle der Sprachausgabe-API von &kde;. Die vollständige Dokumentation für beide APIs finden Sie auf der &kde; Accessibility Webseite (http://accessibility.kde.org).

### Die &DBus;-Schnittstelle von &jovie;

Anwendungen fordern Sprachausgabedienste über die &DBus;-Schnittstelle von &kde; vom Programm `jovie` über das Objekt `KSpeech` an.

Geben Sie die folgenden Befehle in einer &konsole; ein:

Wenn &jovie; noch nicht gestartet wurde

`jovie`

Um einen Textauftrag in die Warteschlange zu stellen

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

dabei ist ``Text`` der Text zum Vorlesen und ``Option`` ein Sprachcode wie ⪚ ``en``, ``de`` &etc;

Beispiel:

`qdbus org.kde.jovie /KSpeech say "Dies ist ein Test." "de"`

Es gibt noch mehr Befehle, die Sie einsetzen können. Für eine Liste aller Befehle geben Sie

`qdbus org.kde.jovie /KSpeech`

ein oder lesen Sie die &kde; Sprachausgabe-API.

## Fragen und Antworten

&reporting.bugs; &updating.documentation;

Ich muss noch einmal von vorne anfangen. Wie kann ich &jovie; vollständig beenden?

Geben Sie die folgenden Befehle in einer &konsole; ein:

    kquitapp jovie

Wie kann ich die Fehlerausgabe von `jovie` sehen?

Öffnen Sie ein &konsole;-Terminalfenster und starten darin `jovie`.

Keiner der genannten Sprachsynthesizer unterstützt meine Sprache. Wo kann ich einen Synthesizer für meine Sprache bekommen?

Suchen Sie bei Google(tm). Diese Verknüpfung könnte auch hilfreich sein. Wenn Sie einen freien Synthesizer für Ihre Wunschsprache finden und dafür Unterstützung zu &jovie; hinzufügen wollen, setzen Sie sich mit den Entwicklern in Verbindung. Quelloffene Synthesizer werden besonders gesucht. Wenn Sie einen kommerziellen Synthesizer kennen, können Sie versuchen, den Hersteller dazu zu überreden, den Entwicklern eine freie Kopie zu überlassen. Bis dahin können Sie versuchen, den Synthesizer mit den Befehlen des Hintergrundprogramms für „speed-dispatcher“ zu benutzen.

Ich habe den &HTML;-&XML;-Umformerfilter eingerichtet, aber bei Verwendung des Moduls für Festival werden Webseiten nicht vorgelesen.

Bedingt durch einen Fehler in Festival 1.95 beta müssen Sie die (männliche britische) Stimme `rab_diphone` installieren, damit SABLE überhaupt funktioniert. Das müssen Sie selbst dann tun, wenn Sie diese Stimme nicht zum Vorlesen von Webseiten benutzen. Stellen Sie außerdem sicher, dass das Programm `xsltproc` installiert und über die Umgebungsvariable PATH zu finden ist.

Bestimmte Zeichen oder Interpunktionszeichen scheinen Fehler beim Synthesizer zu verursachen, sodass ganze Sätze übersprungen oder nur Kauderwelsch ausgegeben wird. Was kann ich dagegen tun?

Stellen Sie zunächst sicher, dass die Option Zeichenkodierung auf den richtigen Wert für die entsprechende Sprache eingestellt ist. Gibt es Probleme mit bestimmten Zeichen oder Wörtern, können diese möglicherweise durch einen Zeichenkettenersetzungsfilter behoben werden. Siehe filters.

## Danksagungen und Lizenz

&jovie;

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

Aktueller Betreuer: Jeremy Whiting jpwhiting@kde.org

Mitwirkende:

- Gary Cramblitt garycramblitt@comcast.net

- Olaf Schmidt ojschmidt@kde.org

- Gunnar Schmi Dt gunnar@schmi-dt.de

- Paul Giannaros ceruleanblaze@gmail.com

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

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

&underFDL; &underGPL;

Die Sprachsynthesizer, die von &jovie; genutzt werden, haben ihre eigene Lizenz, die Sie in der zugehörigen Dokumentation oder auf den betreffenden Webseiten finden. Es gibt auch Stimmen, die eine eigene Lizenz besitzen.

## Installation

### Woher Sie &jovie; bekommen

&install.intro.documentation;

Debian Installationsbefehl: `apt-get install jovie`

Sie finden Quelltexte und übersetzte Pakete auf der &kde; Accessibility Webseite (http://accessibility.kde.org).

Wenn Sie Zugriff auf das KDE-Quellcodearchiv haben, können Sie das Programm &jovie; daraus herunterladen. &jovie; finden Sie im Ordner `jovie`. Außerdem finden Sie den Quellcode von &jovie; unter http://download.kde.org/stable/.

### Voraussetzungen

Unbedingt erforderlich:

- &kde; Version 4.8 oder neuer.

- speech-dispatcher version 0.67 oder neuer.

- Ein Sprachsynthesizer. Die folgenden Synthesizer und Sprachen werden zur Zeit unterstützt.

  Espeak | Enthält viele Sprachen, eine Liste aller aktuell unterstützten Sprachen finden Sie auf der Projektseite http://espeak.sourceforge.net/languages.html.
  Festival | Amerikanisches Englisch, Britisch, Spanisch, Deutsch, Finnisch, Tschechisch, Polnisch, Russisch, Italienisch, Französisch, Kanadisches Französisch, Kiswahili, Zulu und Ibibio.

  &jovie; arbeitet mit auch mit jedem Sprachsynthesizer, der auf der Befehlszeile in einer &konsole; gestartet werden kann.

  Die Liste der oben genannten Sprachen kann unvollständig oder veraltet sein. Ziehen Sie daher die Beschreibung der Synthesizer zu den unterstützten Sprachen zu Rate. Schauen Sie auch auf der Webseite von &jovie;, nach Informationen, die noch nicht in diesem Handbuch enthalten sind.

  Das Programm "speech-dispatcher" benutzt eine anpassungsfähige Modul-Architektur für Sprachsynthesizer. Wenn Sie &jovie; für die Nutzung eines anderen Synthesizers erweitern möchten, setzen Sie sich mit dem Entwicklerteam in Verbindung.

  Spezielle Anleitungen zu den verschiedenen Sprachsynthesizern finden Sie in configuration.

Zusätzliche Komponenten:

- Das Programm `xsltproc` wird für die Unterstützung von SSML und für den &XML;-Umwandlungsfilter benutzt, ist aber nicht zwingend notwendig. Debian-Benutzer können xsltproc mit dem Befehl `apt-get install xsltproc` installieren.

### Kompilierung und Installation

Um &jovie; zu kompilieren, brauchen Sie eine aktuelle Entwicklungsumgebung von KDE (Version 4.8 oder neuer) einschließlich der Pakete kdelibs und der Entwickungsdateien für das Programm "speech-dispatcher".

Wenn Sie die Quelltexte von &jovie; aus dem Quelltextarchiv für `kdeaccessibility` beziehen oder den jede Nacht aktuell erstellten Tarball heruntergeladen haben, übersetzen und installieren Sie das Programm mit folgenden Befehlen:

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

### Einrichtung

Bevor Sie &jovie; benutzen, überprüfen Sie zuerst, ob speech-dispatcher mit Ihrem Sprachsynthesizer richtig arbeitet. Dazu können Sie das Shellskript spd-conf verwenden.

KTTSD und kttsmgr wurden in &kde; 4.5 in &jovie; umbenannt. Das Programm &jovie; soll so weiterentwickelt werden, dass die Einrichtung von speech-dispatcher direkt möglich ist und das Skript spd-conf nicht mehr benötigt wird.

&documentation.index;