# &ktts;-håndbogen

## Indledning

&ktts; er et delsystem i &kde; til at oprette tekst-til-tale (TTS). Det sørger for en fælles programmeringsgrænseflade for &kde;-programmører som giver mulighed for at bruge tekst-til-tale i deres programmer. Det sørger også for nogle gode funktioner for slutbrugere.

Brugerfunktioner:

- Læs indholdet i en tekstfil op.

- Læs &kde;'s meddelelsesbegivenheder op (Knotify).

- Læs hele eller dele af teksten på en netside i &konqueror; op.

- Læs hele eller dele af teksten i &kate; teksteditoren op, inklusive tilfælde hvor &kate; er indlejret i et andet &kde;-program.

- Lang tekst tolkes til sætninger. Brugeren kan gå en sætning tilbage eller en paragraf, læse op igen, holde pause og stoppe oplæsning.

- Lyd via &arts;, ALSA eller Gstreamer (version 0.8.7 eller senere) eller aKode.

- Filter som kan indstilles af brugeren til at erstatte forkert udtalte ord, vælge talesyntese og transformere XHTML/&XML;-dokumenter.

Programmeringsfunktioner:

- Prioriteringssystem for oplæsning af skærmudskrift, advarsler og meddelelser, mens oplæsning af almindelig tekst foregår.

- Arkitektur baseret på plugin med understøttelse for et stort antal forskellige talesynteseprogrammer og drivere.

- Tillader at generere tale fra kommandolinjen (eller via skalscript) med &kde;'s &DCOP;-redskaber.

- Sørger for let og letanvendelig grænseflade for programmer at oprette tale.

- Programmer behøver ikke at bekymre sig om konflikter over oplæsningsenheden.

- FREMTIDIGT: Sørger for understøttelse for talemarkeringssprog, såsom VoiceXML, Sable, &Java; Speech Markup Language (JSML), og Speech Markup Meta-language (SMML).

- FREMTIDIGT: Sørger for begrænset understøttelse for indlejrede talemarkører.

- Asynkront for at forhindre at systemet blokeres.

&ktts; består i virkeligheden af flere programmer:

`kttsd`

- &kde;'s tekst-til-tale dæmon, som er et program uden grafisk grænseflade som sørger for tekst-til-tale tjenester for programmer via DCOP.

`kttsmgr`

- Et grafisk program for til at indstille og styre kttsd. Programmet kttsmgr er placeret i statusfeltet.

`libtdehtmlkttsdplugin`

- Et plugin- for browseren &konqueror; som tillader at hele eller dele af teksten på en netside læses op.

`kteksteditor_kttsd`

- Et plugin for teksteditoren &kate; som tillader at hele eller dele af en tekstfil læses op.

### Støtte

Udover &kde;'s Bugzilla database ( http://bugs.trinitydesktop.org/ ), finder diskussioner om &ktts; for øjeblikket sted i kde-accessibility's e-mail-liste. Abonnér på https://mail.kde.org/mailman/listinfo/kde-accessibility. Udviklerne er også ofte på IRC (irc.kde.org, kanalen #kde-accessibility).

## Brugen af &ktts;

Før du kan bruge &ktts; skal du installere mindst et talesynteseprogram og sikre dig at det fungerer. Se installation.

### Start `kttsmgr`

For at starte &ktts;-systemet, skrives følgende kommando i en terminal

`kttsmgr`

eller klik på kttsmgr i &kde;'s menu.

Hvis dette er første gang `kttsmgr` køres, eller hvis du endnu ikke har indstillet nogen oplæser, vises siden Oplæsere. Se configure-plugin. Hvis du allerede har indstillet in mindst en oplæser, vises siden Generelt. Se general.

### Indstil plugin for syntese (Oplæser)

De fleste programmer for tekst-til-talesyntese (TTS) tilbyder flere sprog og stemmer, og kan tilbyde flere oplæsere med forskellige køn, lydstyrke og hastigheder. Du kan indstille mere end en udgave af syntesen. Hver kombination af sprog, syntese, stemme, køn, lydstyrke og hastighed kaldes en oplæser. Du skal indstille mindst en oplæser inden du kan starte &ktts; og begynde læse tekst op.

Flere oplæsere med samme synteseprogram ligner flere printerkøer for en enkelt fysisk printer.

Når programmer sender tekst til &ktts;, kan de angive egenskaber hos oplæseren de foretrækker for at udføre syntesen. Et program kan for eksempel bede om en engelsksproget kvindelig oplæser. Hvis du har indstiller en oplæser som både er engelsksproget og kvindelig bruges denne oplæser, ellers vælges oplæseren som bedst passer ind automatisk. For at lære dig mere om hvordan &ktts; vælger oplæsere, se filters.

Når du klikker på fanebladet Oplæser i `kttsmgr`, vises siden Oplæser. Siden vises også automatisk hvis du starter kttsmgr og endnu ikke har indstillet nogen oplæsere.

&kde;'s tekst-til-tale håndtering (fanebladet Oplæsere). &kde;'s tekst-til-tale håndtering (fanebladet Oplæsere).

- Klik for at tilføje en ny oplæser.

- Alle indstillede Oplæsere er på denne liste. Oplæsere med højest prioritet er øverst på listen. Den øverste oplæser bruges til at udføre oplæsningen når et program ikke angiver en oplæser.

- Klik på en oplæser i listen for at markere den, og klik på denne knap for at fjerne den.

- Klik på en oplæser i listen for at markere den, og klik på denne knap for at vise syntese-plugins indstillingsdialog. Se nedenfor.

- Klik på en oplæser i listen for at markere den, og klik på denne knappen for at flytte den nedad i listen. Jo lavere en oplæser vises i listen, jo lavere er dens prioritering.

- Klik på en af disse knapper for at anvende de ændringer du har lavet i &ktts;-systemet som kører.

Når du klikker på knappen Tilføj, vises skærmen Tilføj Oplæser.

Skærmen Tilføj oplæser. Skærmen Tilføj oplæser

- Du kan vælge et plugin- for talesyntese enten med navnet på en Talesyntese, eller efter Sprog som talesyntesen kan læse op. Markér radioknappen ved siden af det tilsvarende felt. Når radioknappen Sprog er markeret, viser feltet Sprog alle sprog som understøttes af alle tilgængelige talesyntesprogrammer, og feltet Talesyntese viser kun de talesynteseprogrammer som understøtter det valgte sprog. Når radioknappen Talesyntese er markeret, viser feltet Talesyntese alle tilgængelige talesynteseprogrammer, og feltet Sprog viser kun de sprog som understøttes af det valgte talesynteseprogram.

- Vælg sprog og plugin- for syntese her.

- Når du klikker her, indstiller de fleste plugin- for talesyntese sig selv automatisk, og vælger en standardindstilling. En ny oplæser> vises i listen under skærmen Oplæsere. Klik på knappen Redigér for at vise eller redigere indstillingen for oplæseren.

Når du klikker på knappen Tilføj i fanebladet Oplæsere og tilføjer en Oplæser, eller klikker på knappen Redigér, vises skærmen Indstilling af Oplæser. Hver plugin for talesyntese har en egen skærm for Indstilling af oplæser. Følgende er et eksempel på indstilling af plugin for interaktiv Festival. For specifikke måder at indstille hvert plugin, se configuration.

Indstilling af Oplæser Indstilling af Oplæser

- Angiv søgestien til det kørbare Festival-program. Hvis Festival findes i miljøvariablen PATH, så skriv blot ``festival``.

- Klik for at søge efter tilgængelige stemmer.

- Vælg en stemme.

- Vælg et tegnsæt for tekst som sendes til Festival. For stemmer som &ktts; kender til, vælges indstillingen automatisk for dig. I almindelighed bruger vestlige sprog ISO 8859-1. Østeuropæiske sprog såsom tjekkisk eller slovakisk bruger ISO 8859-2.

- Klik for at teste. Du skal høre en testsætning blive læst op.

- Brug skyderne til at indstille den syntetiserede tales lydstyrke, talehastighed og tonehøjde. Hvis nogen af dem er deaktiverede (grå), understøtter den valgte stemme ikke at ændre dem.

- Visse stemmer, såsom MultiSyn-stemmer, er så store at de kræver flere sekunder om at indlæses. Markeres dette felt indlæses de når KTTSD startes, og på den måde spares gemmes tid (på bekostning af brug af mere hukommelse) inden den første sætning syntetiseres.

Klik på knappen O.k. for at gemme Oplæserens indstillinger.

Sørg for at klikke på knappen Anvend, ellers får dine ændringer ingen effekt i &ktts;-systemet som kører.

Under antagelse af at testen fungerede, er du næsten klar til at begynde at bruge &ktts;. Gå nu tilbage til fanebladet Generelt og markér feltet Aktivér tekst-til-tale systemet (KTTSD). Det starter &kde;'s tekst-til-tale dæmon. Se general. Du kan nu begynde at bruge &ktts; til at læse tekst op. Klik på fanebladet Job for at oprette og håndtere tekstjob. Se jobmgr.

### Start KTTSD og indstil generelle tilvalg

Når du har indstillet mindst en Oplæser, kan du starte &kde;'s tekst-til-tale system. Klik på fanebladet Generelt. Så vises siden Generelt. Du kan også indstille nogle generelle tilvalg på denne side.

&kde;'s tekst-til-tale håndtering (fanebladet Generelt). &kde;'s tekst-til-tale håndtering (fanebladet Generelt)

- Markér dette felt for at aktivere &ktts;-systemet. Det starter &kde;'s tekst-til-tale dæmon (KTTSD). Hvis det lykkes at starte KTTSD, vises fanebladet Job. Når KTTSD er startet, kan du begynde at oprette og læse tekstjob op. Se jobmgr. Afmarkeres feltet, stoppes KTTSD og &kde;'s tekst-til-tale system deaktiveres.

  Hvis dette felt er deaktiveret, har du endnu ikke indstillet nogen Oplæser (eller også glemte du at klikke på knappen Anvend). Se configure-plugin.

- Når dette felt er markeret, vises en ikon i statusfeltet så snart `kttsmgr` kører. Klikkes på Afbryd eller O.k. i denne tilstand, afsluttes `kttsmgr` ikke. I stedet forsvinder skærmen, men `kttsmgr` fortsætter med at køre i statusfeltet. Klik på ikonen for at genoprette skærmen. For at afslutte `kttsmgr`, højreklikkes på ikonen i statusfeltet og Afslut vælges. Når feltet ikke er markeret, vises ikke nogen ikon i statusfeltet. Klikkes på O.k. eller Afbryd afsluttes `kttsmgr`.

  Når kommandoen `kttsmgr` afsluttes, fortsætter &ktts; med at køre hvis feltet Aktivér tekst-til-tale (KTTSD) er markeret.

  Dette tilvalg får ingen effekt før næste gang `kttsmgr` startes.

  Dette tilvalg har ingen effekt når `kttsmgr` kører i &kde;'s kontrolcenter.

- Når dette felt er markeret, vises skærmen for `kttsmgr` når du starter `kttsmgr`. Hvis den ikke er markeret vises ikonen for `kttsmgr` i statusfeltet når `kttsmgr` startes, men skærmen vises ikke. Klik på ikonen i statusfeltet for at få skærmen til at blive vist.

- Når feltet er markeret, og `kttsmgr` ikke allerede kører, vises det i statusfeltet så snart KTTSD læser noget op. Det giver dig mulighed for at stoppe eller på anden måde håndtere oplæsningen.

- Når feltet er markeret, og `kttsmgr` automatisk vises i statusfeltet så snart oplæsning sker, forsvinder det også automatisk når oplæsningen er færdig.

- Sørg for at klikke her for at gemme dine indstillinger.

### Håndtering af tekstjob

Når du klikker på fanebladet Job i `kttsmgr`, vises siden Job.

&kde;'s tekst-til-tale håndtering (fanebladet Job). &kde;'s tekst-til-tale håndtering (fanebladet Job)

- Alle tekstjob som for øjeblikket findes i køen listes her, sammen med programmet som satte jobbet i kø, jobbets nuværende tilstand, antal sætninger i jobbet, og det nuværende meddelelsenummer. Oplæserens identifikation svarer til søjlen Id på siden Oplæser.

- Knapperne i denne linje lader dig starte, fjerne og holde pause i oplæsningsjob. Vælg et job i listen nedenfor, og klik på en af knapperne.

- Knapperne i denne linje lader dig gå en sætning frem eller tilbage i jobbet som er markeret i listen ovenfor. (Ikke alle job har flere dele.)

- Knapperne i denne linje lader dig læse teksten op som for øjeblikket findes på &kde;'s klippebord, eller åbne en tekstfil som skal læses op. Du kan også opdatere listen med tekstjob. Se selecttalker.

- Sætningen som for øjeblikket læses op vises her.

- Når du klikker på O.k. anvendes alle ændringer af indstillinger på andre sider (hvis der er nogen) og `kttsmgr` minimeres til statusfeltet. Klik på ikonen i statusfeltet for at genoprette skærmen.

- Træk i opdeleren for at ændre størrelse på joblisten og feltet Nuværende sætning.

Fanebladet Job vises kun når KTTSD kører. Hvis du ikke ser fanebladet Job, så klik på fanebladet Generelt og markér feltet Aktivér tekst-til-tale (KTTSD).

Hvis du ikke har installeret lydsystemet &arts;, men har installeret ALSA, Gstreamer eller aKode, så klik på fanebladet Lyd. Se audio.

På denne side listes og styres kun tekstjob. Skærmlæsningsudskrift, advarsler og meddelelser vises ikke. For mere information om meddelelsetyper i &ktts;, se filters.

### Lydindstillinger

Når du klikker på fanebladet Lyd i `kttsmgr`, vises siden Lyd.

&kde;'s tekst-til-tale håndtering (fanebladet Lyd). &kde;'s tekst-til-tale håndtering (fanebladet Lyd)

- Vælg lydmetode her. Hvis en komponent er grå, kompileredes enten &ktts; uden støtte for dette lyd-plugin, eller også kunne &ktts; ikke indlæse nødvendige biblioteker.

- Hvis Gstreamer eller aKode er valgt for lyd, vælges metoden for lydsink-metoden her. Hvis ingen sink angives, skal du installere mindst én. Hvis ALSA vælges, skal PCM-enheden vælges her. Se requirements.

- Justér oplæsningens hastighed. 50 % er cirka dobbelt så langsomt som normalt, mens 200 % er cirka dobbelt så hurtigt. Du skal have `sox`-redskabet installeret for at denne indstilling skal virke.

- Når dette felt er markeret, kopierer &ktts; midlertidige lydfiler (.wav-filer) til angivet mappe. Vælg hvilken den mappe på harddisken du vil, men du skal kunne skrive i den. Dette kan være nyttigt for at oprette lydfiler med tale for andre formål. Filerne får navn på formen `kttsd-J-M`, hvor `J` er jobnummeret og `M` er sætningsnumret. Eksisterende filer med samme navn fjernes. Glem ikke at afmarkere feltet, ellers fyldes harddisken op.

- Sørg for at klikke på knappen Anvend, for at bruge de nye indstillinger i &ktts;-systemet som kører.

Der er to måder at justere talehastigheden i &ktts;. Mange af Oplæserne har indstillingen Hastighed i deres indstillingsdialoger, som du kan vise ved at klikke på Redigér på siden Oplæsere. Indstillingen Hastighed på siden Lyd er der udover oplæserens hastighedsindstilling, og kan i almindelighed bruges også selvom oplæseren ikke understøtter en hastighedsindstilling. For at denne hastighedsindstilling skal fungere, skal du have installeret værktøjet `sox` på systemet (Debian-brugere: `apt-get install sox`). Desuden ignoreres hastighedsindstillingen når tekst som indeholder SSML læses op (se ssml).

Listen med ALSA-enheder omfatter alle ALSA PCM-enheder og plugin som er indstillede i systemet. Mange af valgene virker ikke. Du skal eksperimentere for at finde en enhed som virker for dig. Hvis du er i tvivl, så vælg default.

### Indstillinger af tekstafbrydelse

Når du klikker på fanebladet Afbrydelse i `kttsmgr`, vises siden Afbrydelse.

&kde;'s tekst-til-tale håndtering (fanebladet Afbrydelse). &kde;'s tekst-til-tale håndtering (fanebladet Afbrydelse)

Denne side lader dig angive specielle handlinger som skal udføres så snart et tekstjob afbrydes af en anden meddelelse med højere prioritet. Der er fire slags talejob som &ktts; håndterer:

- Sædvanlig tekst.

- Meddelelser.

- Advarsler.

- Skærmlæsningsudskrift.

Skærmlæsningsudskrift har højest prioritering. Den er reserveret til brug af skærmlæsningsprogrammer. Skærmlæsningsudskrift går før alle andre meddelelser, og holder pause i disse job. Så snart skærmlæsningsudskriften er læst op, genoptages jobbet som blev afbrudt automatisk.

Advarsler har følgende prioritering. De er reserverede for meddelelser med høj prioritet, såsom "Processoren er for varm". En advarsel afbryder meddelelser og almindelig tekst, og holder pause i disse job. Så snart advarslen er læst op, genoptages jobbet som blev afbrudt automatisk.

Meddelelser har følgende prioritering. En meddelelse afbryder almindelige tekstjob. &kmouth; er et eksempel på et program somanvender meddelelser. For eksempel, mens en lang tekst fra en netside læses op, kan &kmouth; bruges til at hilse på nogen som kommer ind i rummet.

Alle fire slags job har køer, undtagen skærmlæsningsudskrift. Hvis en skærmlæsningsudskrift sendes fra et program mens &ktts; læser en anden skærmlæsningsudskrift op, stoppes meddelelsen som er ved at blive læst op og smides væk.

Når et tekstjob afbrydes af en meddelelse, en advarsel eller en skærmlæsningsudskrift, tilføjer &ktts; lydudskriften på denne side til strømmen.

- Denne meddelelse læses op så snart et almindeligt tekstjob afbrydes.

- Denne lydfil afspilles så snart et almindeligt tekstjob afbrydes. Hvis både Indledende lyd og Inden meddelelsen er angivne, afspilles Indledende lyd inden Inden meddelelsen læses op.

- Denne meddelelse læses op så snart et afbrudt tekstjob genoptages.

- Denne lydfil afspilles så snart et afbrudt tekstjob genoptages. Den afspilles sidst.

Indstillingerne på denne side gælder kun almindelige tekstjob. Meddelelser, advarsler eller skærmlæsningsudskrifter har ingen særlige handlinger når de afbrydes af en meddelelse med højere prioritering.

### Læs tekst op fra netsider

Når du kører &kde;'s browser &konqueror;, kan du læse teksten op for netsiden som vises. Sørg først for at &ktts; kører. Markér teksten du vil læse op, og vælg Værktøjer Læs tekst op i hovedmenuen. Efter et øjeblik, skulle den markerede teksten begynde at blive læst op.

Det er næsten altid en god idé at markere teksten på netsiden som du vil skal læses op. Du kan springe over dette skridt, men så hører du en mængde &HTML;-hoveder og andre usynlige mærker blive læst op.

### Læs tekst op fra editoren &kate;

Når du kører &kde;'s avancerede teksteditor (&kate;), kan du læse teksten op som vises. Sørg først for at &ktts; kører. Markér teksten du vil læse op, og vælg Værktøjer Læs tekst op i hovedmenuen. Efter et øjeblik, skulle den markerede tekst begynde at blive læst op.

Du behøver ikke først at markere tekst. I dette tilfælde, læses hele filen op.

Dette fungerer også når &kate; kører indlejret i et andet program, såsom &konqueror; eller &quanta;.

### Talende meddelelser (Knotify)

Knotify er meddelelsesystemet i &kde;, som gør dig opmærksom på begivenheder som du indstiller i &kde;-systemet. Du kan indstille &ktts; til at læse tekstmeddelelser op.

For eksempel tillader &konversation;, et IRC-program for &kde;, dig at indstille et stort sæt meddelelser. Du kan for eksempel bede &konversation; om at underrette dig så snart en meddelelse hvor dit alias indgår dukker op i en IRC-kanal. Sammen med &ktts;, kan du lade &kde; læse IRC-meddelelsens tekst op.

I almindelighed, hvis et &kde;-program understøtter , Bekendtgørelser vises menupunktet Indstil meddelelser i menuen Indstillinger. De specifikke måder at indstille hvert program for Knotify varierer fra program til program.

For at gøre det muligt for &ktts; at læse tekstmeddelelser op fra Knotify, start `kttsmgr` og klik på fanebladet Bekendtgørelser. Så kommer skærmen Bekendtgørelser frem.

&kde;'s tekst-til-tale håndtering (fanebladet Bekendtgørelser). &kde;'s tekst-til-tale håndtering (fanebladet Bekendtgørelser)

- Markér dette felt for at aktivere oplæsning af &kde;'s underretninger. Hvis det ikke er markeret, er alt på siden deaktiveret og &ktts; læser ikke nogen underretninger op.

- Hvis markeret, læser &ktts; nogen begivenheder op med et lyd fra noget program.

- Brug disse knapper til at tilføje eller slette programbegivenheder fra listen nedenfor. Når du klikker på knappen Tilføj, vises et felt hvor du vælger programmer og begivenheder som du vil tilføje til listen.

- Denne begivenhed læser meddelelsen op som &konversation; sender når nogen nævner dit alias i en Internet Relay Chat-meddelelse.

- For alle andre begivenheder som kommer fra &konversation;, gør &ktts; ingenting.

- For alle andre begivenheder som ikke angives på anden måde i listen, gør &ktts; ingenting.

- Brug dette felt til at angive hvad &ktts; skal gøre når en begivenhed modtages. Dine valg er:

  Læs begivenhedens navn op

- Læser begivenhedens navn op, det du ser listet i begivenhedlisten på denne side.

Læs bekendtgørelsesbesked op

- Læser meddelelsen op som den sendes fra programmet.

Læs ikke underretningen op

- Læser slet ikke begivenheden op.

Læs egen tekst op

- Læser teksten op som du skriver ind i feltet til højre.

- Hvis handlingen er Læs egen tekst op, så skal meddelelseteksten som du vil skal læses op skrives her. Du kan bruge følgende erstatningsstrenge i meddelelsen:

  %e

- Begivenhedens navn

%a

- Navnet på programmet som sendte begivenheden

%m

- Meddelelsen som programmet sendte

- Test meddelelsen ved at klikke her.

- Du kan angive egenskaber for oplæseren som ønskes til at læse underretningsmeddelelsen her. ``standard`` bruger den øverste oplæser på siden Oplæser. Se selecttalker.

Bemærk at der er tre begivenhedniveauer. Hvis en handling for en vis begivenhed fra et vist program angives, udføres denne handling. Ellers, hvis en handling for alle andre begivenheder fra et vist program angives, udføres denne handling. Ellers udføres handlingen som angives for alle andre begivenheder under Standard (alle andre begivenheder).

Begivenheden alle underretninger for programmet Standard (alle andre begivenheder) kan ikke fjernes fra listen. For standardværdien alle andre begivenheder kan du angive type af underretning som læses op, som følger:

ingen

- Ingen læses op.

underretningsdialoger

- Underretninger som viser en dialog på skærmen, som du siden skal lukke, læses op.

passive meddelelser

- Underretninger som viser en passiv meddelelse på skærmen, som automatisk forsvinder efter et øjeblik, læses op.

underretningsdialoger og passive meddelelser

- Underretninger som vises på skærmen, passive eller ej, læses op.

alle underretninger

- Alle underretninger, uafhængig af om de viser noget på skærmen, læses op.

Strengerstatningsfilter er en god måde at gøre rydde op i meddelelser som sendes fra programmer, hvis de har fejlagtig udtale eller læses forkert op i &ktts;. Filen `kmail.xml` som levereres med &ktts;, er et godt eksempel. Den fjerner mærkerne `br` og `b` i underretningsmeddelelser fra &kmail;, og fjerner også sætningen `/local/inbox/`, eftersom det kan forudsættes i de fleste tilfælde. Se stringreplacer.

Brug knappen Gem til at gemme indstillinger af underretninger i en fil. Brug knappen Indlæs til at indlæse gemte indstillinger fra en fil. De indlæste begivenheder blandes med eksisterende begivenheder i listen. Hvis du vil begynde med en tom liste, klikkes først på knappen Ryd. Alle begivenheder undtagen alle underretninger slettes.

Sørg for at klikke på knappen Anvend eller OK for at gemme de nye indstillinger.

### SSML

SSML (Speech Synthesis Markup Language) er en W3C-standard for at markere tekst for oplæsning. Det sørger for mærker til at styre stemmer, talehastighed, lydstyrke, køn og tonehøjde. Det sørger også for mærker til at styre hvordan ord læses op, for eksempel udtalelse af forkortelser. SSML er en del af specifikationen VoiceXML, som også er en W3C-standard.

For øjeblikket sørger &ktts; for begrænset og meget grundlæggende understøttelse for SSML. Det har følgende begrænsninger:

- Fungerer kun med oplæserne Festival (interaktivt) og Hadifix.

- Du skal installere stemmen `rab_diphone` (britisk mand), eftersom det er standardstemmen som Festival bruger ved oplæsning af SSML.

- Indstillingen Hastighed på siden Lyd ignoreres når tekst som indeholder SSML læses op.

- Hvis indstillingerne Hastighed eller Tonehøjde i Festivals indstillingsdialog ikke er sat til 100 %, gør det oftest at SSML-teksten læses op monotont.

Følgende eksempeltekst kan bruges for at eksperimentere 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>

Mere robust understøttelse for SSML planlægges for næste udgave af &ktts;.

### Filter (avanceret)

Filtre er en avanceret funktion i &ktts;. De behøves ikke for den basale brug af &ktts;.

Filtre bruges til at forbehandle tekst inden den sendes til talesyntesprogrammet. De er nyttige til at forbedre tale, erstatte forkert oplæste ord eller forkortelser, vælge passende sprog og oplæser, eller komme uden om visse begrænsninger i talesyntesen og dens stemmer.

#### Typer af beskeder i &ktts;

For at forstå hvordan filtre bruges, hjælper det først at forstå hvordan tekst behandles af &ktts;. Tekst som læses op af &ktts; er af fire mulige typer.

- Skærmlæsningsudskrift.

- Advarsler.

- Meddelelser

- Tekstjob

Typen afgøres af programmet som sender teksten til &ktts;.

Skærmlæsningsudskrift har højest prioritering. Den er reserveret til brug af skærmlæsningsprogrammer. Skærmlæsningsudskrift går før alle andre meddelelser, og holder pause i disse job. Så snart skærmlæsningsudskriften er læst op, genoptages beskeden som blev afbrudt automatisk.

Advarsler har følgende prioritering. De er reserverede for meddelelser med høj prioritet, såsom "Processoren er for varm". En advarsel afbryder meddelelser og almindelig tekst, og holder pause i disse job. Så snart advarslen er læst op, genoptages beskeden som blev afbrudt automatisk.

Meddelelser har følgende prioritering. En meddelelse afbryder almindelige tekstjob. &kmouth; er et eksempel på et program som anvender meddelelser. For eksempel, mens en lang tekst fra en netside læses op, kan &kmouth; bruges til at hilse på nogen som kommer ind i rummet. &kde;s bekendtgørelser er også beskeder (se knotify).

Resten er almindelige tekstjob. Alle job som du starter fra fanebladet Job er tekstjob. Ksayit er et eksempel på et program som bruger tekstjob. Tekstjob er beregnede til for længere tale som ikke er skal være lige nu.

Alle fire slags job har køer, undtagen skærmlæsningsudskrift. Hvis en skærmlæsningsudskrift sendes fra et program mens &ktts; læser en anden skærmlæsningsudskrift op, stoppes meddelelsen som er ved at blive læst op og smides væk.

#### Typer af filtre

Det første du skal vide om filtre er at de aldrig bruges til skærmlæsningsudtale. De bruges til advarsler, meddelelser og tekstjob, og desuden til &kde;'s underretninger (Knotify).

Der er to slags filtre, almindelige filtre og filter for detektering af sætningsgrænser (SBD-filtre). SBD-filtre deler tekst op i enkelte sætninger. Det gør at &ktts; kan begynde oplæsning hurtigere, eftersom kun den første sætningen behøver at syntetiseres, ikke hele tekstjobbet. Det tillader dig også at gå fremad eller tilbage sætning for sætning i fanebladet Job, eller stoppe og holde pause i tekstjob når talesyntesen ikke direkte understøtter at stoppe oplæsningen.

Almindelige filtre behandler teksten og sender den videre til næste filter. Der er for øjeblikket tre slags almindelige filtre.

- Strengerstatning

- &XML;-transformer

- Valg af oplæser

Filtre er implementerede med en plugin-arkitektur. I fremtiden vil der muligvis være flere slags filtre.

Strengerstatningsfiltre erstatter tekstdele med anden tekst. De erstattede dele matches enten som ord eller som regulære udtryk. &ktts; levereres med fordefinerede strengerstatningsfiltre for at læse forkortelser og chatsmileys såsom ":-)" op, eller til at omformatere underretningsmeddelelser fra &konversation; eller &kmail; til en form som er nemmere at forstå.

&XML;-transformatører bruger et &XML;-stilsprogfil (XSLT-fil) til at konvertere &XML; i et format til et andet format. &ktts; leveres med et par XSLT-filer til at konvertere &XHTML; til SSML

Valg af oplæser lader dig at sende job til en oplæser baseret på tekstens indhold, eller baseret på programmet som sendte det til &ktts;. Hvis du for eksempel har indstillet en kvindelig oplæser i fanebladet Oplæser, kan du sende tekst som kommer fra KSayit til den oplæser. Se configure-plugin.

Hver af disse filtertyper har indstillelige regler som afgør hvornår filtret skal påvirke teksten der skal læses op. Hvis filtret afgør at det ikke skal påvirke teksten, sendes teksten videre til næste filter uforandret.

Når et tekstjob, en besked, advarsel, eller &kde;-underretningsmeddelelse sendes til &ktts;, går det gennem alle aktiverede filter som du har indstillet på skærmen nedenfor. Rækkefølgen er oppefra og ned. Efter at være gået gennem alle almindelige filtre på listen i den øvre del af skærmen, sendes tekstjob til filtrene Detektering af sætningsgrænse (SBD-filtrene). &kde;'s underretningsmeddelelser, advarsler og beskeder går aldrig gennem SBD-filtre. I modsætning til almindelige filtre, så stopper det første SBD-filter som udfører ændringer i teksten yderligere filtrering.

#### Indstil filtre

For at bruge filtre, klikkes på fanebladet Filtre i `kttsmgr`.

&kde;'s tekst-til-tale håndtering (fanebladet Filtre). &kde;'s tekst-til-tale håndtering (fanebladet Filtre)

- Dette er listen med indstillede almindelige filtre. Hvis det ikke er markeret, er filtret inaktivt og springes over. Filtre bruges i rækkefølgen som angives her, oppefra og ned.

- Klik her for at tilføje et nyt filter. Du bliver spurgt om hvilken slags filter som skal tilføjes. Efter du har valgt slagsen, se indstillingsdialogerne nedenfor.

- Klik her for at fjerne et filter.

- Klik her for at ændre et filters indstilling. Se indstillingsdialogerne nedenfor.

- Klik på knapperne for at flytte et filter op eller ned i listen.

- Dette er filtrene til detektion af sætningsgrænser. Når du starter &ktts; første gang, indstilles standardfiltret automatisk til detektering af sætningsgrænser for dig. Du kan ændre filtrets indstilling, eller tilføje yderligere filtre til detektering af sætningsgrænser, men vi råder nybegyndere til ikke at ændre dem.

- Dette dropned-felt lader dig tilføje, fjerne, redigere eller ændre rækkefølge på filtre til detektering af sætningsgrænser.

- Sørg for at du klikker her, ellers får dine indstillinger ingen effekt.

#### Indstil strengerstatningsfilter

Du Indstiller strengerstatningsfiltre ved at sørge for en liste med ord eller regulære udtryk som skal matches. Når det matchede ord eller regulære udtryk findes i teksten, erstattes hvert af dem med en erstatningsstreng som du angiver. Matchningen er ikke versalfølsom.

Streng-erstatter Streng-erstatter

- Indtast et navn på dit filter. Brug et hvilket som helst navn du vil som adskiller det fra alle andre filtre.

- Dette er en liste med ord og regulære udtryk. Filtret søger efter matchende strenge for hver streng i søjlen Matche, og erstatter den matchende streng med strengen i søjlen Erstat med. Listen behandles i den rækkefølge den vises, oppefra og nedad.

- Klik her for at tilføje yderligere et ord eller regulært udtryk til listen.

- Klik her for at fjerne det eksisterende ord eller regulære udtryk som for øjeblikket er markeret fra listen.

- Klik for at ændre et eksisterende ord eller regulært udtryk i listen.

- Klik for at fjerne det eksisterende ord eller regulære udtryk som for øjeblikket er markeret fra listen.

- Brug disse knapper til at indlæse en liste med ord eller regulære udtryk fra en fil, gemme nuværende liste til en fil, eller rydde hele listen. Når du indlæser fra en fil, tilføjes punkterne i filen til sidst i den eksisterende liste.

- Hvis ikke tom, bruges filtret kun hvis sproget for jobbets oplæser passer med sproget du skriver ind. Klik på knappen for at vise en liste over sprog. Du kan vælge mere end et sprog ved at trykke på &Ctrl; når du klikker.

- Hvis ikke tom, bruges filtret kun hvis teksten kommer fra et af de programmer som er på listen. Du kan indtaste mere end et program adskilt med kommaer. Eksempel: ``konversation,kmail``.

  Du kan finde ud af Program-id for programmer som kører med programmet `&kdcop;`. Du skal udelade &DCOP;-nummeret. Hvis &kdcop; for eksempel viser program-id `kopete-3234`, skal du kun indtaste ``kopete``.

Strengerstatningsfiltret bruges kun til tekst hvis alle betingelser som ikke er tomme opfyldes i feltet Brug filtret når. Hvis alle felterne er blanke, vil filtrene blive anvendt på al tekst.

Matchning er ikke versalfølsom.

Når ord matches, bruger strengerstatningsfiltret et regulært udtryk på formen `\s`ord`\s` internt. Med andre ord, skal ordet have ordgrænser (blanke tegn) på begge sider.

En beskrivelse af hvordan man skriver regulære udtryk er udenfor denne håndbogs omfang. Hvis du har &kde;'s editor af regulære udtryk installeret, er der en knap på skærmene Tilføj og Redigér som hjælper dig med at oprette regulære udtryk. &kde;'s editor af regulære udtryk indgår i pakken `tdeutils`.

&ktts; levereres med nogle filer med ordlister, inklusive en liste med smileys, såsom ":-)", nogle forkortelser som typisk bruges i IRC- og instant message programmer, og en liste med andre forkortelser. Der er også en liste med specialtegn, som den nuværende version af den polske stemme i Festival ikke kan håndtere. Hvis du udvikler nyttige egne ordlister, så brug knappen Gem for at gemme dem i en fil, og sende dem til &ktts;-gruppen så de kan inkluderes i næste version.

#### Indstil filter for &XML;-transformator

Filtret for &XML;-transformator bruger XSLT-filer til at transformere &XML; fra et format til et andet. XSLT, &XML;-stilprog-transformationer, er et W3C standardsprog til at udføre sådant. Det kan kun bruges med velformet &XML;. Du skal have redskabet `xsltproc` installeret.

&XML;-Transformator &XML;-Transformator

- Indtast et navn på dit filter. Brug et hvilket som helst navn du vil som adskiller det fra alle andre filtre.

- Indtast fuldstændig søgesti til en eksisterende XSLT-fil, som udfører transformationen.

- Angiv søgestien til værktøjet `xsltproc`. Hvis xsltproc findes i miljøvariabeln PATH, skrives blot ``xsltproc``.

- Hvis ikke tom, bruges filtret kun hvis &XML; har det angivne rodelement eller en `<!DOCTYPE` som begynder med den angivne streng. Dette adskiller en form af &XML; fra en anden. For eksempel vil ``html`` i DOCTYPE-feltetmatche `<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">`.

- Hvis ikke tom, bruges filtret kun hvis teksten kommer fra et af de programmer som er på listen. Du kan indtaste mere end et program adskilt med kommaer. Eksempel: ``konversation,kmail``.

  Du kan finde ud af Program-id for programmer som kører med programmet `&kdcop;`. Du skal udelade &DCOP;-nummeret. Hvis &kdcop; for eksempel viser program-id `kopete-3234`, skal du kun indtaste ``kopete``.

Filtret for &XML;-forvandling bruges kun for tekst hvis det angivne rodelement eller den angivne DOCTYPE stemmer og hvis program-id stemmer i feltet Brug filtret når. Hvis et felt er tomt, udføres testen ikke, så hvis alle felter er tomme gælder filtret for al tekst. Du bør dog udfylde mindst et felt, eftersom mange tekstjob ikke har &XML;-format.

#### Indstil filter til valg af oplæser

Filter til valg af oplæser bruges til at styre teksten hen til en ønsket oplæser indstillet i fanebladet Oplæser, eller til en oplæser som har angivne egenskaber. Du kan for eksempel angive at tekst som kommer fra `kmail` skal læses op af en oplæser som er indstillet til en kvindelig stemme. Se configure-plugin.

Lige inden &ktts; begynder at sende tekst til hvert af filtrene, vælger det en oplæser om skal læse teksten op. Valg af oplæser er baseret på oplæserens egenskaber som angives af programmet som sender teksten til &ktts;, og egenskaber ved oplæsere som du har indstillet i fanebladet Oplæser. Filtret til valg af oplæser tillader at du sætter den valgte oplæser ud af kraft.

Vælger af oplæser Vælger af oplæser

- Indtast et navn på dit filter. Brug et hvilket som helst navn du vil som adskiller det fra alle andre filtre.

- Hvis ikke tom, bruges filtret kun hvis teksten indeholder det indskrevne regulære udtryk. Hvis den er installeret, så klik på søgeknappen til at starte &kde;'s editor af regulære udtryk som hjælper dig med at indtaste det regulære udtryk.

  For bedre ydelse, forsøg at "forankre" det regulære udtryk til strengens begyndelse. Med andre ord, indled dit regulære udtryk med ``^``.

- Hvis ikke tom, bruges filtret kun hvis teksten kommer fra et af de programmer som er på listen. Du kan indtaste mere end et program adskilt med kommaer. Eksempel: ``konversation,kmail``.

  Du kan finde ud af Program-id for programmer som kører med programmet `&kdcop;`. Du skal udelade &DCOP;-nummeret. Hvis &kdcop; for eksempel viser program-id `kopete-3234`, skal du kun indtaste ``kopete``.

- Angiv egenskaber hos oplæseren som du foretrækker skal læse teksterne op. Hvis teksten opfylder filterbetingelserne ovenfor, vælges en oplæser som passer bedst med de egenskaber du angiver her. Klik på knappen til højre for at vise skærmen Vælg oplæser. Se selecttalker.

- Brug disse knapper til at gemme indstillingerne i Valg af oplæser, for at indlæse indstillinger fra en gemt fil, eller rydde alle indstillinger.

Filtret til valg af oplæser bruges kun til tekst hvis alle betingelser som ikke er tomme er opfyldt i feltet Brug filtret når. Du skal udfylde mindst et af filterne.

Den nemmeste måde at lære sig hvordan valg af oplæsere indstilles er at eksperimentere. Deaktivér valg af oplæser og lad noget tekst blive læst op. Bemærk oplæseren som &ktts; vælger i fanebladet Oplæser. Klik på knappen Vælg oplæser, indtast nogle egenskaber, og forsøg igen for at se hvordan valget påvirkes. Du skal naturligvis have mere end en oplæser indstillet for at valg af oplæser skal gøre noget.

#### Indstil filter til at detektere sætningsgrænser

Filter til at detektere sætningsgrænser (SBD-filter) opdeler teksten i enkelte sætninger. Det er vigtigt eftersom det

- tillader at &ktts; begynder at læse teksten op hurtigere, eftersom det kun behøver at syntetisere den første sætning, i stedet for hele tekstblokken, hvilket kan være meget langt, og

- tillader dig at gå tilbage eller fremad sætning for sætning på siden Job og

- lader dig holde pause eller stoppe tekstjob i fanebladet Job, selvom om talesyntesen ikke har mulighed at stoppes.

Af disse grunde, indstilles standardfiltret for detektering af sætningsgrænser automatisk første gangen du kører `kttsmgr` og kan ikke deaktiveres (selvom om du kan fjerne det). Vi råder dig til ikke at ændre filtret, med mindre du ved hvad du gør.

Du kan imidlertid tilføje yderligere SBD-filtre for at løse visse problemer. For eksempel har den polske stemme i Festival, på tidspunktet februar 2005, den irriterende egenskab at den læser tegnsætning op. Den læser for eksempel punktummerne i slutningen af hver sætning. Du kan ikke løse problemet ved at oprette et strengerstatningsfilter til at fjerne sætningernes tegnsætning, eftersom hvis du gør det forhindres det almindelige SBD-filter i at genkende nogle sætninger. I stedet kan du oprette en ændret version af det almindelige SBD-filter som genkender sætninger, og samtidigt fjerner sætningernes tegnsætning. For at gøre det, tilføj et SBD-filter og brug knappen Indlæse for at indlæse filen `polish_festival_sbdrc` som levereres med &ktts;.

SBD-filtre virker ved at matche et regulært udtryk for sætningsafslutning og indsætte et tabulatortegn (decimalt 8) ved sætningsgrænserne. (Alle tabulatortegn fjernes automatisk fra teksten inden filtrering begynder.) Bemærk at standardfiltret bevarer sætningens tegnsætning.

SBD-filtre bruges aldrig til &kde;'s underretningsmeddelelser (knotify), advarsler, advarsler eller output fra skærmlæsere. .

Hvis du fjerner standardfiltret til at detektere sætningsgrænser ved en fejl, kan du få tilbage det ved at indlæse filen `standard_sbdrc`, som leveres med &ktts;.

### Vælg oplæsere (avanceret)

Du kan indstille lige så mange oplæsere som du vil i fanebladet Oplæser. Se configure-plugin. Når programmer sender tekst til &ktts; kan de angive egenskaber for en ønsket oplæser som skal læse teksten op. &ktts; vælger oplæseren som passer bedst blandt de oplæsere som du har indstillet for at opfylde programmets forespørgsler. Et program kan for eksempel angive at teksten skal læses op af en engelsksproget kvindelig stemme. Hvis du har indstillet en oplæser som er engelsksproget og kvindelig bruges denne oplæser. Hvis du kun har indstillet engelsksprogede mandlige oplæsere, bruges en af dem. Hvis et program ikke angiver nogen egenskaber, bruges standardoplæseren (den øverste) som listes i fanebladet Oplæser.

Når programmer angiver egenskaber for den ønskede oplæser, kan de angive at visse egenskaber "foretrækkes" frem for andre egenskaber. Et program kan for eksempel angive at det ønsker at en høj kvindelig stemme læser teksten op, og at egenskaben høj "foretrækkes" frem for egenskaben kvindelig. Hvis du har en stille kvindelig stemme og en høj mandlig stemme indstillet, vælger &ktts; den stærke mandlige stemme til at udføre oplæsningen. Eftersom sprog er en kritisk parameter for at gøre oplæsning forståelig, er det altid en "foretrukken" egenskab.

Ved at bruge siden Vælg oplæser, kan du sætte oplæserindstillinger fra programmer ud af kraft. Denne side vises

- når du klikker på knappen Ændr oplæsere i fanebladet Job, eller

- når du klikker på knappen Oplæser i dialogen Filterindstilling for et filter for valg af oplæsere, eller

- når du klikker på knappen Oplæser i fanebladet Underretninger.

Vælg oplæser Vælg oplæser

Siden tilbyder tre måder at angive egenskaber for ønskede oplæsere:

- Brug standardoplæseren (øverst på siden Oplæser). Med andre ord, angives ingen egenskaber for oplæsere.

- Brug oplæseren som passer bedst ind med en eller flere angivne egenskaber.

- Brug oplæseren som passer bedst og har alle egenskaber hos en indstillet oplæser. Hvis du ikke fjerner eller ændrer oplæserens indstilling, vælger &ktts; den specifikke oplæser. Hvis du fjerner eller ændrer oplæserens indstillinger, vælger &ktts; oplæseren som passer bedst og har oplæserens oprindelige egenskaber.

- Vælg måden at indtaste ønskede oplæseregenskaber ved at klikke på en af radioknapperne.

- Vælg egenskaber for ønskede oplæsere her. Lad en egenskab være tom hvis du er ligeglad med denne egenskab.

- Markér feltet hvis du ønsker at egenskaben skal "foretrækkes" frem for andre egenskaber. Du kan markere mere end et felt.

- Eftersom sprog er en kritisk faktor for at gøre tale forståelig, er det altid en foretrukket egenskab. Det er sjældent at bruge denne egenskab. Det eneste tilfælde hvor du kan behøve at angive sprogegenskaben er når du véd at et vist program sender tekst på et sprog som adskiller sig fra desktoppens sprog.

- Dette er en liste over oplæsere som du for øjeblikket har indstillet i &ktts;. Ved at vælge en af dem, angiver du på denne måde alle egenskaber for oplæseren. Hvis oplæseren stadigvæk er indstillet når tekst sendes, får du en nøjagtig træffer og oplæseren vælges. Hvis du alligevel senere fjerner oplæseren, eller ændrer indstillingerne, bliver det måske ikke den valgte oplæseren længere. Oplæseren som passer bedst med på de oprindelige egenskaber vælges.

Egenskaben Sprog er speciel eftersom tekst formodentlig bliver umulig at forstå hvis den læses op af en oplæsere som anvender et sprog som er forskelligt sig fra tekstens. Derfor er sproget automatisk en egenskab som "foretrækkes". Hvis du angiver et sprog, sættes det valgte sprog ud af kraft, men hvis du efterlader det tomt, bruges den eksisterende sprogindstillingen. Hvis programmet som sender teksten til &ktts; ikke angav et sprog, tildeler &ktts; den øverste oplæsers sprog som du har indstillet under fanebladet Oplæser. Med andre ord, den øverste oplæseren antages at tale desktoppens sprog.

For at rydde alle egenskaber i sektionen Brug nærmeste matchende oplæser som har, klikkes først på radioknappen Brug standardoplæser, og klik derefter på radioknappen Brug nærmeste matchende oplæser som har.

## Kommandoreference

TODO

## Udviklers guide til &ktts;

&ktts; har to programmeringsgrænseflader (API'er):

- &kde;'s tekst-til-tale programmeringsgrænseflade som bruges af programmører for at give programmerne tekst-til-tale funktioner. Programmer kommunikerer med KTTSD via &DCOP;.

- KTTSD grænseflade for plugin- som bruges for at tilføje plugin for talesyntese i KTTSD, så &ktts; fungerer med et nyt talesynteseprogram.

Følgende afsnit giver en kort beskrivelse af &kde;'s tekst-til-tale programmering med &DCOP;-grænseflade. Fuldstændig dokumentation for begge programmeringsgrænseflader er tilgængelig direkte på &kde;'s netsted for tilgængelighed (http://accessibility.kde.org).

### &DCOP;-grænsefladen i &ktts;

Programmer sender forespørgsler om tekst-til-tale tjenester via &kde;'s &DCOP;-grænseflade til objektet `kspeech` i programmet `KSpeech`.

Indtast følgende kommandoer i en terminal.

Hvis KTTSD ikke allerede kører

`kttsd`

For at sætte et tekstjob i kø som skal læses op

`dcop kttsd KSpeech setTekst "`tekst`" "`oplæser`"`

hvor ``tekst`` er teksten som skal læses op, og ``Oplæser`` er en sprogkode såsom ``en``, ``da``, &etc;. Denne kommando læser ikke teksten op, men sætter i stedet et tekstjob i kø for oplæsning.

Eksempel.

`dcop kttsd KSpeech setTekst "Dette er en test." "da"`

For at læse det seneste tekstjob i køen op

`dcop kttsd KSpeech startTekst `0``

I dette tilfælde, henviser `0` til det seneste job i køen. Du kan også angive et specifikt jobnummer. (Hvis intet jobnummer angives, kræves `0`.)

For at stoppe tekstjobbet som for øjeblikket læses op

`dcop kttsd KSpeech stopTekst 0`

Afhængig af hvilket plugin for talesyntese som bruges, stopper oplæsningen måske ikke med det samme.

Der er mange flere kommandoer som kan sendes. For at se en liste af mulige kommandoer, skriv

`dcop kttsd KSpeech`

eller læs &kde;'s tekst-til-tale programmeringsgrænseflade direkte.

## Spørgsmål og svar

&reporting.bugs; &updating.documentation;

`kttsmgr` bryder sammen med det samme når jeg starter det. Jeg kompilerede med fejlsøgningsunderstøttelse, og jag får ikke engang et backtrace.

Gstreamer er brudt sammen og har taget &ktts; med sig. Du skal formodentlig "registrere" Gstreamer. For Gstreamer 0.8x er kommandoen `gst-register-0.8`. Hvis det ikke løser problemet, har du måske en version af Gstreamer som ikke virker sammen med &ktts; installeret. Du skulle forsøge at opdatere eller at afinstallere Gstreamer.

ALSA-lyd virker ikke hvis jeg spiller musik i et andet program samtidigt. Når jeg holder pause i et tekstjob, fryses &ktts;. Jeg ser "unable to open PCM" i terminaluddata.

Du har problemer med konflikt over enheder i ALSA, som forhindrer at mere end en PCM-enhed åbnes af gangen. Se ALSA's hjemmeside (dmix) for mulige løsninger. www.alsa-project.org

Jeg skal begynde forfra. Hvordan gør jeg for at helt afslutte &ktts;?

Indtast følgende kommandoer i en terminal:

    killall kttsd
    killall kttsmgr

Hvordan kan jeg se fejlsøgningsudskrift fra `kttsd`?

Åbn to terminalvinduer. Start først `kttsd` i et vindue, og start derefter `kttsmgr` i det andet.

Jeg har en yderligere stemme for Festival som jeg hentede ned fra internettet. Jeg installerede den og kan bruge den i Festival, men den vises ikke i `kttsmgr`.

Redigér filen `$TDEHOME/share/apps/kttsd/festivalint/voices` for at tilføje den nye stemme. Øvrige indgange kan bruges som guide. Hvis det lykkes at tilføje en stemme, så send gerne en programrettelse til udviklerne, sammen med den &URL; hvor du hentede stemmefilen.

Ingen af de talesynteseprogrammen som understøttes, håndterer det sprog jeg behøver. Hvor kan jeg få fat i et talesynteseprogram for mit sprog?

Google™ er til stor hjælp. Denne link kan også være nyttig. Hvis du finder et frit talesynteseprogram som understøtter dit ønskede sprog, og vil tilføje støtte for det i &ktts;, så kontakt udviklingsgruppen. Programmer med åben kildekode er særligt velkomne. Hvis du kender til et kommercielt synteseprogram, kan du måske overtale fremstilleren at donere en gratis kopi til udviklingsgruppen for &ktts;. Sommetider kan du få synteseprogrammet til at virke med pluginnet ved at bruge Kommando. Se using-with-command.

&ktts; taler for langsomt. Hvordan får jeg det hurtigere?

Under fanebladet Lyd findes indstillingen Hastighed. For at den skal virke, skal værktøjet `sox` være installeret og i din søgesti. Visse syntese-plugin, såsom Festival interaktiv sørger for også indstillingen Hastighed i indstillingsdialogen for oplæsere. Afhængig af stemmen som bruges, kan den være aktiveret eller ikke.

O.k., det virker for visse ting, men netsider læses stadigvæk op for langsomt.

Hastighedsindstillingerne ignoreres når &ktts; læser &HTML; op. (Det skyldes at &HTML; konverteres til SSML, som har sine egne hastighedsmærker.) Deaktivér enten filtret for &XML;-konvertering (se filters), eller hvis du er dristig, redigér .xsl-filen i filtret for konvertering af &HTML; til SSML, og øg standardtalerhastighed.

Jeg kan ikke få netsider til at blive læst op med en kvindelig stemme. Jeg har en kvindelig oplæser indstillet i Festival, men &ktts; læser altid netsider op med en mandlig stemme.

Fra og med Festival 1.95 beta, synes mærket SABLE GENDER ikke at fungere. For at forhindre at Festival giver fejl, tager .xsl-filen for SSML til SABLE kønsmærker væk. Det samme gælder også for stemmemærker.

Jeg har indstillet filtret for konvertering af &HTML; til &XML;, men netsider læses overhovedet ikke op med Festival-pluginnet.

På grund af en fejl i Festival 1.95 beta, skal du installere stemmen `rab_diphone` (britisk mand) for at SABLE overhovedet kan virke, også selvom du ikke bruger stemmeen til at læse netsiderne op. Sørg også for at værktøjet `xsltproc` er installeret og i din søgesti.

Visse tegn eller punktuering synes at give fejl i talesyntesen, hvilket gør at den springer over hele sætninger, eller udtaler nonsens. Hvad kan jeg gøre?

Sørg først for om at tilvalget Tegnsæt i oplæserens indstillingsdialog er rigtigt indstillet for sproget. Hvis visse ord eller tegn forårsager problemer, kan et strengerstatningsfilter hjælpe. Hvis visse punktueringer for sætninger forvirrer talesyntesen, skal du indstille et filter for detektering af sætningsgrænser. Se filters.

Jeg har tilføjet et eget strengerstatningsfilter og nu lader &ktts; mig ikke gå tilbage eller fremad sætning efter sætning. Under fanebladet Job, påstås at hvert job kun har en sætning. Hvad har jeg gjort forkert?

Du må ikke bortfiltrere tegn for punktuering af sætninger (punktum, spørgsmålstegn, udråbstegn, kolon og semikolon). Brug i stedet et filter for detektering af sætningsgrænser for disse tegn.

## Medvirkende og licens

&ktts;

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

Nuværende vedligeholder: Gary Cramblitt garycramblitt@comcast.net

Bidragydere:

- Olaf Schmidt ojschmidt@kde.org

- Gunnar Schmi Dt gunnar@schmi-dt.de

- Paul Giannaros ceruleanblaze@gmail.com

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

&erik.kjaer.pedersen.credit; &underFDL; &underGPL;

Talesynteseprogrammer som bruges af &ktts; har deres egne licenser. Se dokumentationen for hvert program eller netsted for detaljer. Nogle stemmer har også deres egne licenser.

## Installation

### Hvordan får man fat på &ktts;

&install.intro.documentation;

FREMTID: Debian installationskommando: `apt-get install tdeaccessibility`

Du finder link til kildekode og binære pakker på &kde;'s netsted for tilgængelighed (http://accessibility.kde.org).

Hvis du har adgang til &kde;'s kodelager, kan du hente &ktts; ved at tjekke modulet `tdeaccessibility` ud. &ktts; findes i mappen `kttsd`. Du kan også hente tar-bolde med tdeaccessibilitys kildekode fra ftp://ftp.kde.org/pub/kde/

### Krav

Obligatoriske krav

- &kde; version 3.2 eller senere.

- Et talesynteseprogram. Følgende programmer og talte sprog understøttes for øjeblikket:

  Festival | Amerikansk engelsk, britisk engelsk, spansk, tysk, finsk, tjekkisk, polsk, russisk, italiensk, fransk canadisk, kishwahili, zulu og ibibio
  Festival Lite (flite) | Engelsk
  Hadifix (&mbrola; og txt2pho) | Tysk, ungersk
  Epos | Tjekkisk, slovakisk
  FreeTTS | Engelsk

  Det virker også med et hvilket som helst talesynteseprogram som kan køres fra en kommando i en terminal.

  Sprogene på listen ovenfor er måske ikke er fuldstændige eller opdaterede. Kontrollér hvert programs specifikation for en fuldstændig liste med sprog som understøttes. Tjek også hjemmesiden &ktts; for yderligere information der måske ikke er medtaget i denne håndbog.

  &ktts; bruger en fleksibel plugin-arkitektur for talesynteseprogrammer. Hvis du vil udvide &ktts; til at understøtte yderligere et program, så kontakt udviklingsgruppen.

  Se configuration for specifikke instruktioner for hvert af disse programmer.

- I det mindste et af følgende lydsystemer:

  - &kde;'s lydsystem &arts;. &arts; er oftest installeret med &kde;.

  - ALSA (Avanceret &Linux; lydarkitektur). ALSA er installeret på de fleste &Linux;-systemer. (www.alsa-project.org)

  - Gstreamer version 0.8.7 eller senere. Bemærk: sørg for at registrere dine Gstreamer plugin ved at køre kommandoen `gst-register` inden Gstreamer bruges i &ktts;. (http://gstreamer.freedesktop.org)

  - aKode-biblioteket. aKode er et afkoderbibliotek som er en del af &kde;.

  &kde;-projektet planlægger at holde op med at bruge &arts; fra version 4.

  Visse brugere oplever konflikt over enheder med ALSA. Hvis systemet har problemet, kan du ikke samtidigt afspille musik og læse tekst op. &ktts; fryser også hvis du holder pause i et tekstjob og derefter starter et andet. Se ALSA's hjemmeside (dmix) for mulige løsninger.

  For øjeblikket, juli 2005, understøtter aKode ikke en virkelig pausemulighed. Når du holder pause i et tekstjob i &ktts; fortsætter det med at læse nuværende sætning.

Valgfrie komponenter:

- Lydværktøjet `sox` behøves for at justere generel oplæsningshastighed, men kræves ikke. Debian-brugere kan installere sox med kommandoen `apt-get install sox`. Sox indgår i de fleste distributions-cd'er med &Linux;.

- Værktøjet `xsltproc` behøves for SSML-understøttelse, og for &XML;-Transformator-filter, men kræves ikke. Debian-brugere kan installere xsltproc med kommandoen `apt-get install xsltproc`.

### Kompilering og installation

For at kompilere &ktts; skal du have en nylig kopi af &kde;'s udviklingsfiler (&kde; 3.4 eller senere), inklusive tdelibs og arts.

Hvis du har hentet &ktts; som et komprimeret arkiv, så log på som en almindelig bruger og pak arkivet ud i en passende mappe, gå til mappen, og indtast følgende kommandoer:

    ./configure
    make

Følgende flag til `configure` er tilgængelige:

Standardflag | Beskrivelse | Skift
--with-arts | Bygger lydpluginnet aRts. | --without-arts
--with-alsa=check | Bygger ALSA-lydpluginnet | --with-alsa=no
--with-gstreamer=no | Bygger ikke Gstreamer-lydpluginnet | --with-gstreamer=check
--with-akode=no | Bygger ikke aKode-lydpluginnet | --with-akode=check

I &kde; 4, kommer pluginnet &arts; formodentlig til at blive fjernet eller i det mindste ikke bygges som standard.

Følgende plugin for talesyntese bygges alle normalt. Visse af dem afhænger kun af ikke-frit programmel ved kørsel (ikke-fri ifølge Debians politik). Søjlen "Flag til configure for ikke at bygge" viser kommandoen til configure for ikke at bygge pluginnet.

Synth | Licens | Indstillingstilvalg for at ikke bygge
Festival | fri | --disable-kttsd-festivalint
Festival Lite | fri | --disable-kttsd-flite
Epos | fri | --disable-kttsd-epos
Kommando | fri | --disable-kttsd-command
Hadifix | ikke-fri | --disable-kttsd-hadifix
FreeTTS | ikke-fri | --disable-kttsd-freetts

Normalt installerer kommandoerne ovenfor &ktts; i `/opt/kde3`. Hvis mappen ikke findes i søgestien `TDEDIRS`, kan du behøve at tilføje flaget `--prefix=`mål``. For eksempel:

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

På Debian-systemer er ``/usr/local`` det sædvanlige sted at installere programmer som kompileres fra kildekode.

Log på som systemadministrator og installér det kompilerede &ktts; med følgende kommandoer:

    su
    make install

Hvis du hentede kildekoden for &ktts; fra kodelager-modulet `tdeaccessibility`, eller hentede det komprimerede arkiv som laves hver nat, så brug følgende kommandoer for at kompilere og installere.

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

### Indstilling

Sørg for at dit talesynteseprogram virker inden du bruger &ktts;. Følg instruktionerne som levereredes med programmet.

I visse tilfælde skal du give skriveadgang til lydenheden.

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

#### Brug med Festival (interaktivt)

Festival er et af de bedste frie tekst-til-tale programmer med åben kildekode som er tilgængelige. Stemmekvalitet er i almindelighed god og der er støtte for en hel del sprog og stemmer. For mange stemmer kan du styre lydstyrke, den oplæste tales hastighed og tonehøjde fra &ktts;.

Syntesenavn: Festival interaktiv

&URL;: http://www.cstr.ed.ac.uk/projects/festival/

Debian installationskommando: `apt-get install festival`

Du skal installere mindst et sprog. Følg instruktionerne som leveres med Festival. Hvis du vil oplæse hjemmesider, må du installere `rab_diphone` (mandlig britisk) stemme.

Yderligere engelske stemmer for Festival er tilgængelige fra

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

Yderligere spanske, engelske og tyske stemmer er tilgængelige fra

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

Du skal kompilere yderligere et modul for disse stemmer, og derfor skal du have kildekoden for Festival. De tyske stemmer har en begrænset distribution.

En finsk mandlig stemme er tilgængelig fra

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

En polsk mandlig stemme er tilgængelig fra

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

En russisk mandlig stemme er tilgængelig fra

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

Du skal have Festival 1.95 beta eller senere for at bruge denne stemme. Stemmen er stadigvæk i en tidlig udviklingsfase. Pak `festival/lib/voices/russian/` ud. Når du indstiller den russiske oplæser, er stemmekoden `msu_ru_nsh_diphone`. Sørg for at vælge et kyrillisk 8+bit tegnsæt, såsom `KOI8-R`.

Italienske stemmer for Festival 1.95 beta er tilgængelige på

http://www.csrf.pd.cnr.it/TTS/It-FESTIVAL-download.htm.

Hvis du får CRC-fejl når du pakker ud, så forsøg at hente igen.

Kiswahili, zulu og ibibio stemmer for Festival 1.95 beta er tilgængelige på

http://www.llsti.org/.

Desværre fungerer Hindi-stemmen ikke som også er tilgængelig her med &ktts;.

Kommercielle stemmer, inklusive en fransk canadisk stemme, kan købes af Cepstral, LLC på

http://www.cepstral.com/

OSS på deres supportside har information om hvordan deres stemmer bruges i Festival.

Festival indgår ofte i &Linux;-distributioner. Kontrollér din distributions-cd for at se om det indgår.

Når sprogene polsk, ungarsk eller tjekkisk bruges, så sørg for at tilvalget Kodning er indstillet til `ISO 8859-2`.

Når den russiske stemme bruges, så sørg for at tilvalget Tegnsæt er indstillet til et 8-bit cyrillisk tegnsæt såsom `KOI8-R`.

##### Brug Festival med &mbrola;

Festival kan bruges i kombination med &mbrola;-talesyntese. I denne tilstand gør Festival leksikalanalysen og &mbrola; laver lyden. den binære &mbrola;-filen og &mbrola;-stemmefiler kan hentes fra

http://festvox.org/mbrola/.

Følg instruktionerne i filen `readme.txt` som kommer med det der er hentet.

Bemærk at &mbrola; ikke er et fuldstændig system for tekst-til-tale. &mbrola; syntetiserer tale fra difon-filer. Du skal have yderligere programmel som kan oprette difonerne. Ved kombination med Festival, laver Festival difonerne som &mbrola; behøver. `txt2pho` kan også bruges til at oprette difoner fra tysk tekst. Se Brug med Hadifix for mere information.

Der er tre metoder for at kombinere Festival med &mbrola;.

- &mbrola;-indpakning. Mens denne håndbogen skrives, er metoden begrænset til engelske stemmer.

- IMS tysk Festival.

- Tjekkisk Festival.

###### Brug Festival med &mbrola;-indpakning

Med denne metoden tilføjes yderligere omgivelseskode til i Festival for at muliggøre talesyntese med &mbrola; stemmefiler. Bemærk at &mbrola;-stemmefilerne ikke installeres i &mbrola;-mappetræet. I stedet installeres de i mappetræet `festival/lib`. For instruktioner, se

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

###### Brug IMS tysk Festival

IMS tysk Festival er en ændret version af Festival som bruger tyske &mbrola;-stemmer. Det virker enten med Festival version 1.4.1 eller Festival 2.0 (1.95 beta). Installér først Festival og &mbrola;, hvis du ikke allerede har gjort det. Hent derefter IMS tysk Festival fra

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

Følg instruktionerne i filen `README` som indgår i pakken. (Bemærk: hvis dette bruges sammen med Festival 2.0, er det ikke nødvendigt at installere det komprimerede arkiv `fixes`, men du skal alligevel bygge Festival igen.) Tilføj til sidst følgende linjer 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")

lige over linjen som lyder

    (provide 'siteinit)

(På visse systemer, er filen du redigerer `/etc/festival.scm`.) Tilføj kun linjerne som svarer til de tyske stemmer som du har installeret. Erstat ``/usr/local/mbrola`` med den rigtige søgesti. Bemærk også at IMS tysk Festival ikke virker med de tyske stemmer de4, de5 eller de6 (mens dette skrives).

###### Brug af tjekkisk Festival

Denne metode bruger en del speciel kode for at aktivere talesyntese ved brug af Festival og en &mbrola; tjekkisk stemme. For at installere den, hentes først Festival og MROLA, de installeres og du sikrer dig at begge virker. Hent derefter tjekkisk Festival fra

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

Erstat de rigtige mappesøgestier efter behov i følgende procedurer.

Pak op i en passende mappe og byg ordbogen igen. Den kørbare fil for Festival skal være i din `PATH`.

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

Hent stemmefilen `cz2` fra &mbrola;'s netsted, og pak den ud i &mbrola;'s mappe.

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

Tilføj følgende linjer til 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)

lige over linjen som lyder

    (provide 'siteinit)

(På visse systemer er filen du redigerer `/etc/festival.scm`)

#### Brug med Festival Lite (flite)

Festival Lite er et frit program med åben kildekode som for øjeblikket understøtter et begrænset antal stemmer og sprog. Det er letvægts, men giver lidt op på stemmekvalitet. Du kan ikke styre tonehøjde, lydstyrke eller hastighed for programmet fra &ktts;.

Syntesenavn: Festival Lite (flite)

&URL;: http://www.speech.cs.cmu.edu/flite/index.html

Debian installationskommando: `apt-get install flite`

Programmet flite indgår ofte i &Linux;-distributioner. Tjek din distributions-cd for at se om det indgår.

Byg og installér flite ved at følge instruktionerne i filen `README` som levereres med det.

#### Brug med Hadifix (&mbrola; og txt2pho)

Hadifix er et totrins talesynteseprogram baseret på difoner. Værktøjet `txt2pho` konverterer tekst til difoner og programmet &mbrola; syntetiserer difonerne til lyd. Stemmekvaliteten er god, men sprogunderstøttelsen er for øjeblikket noget begrænset. Du kan styre stemme, tonehøjde, hastighed og lydstyrke fra kttsmgr.

Syntesenavn: Hadifix

&URL;: se nedenfor

Debian installationskommando: ingen

Hvis du ikke allerede har installeret Hadifix, så gør følgende:

1. Hent &mbrola;'s binære filer fra http://festvox.org/mbrola/.

2. Installér &mbrola; i mappen `/usr/local/mbrola`.

3. Hent mindst en tysk sprogfil fra &mbrola;-stedet. Pak den ud i mappen `/usr/local/mbrola`.

4. Hent txt2pho fra

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

5. Pak txt2pho ud til `/usr/local/txt2pho`.

6. Redigér filen `txt2phorc`, og tilføj rigtige datastier.

7. Kopiér enten `txt2phorc` til `~/.txt2phorc` eller til `/etc/txt2pho`. Bemærk at du fjerner "rc" fra filnavnet.

8. Vælg sproget tysk i kttsmgr (de), og tilføj Hadifix.

9. På skærmen Indstil Oplæser, indstilles en stemme og søgestierne til &mbrola; og txt2pho.

10. Klik på knappen Test for at teste.

En ungarsk implementering af &mbrola; og txt2pho er tilgængelig på

http://tkltrans.sourceforge.net/.

#### Brug med Epos

Epos er et frit tjekkisk og slovakisk program med åben kildekode. Det er letvægts, men har lidt dårligere stemmekvalitet. Du kan ikke styre lydstyrke for programmet fra &ktts;.

Syntesenavn: Epos tekst-til-tale syntesesystem

&URL;: http://epos.ure.cas.cz/

Debian installationskommando: `apt-get install epos`

Start kttsmgr. Klik på knappen Tilføj på siden Oplæsere. Vælg sproget tjekkisk eller slovakisk og Epos tekst-til-tale syntesesystem. Hvis den kørbare Epos-server og klienten ikke er i din søgesti, indtast den fuldstændige søgestier til disse kørbare programmer på siden Indstil Oplæser. Tilvalgsfelterne tillader dig at sende yderligere flag til serveren og klienten. Skriv `epos -h` eller say -h i en terminal for information.

#### Brug med FreeTTS

FreeTTS er et frit talesynteseprogram med åben kildekode skrevet i &Java;, hvilket betyder at du skal have &Java;s virtuelle maskine installeret på dit system for at bruge den. Den har for øjeblikket begrænset understøttelse for stemmer og sprog. Du kan ikke styre tonehøjde, lydstyrke eller hastighed for programmet fra &ktts;.

Syntesenavn: FreeTTS

&URL;: http://sourceforge.net/projects/freetts/

Debian installationskommando: ingen

#### Brug plugin for kommando

Plugin-programmet for kommando tillader at du bruger &ktts; med et hvilket som helst talesyntesprogram, som kan køres som en kommando i en terminal.

Syntesenavn: Kommando

&URL;: ingen

Debian installationskommando: ingen

Ideelt bør du bruge en kommando som syntetiserer til en midlertidig lydfil (wav), i stedet for at sende talen direkte til lydenheden.

Hvis talesyntesprogrammet kræver at tekst skal have et andet tegnsæt end desktoppens tegnsætindstilling, skal du bruge flaget `%f` til at sende teksten til programmet. &ktts; koder teksten med indstillingerne du angiver når det skriver teksten til den midlertidige filen. Hvis du forsøger at sende tekst på kommandolinjen med flaget `%t`, kodes det med tegnsætindstillingen i desktoppens indstilling af land. Du kan også bruge tilvalget Send data som standardindtastning for at løse problemet, hvis programmet accepterer inddata fra standardindtastningen. Her er et eksempel på en kommando til at sende polsk tekst til Festival med kodningen ISO 8859-2 og fjerne tegnsætning som ikke skal læses op.

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

&documentation.index;