# 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 någon talsyntes. Det kräver istället att ett talsyntesprogram är installerat på systemet.

## Att använda &kmouth;

### Första inställningen

Första gången &kmouth; används, visas en guide där du kan anpassa det.

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

Du anger kommandot som 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 ochsidan Ordkomplettering.

#### 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 utförs genom att skriva in snabbtangenten för en mening, eller genom att välja en mening i menyn Parlör 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

Genom att välja Använd standardsystem för talsyntes talar du om för &kmouth; att först försöka använda systemets taltjänst innan talsyntes anropas direkt. Om det lyckas, ignoreras övriga inställningar under den här fliken. Systemets taltjänst är ett &Qt;-bibliotek som omger speech-dispatcher på &Linux; och inbyggda talsystem på andra plattformar. På ett Debian-baserat system behövs paketen speech-dispatcher, libqt5texttospeech5 och en av modulerna i speech-dispatcher, oftast espeak.

Använd kommandoradsverktyget `spd-conf` (Debian-paketet python3-speechd) för att justera inställningar som hastighet, tonhöjd, volym, rösttyp och språk, etc. för standardtalsystemet. Dessutom låter `spd-conf` dig välja mellan alla installerade speech-dispatcher moduler, dvs. espeak, festival, flite, mbrola etc.

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 kommandot för att läsa upp texter.

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

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

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

## Tack till och licens

&kmouth;

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;