# Handbok &kmouth;

## Inledning

&kmouth; är ett program som gör det möjligt för personer som inte kan tala, att låta sina datorer tala. Det innehåller en historik med talade meningar, där användaren kan välja meningar som ska sägas igen.

Observera att &kmouth; inte innehåller talsyntes. Det kräver istället att ett talsyntesprogram är installerat på systemet.

Rapportera gärna eventuella problem eller önskemål om funktioner till &kmouth;s upphovsman.

## Att använda &kmouth;

### Första uppstarten

När &kmouth; startas första gången, visas en guide där du kan skriva in några grundläggande inställningar.

Guiden Guiden

Du anger kommandot som senare ska användas för konvertering från text till tal på guidens första sida (skärmbilden till vänster). För mer information se beskrivningen av inställningsdialogrutan.

Du anger vilka standardparlörer du behöver på andra sidan. I parlörerna kan du sedan välja ofta använda meningar, så att du inte behöver skriva in dem. Naturligtvis har &kmouth; också en redigeringsdialogruta ifall du senare vill redigera parlörerna.

På den tredje sidan (skärmbilden till höger) definierar du ordlistan för ordkomplettering. &kmouth; tolkar KDE:s dokumentation på valt språk för att detektera relativa förekomsten av enskilda ord. Du kan också valfritt jämföra ordlistan med en Openoffice.org-ordlista för att bara lägga till rättstavade ord i ordkompletteringen.

### Huvudfönstret

&kmouth;s huvudfönster är ganska enkelt. Det består egentligen av ett redigeringsfält där du skriver in meningar (det neder vita fältet på skärmbilden) och en historik med upplästa meningar (det övre vita fältet i skärmbilden).

Huvudfönstret i &kmouth; Skärmbild

Med antagandet att du har anpassat &kmouth; riktigt, kan du använda redigeringsfältet för att skriva in meningar som du vill höra. Så fort en mening har lästs upp, läggs den till i historiken. Du kan välja meningar i historiken som ska läsas upp igen.

Du kan välja meningar som ofta används i parlörerna (placerade i raden under verktygsraden).

### Inställningsdialogrutan

Du visar inställningsdialogrutan i &kmouth; genom att använda menyalternativet Inställningar Anpassa &kmouth;.... Dialogrutan består av två flikar, Text till tal och Inställningar.

#### Fliken Text-till-tal

Fliken Text-till-tal Skärmbild

Du skriver in kommandot för att anropa talsyntesprogrammet i redigeringsfältet under fliken Text till tal. Du anger teckenkodningen som används för att skicka text till talsyntesprogrammet i kombinationsrutan under redigeringsfältet.

&kmouth; känner till två sätt att skicka texten: Om kommandot förväntar sig texten som standardinmatning markerar du kryssrutan.

Det andra sättet är att skicka texten som en parameter. Innan kommandot anropas, ersätter &kmouth; vissa platsmarkörer med verkligt innehåll:

Platsmarkör | Ersätts med
%t | Den verkliga texten som ska läsas upp
%f | Namnet på en tillfällig fil som innehåller texten som ska läsas upp
%l | Språkkoden som hör ihop med aktuell ordkompletteringslista
%% | Ett procenttecken

Naturligtvis beror kommandot för att läsa upp text på vilket talsyntesprogram du använder. Titta i dokumentationen för talsyntesprogrammet för att hitta kommanot för att läsa upp texter. Du hittar exempel på kommandon i appendix.

Genom att välja Använd KTTSD-taltjänst om möjligt talar du om för &kmouth; att först försöka skicka texten till KTTSD-taltjänsten. Om det lyckas, ignoreras övriga inställningar under den här fliken. KTTSD-taltjänsten är &kde;-demon som ger &kde;-program ett standardgränssnitt för talsyntes, som för närvarande utvecklas i CVS. Det är ofarligt att markera alternativet även om KTTSD inte är installerad.

#### Fliken Inställningar

Fliken Inställningar Skärmbild

Fliken Inställningar innehåller alternativ som ändrar &kmouth;s beteende i vissa fall.

Med den första kombinationsrutan, Markering av meningar i parlören, anger du vilken åtgärd som utlöses genom att skriva in snabbtangenten för en mening, eller genom att välja en mening i menyn Parlörer eller i parlörraden.

Genom att välja Läs upp omedelbart läses den markerade meningen omedelbart upp och skrivs in i historiken. Om du väljer Infoga i redigeringsfält, infogas bara den markerade meningen i redigeringsfältet.

Med den andra kombinationsrutan, När parlörens redigeringsfönster stängs, anger du om parlören sparas när du bara stänger parlörens redigeringsfönster.

Genom att välja Spara parlör, sparas parlören. Om du väljer Kasta ändringar, kastas ändringarna och parlören sparas inte. Om du väljer Fråga om de ska sparas, frågar &kmouth; dig om parlören ska sparas.

#### Sidan Ordkomplettering

Sidan Ordkomplettering Skärmbild

Sidan Ordkomplettering innehåller en lista med ordlistor som används för ordkompletteringen (&kmouth; visar en kombinationsruta intill redigeringsfältet i huvudfönstret om listan innehåller mer än en ordlista. Du kan använda kombinationsrutan för att välja ordlistan som verkligen används vid ordkomplettering.)

Med knapparna till höger kan du lägga till och ta bort ordlistor, ändra ordning på ordlistor, eller exportera ordlistor till en fil. Med redigeringsfältet och kombinationsrutan under listan kan du ändra namn och språk som hör ihop med ordlistan.

När du lägger till en ny ordlista kan du välja mellan flera källor:

- Skapa en ny ordlista från KDE:s dokumentation

  Om du använder den här källan, frågar &kmouth; dig om önskat språk och tolkar därefter KDE:s dokumentation. Relativa förekomsten av enskilda ord detekteras genom att helt enkelt räkna förekomsten av varje ord. Du kan också valfritt jämföra ordlistan med en Openoffice.org-ordlista för att bara lägga till rättstavade ord i ordkompletteringen.

- Skapa en ny ordlista från en fil

  Om du använder den här källan, frågar &kmouth; dig om önskad fil. Du kan antingen välja en XML-fil, en vanlig textfil eller en fil som innehåller ordkompletteringskatalog som antingen skapats av &kmouth; eller GOK (GNOME On-screen Keyboard). Om du väljer en vanlig textfil eller en XML-fil, detekteras relativa förekomsten av enskilda ord genom att helt enkelt räkna förekomsten av varje ord. Du kan också valfritt jämföra ordlistan med en Openoffice.org-ordlista för att bara lägga till rättstavade ord i den nya ordlistan.

- Skapa en ny ordlista från en katalog

  Om du använder den här källan, frågar &kmouth; dig om önskad katalog. &kmouth; öppnar alla filer i den katalogen och dess underkataloger. Varje fil laddas antingen som en ordkompletteringslista, som en XML-fil eller som en vanlig textfil. I de två senare fallen, räknas förekomsten av varje enskilt ord. Du kan också valfritt jämföra ordlistan med en Openoffice.org-ordlista för att bara lägga till rättstavade ord i den nya ordlistan.

- Slå ihop ordlistor

  Du kan använda det här alternativet för att sammanfoga tillgängliga ordlistor. &kmouth; frågar vilka ordlistor som ska sammanfogas och hur de enskilda ordlistorna ska viktas.

- Skapa en tom ordlista

  Du kan använda det här alternativet för att skapa en tom ordlista utan några poster. Eftersom &kmouth; automatiskt lägger till nyinskrivna ord i ordlistor, lär den sig ditt ordförråd med tiden.

### Parlörens redigeringsfönster

Genom att använda menyalternativet Parlörer Redigera... visas parlörens redigeringsfönster.

Parlörens redigeringsfönster Skärmbild

Huvudområdet i parlörens redigeringsfönster är uppdelat i två delar. I den övre delen visas parlörerna i en trädstruktur.

I den nedre delen kan du ändra en markerad post. Om du har markerat en mening, kan du ändra innehållet i meningen samt dess snabbtangent. Om du har markerat en parlör kan du bara ändra dess namn.

Åtgärder som att lägga till nya meningar och parlörer, och ta bort markerade meningar och parlörer kan utföras genom att välja dem antingen i menyraden, verktygsraden eller i en meny som visas med höger musknapp.

Du kan ändra ordning för parlörer och meningar genom att dra dem till deras nya platser, eller genom att använda piltangenterna medan &Alt; tangenten hålls nere.

## Kommandoreferens

### Kommandon i huvudfönstret

#### Menyn Arkiv

&Ctrl;O Arkiv Öppna som historik...

- Öppnar en textfil som en historik med upplästa meningar.

&Ctrl;S Arkiv Spara historik som...

- Sparar historiken i en textfil.

&Ctrl;P Arkiv Skriv ut historik...

- Skriver ut historiken.

&Ctrl;Q Arkiv Avsluta

- Avslutar &kmouth;

#### Menyn Redigera

&Ctrl;X Redigera Klipp ut

- Klipper ut den markerade delen och lägger den på klippbordet. Om det finns markerad text i redigeringsfältet läggs den på klippbordet. Annars läggs de markerade meningarna i historiken (om det finns några) på klippbordet.

&Ctrl;C Redigera Kopiera

- Kopierar den markerade delen till klippbordet. Om det finns markerad text i redigeringsfältet kopieras den till klippbordet. Annars kopieras de markerade meningarna i historiken (om det finns några) till klippbordet.

&Ctrl;V Redigera Klistra in

- Klistrar in klippbordets innehåll på markörens nuvarande plats i redigeringsfältet.

Redigera Läs upp

- Läser upp meningar som för närvarande är aktiva. Om det finns någon text i redigeringsfältet läses den upp. Annars läses eventuella markerade meningar i historiken upp.

#### Menyn Parlörer

Parlörer Redigera...

- Visar parlörens redigeringsfönster.

#### Menyn Inställningar

Inställningar Visa menyrad

- När markerad, visar detta menyraden. När avmarkerad döljs menyraden.

Inställningar Visa verktygsrad

- Om markerad, visas en flyttbar verktygsrad som innehåller knappar som används för att utföra ofta använda kommandon. Verktygsraden placeras oftast längst upp i editorn, precis under menyraden. Om inte markerad, är verktygsraden gömd. Ett klick på det streckade greppet visar eller gömmer verktygsraden. Genom att klicka och dra på greppet, kan verktygsraden flyttas.

Inställningar Visa parlörrad

- Om markerad, visas en flyttbar parlörrad som innehåller knappar för parlöralternativen. Parlörraden placeras oftast längst upp i editorn, precis under verktygsraden. Om inte markerad, är parlörraden gömd. Ett klick på det streckade greppet visar eller gömmer eller visar raden. Genom att klicka och dra på greppet, kan raden flyttas.

Inställningar Visa statusrad

- Om markerad, visas en liten rad längst ner i huvudfönstret som innehåller information om &kmouth;s status. Om inte markerad, är statusraden gömd.

Inställningar Anpassa Kmouth...

- Visar inställningsdialogrutan för talsyntes och andra inställningar i &kmouth;.

#### Menyn Hjälp

&help.menu.documentation;

#### Menyn med historikposter

Läs upp

- De markerade meningarna läses upp.

Ta bort

- De markerade meningarna tas bort från historiken.

Klipp ut

- De markerade meningarna tas bort och placeras på klippbordet.

Kopiera

- De markerade meningarna kopieras till klippbordet.

Markera alla poster

- Alla historikposter markeras.

Avmarkera alla poster

- Alla historikposter avmarkeras.

&Ctrl;O Öppna som historik...

- Öppnar en textfil som en historik med upplästa meningar.

&Ctrl;S Spara historik som...

- Sparar historiken i en textfil.

### Kommandon inne i parlörens redigeringsfönster

#### Menyn Arkiv

Arkiv Ny mening

- Lägger till en ny mening.

Arkiv Ny parlör

- Lägger till en ny parlör.

&Ctrl;S Arkiv Spara

- Sparar parlören.

Arkiv Importera...

- Importerar en fil och lägger till innehållet till parlören

Arkiv Importera standardparlör

- Importerar en standardparlör och lägger till innehållet till parlören

Arkiv Exportera...

- Exporterar meningar eller parlörer som för närvarande är markerade till en fil

&Ctrl;P Arkiv Skriv ut...

- Skriver ut nuvarande markerade meningar eller parlörer

&Ctrl;W Arkiv Stäng

- Stänger fönstret

#### Menyn Redigera

&Ctrl;X Redigera Klipp ut

- Klipper ut markerade objekt och lägger dem på klippbordet.

&Ctrl;C Redigera Kopiera

- Kopierar markerade objekt till klippbordet.

&Ctrl;V Redigera Klistra in

- Klistrar in klippbordets innehåll i parlören.

Redigera Ta bort

- Tar bort markerade objekt.

#### Menyn Hjälp

&help.menu.documentation;

#### Menyn som visas

Ny mening

- Lägger till en ny mening.

Ny parlör

- Lägger till en ny parlör.

Importera...

- Importerar en fil och lägger till innehållet till parlören

Importera standardparlör

- Importerar en standardparlör och lägger till innehållet till parlören

Exportera...

- Exporterar meningar eller parlörer som för närvarande är markerade till en fil

Klipp ut

- Klipper ut markerade objekt och lägger dem på klippbordet.

Kopiera

- Kopierar markerade objekt till klippbordet.

Klistra in

- Klistrar in klippbordets innehåll på det här platsen i parlören.

Ta bort

- Tar bort markerade objekt.

## Vanliga frågor

&reporting.bugs; &updating.documentation;

Jag kan inte höra någonting.

Troligen ställde du inte in text-till-tal kommandot riktigt (eller inte alls?). Använd Inställningar Anpassa Kmouth... och skriv in kommandot för att läsa upp texter. (Se avsnittet om inställningsdialogrutan för talsyntes för mer information.)

## Tack till och licens

&kappname;

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

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

Översättning Stefan Asserhäll stefan.asserhall@comhem.se

&underFDL; &underGPL;

## Exempel på inställning av text till tal

Festival

Festival är ett text till tal-system skrivet på Edinburghs universitet. Det stöder för närvarande engelskt, spanskt och walesiskt tal. Dess licens tillåter att Festival används och distribueras utan kostnad eller begränsningar.

För att skapa exemplet för inställning av text till tal-kommandoraden, antar vi att Festival är installerad i katalogen `/usr/local/festival/`. Kommandot för att läsa upp texter är då följande:

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

Alternativet Skicka data som standardinmatning måste vara aktiverat.

FreeTTS

FreeTTS är en talsyntes helt och hållet skriven i programspråket Java™. Den stöder för närvarande bara engelskt uttal. Dess licens tillåter att FreeTTS används och distribueras utan kostnad eller begränsningar.

För att skapa exemplet för inställning av text till tal-kommandoraden, antar vi att FreeTTS är installerad i katalogen `/usr/local/freettsl/`. Kommandot för att läsa upp texter kan då vara ett av de tre följande exemplen:

    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

För det tredje exemplet måste alternativet Skicka data som standardinmatning vara aktiverat. (Detta exemplet är att föredra för användning med FreeTTS.)

MBROLA

MBROLA är en talsyntes för ett stort antal språk. Den konverterar en lista med fonem till en wave-fil, så du behöver ett annat verktyg för att konvertera texten till en lista med fonem. MBROLA:s licens tillåter användning av MBROLA utan kostnad för icke-kommersiella, icke-militära tillämpningar.

I vårt exempel använder vi Hadifax för att konvertera tysk text till en listan med fonem som passar MBROLA. Vi antar att Hadifax och MBROLA är installerade i `/usr/local/hadifax/` och `/usr/local/mbrola/`.

Tyvärr brukar Hadifax svälja det sista tecknet i texten, så vi borde lägga till ett extra tecken i texten. Det fullständiga kommandot är därför mer komplicerat än föregående exempel:

    (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

Alla delar av kommandot måste skrivas på en rad. Alternativet Skicka data som standardinmatning måste vara aktiverat.

KDE:s text till tal-demon

KDE:s text till tal-demon (KTTSD) är en text till tal-tjänst för hela &kde;, som ger &kde;-program ett standardiserat gränssnitt för talsyntes, och och som för närvarande utvecklas i CVS. Den använder insticksprogram för att stödja diverse text till tal-system.

Eftersom inställningen av talsyntesen görs i KTTSD, är den enda specifika inställningen som måste aktiveras i &kmouth; Använd KTTSD-taltjänst om möjligt.

Du måste förstås ställa in KTTSD. Du kan göra det på inställningssidan KTTSD-taltjänst som läggs till i &kmouth;s inställningsdialogruta om KTTSD är installerad.

## Installation

### Hur man skaffar &kmouth;

&install.intro.documentation;

### Krav

För att använda &kmouth; med lyckat resultat, behöver du ett talsyntesprogram (och förstås &kde; 3.x). &kmouth; använder omkring 15 Mibyte minne för att köra (plus mängden minne som behövs av talsyntesen), men det kan variera beroende på plattform och inställningar.

### Kompilering och installation

&install.compile.documentation;