# Het handboek van &kmouth;

Gunnar Schmi Dt

    gunnar@schmi-dt.de

&Rob.Lalau;&Pieter.Hoekstra;&Tom.Albers;
2002 2003 Gunnar Schmi Dt
&FDLNotice;
2004-05-31
1.1.1

&kmouth; is een toepassing die mensen die niet kunnen praten in staat stelt de computer te laten praten.

KDE kdeutils KMouth omzetting van tekst naar spraak doofstomme mensen

## Inleiding

&kmouth; is een programma dat mensen die niet kunnen praten, in staat stelt de computer te laten praten. Het programma houdt een geschiedenis bij van gesproken zinnen, zodat de gebruiker zinnen kan selecteren om opnieuw uit te spreken.

Houd er rekening mee dat &kmouth; niet voorzien is van een spraaksynthesizer. Een spraaksynthesizer moet apart geïnstalleerd zijn.

Voor opmerkingen en verzoeken kunt u zich wenden tot de auteur van &kmouth;.

## &kmouth; gebruiken

### De eerste keer

Als u &kmouth; voor het eerst start, wordt u een assistent gepresenteerd waarmee u enkele basisinstellingen kunt invoeren.

De assistent

De assistent

Op de eerste pagina van de assistent (de linker schermafdruk) specificeert u het commando dat later gebruikt zal worden voor de tekst-naar-spraak-conversie. Zie voor meer informatie de beschrijving van het configuratievenster.

Op de tweede pagina selecteert u de uitdrukkingenboeken die u wilt gebruiken. Uit deze uitdrukkingsboeken kunt u later veelgebruikte uitdrukkingen selecteren, zodat u ze niet uit hoeft te typen. Uiteraard heeft &kmouth; ook een bewerkvenster voor het geval u later uw uitdrukkingenboeken wilt bewerken.

Met de derde pagina (de rechter schermafdruk) kunt u het woordenboek aangeven dat moet worden gebruikt voor het automatisch aanvullen van woorden. &kmouth; zal de KDE documentatie inlezen van de gekozen taal om de frequentie te bepalen van de afzonderlijke woorden. Optioneel kunt u de woordenlijst vergelijken met een woordenboek van OpenOffice.org om alleen correct gespelde woorden toe te laten tot het woordenboek.

### Het hoofdvenster

Het hoofdvenster van &kmouth; is vrij eenvoudig. De twee belangrijkste onderdelen zijn een invoerveld waar u uw zinnen typt (het onderste witte veld in de schermafdruk), en een lijst met zinnen die al uitgesproken zijn (het bovenste witte veld in de schermafdruk).

Het hoofdvenster van &kmouth;

Schermafdruk

Als u &kmouth; goed hebt ingesteld kunt u het invoerveld gebruiken om zinnen in te voeren die u wilt horen. Als een zin uitgesproken is wordt hij aan de geschiedenislijst toegevoegd. Om een zin opnieuw te horen, kunt u hem uit de lijst selecteren.

Uit de uitdrukkingenboeken (in de balk onder de werkbalk) kunt u vaak gebruikte uitdrukkingen selecteren.

### Het configuratievenster

Via de menuoptie Instellingen&kmouth; instellen... opent u het configuratievenster voor &kmouth;. Dit venster bestaat uit twee tabbladen, Voorkeuren en Tekst-naar-spraak.

#### Het tabblad Tekst-naar-spraak

Het tabblad Tekst-naar-spraak

Schermafdruk

In het invoerveld van het tabblad Tekst-naar-spraak vult u het commando in waarmee de spraaksynthesizer aangeroepen wordt. Bij Tekenset vult u de tekenset in die gebruikt wordt om commando's naar de spraaksynthesizer te sturen.

&kmouth; kan de tekst op twee manieren naar het commando sturen: als het commando de tekst via standaardinvoer verwacht, selecteer dan deze optie.

Het is ook mogelijk om de tekst als parameter naar het commando te sturen: voordat het commando aangeroepen wordt, vervangt &kmouth; enkele plaatshouders door tekst:

Plaatshouder | Vervangen met
--- | ---
%t | De tekst die moet worden uitgesproken
%f | De naam van het tijdelijke bestand met de tekst die moet worden uitgesproken
%l | De taalcode die is verbonden met het huidige woordaanvulling-woordenboek
%% | Het percentageteken

Uiteraard is het commando dat gebruikt wordt om teksten uit te spreken afhankelijk van de spraaksynthesizer die u gebruikt. Zie de documentatie van uw spraaksynthesizer voor het commando dat u dient te gebruiken. U kunt voorbeelden vinden voor de commandoregel in de appendix.

Door kttsd-spraakservice gebruiken indien mogelijk te selecteren geeft u &kmouth; opdracht de kttsd spraakservice te proberen. Als dit lukt wordt de rest van de instellingen genegeerd. De kttsd spraakservice is een &kde; daemon die op dit ogenblik in de cvs ontwikkeld wordt, en die &kde;-toepassingen een gestandaardiseerde interface biedt voor spraaksynthese. Het kan geen kwaad om deze optie in te schakelen als kkttsd niet geïnstalleerd is.

#### Het tabblad Voorkeuren

Het tabblad Voorkeuren

Schermafdruk

Op het tabblad Voorkeuren vindt u opties die het gedrag van &kmouth; in bepaalde situaties wijzigen.

Met het eerste selectieveld, Selectie van uitdrukkingen in het uitdrukkingenboek, geeft u aan welke actie genomen moet worden als u een uitdrukking kiest uit een uitdrukkingenboek (door een sneltoets te gebruiken of door een uitdrukking te kiezen uit het menu Uitdrukkingenboeken of uit de uitdrukkingenbalk.

Als u Onmiddellijk uitspreken kiest, wordt de geselecteerde uitdrukking direct uitgesproken en aan de geschiedenis toegevoegd. Als u Invoegen in tekstinvoerveld selecteert, wordt de tekst in het invoerveld geplaatst.

Met het tweede selectieveld, Sluit het tekstinvoervenster van het uitdrukkingenboek, geeft u aan of u wilt dat het uitdrukkingenboek opgeslagen wordt als u het bewerkingsvenster voor uitdrukkingenboeken sluit.

Als u Uitdrukkingenboek opslaan selecteert, wordt het uitdrukkingenboek opgeslagen. Als u kiest voor Wijzigingen negeren worden gemaakte wijzigingen verworpen. Als u Vragen of er dient te worden opgeslagenkiest, vraagt &kmouth; of het uitdrukkingenboek moet worden opgeslagen.

#### Het tabblad Woordaanvulling

Het tabblad Woordaanvulling

Schermafdruk

Het tabblad Woordaanvulling bevat een lijst met woordenboeken die worden gebruikt voor het aanvullen van woorden. (&kmouth; zal een combobox tonen naast het invoervak in het hoofdvenster als deze lijst meer dan een woordenboek bevat. U kunt deze combobox gebruiken om het woordenboek te gebruiken dat moet worden gebruikt voor het automatisch aanvullen van de woorden.

Met de knoppen aan de rechterkant van de pagina kunt u woordenboeken toevoegen en verwijderen, de volgorde veranderen van de woordenboeken of ze exporteren naar een bestand. Met het invoervak en de combobox onder de lijst kunt u de naam en de taal veranderen die zijn verbonden met het woordenboek.

Als u een nieuw woordenboek toevoegt kunt u kiezen uit verschillende bronnen

- Maak een nieuw woordenboek op basis van de KDE documentatie

  Als u deze bron gebruikt zal &kmouth; u vragen naar de bedoelde taal en daarna de KDE documentatie inlezen. De frequentie van de afzonderlijke woorden wordt bepaald door de instanties te tellen van elk woord. Optioneel kunt u de lijst vergelijken met een woordenboek van OpenOffice.org om alleen correct gespelde woorden toe te laten tot het nieuwe woordenboek.

- Maak een nieuw woordenboek van een bestand

  Als u deze bron selecteert zal &kmouth; u vragen naar de bestandsnaam. U kunt een XML bestand, een standaard tekstbestand of een bestand dat een woordaanvulling-woordenboek bevat dat werd gemaakt door &kmouth; of GOK (de Toetsenbord op het scherm van de GNOME) selecteren. Als u een standaard tekstbestand selecteert word de frequentie bepaald van elk woord door de instaties van elk woord te tellen. Optioneel kunt u de lijst vergelijken met een woordenboek van OpenOffice.org om alleen correct gespelde woorden toe te laten tot het nieuwe woordenboek.

- Maak een nieuw woordenboek van een map

  Als u deze bron gebruikt zal &kmouth; u vragen naar de bedoelde map. &kmouth; zal alle bestanden in de map en submappen openen. Elk bestand word gelezen als een woordaanvulling-woordenboek, een XML bestand of als een standaard tekstbestand. In de laaste twee gevallen wordt de frequentie bepaald van elk woord in het bestand. Optioneel kunt u de lijst vergelijken met een woordenboek van OpenOffice.org om alleen correct gespelde woorden toe te laten tot het nieuwe woordenboek.

- Woordenboeken samenvoegen

  U kunt deze optie gebruiken om alle beschikbare woordenboeken samen te voegen. &kmouth; zal vragen welke woordenboeken samengevoegd moeten worden en hoe de zwaar afzonderlijke woordenboeken moeten worden gewogen.

- Maak een lege woordenlijst

  U kunt deze optie gebruiken om een leeg woordenboek zonder enige lemmas te maken. Omdat &kmouth; automatisch nieuw getypte woorden toevoegd aan de woordenboeken zal het uw vocabulaire leren kennen.

### Het bewerkingsvenster voor uitdrukkingenboeken

U opent het bewerkingsvenster voor uitdrukkingenboeken door het menuoptie Uitdrukkingenboeken Bewerken... te kiezen.

Het bewerkingsvenster voor uitdrukkingenboeken

Schermafdruk

Het hoofdveld van het bewerkingsvenster voor uitdrukkingenboeken bestaat uit twee delen. In het bovenste deel worden de uitdrukkingenboeken in een boomstructuur weergegeven.

In het onderste deel kunt u het geselecteerde item bewerken. Als u een uitdrukking hebt geselecteerd kunt u de uitdrukking en de sneltoets bewerken. Als u een uitdrukkingenboek geselecteerd hebt kunt u alleen de naam bewerken.

U kunt uitdrukkingen en uitdrukkingenboeken toevoegen en verwijderen via het menu, de werkbalk of het contextmenu.

U kunt de volgorde van de uitdrukkingenboeken en uitdrukkingen wijzigen door ze te slepen, of door de pijltoetsen te gebruiken terwijl u de &Alt;-toets ingedrukt houdt.

## Commandoreferentie

### Commando's in het hoofdvenster

#### Het menu Bestand

&Ctrl;O Bestand Openen als geschiedenis...

  Leest een tekstbestand, en plaatst het in de geschiedenislijst.

&Ctrl;S Bestand Geschiedenis opslaan als...

  Slaat de geschiedenislijst op als tekstbestand.

&Ctrl;P Bestand Geschiedenis afdrukken...

  Drukt de geschiedenislijst af.

&Ctrl;Q Bestand Afsluiten

  Sluit &kmouth; af.

#### Het menu Bewerken

&Ctrl;X Bewerken Knippen

  Knipt de selectie en plaatst deze op het klembord. Als er een stuk tekst is geselecteerd in het invoerveld, dan wordt deze op het klembord geplaatst. Anders worden de geselecteerde uitdrukkingen in de geschiedenis (indien aanwezig) op het klembord geplaatst.

&Ctrl;C Bewerken Kopiëren

  Kopieert de geselecteerde sectie naar het klembord. Als er een stuk tekst is geselecteerd in het tekstinvoerveld, dan wordt deze op het klembord geplaatst. Anders worden de geselecteerde zinnen in de geschiedenis (indien aanwezig) op het klembord geplaatst.

&Ctrl;V Bewerken Plakken

  Plakt de inhoud van het klembord op de huidige positie van de muisaanwijzer in het invoerveld.

Bewerken Spreken

  De momenteel actieve zin(nen) worden gesproken. Als er tekst in het tekstinvoerveld staat wordt deze gesproken. Anders worden de geselecteerde zinnen in de geschiedenis (indien aanwezig) gesproken.

#### Het menu Uitdrukkingenboeken

Uitdrukkingenboeken Bewerken...

  Opent het venster voor het bewerken van uitdrukkingenboeken.

#### Het menu Instellingen

Instellingen Statusbalk tonen

  Indien deze optie is aangevinkt zal de menubar worden getoont. Anders is de menubar verborgen.

Instellingen Werkbalk tonen

  Als dit ingeschakeld is, wordt er een verplaatsbare werkbalk getoond met de meest gebruikte commando's. De werkbalk wordt meestal langs de bovenkant van het venster getoond, direct onder het menu. Als dit uitgeschakeld is, wordt de werkbalk niet getoond. De gebruiker kan de werkbalk verplaatsen door hem op te pakken bijhet handvat.

Instellingen Uitdrukkingenboek-balk tonen

  Als dit ingeschakeld is, wordt er een verplaatsbare werkbalk getoond met de meest gebruikte commando's. De werkbalk wordt meestal langs de bovenkant van het venster getoond, direct onder het menu. Als dit uitgeschakeld is, wordt de werkbalk niet getoond. De gebruiker kan de werkbalk verplaatsen door hem op te pakken bij het handvat.

Instellingen Statusbalk tonen

  Als dit ingeschakeld is, wordt onderin het hoofdvenster een balk getoond waaarin u kunt zien wat de status van &kmouth; is. Als dit uitgeschakeld is, wordt de balk niet getoond.

Instellingen KMouth instellen...

  Opent het venster voor de configuratie van de spraaksynthesizer en andere instellingen.

#### Het menu Help

&help.menu.documentation;

#### Het contextmenu voor geschiedenisitems

Spreken

  De geselecteerde zinnen worden uitgesproken.

Verwijderen

  De geselecteerde zinnen worden verwijderd uit de geschiedenislijst.

Knippen

  De geselecteerde zinnen worden verwijderd en op het klembord geplaatst.

Kopiëren

  De geselecteerde zinnen worden gekopieerd naar het klembord.

Alle ingangen selecteren

  Alle items in de geschiedenislijst worden geselecteerd.

Alle ingangen deselecteren

  Alle items in de geschiedenislijst worden gedeselecteerd.

&Ctrl;O Openen als geschiedenis...

  Leest een tekstbestand, en plaatst het in de geschiedenislijst.

&Ctrl;S Geschiedenis opslaan als...

  Slaat de geschiedenislijst op als tekstbestand.

### Commando's in het venster voor het bewerken van uitdrukkingenboeken

#### Het menu Bestand

Bestand Nieuwe uitdrukking

  Voegt een nieuwe uitdrukking toe.

Bestand Nieuw uitdrukkingenboek

  Voegt een nieuw uitdrukkingenboek toe.

&Ctrl;S Bestand Opslaan

  Slaat het uitdrukkingenboek op.

Bestand Importeren...

  Importeert een bestand en voegt de inhoud ervan toe aan het uitdrukkingenboek.

Bestand Standaard uitdrukkingenboek importeren

  Importeert een standaard uitdrukkingenboek en voegt de inhoud ervan toe aan het uitdrukkingenboek.

Bestand Exporteren...

  Exporteert de geselecteerde uitdrukkingen of uitdrukkingenboeken naar een bestand.

&Ctrl;P Bestand Afdrukken...

  Drukt de momenteel geselecteerde uitdrukking(en) of uitdrukkingenboek(en) af.

&Ctrl;W Bestand Sluiten

  Sluit het venster.

#### Het menu Bewerken

&Ctrl;X Bewerken Knippen

  Verwijdert de geselecteerde items en plaatst ze op het klembord.

&Ctrl;C Bewerken Kopiëren

  Kopieert de geselecteerde items naar het klembord.

&Ctrl;V Bewerken Plakken

  Plakt de inhoud van het klembord in het uitdrukkingenboek.

Bewerken Verwijderen

  Verwijdert de geselecteerde items.

#### Het menu Help

&help.menu.documentation;

#### Het contextmenu

Nieuwe uitdrukking

  Voegt een nieuwe uitdrukking toe.

Nieuw uitdrukkingenboek

  Voegt een nieuw uitdrukkingenboek toe.

Importeren...

  Importeert een bestand en voegt de inhoud ervan toe aan het uitdrukkingenboek.

Standaard uitdrukkingenboek importeren

  Importeert een standaard uitdrukkingenboek en voegt de inhoud ervan toe aan het uitdrukkingenboek.

Exporteren...

  Exporteert de geselecteerde uitdrukkingen of uitdrukkingenboeken naar een bestand.

Knippen

  Verwijdert de geselecteerde items en plaatst ze op het klembord.

Kopiëren

  Kopieert de geselecteerde items naar het klembord.

Plakken

  Plakt de inhoud van het klembord op deze positie in het uitdrukkingenboek.

Verwijderen

  Verwijdert de geselecteerde items.

## Vragen en antwoorden

&reporting.bugs; &updating.documentation;

Ik hoor niets.

Waarschijnlijk hebt u het tekst-naar-spraak-commando niet (correct) geconfigureerd. Selecteer Instellingen&kmouth; instellen... en dan tabblad Tekst-naar-spraak, en vul het commando in om teksten uit te spreken. (Zie de sectie over configuratie van de spraaksynthesizer voor meer info).

## Dankbetuigingen en licentie

&kappname;

Programma copyright 2002, 2003 Gunnar Schmi Dtgunnar@schmi-dt.de

Documentatie copyright 2002, 2003 Gunnar Schmi Dt gunnar@schmi-dt.de

&meld.fouten;&vertaling.rob;&vertaling.pieter;&vertaling.tom;&nagelezen.rinse; &underFDL; &underGPL;

## Voorbeelden van de instellingen voor tekst-naar-spraak

Festival

Festival is een tekst-naar-spraak syteem geschreven door de Unversity of Edinburgh. Het ondersteunt momenteel Engels, Spaans en Welsh. De bijbehorende licentie staat het gebruik en verspreiding van Festival toe zonder kosten of beperkingen.

Voor het voorbeeld van de commandoregel voor de tekst-naar-spraak configuratie gaan we ervan uit dat Festival is geinstalleerd in de map `/usr/local/festival`. Het commando voor het uitspreken van de tekst is dat als volgt:

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

De optie Zend de data als standaard invoer moet zijn ingeschakeld.

FreeTTS

FreeTTS is een spraak sythesizer die is geschreven in Java™. Het ondersteunt momenteel alleen de engelse uitspraak. De licentie staat het gebruik en verspreiden van FreeTTS toe zonder kosten of beperkingen.

Voor het voorbeeld van de commandoregel voor de tekst-naar-spraak configuratie nemen we aan dat FreeTTS is geinstalleerd in de map `/usr/local/freetts/`. Het commando voor het uitspreken van teksten is dan een van de volgende drie voorbeelden:

    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

Voor het derde voorbeeld moet de optie Zend de data als standaard invoer zijn ingeschakeld. (Dit is het geprefereerde voorbeeld voor het gebruik van FreeTTS.)

MBROLA

MBROLA is een spraak synthesizer voor een groot aantal talen. Het vertaald een lijst van fonemen naar een wave-bestand en daarom heb je een andere tool nodig voor het converteren van de tekst naar een lijst van fonemen. De licentie van MBROLA staat het gebruik en de verspreiding zonder kosten of beperkingen toe aan niet-commercieel en niet-militaire toepassingen.

Voor het voorbeeld gaan we ervan uit dat we Hadifax gebruiken om een Duitse tekst te converteren naar een lijst van fonemen die bruikbaar zijn voor MBROLA. We nemen aan dat Hadifax en MBROLA zijn geinstalleerd in `class="directory" >/usr/local/hadifax/` en `/usr/local/mbrola/`

Helaas heeft Hadifax de eigenschap dat het het laatste teken van de tekst inslikt. U kunt daarom een additioneel character toeveoegen aan de tekst. Het gehele commando is daarom compexer dan in de vorige voorbeelden:

    (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

Alle onderdelen van het comando moeten worden geschreven op een regel. De optie Zend de data als standaard invoer moet zijn ingeschakeld.

De KDE Tekst-naar-spraak-daemon

De KDE Tekst-naar-spraak-deamon (KTTSD) is een &kde; breede tekst-naar-spraak service die de &kde; appicaties een standaard interface bieden voor spraaksythese en wordt momenteel ontwikkeld in CVS. Het gebruikt plug-ins om de verschillende tekst-naar-spraak systemen te ondersteunen.

Omdat de configuratie van de spraaksythesizer wordt afgehandeld in KTTSD is de enige &kmouth;-specifieke optie die je moet activeren de otie gebruik de KTTSD spraak service indien mogelijk.

Natuurlijk moet u KTTSD configureren. U kunt dit doen met het tabblad KTTSD Spraak service dat wordt toegevoegd aan de configuratie dialoog indien KTTSD is geinstalleerd.

## Installatie

### Waar vind ik &kmouth;?

&install.intro.documentation;

### Benodigdheden

Om &kmouth; te kunnen gebruiken hebt u een spraaksynthesizer nodig (en natuurlijk &kde; 3.x). &kmouth; gebruikt ongeveer 15 MB van uw geheugen (plus de hoeveelheid geheugen die uw spraaksynthesizer nodig heeft), maar dit kan per systeem verschillen.

### Compilatie en installatie

&install.compile.documentation;