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

## Att använda &kmouth;

### Första starten

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

Inställning av text till tal Inställning av text till tal

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

Ursprunglig parlör Ursprunglig parlör

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.

Ordkomplettering Ordkomplettering

På den tredje sidan 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).

&kmouth;s huvudfönster Huvudfönstret i &kmouth;

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 sidan Allmänna alternativ med de två flikarna Inställningar och Text till tal, sidan Ordkomplettering och sidan Jovie-taltjänst.

#### Inställningsfliken

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.

#### 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 Jovie-taltjänst om möjligt talar du om för &kmouth; att först försöka skicka texten till Jovie-taltjänsten. Om det lyckas, ignoreras övriga inställningar under den här fliken. Jovie-taltjänsten är &kde;-demonen som ger &kde;-program ett standardgränssnitt för talsyntes, som för närvarande utvecklas i Git. Det är ofarligt att markera alternativet även om Jovie inte är installerad.

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

#### Sidan Jovie-taltjänst

Inställning av &kde;:s taltjänst beskrivs i detalj i Handbok Jovie.

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

&kmouth; har de vanliga menyalternativen i &kde;, Inställningar och Hjälp. För mer information läs avsnitten om Menyn Inställningar och Menyn Hjälp i &kde;:s grunder.

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

Alternativen i den här menyn är likadana som i huvudfönstret.

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

&Ctrl;X Klipp ut

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

&Ctrl;C Kopiera

- Kopierar markerade objekt till klippbordet.

&Ctrl;V 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 Dt gunnar@schmi-dt.de

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

Översättning Stefan Asserhäll stefan.asserhall@bredband.net

&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;
              paplay /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 (Jovie) ä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 Git. Den använder insticksprogram för att stödja diverse text till tal-system.

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

Du måste förstås ställa in Jovie. Du kan göra det på inställningssidan Jovie-taltjänst som läggs till i &kmouth;s inställningsdialogruta om Jovie ä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.

### Kompilering och installation

&install.compile.documentation;