# &jovie; käsiraamat

## Sissejuhatus

&jovie; on &kde; alamsüsteem teksti kõneks muutmiseks (TTS). See pakub &kde; programmeerijatele ühise API, võimaldades neil nii lisada oma rakendustele TTS-võimaluse. Samuti pakub see mitmeid toredaid võimalusi tavalistele kasutajatele.

Kasutajate võimalused:

- Tekstifaili sisu kõnelemine.

- &kde; märguannete (KNotify) kõnelemine.

- Osa või kogu veebilehekülje kõnelemine &konqueror;is.

- Osa või kogu teksti kõnelemine tekstiredaktoris &kate;, kaasa arvatud juhul, kui &kate; on põimitud mõnda muusse &kde; rakendusse.

- Kõnelemine käib kõnedispetšeri kaudu, mistõttu võib kasutada mis tahes kõnedispetšeri taustaprogrammi (espeak, festival &etc;).

- Seadistatavad filtrid valesti kõneldud sõnade asendamiseks, kõnesüntesaatori valimiseks ja XHMTL/&XML;-dokumentide transformeerimiseks.

Pogrammeerija võimalused:

- Suurepärane süsteem ekraanilugeja väljundi, hoiatuste ja teadete jaoks, mis suudab esitada ka tavalist teksti.

- Kõne tekitamise võimalus käsurealt (või shelliskriptiga) &qdbus;i tööriista vahendusel.

- Lihtne ja väike liides rakendustele kõneväljundi tekitamiseks.

- Rakendused ei pruugi muret tunda kõneseadme pärast.

- TULEVIKUS: kõnemärkekeelte toetus, näiteks VoiceXML, Sable, &Java; Speech Markup Language (JSML) ja Speech Markup Meta-language (SMML).

- TULEVIKUS: põimitud kõnemärkimisvahendite piiratud toetus.

- Asünkroonsus süsteemi blokeerimise vältimiseks.

&jovie; koosneb praegu mitmest programmist:

`jovie`

- &kde; teksti kõneks muutmise deemon on rakendus, mis pakub &DBus;-i vahendusel rakendustele TTS-teenust. See töötab ka süsteemisalves.

`libkhtmlkttsdplugin`

- Veebilehitseja &konqueror; plugin, mis võimaldab kõnelda kas kogu veebilehekülge või osa sellest.

`ktexteditor_kttsd`

- Tekstiredaktori &kate; plugin, mis võimaldab kõnelda kogu tekstifaili või osa sellest.

### Toetus

Lisaks &kde; Bugzilla andmebaasile (http://bugs.kde.org/) tegeleb &jovie; asjadega praegu kde-accessibility postiloend. Selle saab tellida aadressil https://mail.kde.org/mailman/listinfo/kde-accessibility. Arendajaid leiab ka IRC-st (irc.kde.org, kanal #kde-accessibility).

## &jovie; kasutamine

Enne &jovie; kasutamist tuleb paigaldada kõnedispetšer ja kontrollida, et see töötab. Vaata installation.

### `jovie` käivitamine

&jovie; süsteemi käivitamiseks anna Konsoolis järgmine käsk

`jovie`

või klõpsa &jovie; kirjel &kde; menüüs.

Kui see on sul esimene kord käivitada `jovie` või kui sa ei ole veel kõnelejaid määranud, ilmub nähtavale kaart Kõnelejad. Vaata configure-talkers. Kui oled aga määranud vähemalt ühe kõneleja, ilmub nähtavale kaart Üldine. Vaata general./>.

### Kõnelejate seadistamine

Enamik teksti kõneks muutmise (TTS) süntesaatoreid pakub välja mitmeid keeli ja hääli ning isegi mitut kõneleja sugu, helitugevust ja kõnekiirust. Võimalik on kasutada ka mitut süntesaatorit. Iga keele, süntesaatori, hääle, soo, helitugevuse ja kõnekiiruse kombinatsiooni nimetatakse kõnelejaks. Enne seda, kui saad käivitada &jovie; ja hakata teksti kõnelema, pead seadistama vähemalt ühe kõneleja, vastasel juhul kasutab kõnedispetšer vaikehäält.

Ühe ja sama süntesaatori mitut kõnelejat võib võrrelda ühe füüsilise printeri mitme tööjärjekorraga.

Klõpsuga kirjele Kõnelejad `jovie` dialoogis ilmub nähtavale kaart Kõnelejad. Sama dialoog ilmub ka siis, kui käivitad `jovie`, ilma et oleksid seadistanud veel ühtegi kõnelejat.

&kde; teksti kõneks muutmise haldur (kõnelejate kaart). &kde; teksti kõneks muutmise haldur (kõnelejate kaart)

- Klõpsa uue kõneleja lisamiseks.

- Siin on kirjas kõik seadistatud kõnelejad. Eespool seisavad kõrgema prioriteediga kõnelejad ning kui rakendus ise ei määra konkreetset kõnelejat, kasutatakse esmalt siin kõige esimesena näidatut.

- Klõpsa nimekirjas vajalikul kõnelejal ja siis sellele nupule antud kõneleja eemaldamiseks.

- Klõpsa nimekirjas vajalikul kõnelejal ja siis sellele nupule seadistuste muutmiseks. Täpsemalt vaata allpool.

- Klõpsa nimekirjas vajalikul kõnelejal ja siis sellele nupule kõneleja liigutamiseks nimekirjas allapoole. Mida tagapool on kõneleja nimekirjas, seda väiksema prioriteediga ta on.

- Klõpsa ühel neist nuppudest tehtud muudatuste rakendamiseks &jovie; süsteemis.

Klõpsuga nupule Lisa ilmub nähtavale dialoog Kõneleja lisamine.

Kõneleja lisamise dialoog. Kõneleja lisamise dialoog

- Uuele kõnelejale tuleb anda nimi, see võib olla milline tahes.

- Vali siin keel ja süntesaator.

- Siin saab valida hääletüübi: valikuteks on kolm mehe-, kolm naise-, üks poisslaose ja üks tütarlapse hääl.

- Siin saab kohandada hääle parameetreid.

- Siia klõpsates ilmub uus kõneleja nimekirja, mida võib näha kaardil Kõnelejad. Klõpsa nupule Muuda, kui soovid kõneleja seadistusi muuta.

&jovie; on nüüd peaaegu kasutamisvalmis. Mine kaardile Üldine ja märgi ära valik Teksti kõneks muutmise süsteemi (Jovie) lubamine. See käivitab &kde; TTS-deemoni. Vaata general. Seejärel võid kasutada &jovie;t teksti kõnelemiseks. Kaardil Tööd saad tekstitöid luua ja hallata. Vaata jobmgr.

### &jovie; käivitamine ja üldised valikud

Kui oled määranud vähemalt ühe kõneleja, võid hakata kasutama &kde; teksti kõneks muutmise süsteemi. Klõpsa sakile Üldine. Avaneb kaart Üldine. Siin saab määrata mõned üldised valikud.

&kde; teksti kõneks muutmise haldur (kaart Üldine). &kde; teksti kõneks muutmise haldur (kaart Üldine)

- Seda kasti märkides saab aktiveerida &jovie; süsteemi. See käivitab &kde; TTS-deemoni (&jovie;). Jovie edukal käivitamisel ilmub nähtavale kaart Tööd. Kui &jovie; on käivitatud, saad hakata tekstitöid looma ja teksti kõnelema. Vaata jobmgr. Kastist märke eemaldamine peatab Jovie ja lülitab &kde; TTS-süsteemi välja.

- Klõpsa kindlasti siia, kui soovid oma seadistusi salvestada.

### Tekstitööde haldamine

Klõpsuga sakile Tööd `jovie` dialoogis ilmub nähtavale kaart Tööd.

&kde; teksti kõneks muutmise haldur (kaart Tööd). &kde; teksti kõneks muutmise haldur (kaart Tööd)

- Siin saab muuta parajasti kõneldava hääle omadusi. Pane tähele, et see toimib ainult siis, kui kõnelejate kaardil pole ühtegi häält seadistatud.

- Selle rea nuppudega saab aktiivset tekstitööd peatada, taasalustada ja selle esitamisest loobuda.

- Selle rea nuppudega saab kõnelda parajasti &kde; lõikepuhvris olevat teksti või avada tekstifaili, mida soovid lasta kõnelda. Samuti saab siin muuta töö jaoks kasutatavat kõnelejat.

- Seadistuste salvestamiseks klõpsa kindlasti nupule Rakenda või OK.

Kaart Tööd on näha ainult siis, kui &jovie; töötab. Kui sa ei näe kaarti Tööd, vali kaart Üldine ja märgi ära kast Teksti kõneks muutmise süsteemi (Jovie) lubamine.

### Veebilehekülgede teksti kõnelemine

&kde; veebilehitsejat &konqueror; kasutades võib lasta kõnelda näidatavaid veebilehekülgi. Selleks kontrolli esmalt, et &jovie; töötab. Vali tekst, mida soovid lasta kõnelda, ning seejärel menüükäsk Tööriistad Kõnele teksti. Hetke pärast peaksid kuulma, kuidas valitud teksti kõneldakse.

Peaaegu alati on mõttekas veebileheküljel valida kindel tekst, mida kõnelda. Seda ei pruugi muidugi teha, aga sel juhul pead tõenäoliselt leppima, et kuuled kõnes ka arvukaid &HTML;-päiseid ja muid muidu nähtamatuid asju.

### Teksti kõnelemine tekstiredaktoris &kate;

&kde; võimsa tekstiredaktori &kate; kasutamisel võib lasta kõnelda näidatavat teksti. Kõigepealt kontrolli, et &jovie; töötab ja lülita &kate; seadistustedialoogis sisse KTextEditori Jovie teksti ettelugemise plugin. Vali tekst, mida soovid lasta kõnelda, ning seejärel menüükäsk Tööriistad Kõnele teksti. Hetke pärast peaksid kuulma, kuidas valitud teksti kõneldakse.

Teksti ei pruugi muidugi valida, sellisel juhul kõneldakse kogu avatud fail.

Seda saab kasutada ka siis, kui &kate; töötab põimituna mõnes muus rakenduses, näiteks &konqueror; või &quanta;.

### Märguannete kõnelemine (KNotify)

KNotify on &kde; märguannete alamsüsteem, mis annab sulle teada neist &kde;-s toimuvatest asjadest, mida oled soovinud teada saada. &jovie; on võimalik panna tekstimärguandeid kõnelema.

Nii võimaldab näiteks &kde; IRC rakendus &konversation; määrata terve rea märguandeid erinevate sündmuste jaoks. &konversation; võib näiteks teada anda, kui mõnel IRC kanalil esineb sõnumis sinu hüüdnimi. &jovie; abil võid lasta &kde;-l ka terve vastava IRC sõnumi ette lugeda.

Üldiselt esineb juhul, kui &kde; rakendus toetab KNotify'd, kirje Märguanded menüüs Seadistused. Kuidas ja mida seadistada saab, sõltub muidugi ennekõike vastavast rakendusest endast.

Stringiasendaja filtrid pakuvad hea võimaluse puhastada rakenduste saadetud sõnumid, kui &jovie; neid valesti hääldab või vigaselt esitab. Selle hea näide on fail `kmail.xml`, mida &jovie; automaatselt pakub. See eemaldab &kmail;i märguannetest sildid `br` ja `b` ning fraasi `/local/inbox/`, sest nende väljarääkimine tekitaks mis tahes keeles paraja segaduse. Vaata stringreplacer.

### Filtrid

Filtrid kujutavad endast &jovie; võimsat lisaomadust. &jovie; lihtsamate, tavaliste operatsioonide jaoks ei ole filtreid vaja.

Filtreid kasutatakse tekst eeltöötluseks enne selle saatmist kõnedispetšerile. Neist on kasu kõne täiustamisel, valesti kõneldud sõnade või lühendite asendamisel, sobiva keele ja kõneleja valimisel või kõnesüntesaatorite ja häälte teatud piirangute vältimisel.

#### &jovie; teadete tüübid

Filtrite kasutamiseks tuleks kõigepealt üritada mõista, kuidas kõnedispetšer töötleb. &jovie; kõneldav tekst võib olla nelja liiki.

- Ekraanilugeja väljund

- Hoiatused

- Teated

- Tekstitööd

Tüübi määrab rakendus, mis saadab teksti &jovie;le.

Ekraanilugeja väljundi prioriteet on suurim. See on mõeldud ekraanilugemisrakendustele. Ekraanilugeja väljundi korral katkestatakse mis tahes muud kõnetööd. Kui ekraanilugeja väljund on kõneldud, jätkatakse poolelijäänud töid automaatselt.

Hoiatuste prioriteet on veidi väiksem. See on mõeldud tõesti olulistele teadetele, näiteks "Protsessor on ülekuumenenud". Hoiatus on tähtsam kui teated ja tavaline tekst ning see sunnib need peatuma. Kui hoiatus on kõneldud, jätkatakse poolelijäänud töid automaatselt.

Teadete prioriteet on veelgi väiksem. Teade on olulisem kui tavaline tekst. Teateid kasutab näiteks rakendus &kmouth;. Kui näiteks parajasti kõneldakse mõne veebilehekülje pikka teksti, võib &kmouth; vahele seda ja tervitada kedagi, kes tuppa astub. Teated on ka &kde; märguanded (vaata knotify).

Kõik ülejäänu on tavaline tekstitöö. Kõik tööd, mida käivitad kaardil Tööd, on tekstitööd. Tekstitöid kasutab näiteks rakendus KSayit. Tekstitööd on sageli pikemad ega ole eluliselt tähtsad.

Kõik neli tekstitöö liiki esitatakse järjekorras, välja arvatud ekraanilugeja väljund. Kui rakendus saadab ekraanilugeja väljundi ajal, mil &jovie; kõneleb varasemat ekraanilugeja väljundit, peatatakse ja kustutatakse varasem kõne.

#### Filtrite tüübid

Filtrite juures tasuks kõigepealt tähele panna, et neid ei rakendata kunagi ekraanilugeja väljundi korral. Neid saab rakendada hoiatustele, teadetele ja tekstitöödele, samuti &kde; märguannetele.

Filtrid töötlevad teksti ja saadavad selle edasi järgmisele filtrile. Praegu on olemas kolme liiki filtreid.

- Stringiasendajad

- &XML;-i transformeerijad

- Kõneleja valijad

Filtrid on kasutusel pluginaarhitektuuri vahendusel. Tulevikus võib filtreid juurde tekkida.

Stringiasendusfiltrid asendavad tekstiosa mingi muu tekstiga. Asendatavad osad peavad sobima määratud sõnadele või regulaaravaldistele. &jovie; kasutab eelnevalt määratud stringasendusfiltreid lühendite, kiirsuhtluse emotikonide (näiteks ":-)") kõnelemiseks või &konversation;i ja &kmail;i märguannete vorminduse muutmiseks mõistetavamaks.

&XML;-i transformeerijad kasutavad &XML;-keele stiiliteisenduste (XSLT) faili ühes vormingus &XML;-i teisendamiseks teise vormingusse. &jovie; pakub välja mitu XSLT-faili &XHTML;-i teisendamiseks SSML-iks.

Kõneleja valijad võimaldavad suunata töid kõnelejale vastavalt teksti sisule või rakendusele, mis töö &jovie;le saadab. Kui oled näiteks määratud kaardil Kõnelejad naishäälega kõneleja, võid suunata KSayIt saadetud teksti just sellele kõnelejale. Vaata configure-talkers.

Kõigil filtritel on seadistatavad reeglid, mida kasutatakse filtri rakendamisel kõneldavale tekstile. Kui filter leiab, et antud juhul ei näe reeglid millegi muutmist ette, edastatakse tekst järgmisele filtrile muutmata kujul.

Kui tekstitöö, sõnu,, hoiatus või &kde; märguanne saadetakse &jovie;le, läbib see alloleval ekraanil sisse lülitatud filtreid. Filtrite läbimise järjekord on ülalt alla.

#### Filtrite seadistamine

Filtrite kasutamiseks klõpsa `jovie` dialoogis kaardile Filtrid.

&kde; teksti kõneks muutmise haldur (kaart Filtrid). &kde; teksti kõneks muutmise haldur (kaart Filtrid)

- See on seadistatud tavaliste filtrite nimekiri. Märkimatajätmisel ei lülitata filtrit sisse ega lisata filtriahelasse. Filtrid rakendatakse siintoodud järjekorras ülalt alla.

- Klõpsa siia uue filtri lisamiseks. Sinu käest päritakse, millist liiki filter lisada. Kui oled liigi valinud, näed üht alltoodud seadistustedialoogidest.

- Klõpsa siia filtri eemaldamiseks.

- Klõpsa siia filtri seadistamiseks. Selle peale avaneb vastavalt filtrile mõni alltoodud seadistustedialoogidest.

- Klõpsa neile nuppudele filtri liigutamiseks nimekirjas üles- või allapoole.

- Klõpsa kindlasti siia, muidu sinu seadistusi ei rakendata.

#### Stringiasendusfiltrite seadistamine

Stringiasendusfiltreid saab seadistada otsitavate sõnade või regulaaravaldiste nimekirja kirjeid lisades või muutes. Kui tekstis leitakse otsitavad sõnad või regulaaravaldise vasted, asendatakse need siin antud asendusega.

Stringiasendaja Stringiasendaja

- Määra siin filtri nimi. See võib olla milline tahes, seda kasutatakse selleks, et sa ise suudaksid üht filtrit teisest eristada.

- See on sõnade ja regulaaravaldiste nimekiri. Filter otsib kõigi veerus Sobivus antud stringide vasteid ja leidmisel asendab need stringiga veerust Asendus. Nimekiri läbitakse vastavalt kirjete järjekorrale ülalt alla.

- Klõpsa siia sõna või regulaaravaldise lisamiseks nimekirja.

- Klõpsa siia parajasti valitud sõna või regulaaravaldise liigutamiseks nimekirjas üles- või allapoole.

- Klõpsa siia nimekirjas oleva sõna või regulaaravaldise muutmiseks.

- Klõpsa siia parajasti valitud sõna või regulaaravaldise eemaldamiseks nimekirjast.

- Nende nuppudega saab laadida sõnu või regulaaravaldisi sisaldava faili, salvestada senise nimekirja failina või puhastada kogu nimekirja. Faili laadimisel lisatakse selles leiduvad kirjed senise nimekirja lõppu.

- Kui see ei ole tühi, rakendatakse filtrit ainult juhul, kui tekstitöö kõneleja keel vastab siinsisestatud keelele. Nupule klõpsates saab näha võimalikke keeli. Enam kui ühe keele saab valida, kui keeltele klõpsamise ajal hoida all klahvi &Ctrl;.

- Kui see ei ole tühi, rakendatakse filtrit ainult juhul, kui tekst on pärit mõnelt siin antud rakenduselt. Komadega eraldatult saab määrata ka mitu rakendust, näiteks ``konversation,kmail``.

  Töötavate programmide rakenduse ID saab leida programmiga `&qdbus;`. &DBus;-numbrid tuleb küll sel juhul välja jätta. Kui näiteks &qdbus; näitab rakenduse ID-ks `kopete-3432`, tuleb siin anda lihtsalt ``kopete``.

Stringiasendusfiltrit rakendatakse ainult juhul, kui kõik kastis Filtri rakendamise tingimused esinevad mittetühjad tingimused on täidetud. Kui seal pole midagi, rakendatakse filtrit kogu tekstile.

Sõnade otsimisel ja asendamisel kasutab stringiasendusfilter seesmiselt regulaaravaldist kujul `\s`sõna`\s`. See tähendab, et sõnal peab mõlemalt poolt ümbritsema vähemalt üks tühik.

Pikem seletus, kuidas panna kirja regulaaravaldisi, väljub käesoleva käsiraamatu piiridest. Kui sul on paigaldatud &kde; regulaaravaldiste redaktor, on pärast nupule Lisa või Muuda ilmuvas dialoogis olemas nupp, millele klõpsates saad regulaaravaldise graafiliselt luua. &kde; regulaaravaldiste redaktor kuulub "playgroundi" Giti moodulisse `Utils`.

&jovie; pakub välja teatud valiku sõnade nimekirju, sealhulgas emotikonid (näiteks ":-)"), mõned tavalisemad IRC-s või kiirsuhtlusrakendustes kasutatavad lühendid ja veel mõned levinumad lühendid. On ka omaette erisümbolite nimekiri, mida praegune Festivali poola hääl ei suuda käsitleda. Kui oled loonud ise mõne asjaliku sõnade nimekirja, kasuta nuppu Salvesta selle salvestamiseks failina ning saada see siis &jovie; meeskonnale, kes võib selle järgmise versiooniga juba kaasa panna.

#### &XML;-i transformeerimise filtrite seadistamine

&XML;-teisenduse filter kasutab XSLT-faile &XML;-i teisendamiseks ühest vormingust teise. &XML;-keele stiiliteisendused ehk XSLT on W3C standarditele vastav keel, mis võimaldab selliseid teisendusi ette võtta. Kasutada saab siiski ainult korrektset &XML;-i. Paigaldatud peab olema utiliit `xsltproc`.

&XML;-teisendus &XML;-teisendus

- Määra siin filtri nimi. See võib olla milline tahes, seda kasutatakse selleks, et sa ise suudaksid üht filtrit teisest eristada.

- Määra siin XSLT-faili täielik asukoht, mida soovid kasutada teisendamiseks.

- Määra siin programmi `xsltproc` asukoht. Kui see asub keskkonnamuutujaga PATH määratud asukohas, kirjuta lihtsalt ``xsltproc``.

- Kui see ei ole tühi, rakendatakse filtrit ainult siis, kui &XML;-il on määratud juurelement või stringiga algav `<!DOCTYPE` spetsifikatsioon. See eristab üht &XML;-i vormi teisest. Näiteks kui DOCTYPE on ``html``, siis vastab sellele `<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" >`.

- Kui see ei ole tühi, rakendatakse filtrit ainult juhul, kui tekst on pärit mõnelt siin antud rakenduselt. Komadega eraldatult saab määrata ka mitu rakendust, näiteks ``konversation,kmail``.

  Töötavate programmide rakenduse ID saab leida programmiga `&qdbus;`. &DBus;-numbrid tuleb küll sel juhul välja jätta. Kui näiteks &qdbus; näitab rakenduse ID-ks `kopete-3432`, tuleb siin anda lihtsalt ``kopete``.

&XML;-teisenduse filtrit rakendatakse ainult juhul, kui juurelemen või DOCTYPE on määratud ning kõik kastis Filtri rakendamise tingimused esinevad mittetühjad tingimused on täidetud. Kui kõik kastid on tühjad, rakendatakse seda kogu tekstile. Siiski tuleks täita vähemalt üks kast, sest paljud tekstitööd pole &XML;-vormingus.

#### Kõneleja valimise filtrite seadistamine

Kõneleja valimise filtreid saab kasutada kõne suunamiseks vajalikule kõnelejale, mis on seadistatud kaardil Kõnelejad, või mis tahes määratud omadustega kõnelejale. Nii saab näiteks määrata, et tekst, mille saadab `kmail`, kõneldakse alati naishäälega. Vaata configure-talkers.

Enne seda, kui &jovie; saadab teksti filtritele, valitakse välja seda hiljem kõnelema asuv kõneleja. Kõneleja valik tugineb kõneleja atribuutidele, mille määrab rakendus, mis teksti &jovie;le saatis, ning kaardil Kõnelejad seadistatud kõneleja atribuutidele. Kõneleja valimise filtriga saab tühistada kõneleja vaikevaliku.

Kõneleja valik Kõneleja valik

- Määra siin filtri nimi. See võib olla milline tahes, seda kasutatakse selleks, et sa ise suudaksid üht filtrit teisest eristada.

- Kui see pole tühi, rakendatakse filtrit ainult juhul, kui tekst sisaldab siinmääratud regulaaravaldist. Kui sul on paigaldatud &kde; regulaaravaldiste redaktor, klõpsa vastavat nuppu ning redaktor aitab sul luua sobiva regulaaravaldise.

  Et asjad paremini sujuks, ürita "ankurdada" regulaaravaldis stringi algusse - see tähendab, alusta regulaaravaldist sümboliga ``^``.

- Kui see ei ole tühi, rakendatakse filtrit ainult juhul, kui tekst on pärit mõnelt siin antud rakenduselt. Komadega eraldatult saab määrata ka mitu rakendust, näiteks ``konversation,kmail``.

  Töötavate programmide rakenduse ID saab leida programmiga `&qdbus;`. &DBus;-numbrid tuleb küll sel juhul välja jätta. Kui näiteks &qdbus; näitab rakenduse ID-ks `kopete-3432`, tuleb siin anda lihtsalt ``kopete``.

- Määra siin kõneleja omadused, mida soovid teksti kõnelemiseks kasutada. Kui tekst vastab ülaltoodud filtritingimustele, valitakse kõneleja, mis kõige enam vastab siinmääratud omadustele. Paremal asuvale nupule klõpsates saab avada dialoogi Kõneleja valik.

- Nende nuppudega saab salvestada kõneleja valimise seadistused, laadida olemasolevad seadistused failist või puhastada kõik seadistused.

Kõneleja valimise filtrit rakendatakse ainult juhul, kui kõik kastis Filtri rakendamise tingimused esinevad mittetühjad tingimused on täidetud. Täita tuleb vähemalt üks kast.

## &jovie; arendajatele

&jovie;l on kaks programmiliidest (API):

- &kde; teksti kõneks muutmise API, mida rakenduse programmeerijad saavad kasutada oma rakendusele TTS-võimaluste lisamiseks. Rakendused suhtlevad &jovie;ga &DBus;-i vahendusel.

- &jovie; teksti ettelugemise plugina API, mida saab kasutada kõnesünteesipluginate lisamiseks &jovie;le, et &jovie; suudaks kasutada uut kõnesünteesi mootorit.

Järgnevas osas kirjeldame lühidalt &kde; teksti kõneks muutmise API &DBus;-liidest. Mõlema API täieliku dokumentatsiooni leiab internetist &kde; hõlbustuse veebisaidilt (http://accessibility.kde.org).

### &jovie; &DBus;-liides

Rakendused saadavad teksti kõneks muutmise teenuse soovid &kde; &DBus;-liidese vahendusel `jovie` objektile `KSpeech`.

Anna järgnevad käsud Konsoolis.

Kui &jovie; veel ei tööta

`jovie`

Kõneldava tekstitöö järjekorda asetamiseks

`qdbus org.kde.jovie /KSpeech say "`tekst`" "`valikud`"`

kus ``tekst`` on kõneldav tekst ja ``valikud`` keelekood, näiteks ``en``, ``et`` &etc;

Näide:

`qdbus org.kde.jovie /KSpeech say "This is a test." "en"`

Saata saab üsna palju käske. Võimalike käskudega tutvumiseks kasuta käsku

`qdbus org.kde.jovie /KSpeech`

või tutvu võrgus &kde; teksti kõneks muutmise API-ga.

## Küsimused ja vastused

&reporting.bugs; &updating.documentation;

Mul on vaja uuesti alustada. Kuidas &jovie; täiesti tööst välja lülitada?

Anna Konsoolis järgmised käsud:

    kquitapp jovie

Kuidas näha `jovie` silumisväljundit?

Ava &konsole;'i aken ja anna käsk `jovie`.

Ükski toetatud kõnesüntesaatoritest ei toeta keelt, mida mul vaja läheks. Kuidas siis panna süntesaator minu keeles tööle?

Siin on sinu sõber Google(tm). Abiks võib olla ka see link. Kui leiad vabatarkvaralise sünteesimootori, mis toetab sinu keelt, ning soovid, et seda toetaks ka &jovie;, võta arendajatega ühendust. Eriti oodatud on mõistagi just vabatarkvaralised lahendused. Kui tead kommerts-kõnesüntesaatorit, õnnestub sul vahest veenda selle tootjat või levitajat annetama vaba koopia &jovie; arendajatele. Seni aga võib olla võimalik oma keel tööle saada kõnedispetšeri käsurea-taustaprogrammiga.

Olen seadistanud &HTML;-i &XML;-teisenduse filtri, aga veebilehekülgede kõnelemisel ei kasutata üldse Festivali pluginat.

Festival 1.95 beta vea tõttu tuleb paigaldada `rab_diphone` (briti mehehääl), et SABLE üldse töötaks - isegi juhul, kui sa ei kasuta seda häält veebilehekülgede kõnelemiseks. Samuti kontrolli, et utiliit `xsltproc` oleks paigaldatud ja asuks keskkonnamuutujaga PATH määratud asukohas.

Teatud tähed või kirjavahemärgid paistavad süntesaatoris vigu tekitavat, sunnivad seda terveid lauseid vahele jätma või muidu jama kõnelema. Mida ette võtta.

Kõigepealt kontrolli, et kõneleja seadistustedialoogis oleks valik Kodeering sinu keele jaoks korrektselt määratud. Kui probleeme tekitavad teatud sõnad või tähed, võib abi olla stringiasendusfiltrist. Vaata filters.

## Autorid ja litsents

&jovie;

Rakenduse autoriõigus © 2002: José Pablo Ezequiel "Pupeno" Fernández pupeno@kde.org

Praegune hooldaja: Jeremy Whiting jpwhiting@kde.org

Kaasautorid:

- Gary Cramblitt garycramblitt@comcast.net

- Olaf Schmidt ojschmidt@kde.org

- Gunnar Schmi Dt gunnar@schmi-dt.de

- Paul Giannaros ceruleanblaze@gmail.com

Dokumentatsiooni autoriõigus © 2009: Jeremy Whiting jpwhiting@kde.org © 2004: Gary R. Cramblitt garycramblitt@comcast.net

Tõlge eesti keelde: Marek Laane bald@starman.ee

&underFDL; &underGPL;

&jovie; kasutatavatel kõnesünteesi mootoritel on omaette litsentsid. Vaata neid mootorite dokumentatsioonist või veebisaidilt. Ka mõnel häälel on omaette litsents.

## Paigaldamine

### &jovie; hankimine

&install.intro.documentation;

Debiani paigaldamiskäsk: `apt-get install jovie`

Viidad lähtetekstile ja binaarpakettidele leiab &kde; hõlbustuse veebileheküljelt (http://accessibility.kde.org).

Kui sul on ligipääs &kde; lähtekoodi hoidlale, võid hankida &jovie; moodulit `jovie` välja võttes. &jovie; on kataloogis `jovie`. Samuti võib tõmmata kogu &jovie; lähtekoodi pakitud versiooni aadressilt http://download.kde.org/stable/

### Nõuded

Kohustuslikud nõdued:

- &kde; versioon 4.8 või uuem..

- kõnedispetšeri versioon 0.67 või uuem.

- Kõnesüntesaator. Praegu on toetatud järgmised mootorid ja kõneldavad keeled.

  Espeak | Väga palju keeli, praegust seisu näeb aadressil http://espeak.sourceforge.net/languages.html.
  Festival | Ameerika inglise, briti inglise, hispaania, saksa, soome, tšehhi, poola, vene, itaalia, Kanada prantsuse, suahiili, suulu ja ibibio

  See töötab ka iga sünteesimootoriga, mida saab käivitada Konsoolist ehk käsurealt.

  Toodud keelteloend ei pruugi olla ammendav või kõige värskem. Kontrolli kõigi mootorite spetsifikatsiooni, kust leiad kõik toetatud keeled. Samuti võid infot, mis ei ole käsiraamatusse veel jõudnud, leida &jovie; veebileheküljelt.

  kõnedispetšer kasutab kõnesünteesi mootorite jaoks paindlikku pluginaarhitektuuri. Kui soovid &jovie; veel paremaks muuta mõne mootori lisamisega, võta ühendust arendajatega.

  Iga mootori kohta annab konkreetseid juhiseid configuration.

Lisakomponendid:

- Utiliiti `xsltproc` on vaja SSML-i toetuse ja &XML;-teisenduse filtri jaoks. Debiani kasutajad saavad selle paigaldada käsuga `apt-get install xsltproc`.

### Kompileerimine ja paigaldamine

&jovie; kompileerimiseks läheb vaja üsna uusi &kde; teeke (&kde; 4.8 või uuem), sealhulgas paketti kdelibs ja kõnedispetšeri arendusfaile.

Kui oled tõmmanud &jovie; lähtekoodi `kdeaccessibility` lähtekoodi hoidla moodulist või laadinud alla igaöise tar-pakitud faili, kasuta kompileerimiseks ja paigaldamiseks järgmisi käske:

    cd jovie
    mkdir build
    cd build
    cmake ../
    make
    sudo make install

### Seadistamine

Kontrolli enne &jovie; kasutamist, et kõnedispetšer töötab koos kõnesünteesi mootoriga. Selleks saab kasutada shelliskripti spd-conf.

&jovie; &kde; 4.5 raames on varasema KTTSD ja kttsmgr jätk teise nime all. Tulevikus peaks kttsmgr olema võimeline seadistama kõnedispetšerit otse, ilma skripti spd-conf vahenduseta.

&documentation.index;