# Handbok &kmyapplication;

## Inledning

&kmyapplication; är ett delsystem i KDE för att skapa text-till-tal (TTS). Det tillhandahåller ett gemensamt programmeringsgränssnitt för KDE-programmerare som ger möjlighet att använda text-till-tal i sina program. Det tillhandahåller också några trevliga funktioner för slutanvändare.

Användarfunktioner:

- Läs upp innehållet i en textfil.

- Läs upp KDE:s meddelandehändelser (Knotify).

- Läs upp hela eller delar av texten på en webbsida i Konqueror.

- Läs upp hela eller delar av texten i Kate texteditorn, inklusive fall då Kate är inbäddad i ett annat KDE-program.

- Lång text tolkas till meningar. Användaren kan gå bakåt en mening eller ett stycke, läsa upp igen, göra paus och stoppa uppläsning.

- Ljudutmatning via aRts eller Gstreamer (version 0.8.7 eller senare)

- Filter som kan anpassas av användaren för att ersätta feluttalade ord, välja talsyntes och omvandla XML-dokument.

Programmeringsfunktioner:

- Prioriteringssystem för uppläsning av skärmutmatning, varningar och meddelanden, medan uppläsning av vanlig text pågår.

- Arkitektur baserad på insticksprogram med stöd för ett stort antal olika talsyntesprogram och drivrutiner.

- Tillåter att skapa tal från kommandoraden (eller via skalskript) med KDE:s DCOP-verktyg.

- Tillhandahåller en lättviktig och lättanvänt gränssnitt för program att skapa talad utmatning.

- Program behöver inte bekymra sig om konflikt över uppläsningsenheten.

- FRAMTIDA: Tillhandahåller stöd för talmarkeringsspråk, såsom VoiceXML, Sable, Java Speech Markup Language (JSML), och Speech Markup Meta-language (SMML).

- FRAMTIDA: Tillhandahålla begränsat stöd för inbäddade talmarkörer.

- Asynkront för att förhindra att systemet blockeras.

&kmyapplication; består i själva verket av flera program:

`kttsd`

- KDE:s text-till-tal demon, som är ett program utan grafiskt gränssnitt som tillhandahåller text-till-tal tjänster till program via DCOP.

`kttsmgr`

- Ett grafiskt program för att anpassa och styra kttsd. Programmet kttsmgr är placerad i systembrickan.

`libkhtmlkttsdplugin`

- Ett insticksprogram för webbläsaren Konqueror som tillåter att hela eller delar av texten på en webbsida läses upp.

`ktexteditor_kttsd`

- Ett insticksprogram för texteditorn Kate som tillåter att hela eller delar av en textfil läses upp.

### Stöd

Förutom KDE:s feldatabas Bugzilla (http://bugs.kde.org/), äger diskussioner om &kmyapplication; för närvarande rum på e-postlistan kde-accessibility. Prenumerera på kde-accessibility. Utvecklare finns också på IRC (irc.kde.org, kanalen #kde-accessibility).

## Att använda &kmyapplication;

Innan du kan använda &kmyapplication; måste du installera minst ett talsyntesprogram och försäkra dig om att det fungerar. Se installation.

### Starta `kttsmgr`

För att starta &kmyapplication;-systemet, skriv in följande kommando i en terminal

`kttsmgr`

eller klicka på &kmyapplication; i KDE:s meny.

Om det är första gången `kttsmgr` körs, eller om du ännu inte har ställt in några talare, visas sidan Talare. Se select-plugin. Om du redan har ställt in minst en talare, visas sidan Allmänt. Se general.

### Välja insticksprogram för syntes (talare)

När du klickar på fliken Talare i `kttsmgr`, visas sidan Talare.

KDE:s text-till-tal hantering (fliken Talare). KDE:s text-till-tal hantering (fliken Talare).

- Klicka för att lägga till en ny talare, som är ett insticksprogram för talsyntes.

- Alla inställda talare listas här. Talaren med högst prioritet listas överst. Den översta talaren används för att utföra uppläsningen när ett program inte anger en talare.

- Klicka på en talare i listan för att markera den, och klicka på den här knappen för att ta bort den.

- Klicka på en talare i listan för att markera den, och klicka på den här knappen för att visa insticksprogrammets inställningsdialogruta.

- Klicka på en talare i listan för att markera den, och klicka på den här knappen för att flytta den neråt i listan. Ju lägre en talare visas i listan, ju lägre är dess prioritering.

- Klicka på någon av dessa knappar för att verkställa ändringarna du har gjort i &kmyapplication;-systemet som kör.

När du klickar på knappen Lägg till, visas skärmen Lägg till talare.

Skärmen Lägg till talare. Skärmen Lägg till talare

- Du kan välja ett insticksprogram för talsyntes antingen med namnet på en Talsyntes, eller enligt Språk som talsyntesen kan läsa upp. Markera alternativknappen intill motsvarande ruta. När alternativknappen Språk är markerad, visar rutan Språk alla språk som stöds av alla tillgängliga talsyntesprogram, och rutan Talsyntes visar bara de talsyntesprogram som stöder det valda språket. När alternativknappen Talsyntes är markerad, visar rutan Talsyntes alla tillgängliga talsyntesprogram, och rutan Språk visar bara de språk som stöds av det valda talsyntesprogrammet.

- Välj språk och insticksprogram för syntes här.

- När du klickar här, ställer de flesta insticksprogram för talsyntes in sig själva automatiskt, och väljer en standardinställning. En ny talare visas i listan under fliken Talare. Klicka på knappen Redigera för att visa eller redigera inställningen för talaren. Se configure-plugin.

Du måste ställa in minst en talare och klicka på knappen Verkställ eller Ok innan du kan starta &kmyapplication;-systemet och börja läsa upp text. För att starta &kmyapplication;-systemet, klicka på fliken Allmänt och markera rutan Aktivera text-till-tal (KTTSD). Se general.

### Anpassa insticksprogram för syntes (talare)

När du klickar på knappen Lägg till under fliken Talare och lägger till en talare, eller klickar på knappen Redigera, visas skärmen Inställning av talare. Varje insticksprogram för talsyntes har en egen skärm för inställning av talare. Följande är ett exempel på inställning av insticksprogrammet för interaktiv Festival. För specifika sätt att ställa in varje insticksprogram, se configuration.

Inställning av talare Inställning av talare

- Ange sökvägen till det körbara Festival-programmet. Om Festival finns i miljövariabeln PATH, skriv bara in ``festival``.

- Klicka för att söka efter tillgängliga röster.

- Välj en röst.

- Klicka för att testa. Du ska höra en testmening läsas upp.

- Använd reglagen för att ställa in det syntetiserade talets volym, talhastighet och tonhöjd. Om något av dem är inaktiverat (grått), stöder inte den valda rösten att de ändras.

- Vissa röster, såsom MultiSyn-röster, är så stora att de kräver flera sekunder att laddas. Markeras rutan gör att de laddas när KTTSD startas, och på så sätt sparas tid (till kostnad av användning av mer minne) innan den första meningen syntetiseras.

Klicka på knappen Ok för att spara talarens inställningar.

Försäkra dig om att klicka på knappen Verkställ, annars får dina ändringar ingen effekt i &kmyapplication;-systemet som kör.

Med antagandet att testen fungerade, är du nästan klar att börja använda &kmyapplication;. Gå nu tillbaka till fliken Allmänt och markera Aktivera text-till-tal systemet (KTTSD). Det startar KDE:s text-till-tal demon. Se general. Du kan nu börja använda &kmyapplication; för att läsa upp text. Klicka på fliken Jobb för att skapa och hantera textjobb. Se jobmgr.

### Starta KTTSD och ställa in allmänna alternativ

När du väl har ställt in minst en talare, kan du starta KDE:s text-till-tal system. Klicka på fliken Allmänt. Sidan Allmänt visas. Du kan också ställa in några allmänna alternativ på den här sidan.

KDE:s text-till-tal hantering (fliken Allmänt). KDE:s text-till-tal hantering (fliken Allmänt)

- Markera rutan för att aktivera &kmyapplication;-systemet. Det startar KDE:s text-till-tal demon (KTTSD). Om KTTSD startas med lyckat resultat, visas fliken Jobb. När KTTSD väl har startats, kan du börja skapa och läsa upp textjobb. Se jobmgr. Avmarkeras rutan, stoppas KTTSD och inaktiverar KDE:s text-till-tal system.

  Om rutan är inaktiverad, har du ännu inte ställt in några talare (eller så glömde du klicka på knappen Verkställ). Se select-plugin.

- Markera den här rutan för att läsa upp KDE:s meddelanden. Se knotify för mer information.

- Markera den här rutan för att bara läsa upp KDE:s meddelanden som visas i ett fönster.

- Markera den här rutan för att läsa upp KDE:s meddelanden som visas i ett passivt fönster.

- När rutan är markerad, visas en ikon i systembrickan så fort `kttsmgr` kör. Klickas Avbryt eller Ok i detta läge avslutas inte `kttsmgr`. Istället försvinner skärmen, men `kttsmgr` fortsätter att köra i systembrickan. Klicka på ikonen för att återställa skärmen. För att avsluta `kttsmgr`, högerklicka på ikonen i systembrickan och välj Avsluta. När rutan inte är markerad, visas inte någon ikon i systembrickan. Klickas Ok eller Avbryt avslutas `kttsmgr`.

  När kommandot `kttsmgr` avslutas, fortsätter &kmyapplication; köra om rutan Aktivera text-till-tal (KTTSD) är markerad.

  Det här alternativet får ingen effekt förrän nästa gång `kttsmgr` startas.

  Det här alternativet har ingen effekt när `kttsmgr` körs i KDE:s inställningscentral.

- När rutan markeras, visas skärmen för `kttsmgr` när du startar `kttsmgr`. Om den inte är markerad visas ikonen för `kttsmgr` i systembrickan när `kttsmgr` startas, men skärmen visas inte. Klicka på ikonen i systembrickan för att få skärmen att visas.

- Försäkra dig om att du klickar här för att spara dina inställningar.

### Hantera textjobb

När du klickar på fliken Jobb i `kttsmgr`, visas sidan Jobb.

KDE:s text-till-tal hantering (fliken Jobb). KDE:s text-till-tal hantering (fliken Jobb)

- Knapparna i den här verktygsraden låter dig starta, ta bort och göra paus i uppläsningsjobb. Välj ett jobb i listan nedan, och klicka på en av knapparna.

- Knapparna i den här verktygsraden låter dig gå fram eller tillbaka en mening i jobbet som är markerat i listan nedan. (Alla jobb har inte flera delar.)

- Knapparna i den här verktygsraden låter dig läsa upp texten som för närvarande finns på KDE:s klippbord, eller öppna en textfil som ska läsas upp. Du kan också uppdatera listan med textjobb.

- Meningen som för närvarande läses upp visas här. Om du behöver, kan du ändra storlek på rutan genom att dra avdelaren uppåt eller neråt.

- När du klickar på Ok verkställs alla ändringar av inställningar på andra sidor (om det finns några) och `kttsmgr` minimeras till systembrickan. Klicka på ikonen i systembrickan för att återställa skärmen.

Fliken Jobb visas bara när KTTSD kör. Om du inte ser fliken Jobb, klicka på fliken Allmänt och markera rutan Aktivera text-till-tal (KTTSD).

### Ljudinställningar

När du klickar på fliken Ljud i `kttsmgr`, visas sidan Ljud.

KDE:s text-till-tal hantering (fliken Ljud). KDE:s text-till-tal hantering (fliken Ljud)

- Välj ljudutmatningsmetod här. Om Gstreamer är grått, kompilerades antingen &kmyapplication; utan stöd för Gstreamer, eller kunde inte &kmyapplication; ladda nödvändiga Gstreamer-bibliotek.

- Om Gstreamer är vald för ljudutmatning, välj metoden för Gstreamers ljudsänka här. Om inga sänkor anges, måste du installera minst en. Se requirements.

- Justera uppläsningens hastighet här. 50 % är ungefär två gånger långsammare än normalt, medan 200 % är ungefär två gånger snabbare. Du måste ha installerat verktyget `sox` för att inställningen ska fungera.

- När rutan är markerad, kopierar &kmyapplication; tillfälliga ljudfiler (.wav-filer) till angiven katalog. Välj vilken katalog på hårddisken du vill, men du måste kunna skriva i den. Det kan vara användbart för att skapa ljudfiler med tal för andra syften. Filerna får namn på formen `kttsd-J-M`, där `J` är jobbnumret och `M` är meningsnumret. Befintliga filer med samma namn tas bort. Glöm inte bort att avmarkera rutan, annars fylls hårddisken upp.

- Försäkra dig om att klicka på knappen Verkställ, för att använda de nya inställningarna i &kmyapplication;-systemet som kör.

Det finns två sätt att justera talhastigheten i &kmyapplication;. Många av Talarna har inställningen Hastighet i sina inställningsdialogrutor, som du kan visa genom att klicka på Redigera på sidan Talare. Inställningen Hastighet på sidan Ljud finns förutom talarens hastighetsinställning, och kan i allmänhet användas även om talaren inte stöder en hastighetsinställning. För att denna hastighetsinställning ska fungera, måste du ha installerat verktyget `sox` på systemet (Debian-användare: `apt-get install sox`). Dessutom ignoreras hastighetsinställningen när text som innehåller SSML läses upp (se ssml).

### Filter

Filter är en avancerad funktion i &kmyapplication;. De behövs inte för den grundläggande användningen av &kmyapplication;.

Filter används för att förbehandla text innan den skickas till talsyntesprogrammet. De är användbara för att förbättra tal, ersätta felupplästa ord eller förkortningar, välja lämpligt språk och talare, eller gå runt vissa begränsningar i talsyntesen och dess röster.

För att förstå hur filter används, är det till hjälp att först förstå hur text behandlas av &kmyapplication;. Text som läses upp av &kmyapplication; är av fyra möjliga typer.

- Skärmläsningsutmatning.

- Varningar.

- Meddelanden

- Textjobb

Typen avgörs av programmet som skickar texten till &kmyapplication;. Skärmläsningsutmatning används av program som är konstruerade för blinda eller synskadade. Skärmläsningsutmatning läses alltid upp innan någon annan typ, och avbryter alla typer av uppläsning. Varningar och meddelanden är korta meningar som gör dig uppmärksam på brådskande information. De avbryter textjobb. Varningar har högre prioritet än meddelanden. Kmouth är ett exempel på ett program som använder meddelanden vid uppläsning. KDE:s underrättelser är också meddelanden. Allt annat är vanliga textjobb. Alla jobb som du startar under fliken Jobb är textjobb. Ksayit är ett exempel på ett program som använder textjobb. Textjobb är avsedda för längre uppläsning som inte är brådskande.

Det första du måste veta om filter är att de bara används för vanliga textjobb och KDE:s underrättelsemeddelanden. Alla andra skärmläsningsutmatningar, varningar och meddelanden påverkas inte av filter.

Det finns två sorters filter, vanliga filter och filter för detektering av meningsgränser (SBD-filter). SBD-filter delar upp text i enskilda meningar. Det gör att &kmyapplication; kan börja uppläsning snabbare, eftersom bara den första meningen behöver syntetiseras, inte hela textjobbet. Det låter dig också att gå framåt eller bakåt mening för mening under fliken Jobb, eller stoppa och göra paus i textjobb när talsyntesen inte direkt stöder att stoppa uppläsningen.

Vanliga filter behandlar texten och skickar den vidare till nästa filter. Det finns för tillfället tre sorters vanliga filter.

- Strängersättning

- XML-omvandling

- Val av talare

Filter är implementerade med en insticksarkitektur. Det kan komma att finnas ytterligare sorters filter i framtiden.

Strängersättningsfilter ersätter textdelar med annan text. De ersatta delarna matchas antingen som ord eller som reguljära uttryck. &kmyapplication; levereras med fördefinierade strängersättningsfilter för att läsa upp förkortningar och chattsmilisar som ":-)", eller för att formatera om underrättelsemeddelanden från Konversation eller Kmail till en form som är enklare att förstå.

XML-omvandlingsfilter använder en XML-stilspråkomvandlingsfil (XSLT-fil) för att konvertera XML med ett format till ett annat format. &kmyapplication; levereras med en XSLT-fil för att konvertera XHTML till SSML, men den ska anses mycket experimentell.

Val av talare låter dig att skicka jobb till en talare baserat på textens innehåll, eller baserat på programmet som skickade det till &kmyapplication;. Om du till exempel har ställt in en kvinnlig talare under fliken Talare, kan du skicka text som kommer från KDE:s underrättelser till den talaren. Se select-plugin.

Var och en av dessa filtertyper har inställningsbara regler som avgör när filtret ska påverka texten att läsa upp. Om filtret avgör att det inte ska påverka texten, skickas texten vidare till nästa filter oförändrad.

När ett textjobb eller KDE underrättelsemeddelande skickas till &kmyapplication;, går det igenom alla aktiverade filter som du har ställt in på skärmen nedan. Ordningen är uppifrån och ner. Efter att ha gått igenom alla vanliga filter listade i den övre delen av skärmen, skickas textjobb till filtren Detektering av meningsgräns (SBD-filtren). KDE:s underrättelsemeddelanden går aldrig igenom SBD-filter. I motsats till vanliga filter, så stoppar det första SBD-filter som gör ändringar i texten ytterligare filtrering.

Klicka på fliken Filter i `kttsmgr` för att använda filter.

KDE:s text-till-tal hantering (fliken Filter). KDE:s text-till-tal hantering (fliken Filter).

- Det här är listan med inställda vanliga filter. Om omarkerat, är filtret inaktivt och hoppas över. När du kör &kmyapplication; för första gången, fylls den automatiskt i med en instans av varje sorts filter, men de är alla inaktiva. Filter används i ordningen som anges här, uppifrån och ner.

- Klicka här för att lägga till ett nytt filter. Du blir tillfrågad om vilken sorts filter som ska läggas till. Efter du har valt sort, se inställningsdialogrutorna nedan.

- Klicka här för att ta bort ett filter. Om filtret är det sista av sin sort, tas det inte bort, utan inaktiveras istället.

- Klicka här för att ändra ett filters inställning. Se inställningsdialogrutorna nedan.

- Klicka på knapparna för att flytta upp eller ner ett filter i listan.

- Det här är filtren för detektering av meningsgränser. När du startar &kmyapplication; för första gången, ställs automatiskt standardfiltret för detektering av meningsgränser in åt dig. Du kan ändra filtrets inställning, eller lägga till ytterligare filter för detektering av meningsgränser, men vi råder nybörjare att inte ändra dem.

- Den här kombinationsrutan låter dig lägga till, ta bort, redigera eller ändra ordning på filter för detektering av meningsgränser.

- Försäkra dig om att du klickar här, annars får dina inställningar ingen effekt.

#### Anpassa strängersättningsfilter

Du ställer in stängersättningsfilter genom att tillhandahålla en lista med ord eller reguljära uttryck som ska matchas. När det matchade ordet eller reguljära uttrycket hittas i texten, ersätts vart och ett av en ersättningssträng som du anger. Matchningen är okänslig för skiftläget.

Strängersättning Strängersättning

- Skriv in ett namn på ditt filter. Använd vilken namn du vill som skiljer det från alla andra filter.

- Det här är en lista med ord och reguljära uttryck. Filtret söker efter matchande strängar för varje sträng i kolumnen Matcha, och ersätter den matchande strängen med strängen i kolumnen Ersätt med.

- Klicka här för att lägga till ytterligare ett ord eller reguljärt uttryck i listan.

- Klicka här för att flytta ordet eller det reguljära uttrycket som för närvarande är markerat uppåt eller neråt i listan. Listan behandlas i ordningen den visas, uppifrån och ner.

- Klicka för att ändra ett befintligt ord eller reguljärt uttryck i listan.

- Klicka för att ta bort det befintliga ordet eller reguljära uttrycket som för närvarande är markerat från listan.

- Använd knapparna för att ladda en lista med ord eller reguljära uttryck från en fil, spara nuvarande lista till en fil, eller rensa hela listan. När du laddar från en fil, läggs posterna i filen till sist i den befintliga listan.

- Om inte tom, används filtret bara om språket för textjobbets talare stämmer med språket du skriver in. Klicka på knappen för att visa en lista över språk. Du kan välja mer än ett språk genom att trycka på &Ctrl; när du klickar.

- Om inte tom, används filtret bara om texten kommer från ett av programmen som listas. Du kan skriva in mer än ett program åtskilda med kommatecken. Exempel: ``knotify,konversation``.

  Du kan ta reda på Programidentifikation för program som kör med programmet `kdcop`. Du ska utelämna DCOP-numret. Om kdcop till exempel visar programidentifikationen `kopete-3234`, ska du bara skriva in ``kopete``.

Strängersättningsfiltret används bara för text om alla villkor som inte är tomma uppfylls i rutan Använd filtret när.

All matchning är okänslig för skiftläge.

När ord matchas, använder strängersättningsfiltret ett reguljärt uttryck på formen `\s`ord`\s` internt. Med andra ord, måste ordet ha ordgränser (blanktecken) på båda sidor.

En beskrivning av hur man skriver reguljära uttryck är utanför den här handbokens omfattning. Om du har KDE:s editor av reguljära uttryck installerad, finns en knapp tillgänglig på skärmarna Lägg till och Redigera som hjälper dig att skapa reguljära uttryck. KDE:s editor av reguljära uttryck ingår i paketet `kdeutils`.

&kmyapplication; levereras med några filer med ordlistor, inklusive en lista med smilisar, som ":-)", några förkortningar som typiskt används i IRC- och direktmeddelandeprogram, och en lista med andra förkortningar. Det finns också en lista med specialtecken, som den nuvarande versionen av den polska rösten i Festival inte kan hantera. Om du utvecklar användbara egna ordlistor, använd knappen Spara för att spara dem i en fil, och skicka dem till &kmyapplication;-gruppen så att de kan inkluderas i nästa version.

#### Anpassa filter för XML-omvandling

Filtret för XML-omvandling använder XSLT-filer för att omvandla XML från ett format till ett annat. XSLT, XML-stilspråkomvandlingar, är ett W3C standardspråk för att utföra sådana omvandlingar. Det kan bara användas med välformad XML.

XML-omvandlingar XML-omvandlingar

- Skriv in ett namn på ditt filter. Använd vilken namn du vill som skiljer det från alla andra filter.

- Skriv in fullständig sökväg till en befintlig XSLT-fil, som utför omvandlingen.

- Ange sökvägen till verktyget `xsltproc`. Om xsltproc finns i miljövariabeln PATH, skriv helt enkelt in ``xsltproc``.

- Om inte tom, används filtret bara om XML har angivet rotelement. Det skiljer en form av XML från en annan.

- Om inte tom, används filtret bara om XML har specifikationen `<!DOCTYPE` som börjar med den angivna strängen. Till exempel ``html`` matchar `<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" >`.

- Om inte tom, används filtret bara om texten kommer från ett av programmen som listas. Du kan skriva in mer än ett program åtskilda med kommatecken. Exempel: ``knotify,konversation``.

  Du kan ta reda på Programidentifikation för program som kör med programmet `kdcop`. Du ska utelämna DCOP-numret. Om kdcop till exempel visar programidentifikationen `kopete-3234`, ska du bara skriva in ``kopete``.

Filtret för XML-omvandling används bara för text om alla villkor som inte är tomma uppfylls i rutan Använd filtret när.

#### Anpassa filter för val av talare

Filter för val av talare används för att styra texten till en önskad talare inställd under fliken Talare, eller till någon talare som har angivna egenskaper. Du kan till exempel ange att text som kommer från `knotify` ska läsas upp av en talare som är inställd till en kvinnlig röst. Se select-plugin.

Precis innan &kmyapplication; börjar skicka text till vart och ett av filtren, väljer det en talare som ska läsa upp texten. Valet av talare är baserat på talarens egenskaper som anges av programmet som skickar texten till &kmyapplication;, och egenskaper hos talare som du har ställt in under fliken Talare. Filtret för val av talare tillåter att du överskrider den valda talaren.

Val av talare Val av talare

- Skriv in ett namn på ditt filter. Använd vilken namn du vill som skiljer det från alla andra filter.

- Om inte tom, används filtret bara om texten innehåller det inskrivna reguljära uttrycket. Om den är installerad, klicka på bläddringsknappen för att starta KDE:s editor av reguljära uttryck som hjälper dig att skriva in det reguljära uttrycket.

  För bättre prestanda, försök att "förankra" det reguljära uttrycket till strängens början. Med andra ord, inled ditt reguljära uttryck med ``^``.

- Om inte tom, används filtret bara om texten kommer från ett av programmen som listas. Du kan skriva in mer än ett program åtskilda med kommatecken. Exempel: ``knotify,konversation``.

  Du kan ta reda på Programidentifikation för program som kör med programmet `kdcop`. Du ska utelämna DCOP-numret. Om kdcop till exempel visar programidentifikationen `kopete-3234`, ska du bara skriva in ``kopete``.

- Ange egenskaper hos talaren som du föredrar ska läsa upp texten här. Om texten uppfyller filtervillkoren ovan, väljes en talare som passar bäst in på egenskaperna du anger här. Du kan ange ett språk genom att klicka på knappen.

- På liknande sätt anger posterna du anger här också egenskaperna hos talaren som du föredrar ska läsa upp texten. Du måste inte ange alla egenskaper.

- Du kan ange att en egenskap är viktigare än andra egenskaper genom att markera rutorna.

Filtret för val av talare används bara för text om alla villkor som inte är tomma uppfylls i rutan Använd filtret när.

Egenskapen Språk är speciell eftersom text troligen blir omöjlig att förstå om den läses upp av en talare som använder ett språk som skiljer sig från textens. Därför är språket automatiskt en egenskap som föredras. Om du anger ett språk, överskrider det valt språk, men om du lämnar det tomt, används det befintliga språket som redan valts av &kmyapplication;. Om programmet som skickar texten till &kmyapplication; inte angav ett språk, tilldelar &kmyapplication; den översta talarens språk som du har ställt in under fliken Talare. Övriga egenskaper överskrider alltid. Med andra ord, om du lämnar egenskapen Sats tom, hittar val av talare den talare som passar bäst oberoende av talhastighet.

Det enklaste sättet att lära sig hur val av talare ställs in är att experimentera. Inaktivera val av talare och låt någon text läsas upp. Observera talaren som &kmyapplication; väljer under fliken Talare. Aktivera val av talare, skriv in några egenskaper, och försök igen för att se hur valet påverkas. Du måste förstås ha mer än en talar inställd för att val av talare ska göra någonting.

#### Anpassa filter för att detektera meningsgränser

Filter för att detektera meningsgränser (SBD-filter) delar upp texten i enskilda meningar. Det är viktigt eftersom det

- tillåter att &kmyapplication; börjar läsa upp texten snabbare, eftersom det bara behöver syntetisera den första meningen, istället för hela textblocket, vilket kan vara mycket långt, och

- låter dig gå bakåt eller framåt mening för mening under fliken Jobb, och

- låter dig göra paus eller stoppa textjobb under fliken Jobb, även om talsyntesen inte har möjlighet att stoppas.

Av dessa orsaker, ställs standardfiltret för detektering av meningsgränser automatiskt in första gången du kör `kttsmgr` och kan inte inaktiveras (även om du kan ta bort det). Vi råder dig att inte ändra filtret, om du inte vet vad du gör.

Du kan dock lägga till ytterligare SBD-filter för att lösa vissa problem. Till exempel har den polska rösten i Festival, vid tidpunkten februari 2005, den irriterande egenskapen att den läser upp interpunktion. Den läser till exempel upp punkterna i slutet på varje mening. Du kan inte lösa problemet genom att skapa ett strängersättningsfilter för att ta bort meningarnas interpunktion, eftersom om du gör det förhindras det vanliga SBD-filtret från att känna igen några meningar. Istället kan du skapa en ändrad version av det vanliga SBD-filtret som känner igen meningar, och samtidigt tar bort meningarnas interpunktion. För att göra det, lägg till ett SBD-filter och använd knappen Ladda för att ladda filen `polish_festival_sbdrc` som levereras med &kmyapplication;.

SBD-filter fungerar genom att matcha ett reguljärt uttryck för meningsslut och infoga ett tabulatortecken (decimalt 8) vid meningsgränserna. (Alla tabulatortecken tas automatiskt bort från texten innan filtrering börjar.) Observera att standardfiltret bevarar meningens interpunktion.

SBD-filter används aldrig för KDE:s underrättelsemeddelanden (knotify).

Om du tar bort standardfiltret för att detektera meningsgränser av misstag, kan du få tillbaka det genom att ladda filen `standard_sbdrc`, som levereras med &kmyapplication;.

### Inställningar av textavbrott

När du klickar på fliken Avbrott i `kttsmgr`, visas sidan Avbrott.

KDE:s text-till-tal hantering (fliken Avbrott). KDE:s text-till-tal hantering (fliken Avbrott)

Den här sidan låter dig ange speciella åtgärder som ska utföras så fort ett textjobb avbryts av ett annat, högre prioriterat, meddelande. Det finns fyra sorters taljobb som &kmyapplication; hanterar:

- Vanlig text.

- Meddelanden.

- Varningar.

- Skärmläsningsutmatning.

Skärmläsningsutmatning har högst prioritering. Den är reserverad för användning av skärmläsningsprogram. Skärmläsningsutmatning går före alla andra meddelande, och gör paus i dessa jobb. Så fort skärmläsningsutmatningen har lästs upp, återupptas automatiskt jobben som avbröts.

Varningar har följande prioritering. De är reserverade för meddelanden med hög prioritet, som "Processorn överhettas". En varning avbryter meddelanden och vanlig text, och gör paus i dessa jobb. Så fort varningen har lästs upp, återupptas automatiskt jobben som avbröts.

Meddelanden har följande prioritering. Ett meddelande avbryter vanliga textjobb. Kmouth är ett exempel på ett program som använder meddelanden. Till exempel medan en lång text från en webbsida läses upp, kan Kmouth användas för att hälsa på någon som kommer in i rummet.

Alla fyra sorters jobb har köer, utom skärmläsningsutmatning. Om en skärmläsningsutmatning skickas från ett program medan &kmyapplication; läser upp en annan skärmläsningsutmatning, stoppas meddelandet som håller på att läsas upp och kastas.

När ett textjobb avbryts av ett meddelande, en varning eller en skärmläsningsutmatning, lägger &kmyapplication; till ljudutmatningen på den här sidan till strömmen.

- Det här meddelandet läses upp så fort ett vanligt textjobb avbryts.

- Den här ljudfilen spelas upp så fort ett vanligt textjobb avbryts. Om både Inledande ljud och Innan meddelandet är angivna, spelas Inledande ljud upp innan Innan meddelandet läses upp.

- Det här meddelandet läses upp så fort ett avbrutet textjobb återupptas.

- Den här ljudfilen spelas upp så fort ett avbrutet textjobb återupptas. Den spelas upp sist.

Inställningarna på den här sidan gäller bara vanliga textjobb. Meddelanden, varningar eller skärmläsningsutmatningar har inga särskilda åtgärder när de avbryts av ett meddelande med högre prioritering.

### Läsa upp text från webbsidor

När du kör KDE:s webbläsare Konqueror, kan du läsa upp texten på webbsidan som visas. Försäkra dig först om att &kmyapplication; kör. Markera texten du vill läsa upp, och välj Verktyg Läs upp text i huvudmenyn. Efter ett ögonblick, ska den markerade texten börja läsas upp.

Det är nästan alltid en god idé att markera texten på webbsidan som du vill ska läsas upp. Du kan hoppa över steget, men du hör då en mängd HTML-huvuden och andra osynliga taggar läsas upp.

### Läsa upp text från editorn Kate

När du kör KDE:s avancerade texteditor (Kate), kan du läsa upp texten som visas. Försäkra dig först om att &kmyapplication; kör. Markera texten du vill läsa upp, och välj Verktyg Läs upp text i huvudmenyn. Efter ett ögonblick, ska den markerade texten börja läsas upp.

Du behöver inte först markera text. I detta fall, läses hela filen upp.

Detta fungerar också när Kate kör inbäddad i ett annat program, som Konqueror eller Quanta.

### Talade meddelanden (Knotify)

Knotify är meddelandesystemet i KDE, som gör dig uppmärksam på händelser som du ställer in i KDE-systemet. Du kan anpassa &kmyapplication; att läsa upp textmeddelanden.

Till exempel tillåter Konversation, ett KDE IRC-program, dig att ställa in en stor uppsättning meddelanden. Du kan till exempel tala om för Konversation att underrätta dig så fort ett meddelande där ditt smeknamn ingår dyker upp i en IRC-kanal. Tillsammans med &kmyapplication;, kan du låta KDE läsa upp IRC-meddelandets text.

I allmänhet, om ett KDE-program stöder Knotify, visas menyalternativet Anpassa meddelanden i menyn Inställningar. De specifika sätten att anpassa varje program för Knotify varierar från program till program.

För att göra det möjligt för &kmyapplication; att läsa upp textmeddelanden från Knotify, starta `kttsmgr`, klicka på fliken Allmänt, och markera rutan Läs upp meddelanden (Knotify). Klicka därefter på knappen Verkställ.

### SSML

SSML (Speech Synthesis Markup Language) är en W3C-standard för att märka text för uppläsning. Det tillhandahåller taggar för att styra röster, talhastighet, volym, kön och tonhöjd. Det tillhandahåller också taggar för att styra hur ord läses upp, till exempel utskrift av förkortningar. SSML är en del av specifikationen VoiceXML, som också är en W3C-standard.

För närvarande tillhandahåller &kmyapplication; begränsat och mycket grundläggande stöd för SSML. Det har följande begränsningar:

- Fungerar bara med talarna i Festival (interaktivt) och Hadifix.

- Du måste installera rösten `rab_diphone` (brittisk man), eftersom det är den förvalda rösten som Festival använder vid uppläsning av SSML.

- Inställningen Hastighet på sidan Ljud ignoreras när text som innehåller SSML läses upp.

- Om inställningarna Hastighet eller Tonhöjd i Festivals inställningsdialogruta inte är inställda till 100 %, gör det oftast att SSML-texten läses upp monotont.

Följande exempeltext kan användas för att experimentera med SSML.

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE speak PUBLIC "-//W3C//DTD SYNTHESIS 1.0//EN"
        "http://www.w3.org/TR/speech-synthesis/synthesis.dtd">

    <speak version="1.0" xml:lang="en-US">
        <prosody pitch="low">
            Who's been sleeping in my bed?
        </prosody>
        said papa bear.
        <prosody pitch="medium">
            Who's been sleeping in my bed?
        </prosody>
        said momma bear.
        <prosody pitch="high">
            Who's been sleeping in my bed?
        </prosody>
        said baby bear.
    </speak>

Robustare stöd för SSML planeras för nästa version av &kmyapplication;.

## Kommandoreferens

Att göra.

## Utvecklingsguide för &kmyapplication;

&kmyapplication; har två programmeringsgränssnitt (API:er):

- KDE:s text-till-tal programmeringsgränssnitt som används av programmerare för att ge programmen text-till-tal funktioner. Program kommunicerar med KTTSD via DCOP.

- KTTSD gränssnitt för insticksprogram som används för att lägga till insticksprogram för talsyntes till KTTSD, så att &kmyapplication; fungerar med ett nytt talsyntesprogram.

Följande avsnitt ger en kort beskrivning av KDE:s text-till-tal programmering med DCOP-gränssnitt. Fullständig dokumentation för båda programmeringsgränssnitten är tillgänglig direkt på KDE:s webbplats för handikappstöd (http://accessibility.kde.org).

### DCOP-gränssnittet i &kmyapplication;

Program skickar begäran om text-till-tal tjänster via KDE:s DCOP-gränssnitt till objektet `KSpeech` i programmet `kttsd`.

Skriv in följande kommandon i en terminal.

Om KTTSD inte redan kör

`kttsd`

För att köa ett textjobb som ska läsas upp

`dcop kttsd KSpeech setText "`text`" "`talare`"`

där ``text`` är texten som ska läsas upp, och ``talare`` är en språkkod som ``en``, ``sv``, etc. Kommandot läser inte upp texten, utan istället köar det ett textjobb för uppläsning.

Exempel.

`dcop kttsd KSpeech setText "Det här är en test." "sv"`

För att läsa upp det senast köade textjobbet

`dcop kttsd KSpeech startText `0``

I det här fallet, hänvisar `0` till det senast köade jobbet. Du kan också ange ett specifikt jobbnummer. (Om inget jobbnummer anges, krävs `0`.)

För att stoppa textjobbet som för närvarande läses upp

`dcop kttsd KSpeech stopText 0`

Beroende på vilket insticksprogram för talsyntes som används, kanske inte uppläsningen stoppar omedelbart.

Det finns många fler kommandon som kan skickas. För att se en lista av möjliga kommandon, skriv

`dcop kttsd KSpeech`

eller läs KDE:s text-till-tal programmeringsgränssnitt direkt.

## Vanliga frågor

&reporting.bugs; &updating.documentation;

Jag måste börja om. Hur gör jag för att helt avsluta &kmyapplication;?

Skriv in följande kommandon i en terminal:

    killall kttsd
    killall kttsmgr

Hur kan jag se avlusningsutmatning från `kttsd`?

Öppna två terminalfönster. Starta först `kttsd` i ett fönster, och starta därefter `kttsmgr` i det andra.

Jag har en ytterligare röst för Festival som jag laddade ner från Internet. Jag installerade den och kan använda den i Festival, men den visas inte i `kttsmgr`.

Redigera filen `$KDEHOME/share/apps/kttsd/festivalint/voices` för att lägga till den nya rösten. Övriga poster kan användas som guide. Om du lägger till en röst med lyckat resultat, skicka gärna en programfix till utvecklarna, tillsammans med webbadressen där du hämtade röstfilen.

Ingen av talsyntesprogrammen som stöds, hanterar språket jag behöver. Var kan jag få tag på ett talsyntesprogram för mitt språk?

Google™ är till stor hjälp. Den här länken kan också vara användbar. Om du hittar ett fritt talsyntesprogram som stöder ditt önskade språk, och vill lägga till stöd för den i &kmyapplication;, kontakta utvecklingsgruppen. Program med öppen källkod är särskilt välkomna. Om du känner till ett kommersiellt syntesprogram, kan du kanske övertala tillverkaren att donera en gratis kopia till utvecklingsgruppen för &kmyapplication;. Under tiden kan du få syntesprogrammet att fungera med insticksprogrammet Kommando. Se using-with-command.

## Tack till och licens

&kmyapplication;

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

Nuvarande utvecklare: Gary Cramblitt garycramblitt@comcast.net

Bidragsgivare:

- Olaf Schmidt ojschmidt@kde.org

- Gunnar Schmi Dt gunnar@schmi-dt.de

- Paul Giannaros ceruleanblaze@gmail.com

Dokumentation Copyright © 2004 Gary R. Cramblitt garycramblitt@comcast.net

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

&underFDL; &underGPL;

Talsyntesprogram som används av &kmyapplication; har sina egna licenser. Se dokumentationen för varje program eller webbplats för detaljinformation.

## Installation

### Hur man skaffar &kmyapplication;

&install.intro.documentation;

FRAMTIDA: Debian installationskommando: `apt-get install kdeaccessibility`

Du hittar länkar till källkod och binärpaket på KDE:s webbplats för handikappstöd (http://accessibility.kde.org).

Om du har tillgång till KDE:s CVS, kan du ladda ner &kmyapplication; genom att checka ut modulen `kdeaccessibility`. &kmyapplication; finns i katalogen `kttsd`. Du kan också ladda ner ett komprimerat arkiv, som skapas varje natt, från ftp://ftp.kde.org/pub/kde/unstable/latest/kdeaccessibility.tar.bz2

### Krav

Nödvändiga krav:

- KDE version 3.2 eller senare.

- Ett talsyntesprogram. Följande program och talade språk stöds för närvarande:

  Festival | Amerikansk engelska, brittisk engelska, spanska, tyska, finska, tjeckiska, polska, ryska
  Festival Lite (flite) | Engelska
  Hadifix (MBROLA och txt2pho) | Tyska
  Epos | Tjeckiska, slovakiska
  FreeTTS | Engelska

  Det fungerar också med vilket talsyntesprogram som helst som kan köras från ett kommando i en terminal.

  Språken som listas ovan kanske inte är fullständiga eller aktuella. Kontrollera varje programs specifikation för en fullständig lista med språk som stöds.

  &kmyapplication; använder en flexibel insticksprogramarkitektur för talsyntesprogram. Om du vill utöka &kmyapplication; för att stöda ytterligare ett program, kontakta utvecklingsgruppen.

  Se configuration för specifika instruktioner för vart och ett av dessa program.

Valfria komponenter:

- Ljudverktyget `sox` behövs för att justera allmän uppläsningshastighet, men krävs inte. Debian-användare kan installera sox med kommandot `apt-get install sox`. Sox ingår i de flesta distributions-cd med &Linux;.

- Verktyget `xsltproc` behövs för SSML-stöd och för XML-omvandling, men krävs inte. Debian-användare kan installera xsltproc med kommandot `apt-get install xsltproc`.

- Gstreamer version 0.8.7 eller senare. Normalt använder &kmyapplication; aRts för ljudutmatning, men om du installerar Gstreamer kan du använda den istället. Du kan skaffa Gstreamer från:

  http://gstreamer.freedesktop.org/

### Kompilering och installation

För att kompilera &kmyapplication; måste du ha en aktuell kopia av KDE:s utvecklingsfiler (KDE 3.4 eller senare), inklusive kdelibs och arts.

Om du har laddat ner &kmyapplication; som ett komprimerat arkiv, logga in som en vanlig användare och packa upp arkivet i en lämplig katalog, gå till katalogen, och skriv in följande kommandon:

    ./configure
    make

Om du har utvecklingsfilerna för Gstreamer 0.8.7 eller senare installerade, och vill bygga &kmyapplication; med stöd för Gstreamer, skriv in följande kommando istället:

    ./configure --enable-kttsd-gstreamer
    make

Normalt installerar kommandona ovan &kmyapplication; i `/opt/kde3`. Om katalogen inte finns i sökvägen $`KDEDIRS`, kan du behöva lägga till väljaren `--prefix=`mål``. Till exempel:

    ./configure --prefix=/usr/local
    make

På Debian-system är ``/usr/local`` det vanliga stället att installera program som kompileras från källkod.

Logga in som systemadministratör och installera det kompilerade &kmyapplication; med följande kommandon:

    su
    make install

Om du laddade ner källkoden för &kmyapplication; från CVS-modulen `kdeaccessibility`, eller laddade ner det komprimerade arkivet som skapas varje natt, använd följande kommandon för att kompilera och installera.

    cd kdeaccessibility
    echo kttsd
    >inst-apps
    make -f Makefile.cvs
    ./configure
    cd kttsd
    make
    su
    make install

### Anpassning

Försäkra dig om att ditt talsyntesprogram fungerar innan du använder &kmyapplication;. Följ instruktionerna som levererades med programmet.

I vissa fall måste du ge skrivåtkomst till ljudenheten.

`chmod a+rw `/dev/dsp*``

#### Användning med Festival (interaktivt)

Festival är ett av de bättre fria text-till-tal programmen med öppen källkod som är tillgängliga. Röstkvalitet är i allmänhet bra och det finns stöd för en hel del språk och röster. För många röster kan du styra volym, det upplästa talets hastighet och tonhöjd från &kmyapplication;.

Syntesnamn: Festival interaktiv

Webbadress: http://www.cstr.ed.ac.uk/projects/festival/

Debian installationskommando: `apt-get install festival`

Du måste installera minst ett språk. Följ instruktionerna som levereras med Festival.

Ytterligare engelska röster för Festival är tillgängliga från

http://hts.ics.nitech.ac.jp/.

Ytterligare spanska, engelska och tyska röster är tillgängliga från

http://cslu.cse.ogi.edu/tts/download/

Du måste kompilera ytterligare en modul för dessa röster, och därför måste du ha källkoden för Festival. De tyska rösterna har en begränsad distribution.

En finsk manlig röst är tillgänglig från

http://www.ling.helsinki.fi/suopuhe/download/.

En polsk manlig röst är tillgänglig från

http://www.artegence.com/download/voicexml/speech/festival_polish_voice.tgz.

En rysk manlig röst är tillgänglig från

http://nshmyrev.narod.ru/festival/festival.html

Du måste ha Festival 1.95 beta eller senare för att använda rösten. Rösten är fortfarande i en tidig utvecklingsfas. Packa upp i `festival/lib/voices/russian/`. När du ställer in den ryska talaren, är röstkoden `msu_ru_nsh_diphone`. Försäkra dig om att välja en kyrillisk kodning med en byte, såsom `KOI8-R`.

Festival ingår ofta i &Linux;-distributioner. Kontrollera din distributions-cd för att se om det ingår.

Starta `kttsmgr`. Klicka på knappen Lägg till på sidan Talare. Välj Interaktiv Festival och ett Språk. Om skärmen Anpassa talare inte visas, klicka på knappen Redigera. Om det körbara Festival-programmet inte finns i din sökväg, skriv in fullständig sökväg till det körbara programmet. Klicka på knappen Avsök igen, välj en röst, och klicka på knappen Test. Du ska höra en testmening läsas upp.

När språken polska eller tjeckiska används, försäkra dig om att alternativet Kodning är inställt till `ISO 8859-2`.

När den ryska rösten används, försäkra dig om att alternativet Kodning är inställt till en kyrillisk kodning med en byte, till exempel `KOI8-R`.

##### Använda Festival med &mbrola;

Festival kan användas i kombination med &mbrola;-talsyntes. I detta läge gör Festival lexikalanalysen och &mbrola; skapar ljudet. &mbrola;-binärfilen och &mbrola;-röstfiler kan laddas ner från

http://festvox.org/mbrola/.

Följ instruktionerna i filen `readme.txt` som ingår i nerladdningen.

Observera att &mbrola; inte är ett fullständig system för text-till-tal. &mbrola; syntetiserar tal från difonfiler. Du måste ha ytterligare programvara som kan skapa difonerna. Vid kombination med Festival, skapar Festival difonerna som &mbrola; behöver. `txt2pho` kan också användas för att skapa difoner från tysk text. Se Användning med Hadifix för mer information.

Det finns tre metoder för att kombinera Festival med &mbrola;.

- &mbrola;-omgivning. När den här handboken skrivs, är metoden begränsad till engelska röster.

- IMS tyska Festival.

- Tjeckisk Festival.

###### Använda Festival med &mbrola;-omgivning

Med den här metoden läggs ytterligare omgivningskod till i Festival för att möjliggöra talsyntes med &mbrola; röstfiler. Observera att &mbrola;-röstfilerna inte installeras i &mbrola;-katalogträdet. Istället installeras de i katalogträdet `festival/lib`. För instruktioner, se

http://www.cstr.ed.ac.uk/projects/festival/mbrola.html

###### Använda IMS tyska Festival

IMS tyska Festival är en ändrad version av Festival som använder tyska &mbrola;-röster. Den fungerar antingen med Festival version 1.4.1 eller Festival 2.0 (1.95 beta). Installera först Festival och &mbrola;, om du inte redan har gjort det. Ladda därefter ner IMS tyska Festival från

http://www.ims.uni-stuttgart.de/phonetik/synthesis/festival_opensource.html.

Följ instruktionerna i filen `README` som ingår i nerladdningen. (Observera: om det används tillsammans med Festival 2.0, är det inte nödvändigt att installera det komprimerade arkivet `fixes`, men du måste ändå bygga om Festival.) Lägg till sist till följande rader i filen `festival/lib/siteinit.scm`.

    (voice-location "german_de1_os" "/usr/local/mbrola/de1"
      "German Female, IMS Festival de1")
    (voice-location "german_de2_os" "/usr/local/mbrola/de2"
      "German Male, IMS Festival de2")
    (voice-location "german_de3_os" "/usr/local/mbrola/de3"
      "German Female, IMS Festival de3")

precis ovanför raden som lyder

    (provide 'siteinit)

(På vissa system, är filen du redigerar `/etc/festival.scm`.) Lägg bara till raderna som motsvarar de tyska röster som du har installerat. Ersätt ``/usr/local/mbrola`` med rätt sökväg. Observera också att IMS tyska Festival inte fungerar med de tyska rösterna de4, de5 eller de6 (när det här skrivs).

###### Använda tjeckisk Festival

Den här metoden använder en del speciell kod för att aktivera talsyntes med användning av Festival och en &mbrola; tjeckisk röst. För att installera den, ladda först ner och installera Festival och &mbrola; och försäkra dig om att båda fungerar. Ladda därefter ner tjeckiska Festival från

http://www.freebsoft.org/festival-czech

Ersätt riktiga katalogsökvägar efter behov i följande procedurer.

Packa upp nerladdningen i en lämplig katalog och bygg ordboken. Den körbara filen för Festival måste finnas i din `PATH`.

    cd /usr/local
    tar xvfz festival-czech.tar.gz
    cd festival-czech
    make

Ladda ner röstfilen `cz2` från &mbrola;:s webbplats, och packa upp den i &mbrola;:s katalog.

    cd /usr/local/mbrola
    mkdir cz2
    cd cz2
    unzip cz2-001009.zip

Lägg till följande rader i filen `festival/lib/siteinit.scm` :

    (set! czech-lexicon-file "/usr/local/festival-czech/czech-lexicon.out")
    (set! load-path (cons "/usr/local/festival-czech" load-path))
    (require 'czech)
    (set! czech-mbrola_database "/usr/local/mbrola/cz2/cz2")
    (set! mbrola_progname "/usr/local/mbrola/mbrola")
    (voice-location "czech_mbrola_cz2" "/usr/local/mbrola/cz2"
        "Czech Male, MBROLA")
    (require 'czech-mbrola)

precis ovanför raden som lyder

    (provide 'siteinit)

(På vissa system är filen du redigerar `/etc/festival.scm`)

#### Användning med Festival Lite (flite)

Festival Lite är ett fritt program med öppen källkod som för närvarande stöder ett begränsat antal röster och språk. Det är lättviktigt, men offrar i viss mån röstkvalitet. Du kan inte styra tonhöjd, volym eller hastighet för programmet från &kmyapplication;.

Syntesnamn: Festival Lite (flite)

Webbadress: http://www.speech.cs.cmu.edu/flite/index.html

Debian installationskommando: `apt-get install flite`

Programmet flite ingår ofta i &Linux;-distributioner. Kontrollera din distributions-cd för att se om det ingår.

Bygg och installera flite genom att följa instruktionerna i filen `README` som levereras med det.

#### Användning med Hadifix (&mbrola; och txt2pho)

Hadifix är ett tvåstegs talsyntesprogram baserat på difoner. Verktyget `txt2pho` konverterar text till difoner och programmet &mbrola; syntetiserar difonerna till ljud. Röstkvaliteten är bra, men språkstödet är för närvarande något begränsat. Du kan styra röst, tonhöjd, hastighet och volym från kttsmgr.

Syntesnamn: Hadifix

Webbadress: se nedan

Debian installationskommando: inget

Om du inte redan har installerat Hadifix, gör följande:

1. Ladda ner MBROLA-binarfiler från http://festvox.org/mbrola/.

2. Installera &mbrola; i katalogen `/usr/local/mbrola`.

3. Ladda ner minst en tysk språkfil från &mbrola;-platsen. Packa upp den i katalogen `/usr/local/mbrola`.

4. Ladda ner txt2pho från

   http://www.ikp.uni-bonn.de/dt/forsch/phonetik/hadifix/HADIFIXforMBROLA.html.

5. Packa upp txt2pho till `/usr/local/txt2pho`.

6. Redigera filen `txt2phorc`, och lägg till riktiga datavägar.

7. Kopiera antingen `txt2phorc` till `~/.txt2phorc` eller till `/etc/txt2pho`. Observera att du tar bort "rc" från filnamnet.

8. Välj språket tyska i kttsmgr (de), och lägg till Hadifix.

9. På skärmen Anpassa talare, ställ in en röst och sökvägarna till &mbrola; och txt2pho.

10. Klicka på knappen Testa för att testa.

#### Användning med Epos

Epos är ett fritt tjeckiskt och slovakiskt program med öppen källkod. Det är lättviktigt, men offrar i viss mån röstkvalitet. Du kan inte styra volym för programmet från &kmyapplication;.

Syntesnamn: Epos text-till-tal syntessystem

Webbadress: http://epos.ure.cas.cz/

Debian installationskommando: `apt-get install epos`

Starta kttsmgr. Klicka på knappen Lägg till på sidan Talare. Välj språket tjeckiska eller slovakiska och Epos text-till-tal syntessystem. Om den körbara Epos-servern och klienten inte finns i din sökväg, skriv in fullständiga sökvägar till dessa körbara program på sidan Anpassa talare. Alternativrutorna tillåter dig att skicka ytterligare väljare till servern och klienten. Skriv `epos -h` eller say -h i en terminal för information.

#### Användning med FreeTTS

FreeTTS är ett fritt talsyntesprogram med öppen källkod skrivet i Java™, vilket betyder att du måste ha Javas virtuella maskin installerad i ditt system för att använda den. Den har för närvarande begränsat stöd för röster och språk. Du kan inte styra tonhöjd, volym eller hastighet för programmet från &kmyapplication;.

Syntesnamn: FreeTTS

Webbadress: http://sourceforge.net/projects/freetts/

Debian installationskommando: inget

#### Använda insticksprogrammet för kommando

Insticksprogrammet för kommando tillåter att du använder &kmyapplication; med vilket talsyntesprogram som helst som kan köras som ett kommando i en terminal.

Syntesnamn: Kommando

Webbadress: ingen

Debian installationskommando: inget

Idealiskt bör du använda ett kommando som syntetiserar till en tillfällig ljudfil (wav), istället för att direkt skicka talet till ljudenheten.

Om talsyntesprogrammet kräver att text ska ha en annan kodning från skrivbordets kodningsinställning, måste du använda väljaren `%f` för att skicka texten till programmet. &kmyapplication; kodar texten med inställningen du anger när det skriver texten till den tillfälliga filen. Om du försöker skicka text på kommandoraden med väljaren `%t`, kodas den med kodningsinställningen i skrivbordets landsinställning. Du kan också använda alternativet Skicka data som standardinmatning för att lösa problemet, om programmet accepterar indata från standardinmatningen. Här är ett exempel på ett kommando för att skicka polsk text till Festival med kodningen ISO 8859-2 och ta bort interpunktionstecken som inte ska läsas upp.

`cat %f | tr '(){}[]"' ' ' | festival --tts --language polish`

&documentation.index;