<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!-- Define an entity for your application if it is not part of KDE
       CVS -->
  <!ENTITY ktts "<application
>KTTS</application
>">
  <!ENTITY kappname "&ktts;"
><!-- replace kmyapplication here
                                            do *not* replace kappname-->
  <!ENTITY package "kdeaccessibility"
><!-- kdebase, kdeadmin, etc.  Leave
                                     this unchanged if your
                                     application is not maintained in KDE CVS -->
  <!ENTITY mbrola "<application
>MBROLA</application
>">
  <!ENTITY % imageobjectco.module "INCLUDE">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Estonian  "INCLUDE"
> <!-- ONLY If you are writing non-English 
                                     original documentation, change 
                                     the language here -->
    
  <!-- Do not define any other entities; instead, use the entities
       from entities/general.entities and $LANG/user.entities. -->
]>
<!-- Note to translators: KTTSD is meant to be built under KDE
     versions 3.2 and later.  Please avoid entities that won't
     be defined under those KDE versions.  Thanks.
-->

<!-- kdoctemplate v0.9 January 10 2003
     Changes to comments to clarify entity usage January 10 2003
     Minor update to "Credits and Licenses" section on August 24, 2000
     Removed "Revision history" section on 22 January 2001
     Changed to Installation/Help menu entities 18 October 2001
     Other minor cleanup and changes 18 October 2001 
     FPI change and minor changes November 2002 -->

<!--
This template was designed by: David Rugge davidrugge@mindspring.com
with lots of help from: Eric Bischoff ebisch@cybercable.tm.fr
and Frederik Fouvry fouvry@sfs.nphil.uni-tuebingen.de
of the KDE DocBook team.

You may freely use this template for writing any sort of KDE documentation.
If you have any changes or improvements, please let us know.

Remember:
- in XML, the case of the <tags
> and attributes is relevant ;
- also, quote all attributes.

Please don't forget to remove all these comments in your final documentation,
thanks ;-).
-->

<!-- ................................................................ -->

<!-- The language must NOT be changed here. -->
<!-- If you are writing original documentation in a language other -->
<!-- than English, change the language above ONLY, not here -->
<book lang="&language;">

<!-- This header contains all of the meta-information for the document such
as Authors, publish date, the abstract, and Keywords -->

<bookinfo>
<title
>&ktts; käsiraamat</title>

<authorgroup>
<author
><personname
> <firstname
>Gary</firstname
> <othername
>R.</othername
> <surname
>Cramblitt</surname
> </personname
> <email
>garycramblitt@comcast.net</email
> </author>

<othercredit role="translator"
><firstname
>Marek</firstname
> <surname
>Laane</surname
> <affiliation
><address
><email
>bald@starman.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 

</authorgroup>

<copyright>
<year
>2004-2005</year>
<holder
>Gary R. Cramblitt</holder>
</copyright>
<!-- Translators: put here the copyright notice of the translation -->
<!-- Put here the FDL notice.  Read the explanation in fdl-notice.docbook 
     and in the FDL itself on how to use it. -->
<legalnotice
>&FDLNotice;</legalnotice>

<!-- Date and version information of the documentation
Don't forget to include this last date and this last revision number, we
need them for translation coordination !
Please respect the format of the date (YYYY-MM-DD) and of the version
(V.MM.LL), it could be used by automation scripts.
Do NOT change these in the translation. -->

<date
>2005-07-31</date>
<releaseinfo
>1.05.00</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para
>&kde; teksti kõneks muutmise süsteem &ktts; on pluginatepõhine teenus, mis võimaldab &DCOP;-liidese abil kõigil &kde; (või ka &kde;-välistel) rakendustel teksti kõnelda. </para>

<para
>&ktts; aluseks on &kde; teksti kõneks muutmise API.</para>

</abstract>

<!-- This is a set of Keywords for indexing by search engines.
Please at least include KDE, the KDE package it is in, the name
 of your application, and a few relevant keywords. -->

<keywordset>
<keyword
>KDE</keyword>
<keyword
>hõlbustus</keyword>
<keyword
>kdeaccessibility</keyword>
<keyword
>TTS</keyword>
<keyword
>Tekst kõneks</keyword>
<keyword
>KTTSD</keyword>
<keyword
>kttsmgr</keyword>
<keyword
>festival</keyword>
<keyword
>flite</keyword>
<keyword
>hadifix</keyword>
<keyword
>MBROLA</keyword>
<keyword
>freetts</keyword>
<keyword
>epos</keyword>
<keyword
>SSML</keyword>
</keywordset>

</bookinfo>

<!-- The contents of the documentation begin here.  Label
each chapter so with the id attribute. This is necessary for two reasons: it
allows you to easily reference the chapter from other chapters of your
document, and if there is no ID, the name of the generated HTML files will vary
from time to time making it hard to manage for maintainers and for the CVS
system. Any chapter labelled (OPTIONAL) may be left out at the author's
discretion. Other chapters should not be left out in order to maintain a
consistent documentation style across all KDE apps. -->

<!-- ====================================================================== -->

<chapter id="introduction">
<title
>Sissejuhatus</title>

<!-- The introduction chapter contains a brief introduction for the
application that explains what it does and where to report
problems. Basically a long version of the abstract.  Don't include a
revision history. (see installation appendix comment) -->

<para
>&ktts; 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.</para>

<para
>Kasutajate võimalused:</para>

<itemizedlist>
<listitem
><para
>Tekstifaili sisu kõnelemine.</para
></listitem>
<listitem
><para
>&kde; märguannete (KNotify) kõnelemine.</para
></listitem>
<listitem
><para
>Osa või kogu veebilehekülje kõnelemine &konqueror;is.</para
></listitem>
<listitem
><para
>Osa või kogu teksti kõnelemine tekstiredaktoris &kate;, kaasa arvatud juhul, kui &kate; on põimitud mõnda muusse &kde; rakendusse.</para
></listitem>
<listitem
><para
>Pikad tekstid parsitakse lauseteks. Kasutajad võivad lause või lõigu varukoopiana salvestada, seda taasesitada, esituse peatada või katkestada.</para
></listitem>
<listitem
><para
>Heliväljund &arts;i, ALSA, GStreameri (versioon 0.8.7 või uuem) või aKode vahendusel.</para
></listitem>
<listitem
><para
>Seadistatavad filtrid valesti kõneldud sõnade asendamiseks, kõnesüntesaatori valimiseks ja XHMTL/&XML;-dokumentide transformeerimiseks.</para
></listitem>
</itemizedlist>

<para
>Pogrammeerija võimalused:</para>

<itemizedlist>
<listitem
><para
>Suurepärane süsteem ekraanilugeja väljundi, hoiatuste ja teadete jaoks, mis suudab esitada ka tavalist teksti.</para
></listitem>
<listitem
><para
>Pluginapõhine arhitektuur võimaldab toetada paljusid kõnesünteesi mootoreid ja draivereid.</para
></listitem>
<listitem
><para
>Kõne tekitamise võimalus käsurealt (või shelliskriptiga) &kde; &DCOP;-utiliitide vahendusel.</para
></listitem>
<listitem
><para
>Lihtne ja väike liides rakendustele kõneväljundi tekitamiseks.</para
></listitem>
<listitem
><para
>Rakendused ei pruugi muret tunda kõneseadme pärast.</para
></listitem>
<listitem
><para
>TULEVIKUS: kõnemärkekeelte toetus, näiteks VoiceXML, Sable, &Java; Speech Markup Language (JSML) ja Speech Markup Meta-language (SMML).</para
></listitem>
<listitem
><para
>TULEVIKUS: põimitud kõnemärkimisvahendite piiratud toetus.</para
></listitem>
<listitem
><para
>Asünkroonsus süsteemi blokeerimise vältimiseks.</para
></listitem>
</itemizedlist>

<para
>&ktts; koosneb praegu mitmest programmist: <variablelist>

<varlistentry>
<term
><command
>kttsd</command
></term>
<listitem
><para
>&kde; teksti kõneks muutmise deemon on graafilise kasutajaliideseta rakendus, mis pakub &DCOP;-i vahendusel rakendustele TTS-teenust. </para
></listitem
></varlistentry>

<varlistentry>
<term
><command
>kttsmgr</command
></term>
<listitem
><para
>Graafilise kasutajaliidesega rakendus KTTSD seadistamiseks ja juhtimiseks. KTTSMGR töötab süsteemses salves. </para
></listitem
></varlistentry>

<varlistentry>
<term
><command
>libkhtmlkttsdplugin</command
></term>
<listitem
><para
>Veebilehitseja &konqueror; plugin, mis võimaldab kõnelda kas kogu veebilehekülge või osa sellest. </para
></listitem
></varlistentry>

<varlistentry>
<term
><command
>ktexteditor_kttsd</command
></term>
<listitem
><para
>Tekstiredaktori &kate; plugin, mis võimaldab kõnelda kogu tekstifaili või osa sellest. </para
></listitem
></varlistentry>

</variablelist>
</para>

<!-- ...................................................................... -->

<sect1 id="support">
<title
>Toetus</title>
<para
>Lisaks &kde; Bugzilla andmebaasile (<ulink url="http://bugs.kde.org/"
>http://bugs.kde.org/</ulink
>) tegeleb &ktts; asjadega praegu kde-accessibility meililist. Selle saab tellida aadressil <ulink url="https://mail.kde.org/mailman/listinfo/kde-accessibility"
> https://mail.kde.org/mailman/listinfo/kde-accessibility</ulink
>. Arendajaid leiab ka IRC-st (irc.kde.org, kanal #kde-accessibility). </para>
</sect1>

</chapter>

<!-- ====================================================================== -->

<chapter id="using-kapp">
<title
>&ktts; kasutamine</title>

<para>
<warning
><para
>Enne &ktts; kasutamist tuleb paigaldada vähemalt üks kõnesünteesi mootor ja kontrollida, et see töötab. Vaata <xref linkend="installation"/>. </para
></warning
></para>

<!-- ...................................................................... -->


<sect1 id="starting-kttsmgr">
<title
><command
>kttsmgr</command
> käivitamine</title>

<para
>&ktts; süsteemi käivitamiseks anna Konsoolis järgmine käsk </para>

<para
><userinput
>kttsmgr</userinput
></para>

<para
>või klõpsa kttsmgr kirjel &kde; menüüs.</para>

<para
>Kui see on sul esimene kord käivitada <command
>kttsmgr</command
> või kui sa ei ole veel kõnelejaid määranud, ilmub nähtavale kaart <guilabel
>Kõnelejad</guilabel
>. Vaata <xref linkend="configure-plugin"/>. Kui oled aga määranud vähemalt ühe kõneleja, ilmub nähtavale kaart <guilabel
>Üldine</guilabel
>. Vaata <xref linkend="general"/>.</para>

</sect1>

<!-- ...................................................................... -->


<sect1 id="configure-plugin">
<title
>Kõnesünteesi pluginate (kõnelejate) seadistamine</title>

<para
>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 &ktts; ja hakata teksti kõnelema, pead seadistama vähemalt ühe kõneleja.</para>

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

<para
>Kui rakendused saadavad teksti &ktts;-le, võivad nad määrata ka eelistatud kõneleja atribuudid. Nii võib rakendus soovida näiteks kõnelejaks ingliskeelset naishäält. Kui sul on seadistatud kõneleja, mis kasutab nii inglise keelt kui naishäält, kasutatakse seda, kui mitte, siin valitakse automaatselt kõige sobivam kõneleja. Täpsemalt räägib sellest, kuidas &ktts; kõneleja valib, <xref linkend="filters"/>.</para>

<para
>Klõpsuga kirjele <guilabel
>Kõnelejad</guilabel
> <command
>kttsmgr</command
> dialoogis ilmub nähtavale kaart <guilabel
>Kõnelejad</guilabel
>. Sama dialoog ilmub ka siis, kui käivitad <command
>kttsmgr</command
>, ilma et oleksid seadistanud veel ühtegi kõnelejat.</para>

<para>
<screenshot>
<screeninfo
>&kde; teksti kõneks muutmise haldur (kõnelejate kaart).</screeninfo>
	<mediaobjectco>
		<imageobjectco>
			<areaspec units="calspair">
				<area id="pt-talker-1" coords="1 1"/>
				<area id="pt-talker-2" coords="1 1"/>
				<area id="pt-talker-3" coords="1 1"/>
				<area id="pt-talker-4" coords="1 1"/>
				<area id="pt-talker-5" coords="1 1"/>
				<area id="pt-talker-6" coords="1 1"/>
			</areaspec>
			<imageobject>
				<imagedata fileref="talkers.png" format="PNG"/>
			</imageobject>
		</imageobjectco>
		<textobject>
			<phrase
>&kde; teksti kõneks muutmise haldur (kõnelejate kaart)</phrase>
		</textobject>
	</mediaobjectco>
</screenshot>
</para>

<para>
<calloutlist>
<callout arearefs="pt-talker-1"
><para
>Klõpsa uue kõneleja lisamiseks.</para
></callout>
<callout arearefs="pt-talker-2"
><para
>Siin on kirjas kõik seadistatud <guilabel
>kõnelejad</guilabel
>. Eespool seisavad kõrgema prioriteediga <guilabel
>kõnelejad</guilabel
> ning kui rakendus ise ei määra konkreetset kõnelejat, kasutatakse esmalt siin kõige esimesena näidatut.</para
></callout>
<callout arearefs="pt-talker-3"
><para
>Klõpsa nimekirjas vajalikul kõnelejal ja siis sellele nupule antud kõneleja eemaldamiseks.</para
></callout>
<callout arearefs="pt-talker-4"
><para
>Klõpsa nimekirjas vajalikul kõnelejal ja siis sellele nupule kõnesünteesi plugina seadistustedialoogi avamiseks. Täpsemalt vaata allpool.</para
></callout>
<callout arearefs="pt-talker-5"
><para
>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.</para
></callout>
<callout arearefs="pt-talker-6"
><para
>Klõpsa ühel neist nuppudest tehtud muudatuste rakendamiseks &ktts; süsteemis.</para
></callout>
</calloutlist>
</para>

<para
>Klõpsuga nupule <guibutton
>Lisa</guibutton
> ilmub nähtavale dialoog <guilabel
>Kõneleja lisamine</guilabel
>.</para>

<para>
	<screenshot>
		<screeninfo
>Kõneleja lisamise dialoog.</screeninfo>
		<mediaobjectco>
			<imageobjectco>
				<areaspec units="calspair">
					<area id="pt-addtalker-1" coords="1 1"/>
					<area id="pt-addtalker-2" coords="1 1"/>
					<area id="pt-addtalker-3" coords="1 1"/>
				</areaspec>
				<imageobject>
					<imagedata fileref="addtalker.png" format="PNG"/>
				</imageobject>
			</imageobjectco>
			<textobject>
				<phrase
>Kõneleja lisamise dialoog</phrase>
			</textobject>
		</mediaobjectco>
	</screenshot>
</para>

<para>
<calloutlist>
<callout arearefs="pt-addtalker-1"
><para
>Kõnesünteesiplugina saab valida kas <guilabel
>Süntesaator</guilabel
>i nime või siis <guilabel
>Keel</guilabel
>e järgi, mida süntesaator kõneleb. Märgi ära vastav raadionupp. Kui märkida raadionupp <guilabel
>Keel</guilabel
>, näitab väli <guilabel
>Keel</guilabel
> kõiki keeli, mida olemasolevad süntesaatorid toetavad, ning väli <guilabel
>Süntesaator</guilabel
> ainult neid süntesaatoreid, mis valitud keelt toetavad. Kui märkida raadionupp <guilabel
>Süntesaator</guilabel
>, näitab väli <guilabel
>Süntesaator</guilabel
> kõiki olemasolevaid süntesaatoreid, ning väli <guilabel
>Keel</guilabel
> ainult neid keeli, mida valitud süntesaator toetab.</para
></callout>
<callout arearefs="pt-addtalker-2"
><para
>Vali siin keel ja sünteesiplugin.</para
></callout>
<callout arearefs="pt-addtalker-3"
><para
>Siia klõpsates seadistab enamik sünteesipluginaid ennast automaatselt ise, kasutades vaikeseadistust. Uus kõneleja ilmub nimekirja, mida võib näha kaardil <guilabel
>Kõnelejad</guilabel
>. Klõpsa nupule <guibutton
>Muuda</guibutton
>, kui soovid kõneleja seadistusi näha või muuta.</para
></callout>
</calloutlist>
</para>

<para
>Kaardil <guilabel
>Kõnelejad</guilabel
> nupule <guibutton
>Lisa</guibutton
> klõpsates ja kõnelejat lisades või nupule <guibutton
>Muuda</guibutton
> klõpsates ilmub dialoog <guilabel
>Kõneleja seadistamine</guilabel
>. Iga kõnesünteesiplugina korral on dialoog <guilabel
>Kõneleja seadistamine</guilabel
> erinev. Järgnevas näites on tegemist Festival Interactive'i plugina seadistamisega. Kõigist pluginatest räägib täpsemalt <xref linkend="configuration"/>.</para>

<para>
<screenshot>
<screeninfo
>Kõneleja seadistamine</screeninfo>
	<mediaobjectco>
		<imageobjectco>
			<areaspec units="calspair">
				<area id="pt-prop-1" coords="1 1"/>
				<area id="pt-prop-2" coords="1 1"/>
				<area id="pt-prop-3" coords="1 1"/>
				<area id="pt-prop-4" coords="1 1"/>
				<area id="pt-prop-5" coords="1 1"/>
				<area id="pt-prop-6" coords="1 1"/>
				<area id="pt-prop-7" coords="1 1"/>
			</areaspec>
			<imageobject>
				<imagedata fileref="festivalintconf.png" format="PNG"/>
			</imageobject>
		</imageobjectco>
		<textobject>
			<phrase
>Kõneleja seadistamine</phrase>
		</textobject>
	</mediaobjectco>
</screenshot>
</para>

<para>
<calloutlist>
<callout arearefs="pt-prop-1"
><para
>Määra siin programmi Festival käivitatava faili asukoht. Kui Festival asub keskkonnamuutujaga PATH määratud asukohas, kirjuta lihtsalt <userinput
><replaceable
>festival</replaceable
></userinput
>.</para
></callout>
<callout arearefs="pt-prop-2"
><para
>Klõpsa siia saadaolevate häälte otsimiseks.</para
></callout>
<callout arearefs="pt-prop-3"
><para
>Vali hääl.</para
></callout>
<callout arearefs="pt-prop-4"
><para
>Vali Festivalile saadetava teksti kodeering. Häälte korral, mida &ktts; tunneb, valitakse see automaatselt. Üldiselt kasutavad lääneriikide keeled kodeeringut ISO-8859-1, Ida-Euroopa keeled, näiteks tšehhi ja slovaki keel, aga kodeeringut ISO-8859-2. Eesti keele puhul peaks kodeering olema UTF-8.</para
></callout>
<callout arearefs="pt-prop-5"
><para
>Klõpsa siia testimiseks. Peaksid kuulma testlauset.</para
></callout>
<callout arearefs="pt-prop-6"
><para
>Siin saab määrata kõnesünteesi helitugevuse, kõne kiiruse ja tooni. Kui mõni neist ei ole aktiivne (on halli värvi), ei toeta antud hääl selle omaduse muutmist.</para
></callout>
<callout arearefs="pt-prop-7"
><para
>Mõned hääled, eriti MultiSyn-hääled, on nii mahukad, et nõuavad laadimiseks mitu sekundit. Selle kasti märkimisel laetakse need kohe KTTSD käivitamisel, mis säästab aega (kuigi kulutab enam mälu) esimese kõneldava lause sünteesil.</para
></callout>
</calloutlist>
</para>

<para
>Klõpsuga nupule <guibutton
>OK</guibutton
> saab salvestada kõneleja seadistused.</para>

<warning
><para
>Klõpsa kindlasti nupule <guibutton
>Rakenda</guibutton
>, muidu ei kasutata tehtud muudatusi töötavas &ktts; süsteemis. </para
></warning>

<para
>Kui test õnnestus, on &ktts; peaaegu kasutamisvalmis. Mine nüüd kaardile <guilabel
>Üldine</guilabel
> ja märgi ära valik <guilabel
>Teksti kõneks muutmise süsteemi (KTTSD) lubamine</guilabel
>. See käivitab &kde; TTS-deemoni. Vaata <xref linkend="general"/>. Seejärel võid kasutada &ktts;-i teksti kõnelemiseks. Kaardil <guilabel
>Tööd</guilabel
> saad tekstitöid luua ja hallata. Vaata <xref linkend="jobmgr"/>. </para>

</sect1>

<!-- ...................................................................... -->


<sect1 id="general">
<title
>KTTSD käivitamine ja üldised valikud</title>

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

<para>
	<screenshot>
		<screeninfo
>&kde; teksti kõneks muutmise haldur (kaart Üldine).</screeninfo>
		<mediaobjectco>
			<imageobjectco>
				<areaspec units="calspair">
					<area id="pt-gen-1" coords="1 1"/>
					<area id="pt-gen-2" coords="1 1"/>
					<area id="pt-gen-3" coords="1 1"/>
					<area id="pt-gen-4" coords="1 1"/>
                    <area id="pt-gen-5" coords="1 1"/>
                    <area id="pt-gen-6" coords="1 1"/>
				</areaspec>
				<imageobject>
					<imagedata fileref="general.png" format="PNG"/>
				</imageobject>
			</imageobjectco>
			<textobject>
				<phrase
>&kde; teksti kõneks muutmise haldur (kaart Üldine)</phrase>
			</textobject>
		</mediaobjectco>
	</screenshot>
</para>

<para>
<calloutlist>
<callout arearefs="pt-gen-1"
><para
>Seda kasti märkides saab aktiveerida &ktts; süsteemi. See käivitab &kde; TTS-deemoni (KTTSD). KTTSD edukal käivitamisel ilmub nähtavale kaart <guilabel
>Tööd</guilabel
>. Kui KTTSD on käivitatud, saad hakata tekstitöid looma ja teksti kõnelema. Vaata <xref linkend="jobmgr"/>. Kastist märke eemaldamine peatab KTTSD ja lülitab &kde; TTS-süsteemi välja. <note
><para
>Kui see kast ei ole märgitud, ei ole sa veel määranud ühtegi kõnelejat (või oled unustanud klõpsata nupule <guilabel
>Rakenda</guilabel
>). Vaata <xref linkend="configure-plugin"/>.</para
></note>
</para
></callout>
<callout arearefs="pt-gen-2"
><para
>Selle kasti märkimisel ilmub <command
>kttsmgr</command
> käivitamisel ikoon süsteemsesse salve. Selle korral ei põhjusta klõps nupule <guibutton
>OK</guibutton
> või <guibutton
>Loobu</guibutton
> veel <command
>kttsmgr</command
> töö lõpetamist. Dialoog küll kaob, kuid <command
>kttsmgr</command
> jätkab tööd süsteemses salves. Klõpsuga ikoonile saab dialoogi taas nähtavaks muuta. <command
>kttsmgr</command
> töö lõpetamiseks klõpsa hiire parema nupuga süsteemse salve ikoonil ja vali <guilabel
>Välju</guilabel
>. Kui kast on märkimata, ei näidata süsteemses salves ikooni. Klõps nupule <guibutton
>OK</guibutton
> või <guibutton
>Loobu</guibutton
> lõpetab ühtlasi <command
>kttsmgr</command
> töö. <note
><para
>Kui <command
>kttsmgr</command
> lõpetab töö, jääb &ktts; ometi tööle, kui ära on märgitud kast <guilabel
>Teksti kõneks muutmise süsteemi (KTTSD) lubamine</guilabel
>.</para
></note>
<note
><para
>See valik rakendub alles <command
>kttsmgr</command
> järgmisel käivitamisel.</para
></note>
<note
><para
>Sel valikul pole mõju, kui <command
>kttsmgr</command
> on tööle pandud &juhtimiskeskus;es.</para
></note>
</para
></callout>
<callout arearefs="pt-gen-3"
><para
>Selle kasti märkimisel ilmub alati <command
>kttsmgr</command
> dialoog, kui käivitad <command
>kttsmgr</command
>. Kui see on märkimata, ilmub <command
>kttsmgr</command
> ikoon süsteemses salves, kui käivitad <command
>kttsmgr</command
>, aga dialoogi ei näidata. Klõps süsteemse salve ikoonile toob dialoogi nähtavale.</para
></callout>
<callout arearefs="pt-gen-4"
><para
>Selle kasti märkimisel ilmub juhul, kui <command
>kttsmgr</command
> veel ei tööta, see iga kord süsteemsesse salve, kui KTTSD asub kõnelema. See annab sulle võimaluse kõnelemine peatada või seda hallata.</para
></callout>
<callout arearefs="pt-gen-5"
><para
>Selle kasti märkimisel kaob juhul, kui <command
>kttsmgr</command
> ilmub kõnelemisel alati automaatselt süsteemsesse salve, ikoon sealt samuti automaatselt pärast kõnelemise lõpetamist.</para
></callout>
<callout arearefs="pt-gen-6"
><para
>Klõpsa kindlasti siia, kui soovid oma seadistusi salvestada.</para
></callout>
</calloutlist>
</para>

</sect1>

<!-- ...................................................................... -->


<sect1 id="jobmgr">
<title
>Tekstitööde haldamine</title>

<para
>Klõpsuga sakile <guilabel
>Tööd</guilabel
> <command
>kttsmgr</command
> dialoogis ilmub nähtavale kaart <guilabel
>Tööd</guilabel
>.</para>

<para>
<screenshot>
<screeninfo
>&kde; teksti kõneks muutmise haldur (kaart Tööd).</screeninfo>
	<mediaobjectco>
		<imageobjectco>
			<areaspec units="calspair">
				<area id="pt-jobmgr-1" coords="1 1"/>
				<area id="pt-jobmgr-2" coords="1 1"/>
				<area id="pt-jobmgr-3" coords="1 1"/>
				<area id="pt-jobmgr-4" coords="1 1"/>
				<area id="pt-jobmgr-5" coords="1 1"/>
				<area id="pt-jobmgr-6" coords="1 1"/>
				<area id="pt-jobmgr-7" coords="1 1"/>
			</areaspec>
			<imageobject>
				<imagedata fileref="jobs.png" format="PNG"/>
			</imageobject>
		</imageobjectco>
		<textobject>
			<phrase
>&kde; teksti kõneks muutmise haldur (kaart Tööd)</phrase>
		</textobject>
	</mediaobjectco>
</screenshot>
</para>

<para>
<calloutlist>
<callout arearefs="pt-jobmgr-1"
><para
>Siin on kirjas kõik parajasti järjekorras olevad tekstitööd. Ühtlasi on näha töö järjekorda seadnud rakendus, töö kehtiv olek, lausete arv töös ja aktiivse lause järjekorranumber. <guilabel
>Kõneleja ID</guilabel
> vastab kaardi <guilabel
>Kõnelejad</guilabel
> veerule <guilabel
>ID</guilabel
>. </para
></callout>
<callout arearefs="pt-jobmgr-2"
><para
>Selle rea nuppudega saab tekstitöid käivitada, kustutada ja peatada. Vali allolevast nimekirjast töö ja kasuta siis vajalikku nuppu.</para
></callout>
<callout arearefs="pt-jobmgr-3"
><para
>Selle rea nuppudega saab nimekirjast valitud tekstitöös lausekaupa edasi või tagasi liikuda (arvesta, et mitte kõigil töödel pole osasid).</para
></callout>
<callout arearefs="pt-jobmgr-4"
><para
>Selle rea nuppudega saab kõnelda parajasti &kde; lõikepuhvris olevat teksti või avada tekstifaili, mida soovid lasta kõnelda. Samuti saab siin tekstitööde nimekirja värskendada. Vaata <xref linkend="selecttalker"/>.</para
></callout>
<callout arearefs="pt-jobmgr-5"
><para
>Siin on näha parajasti kõneldav lause.</para
></callout>
<callout arearefs="pt-jobmgr-6"
><para
>Klõpsuga nupule <guibutton
>OK</guibutton
> rakendatakse kõik muudatused dialoogi muude kaartide seadistustes (kui neid on) ning <command
>kttsmgr</command
> minimeeritakse süsteemsesse salve. Klõpsuga süsteemse salve ikoonil saab dialoogi taas nähtavale tuua.</para
></callout>
<callout arearefs="pt-jobmgr-7"
><para
>Eraldajat hiirega lohistades saab muuta tööde nimekirja ja paneeli <guilabel
>Praegune lause</guilabel
> suurust.</para
></callout>
</calloutlist>
</para>

<note
><para
>Kaart <guilabel
>Tööd</guilabel
> on näha ainult siis, kui KTTSD töötab. Kui sa ei näe kaarti <guilabel
>Tööd</guilabel
>, vali kaart <guilabel
>Üldine</guilabel
> ja märgi ära kast <guilabel
>Teksti kõneks muutmise süsteemi (KTTSD) lubamine</guilabel
>.</para>
</note>

<note
><para
>Kui sul ei ole paigaldatud &arts;i audioalamsüsteemi, vaid ALSA, GStreamer või aKode, klõpsa kaardile <guilabel
>Audio</guilabel
>. Vaata <xref linkend="audio"/>.</para
></note>

<note
><para
>Sellel kaardil saab näha ja juhtida ainult tekstitöid. Ekraanilugeja väljundit, hoiatusi ja teateid siin ei näidata. Rohkem infot &ktts; sõnumite tüüpide kohta annab <xref linkend="filters"/>.</para
></note>

</sect1>

<!-- ...................................................................... -->

<sect1 id="audio">
<title
>Heliseadistused</title>

<para
>Klõpsuga sakile <guilabel
>Audio</guilabel
> <command
>kttsmgr</command
> dialoogis ilmub nähtavale kaart <guilabel
>Audio</guilabel
>.</para>

<para>
    <screenshot>
        <screeninfo
>&kde; teksti kõneks muutmise haldur (kaart Audio).</screeninfo>
        <mediaobjectco>
            <imageobjectco>
                <areaspec units="calspair">
                    <area id="pt-audio-1" coords="1 1"/>
                    <area id="pt-audio-2" coords="1 1"/>
                    <area id="pt-audio-3" coords="1 1"/>
                    <area id="pt-audio-4" coords="1 1"/>
                    <area id="pt-audio-5" coords="1 1"/>
                </areaspec>
                <imageobject>
                    <imagedata fileref="audio.png" format="PNG"/>
                </imageobject>
            </imageobjectco>
            <textobject>
                <phrase
>&kde; teksti kõneks muutmise haldur (kaart Audio)</phrase>
            </textobject>
        </mediaobjectco>
    </screenshot>
</para>

<para>
<calloutlist>
<callout arearefs="pt-audio-1"
><para
>Vali siin heliväljundi meetod. Kui mõni komponent ei ole kasutatav, tähendab see, et &ktts; on kompileeritud ilma vastava audioplugina toetuseta või ei suuda &ktts; laadida vajalikke teeke. </para
></callout>
<callout arearefs="pt-audio-2"
><para
>Kui heliväljundiks on valitud GStreamer või aKode, vali siin audioneelu meetod. Kui ühtegi neelu ei ole näha, tuleb vähemalt üks paigaldada. Kui valitud on ALSA, vali siin PCM seade. Vaata <xref linkend="requirements"/>. </para
></callout>
<callout arearefs="pt-audio-3"
><para
>Siin saab reguleerida kõnelemise kiirust. 50% on umbes kaks korda aeglasem tavalisest kiirusest, 200% aga umbes kaks korda kiirem. Selle seadistamiseks peab olema paigaldatud utiliit <command
>sox</command
>. </para
></callout>
<callout arearefs="pt-audio-4"
><para
>Selle kasti märkimisel kopeerib &ktts; ajutised helifailid (.wav-failid) määratud kataloogi. Valida võib suvalise kataloogi kõvakettal, aga sul peab olema selles kirjutamisõigus. See on kasulik näiteks kõnefailide loomisel, mida saab hiljem millekski muuks tarvitada. Failidele antakse nimi kujul <filename
>kttsd-J-SS</filename
>, kus <filename
>J</filename
> on tekstitöö ja <filename
>SS</filename
> lause järjekorranumber. Samanimelised varasemad failid kirjutatakse üle. <emphasis
>Ära unusta pärast vajaduse möödumist sellest kastist märget eemaldamast, muidu võib su kõvakettal peagi ruum otsa lõppeda!</emphasis
> </para
></callout>
<callout arearefs="pt-audio-5"
><para
>Klõpsa kindlasti nupule <guibutton
>Rakenda</guibutton
>, kui soovid uusi seadistusi kasutada töötavas &ktts; süsteemis. </para
></callout>
</calloutlist>
</para>

<note
><para
>&ktts; võimaldab kõnelemise kiirust muuta kahel moel: paljudel <guilabel
>kõneleja</guilabel
>tel on seadistustedialoogis valik <guilabel
>Kiirus</guilabel
> (selle dialoogi saab avada, kui klõpsata kaardil <guilabel
>Kõnelejad</guilabel
> nupule <guibutton
>Muuda</guibutton
>). Valik <guilabel
>Kiirus</guilabel
> kaardil <guilabel
>Audio</guilabel
> on täienduseks kõnelejate kiiruseseadistusele ja mõeldud ennekõike juhuks, kui kõneleja ei toeta kiiruse määramist. Selle valiku kasutamiseks peab süsteemi olema paigaldatud utiliit <command
>sox</command
> (Debiani kasutajatele: <command
>apt-get install sox</command
>). Samuti ei arvestata seda, kui kõneldakse SSML-i sisaldavat teksti (vaata <xref linkend="ssml"/>).</para
></note>

<note
><para
>ALSA seadmete nimekirjas on ära toodud kõik ALSA PCM seadmed ja pluginad, mis on süsteemis seadistatud. Paljud valikud arvatavasti ei toimi, mistõttu sul tuleb katsetada, milline seade korralikult töötab. Kui sa ei ole kindel, vali <guilabel
>vaikimisi</guilabel
>.</para
></note>

</sect1>

<!-- ...................................................................... -->

<sect1 id="interruption">
<title
>Tekstikatkestuse seadistamine</title>

<para
>Klõpsuga sakile <guilabel
>Tekstikatkestus</guilabel
> <command
>kttsmgr</command
> dialoogis avaneb kaart <guilabel
>Tekstikatkestus</guilabel
>.</para>

<para>
<screenshot>
<screeninfo
>&kde; teksti kõneks muutmise haldur (kaart Tekstikatkestus).</screeninfo>
	<mediaobjectco>
		<imageobjectco>
			<areaspec units="calspair">
				<area id="pt-interruption-1" coords="1 1"/>
				<area id="pt-interruption-2" coords="1 1"/>
				<area id="pt-interruption-3" coords="1 1"/>
				<area id="pt-interruption-4" coords="1 1"/>
			</areaspec>
			<imageobject>
				<imagedata fileref="interruption.png" format="PNG"/>
			</imageobject>
		</imageobjectco>
		<textobject>
			<phrase
>&kde; teksti kõneks muutmise haldur (kaart Tekstikatkestus)</phrase>
		</textobject>
	</mediaobjectco>
</screenshot>
</para>

<para
>Sellel kaardil saab määrata toimingud, mis võetakse ette siis, kui tekstitöö katkestab mõni suurema prioriteediga teade. &ktts; tegeleb nelja liiki kõnetöödega: <itemizedlist>
<listitem
><para
>Tavaline tekst</para
></listitem>
<listitem
><para
>Teated</para
></listitem>
<listitem
><para
>Hoiatused</para
></listitem>
<listitem
><para
>Ekraanilugeja väljund</para
></listitem>
</itemizedlist>
</para>

<para
>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. </para>

<para
>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.</para>

<para
>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 segada ja tervitada kedagi, kes tuppa astub.</para>

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

<para
>Kui tekstitööd katkestab teade, hoiatus või ekraanilugeja väljund, lisab &ktts; antud ekraani audioväljundi voole.</para>

<para>
<calloutlist>
<callout arearefs="pt-interruption-1"
><para
>See sõnum kõneldakse siis, kui tavalise teksti kõnelemine katkestatakse.</para
></callout>
<callout arearefs="pt-interruption-2"
><para
>See helifail esitatakse siis, kui tavalise teksti kõnelemine katkestatakse. Kui määratud on nii <guilabel
>eelheli</guilabel
> kui ka <guilabel
>eelsõnum</guilabel
>, kõlab <guilabel
>eelheli</guilabel
> enne <guilabel
>eelsõnum</guilabel
>it.</para
></callout>
<callout arearefs="pt-interruption-3"
><para
>See sõnum kõneldakse siis, kui tavalise teksti katkestus lõpeb.</para
></callout>
<callout arearefs="pt-interruption-4"
><para
>See helifail esitatakse siis, kui tavalise teksti katkestus lõpeb. See esitatakse viimasena.</para
></callout>
</calloutlist>
</para>

<note
><para
>Selle dialoogi seadistused kehtivad ainult tavalise teksti kõnelemisel. Teadetel, hoiatustel ja ekraanilugeja väljundil ei ole eritoiminguid, kui neid katkestab suurema prioriteediga sõnum.</para
></note>

</sect1>

<!-- ...................................................................... -->


<sect1 id="web">
<title
>Veebilehekülgede teksti kõnelemine</title>

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

<tip
><para
>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.</para
></tip>

</sect1>

<!-- ...................................................................... -->


<sect1 id="kate">
<title
>Teksti kõnelemine tekstiredaktoris &kate;</title>

<para
>&kde; võimsa tekstiredaktori &kate; kasutamisel võib lasta kõnelda näidatavat teksti. Kõigepealt kontrolli, et &ktts; töötab. Vali tekst, mida soovid lasta kõnelda, ning seejärel menüükäsk <menuchoice
><guisubmenu
>Tööriistad</guisubmenu
> <guisubmenu
>Kõnele teksti</guisubmenu
></menuchoice
>. <action
>Hetke pärast peaksid kuulma, kuidas valitud teksti kõneldakse.</action
> </para>

<tip
><para
>Teksti ei pruugi muidugi valida, sellisel juhul kõneldakse kogu avatud fail.</para
></tip>

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

</sect1>

<!-- ...................................................................... -->

<sect1 id="knotify">
<title
>Märguannete kõnelemine (KNotify)</title>

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

<para
>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. &ktts; abil võid lasta &kde;-l ka terve vastava IRC sõnumi ette lugeda.</para>

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

<para
>Kui soovid, et &ktts; kõneleks KNotify tekstimärguandeid, käivita <command
>kttsmgr</command
> ja klõpsa sakile <guilabel
>Märguanded</guilabel
>. Ilmub kaart <guilabel
>Märguanded</guilabel
>.</para>

<para>
<screenshot>
<screeninfo
>&kde; teksti kõneks muutmise haldur (kaart Märguanded).</screeninfo>
	<mediaobjectco>
		<imageobjectco>
			<areaspec units="calspair">
				<area id="pt-notify-1" coords="1 1"/>
				<area id="pt-notify-2" coords="1 1"/>
				<area id="pt-notify-3" coords="1 1"/>
				<area id="pt-notify-4" coords="1 1"/>
				<area id="pt-notify-5" coords="1 1"/>
				<area id="pt-notify-6" coords="1 1"/>
				<area id="pt-notify-7" coords="1 1"/>
				<area id="pt-notify-8" coords="1 1"/>
				<area id="pt-notify-9" coords="1 1"/>
				<area id="pt-notify-10" coords="1 1"/>
			</areaspec>
			<imageobject>
				<imagedata fileref="notifications.png" format="PNG"/>
			</imageobject>
		</imageobjectco>
		<textobject>
			<phrase
>&kde; teksti kõneks muutmise haldur (kaart Märguanded)</phrase>
		</textobject>
	</mediaobjectco>
</screenshot>
</para>

<para>
<calloutlist>
<callout arearefs="pt-notify-1"
><para
>Selle kasti märkimisel saab lubada &kde; märguannete kõnelemise. Kui see on märkimata, ei saa dialoogis ka midagi muud seadistada ning &ktts; ei kõnele märguandeid.</para
></callout>
<callout arearefs="pt-notify-2"
><para
>Selle märkimisel ei kõnele &ktts; heliga sündmusi, mida rakendused saadavad.</para
></callout>
<callout arearefs="pt-notify-3"
><para
>Nende nuppudega saab allolevasse nimekirja rakenduse sündmusi lisada või neid sealt kustutada. Klõpsuga nupule <guibutton
>Lisa</guibutton
> ilmub dialoog, kus saad valida rakenduse ja sündmuse, mida nimekirja lisada. </para
></callout>
<callout arearefs="pt-notify-4"
><para
>See sündmus kõneleb teadet, mida &konversation; saadab, kui keegi mainib sinu hüüdnime oma sõnumis. </para
></callout>
<callout arearefs="pt-notify-5"
><para
>Kõigi muude &konversation;i sündmuste korral ei võta &ktts; midagi ette.</para
></callout>
<callout arearefs="pt-notify-6"
><para
>Kõigi sündmuste korral, mida nimekirjas ei leidu, ei võta &ktts; midagi ette.</para
></callout>
<callout arearefs="pt-notify-7"
><para
>Selle kastiga saab määrata, mida &ktts; sündmuse saabumisel ette võtab. Valikud on järgmised:</para>
<para>
<variablelist>
<varlistentry>
<term
>Sündmuse nime kõnelemine</term>
<listitem
><para
>Kõneldakse sündmuse nimi ehk see, mida näed sündmuste nimekirjas kirjapanduna.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Märguande sõnumi kõnelemine</term>
<listitem
><para
>Kõneldakse sõnum, mida rakendus on saatnud.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Märguannet ei kõnelda</term>
<listitem
><para
>Sündmust ei kõnelda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>Kohandatud teksti kõnelemine</term>
<listitem
><para
>Kõneldakse tekst, mida saad sisestada paremal asuvasse kasti.</para
></listitem>
</varlistentry>
</variablelist>
</para>
</callout>
<callout arearefs="pt-notify-8"
><para
>Kui toiminguks on <guilabel
>Kohandatud teksti kõnelemine</guilabel
>, sisesta siia kasti sõnum, mida soovid lasta kõnelda. Selles võib kasutada järgmisi kohatäitjaid:</para>
<para>
<variablelist>
<varlistentry>
<term
>%e</term>
<listitem
><para
>Sündmuse nimi</para
></listitem>
</varlistentry>
<varlistentry>
<term
>%a</term>
<listitem
><para
>Sündmuse saatnud rakenduse nimi</para
></listitem>
</varlistentry>
<varlistentry>
<term
>%m</term>
<listitem
><para
>Rakenduse saadetud sõnum</para
></listitem>
</varlistentry>
</variablelist>
</para>
</callout>
<callout arearefs="pt-notify-9"
><para
>Siia klõpsates saab sõnumit testida.</para
></callout>
<callout arearefs="pt-notify-10"
><para
>Siin saab määrata selle kõneleja atribuudid, mida soovid märguannete kõnelemiseks kasutada. Valiku <command
><userinput
>vaikimisi</userinput
></command
> korral kasutatakse kõnelejat, mis seisab kaardi <guilabel
>Kõnelejad</guilabel
> nimekirjas esikohal. Vaata <xref linkend="selecttalker"/>. </para
></callout>
</calloutlist>
</para>

<para
>Pane tähele, et sündmustel on kolm tasandit. Kui konkreetsele sündmusele või rakendusele on määratud mingi toiming, võetakse see ka ette. Kui määratud on toiming konkreetse rakenduse kõigile muudele sündmustele, võetakse ette määratud toiming. Ülejäänud juhtudel võetakse ette toiming, mis on määratud kõigile muudele sündmustele valikuga <guilabel
>Vaikimisi (kõik muud sündmused)</guilabel
>.</para>

<para
>Sündmust <guilabel
>kõik märguanded</guilabel
> rakendusele <guilabel
>Vaikimisi (kõik muud sündmused)</guilabel
> ei saa nimekirjast kustutada. Kõigi muude sündmuste vaikeväärtuseks võib määrata kõneldavate märguannete tüübi järgmiselt:</para>

<variablelist>
<varlistentry>
<term
>puudub</term>
<listitem
><para
>Midagi ei kõnelda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>märguannete dialoogid</term>
<listitem
><para
>Kõneldakse märguanded, mis näitavad ekraanil dialoogi, mis sul tuleb sulgeda.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>passiivsed hüpikaknad</term>
<listitem
><para
>Kõneldakse märguanded, mis näitavad ekraanil dialoogi, mis mõne hetke pärast automaatselt kaob.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>märguannete dialoogid ja passiivsed hüpikaknad</term>
<listitem
><para
>Kõneldakse nii passiivseid kui mittepassiivseid ekraanil näidatavaid märguandeid.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>kõik märguanded</term>
<listitem
><para
>Kõneldakse kõik märguanded sõltumata sellest, kas neid ekraanil näidatakse või mitte.</para
></listitem>
</varlistentry>
</variablelist>

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

<para
>Nupule <guibutton
>Salvesta</guibutton
> klõpsates saab märguannetega seotud seadistused failina salvestada. Nupule <guibutton
>Laadi</guibutton
> klõpsates saab laadida faili salvestatud seadistused. Laaditud sündmused liidetakse nimekirjas leiduvate sündmustega. Kui soovid alustada tühja sündmuste nimekirjaga, klõpsa nupule <guibutton
>Puhasta</guibutton
>. See eemaldab kõik sündmused, välja arvatud <guilabel
>kõik märguanded</guilabel
>.</para>

<note
><para
>Seadistuste salvestamiseks klõpsa kindlasti nupule <guibutton
>Rakenda</guibutton
> või <guibutton
>OK</guibutton
>.</para
></note>

</sect1>

<!-- ...................................................................... -->

<sect1 id="ssml">
<title
>SSML</title>

<para
>Kõnesünteesi märkekeel (Speech Synthesis Markup Language, SSML) on W3C standard kõneväljundi teksti ülestähendamiseks. See kasutab silte häälte, kõnekiiruse, helitugevuse, kõneleja soo ja tooni juhtimiseks. Siltidega saab ka määrata sõnade kõnelemist, näiteks lühendite hääldust. SSML on osa VoiceXML-i spetsifikatsioonist, mis on samuti W3C standard.</para>

<para
>Hetkel pakub &ktts; üsna piiratud elementaarset SSML-i toetust. Sellel on järgmised piirangud.</para>

<itemizedlist>
<listitem
><para
>Toimib ainult Festival Interactive'i ja Hadifixi kõnelejatega.</para
></listitem>
<listitem
><para
>Paigaldada tuleb <command
>rab_diphone</command
> (briti mehe) hääl, mis on Festivali vaikehääl SSML-i kõnelemisel.</para
></listitem>
<listitem
><para
><guilabel
>Kiirus</guilabel
>e valikut kaardil <guilabel
>Audio</guilabel
> ignoreeritakse SSML-i sisaldava teksti kõnelemisel.</para
></listitem>
<listitem
><para
>Kui Festivali seadistustedialoogis pole <guilabel
>kiirus</guilabel
> või <guilabel
>toon</guilabel
> määratud 100% peale, kõneldakse SSML-tekst tavaliselt täiesti monotoonselt.</para
></listitem>
</itemizedlist>

<para
>Järgnevat (ingliskeelset) näiteteksti võib pruukida SSML-i katsetamiseks.</para>

<programlisting
><![CDATA[
<?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>
]]></programlisting>

<para
>&ktts; järgmises versioonis peaks SSML-i toetus olema juba palju parem ja korralikum. </para>

</sect1>

<!-- ...................................................................... -->

<sect1 id="filters">
<title
>Filtrid</title>

<para
>Filtrid kujutavad endast &ktts; võimsat lisaomadust. &ktts; lihtsamate, tavaliste operatsioonide jaoks ei ole filtreid vaja.</para>

<para
>Filtreid kasutatakse tekst eeltöötluseks enne selle saatmist kõnesünteesi mootorile. 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.</para>

<!-- ...................................................................... -->

<sect2 id="msg-types">
<title
>&ktts; teadete tüübid</title>

<para
>Filtrite kasutamiseks tuleks kõigepealt üritada mõista, kuidas &ktts; teksti töötleb. &ktts; kõneldav tekst võib olla nelja liiki.</para>

<para>
<itemizedlist>
<listitem
><para
>Ekraanilugeja väljund</para
></listitem>
<listitem
><para
>Hoiatused</para
></listitem>
<listitem
><para
>Teated</para
></listitem>
<listitem
><para
>Tekstitööd</para
></listitem>
</itemizedlist>
</para>

<para
>Tüübi määrab rakendus, mis saadab teksti &ktts;-ile.</para>

<para
>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. </para>

<para
>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.</para>

<para
>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 <xref linkend="knotify"/>).</para>

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

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

</sect2>

<!-- ...................................................................... -->

<sect2 id="filter-types">
<title
>Filtrite tüübid</title>

<para
>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.</para>

<para
>Filtreid on kaht tüüpi: tavalised filtrid ja lausepiiri tuvastamise (SBD) filtrid. SBD-filtrid jagavad teksti üksiklauseteks. See võimaldab &ktts;-il kiiremini kõnelda, sest vaja on sünteesida ainult esimene lause, mitte aga kogu tekstitöö. See võimaldab ka kaardil <guilabel
>Tööd</guilabel
> lausekaupa edasi või tagasi liikuda või tekstitöid peatada või katkestada isegi siis, kui kõnesüntesaator ei toeta otseselt kõne peatamist. </para>

<para
>Tavalised filtrid töötlevad teksti ja saadavad selle edasi järgmisele filtrile. Praegu on olemas kolme liiki tavalisi filtreid. </para>

<para>
<itemizedlist>
<listitem
><para
>Stringiasendajad</para
></listitem>
<listitem
><para
>&XML;-i transformeerijad</para
></listitem>
<listitem
><para
>Kõneleja valijad</para
></listitem>
</itemizedlist>
</para>

<note
><para
>Filtrid on kasutusel pluginaarhitektuuri vahendusel. Tulevikus võib filtreid juurde tekkida.</para
></note>

<para
>Stringiasendusfiltrid asendavad tekstiosa mingi muu tekstiga. Asendatavad osad peavad sobima määratud sõnadele või regulaaravaldistele. &ktts; 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. </para>

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

<para
>Kõneleja valijad võimaldavad suunata töid kõnelejale vastavalt teksti sisule või rakendusele, mis töö &ktts;-ile saadab. Kui oled näiteks määratud kaardil <guilabel
>Kõnelejad</guilabel
> naishäälega kõneleja, võid suunata KSayIt saadetud teksti just sellele kõnelejale. Vaata <xref linkend="configure-plugin"/>. </para>

<para
>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.</para>

<para
>Tekstitöö, teate, hoiatuse või &kde; märguande saatmisel &ktts;-ile läbib see kõik seadistatud ja sisselülitatud filtrid, mida allpool lähemalt tutvustame. Filtreid rakendatakse nii, nagu nad nimekirjas esinevad - ülalt alla. Pärast kõigi tavaliste filtrite läbimist, mida näeb dialoogi ülaosas, edastatakse tekstitööd <guilabel
>lausepiiri tuvastamise</guilabel
> (SBD) filtritele (&kde; märguanded, hoiatused ja teated SBD-filtreid ei läbi). Erinevalt tavalistest filtritest peatab esimene SBD-filter, mis teksti muudab, selle edasise töötlemise. </para>

</sect2>

<!-- ...................................................................... -->

<sect2 id="configure-filters">
<title
>Filtrite seadistamine</title>

<para
>Filtrite kasutamiseks klõpsa <command
>kttsmgr</command
> dialoogis kaardile <guilabel
>Filtrid</guilabel
>.</para>

<para>
    <screenshot>
        <screeninfo
>&kde; teksti kõneks muutmise haldur (kaart Filtrid).</screeninfo>
        <mediaobjectco>
            <imageobjectco>
                <areaspec units="calspair">
                    <area id="pt-filters-1" coords="1 1"/>
                    <area id="pt-filters-2" coords="1 1"/>
                    <area id="pt-filters-3" coords="1 1"/>
                    <area id="pt-filters-4" coords="1 1"/>
                    <area id="pt-filters-5" coords="1 1"/>
                    <area id="pt-filters-6" coords="1 1"/>
                    <area id="pt-filters-7" coords="1 1"/>
                    <area id="pt-filters-8" coords="1 1"/>
                </areaspec>
                <imageobject>
                    <imagedata fileref="filters.png" format="PNG"/>
                </imageobject>
            </imageobjectco>
            <textobject>
                <phrase
>&kde; teksti kõneks muutmise haldur (kaart Filtrid)</phrase>
            </textobject>
        </mediaobjectco>
    </screenshot>
</para>

<para>
<calloutlist>
<callout arearefs="pt-filters-1"
><para
>See on seadistatud tavaliste filtrite nimekiri. Märkimatajätmisel ei lülitata filtrit sisse ega lisata filtriahelasse. Filtrid rakendatakse siintoodud järjekorras ülalt alla.</para
></callout>
<callout arearefs="pt-filters-2"
><para
>Klõpsa siia uue filtri lisamiseks. Sinu käest päritakse, millist liiki filter lisada. Kui oled liigi valinud, näed üht alltoodud seadistustedialoogidest.</para
></callout>
<callout arearefs="pt-filters-3"
><para
>Klõpsa siia filtri eemaldamiseks.</para
></callout>
<callout arearefs="pt-filters-4"
><para
>Klõpsa siia filtri seadistamiseks. Selle peale avaneb vastavalt filtrile mõni alltoodud seadistustedialoogidest.</para
></callout>
<callout arearefs="pt-filters-5"
><para
>Klõpsa neile nuppudele filtri liigutamiseks nimekirjas üles- või allapoole.</para
></callout>
<callout arearefs="pt-filters-6"
><para
>Need on sõnapiiri tuvastamise filtrid. &ktts; esmakäivitusel seadistatakse sinu eest automaatselt standardne sõnapiiri tuvastaja. Sul on võimalik muuta selle seadistusi või lisada täiendavaid sõnapiiri tuvastajaid, kuid eriti algajatel ei ole soovitatav seda ette võtta.</para
></callout>
<callout arearefs="pt-filters-7"
><para
>See hüpikmenüüga nupp võimaldab sõnapiiri tuvastamise filtreid lisada, eemaldada, muuta või nende järjekorda muuta.</para
></callout>
<callout arearefs="pt-filters-8"
><para
>Klõpsa kindlasti siia, muidu sinu seadistusi ei rakendata.</para
></callout>
</calloutlist>
</para>

</sect2>

<!-- ...................................................................... -->

<sect2 id="stringreplacer">
<title
>Stringiasendusfiltrite seadistamine</title>

<para
>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. Sobivuse leidmine arvestab tõstuga ehk tähesuurusega.</para>

<para>
    <screenshot>
        <screeninfo
>Stringiasendaja</screeninfo>
        <mediaobjectco>
            <imageobjectco>
                <areaspec units="calspair">
                    <area id="pt-stringreplacer-1" coords="1 1"/>
                    <area id="pt-stringreplacer-2" coords="1 1"/>
                    <area id="pt-stringreplacer-3" coords="1 1"/>
                    <area id="pt-stringreplacer-4" coords="1 1"/>
                    <area id="pt-stringreplacer-5" coords="1 1"/>
                    <area id="pt-stringreplacer-6" coords="1 1"/>
                    <area id="pt-stringreplacer-7" coords="1 1"/>
                    <area id="pt-stringreplacer-8" coords="1 1"/>
                    <area id="pt-stringreplacer-9" coords="1 1"/>
                </areaspec>
                <imageobject>
                    <imagedata fileref="stringreplacer.png" format="PNG"/>
                </imageobject>
            </imageobjectco>
            <textobject>
                <phrase
>Stringiasendaja</phrase>
            </textobject>
        </mediaobjectco>
    </screenshot>
</para>

<para>
<calloutlist>
<callout arearefs="pt-stringreplacer-1"
><para
>Määra siin filtri nimi. See võib olla milline tahes, seda kasutatakse selleks, et sa ise suudaksid üht filtrit teisest eristada.</para
></callout>
<callout arearefs="pt-stringreplacer-2"
><para
>See on sõnade ja regulaaravaldiste nimekiri. Filter otsib kõigi veerus <guilabel
>Sobivus</guilabel
> antud stringide vasteid ja leidmisel asendab need stringiga veerust <guilabel
>Asendus</guilabel
>. Nimekiri läbitakse vastavalt kirjete järjekorrale ülalt alla.</para
></callout>
<callout arearefs="pt-stringreplacer-3"
><para
>Klõpsa siia sõna või regulaaravaldise lisamiseks nimekirja.</para
></callout>
<callout arearefs="pt-stringreplacer-4"
><para
>Klõpsa siia parajasti valitud sõna või regulaaravaldise liigutamiseks nimekirjas üles- või allapoole.</para
></callout>
<callout arearefs="pt-stringreplacer-5"
><para
>Klõpsa siia nimekirjas oleva sõna või regulaaravaldise muutmiseks.</para
></callout>
<callout arearefs="pt-stringreplacer-6"
><para
>Klõpsa siia parajasti valitud sõna või regulaaravaldise eemaldamiseks nimekirjast.</para
></callout>
<callout arearefs="pt-stringreplacer-7"
><para
>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.</para
></callout>
<callout arearefs="pt-stringreplacer-8"
><para
>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 <keycap
>&Ctrl;</keycap
>.</para
></callout>
<callout arearefs="pt-stringreplacer-9"
><para
>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 <command
><userinput
>konversation,kmail</userinput
></command
>.</para>
<tip
><para
>Töötavate programmide <guilabel
>rakenduse ID</guilabel
> saab leida programmiga <command
>&kdcop;</command
>. &DCOP;-numbrid tuleb küll sel juhul välja jätta. Kui näiteks &kdcop; näitab rakenduse ID-ks <command
>kopete-3432</command
>, tuleb siin anda lihtsalt <command
><userinput
>kopete</userinput
></command
>.</para
></tip
></callout>
</calloutlist>
</para>

<para
>Stringiasendusfiltrit rakendatakse ainult juhul, kui kõik kastis <guilabel
>Filtri rakendamise tingimused</guilabel
> esinevad mittetühjad tingimused on täidetud.</para>

<para
>Kõik otsingud on tõstutundlikud.</para>

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

<para
>Pikem seletus, kuidas panna kirja regulaaravaldisi, väljub käesoleva käsiraamatu piiridest. Kui sul on paigaldatud &kde; regulaaravaldiste redaktor, on pärast nupule <guilabel
>Lisa</guilabel
> või <guilabel
>Muuda</guilabel
> ilmuvas dialoogis olemas nupp, millele klõpsates saad regulaaravaldise graafiliselt luua. &kde; regulaaravaldiste redaktor kuulub paketti <command
>kdeutils</command
>.</para>

<para
>&ktts; 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 <guibutton
>Salvesta</guibutton
> selle salvestamiseks failina ning saada see siis &ktts; meeskonnale, kes võib selle järgmise versiooniga juba kaasa panna.</para>

</sect2>

<!-- ...................................................................... -->

<sect2 id="xmltransformer">
<title
>&XML;-i transformeerimise filtrite seadistamine</title>

<para
>&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 <command
>xsltproc</command
>.</para>

<para>
    <screenshot>
        <screeninfo
>&XML;-teisendus</screeninfo>
        <mediaobjectco>
            <imageobjectco>
                <areaspec units="calspair">
                    <area id="pt-xmltransformer-1" coords="1 1"/>
                    <area id="pt-xmltransformer-2" coords="1 1"/>
                    <area id="pt-xmltransformer-3" coords="1 1"/>
                    <area id="pt-xmltransformer-4" coords="1 1"/>
                    <area id="pt-xmltransformer-5" coords="1 1"/>
                </areaspec>
                <imageobject>
                    <imagedata fileref="xmltransformer.png" format="PNG"/>
                </imageobject>
            </imageobjectco>
            <textobject>
                <phrase
>&XML;-teisendus</phrase>
            </textobject>
        </mediaobjectco>
    </screenshot>
</para>

<para>
<calloutlist>
<callout arearefs="pt-xmltransformer-1"
><para
>Määra siin filtri nimi. See võib olla milline tahes, seda kasutatakse selleks, et sa ise suudaksid üht filtrit teisest eristada.</para
></callout>
<callout arearefs="pt-xmltransformer-2"
><para
>Määra siin XSLT-faili täielik asukoht, mida soovid kasutada teisendamiseks.</para
></callout>
<callout arearefs="pt-xmltransformer-3"
><para
>Määra siin programmi <command
>xsltproc</command
> asukoht. Kui see asub keskkonnamuutujaga PATH määratud asukohas, kirjuta lihtsalt <command
><userinput
>xsltproc</userinput
></command
>.</para
></callout>
<callout arearefs="pt-xmltransformer-4"
><para
>Kui see ei ole tühi, rakendatakse filtrit ainult siis, kui &XML;-il on määratud juurelement või stringiga algav <command
><![CDATA[<!DOCTYPE]]></command
> spetsifikatsioon. See eristab üht &XML;-i vormi teisest. Näiteks kui <guilabel
>DOCTYPE</guilabel
> on <command
><userinput
>html</userinput
></command
>, siis vastab sellele <command
><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"
>]]></command
>. </para
></callout>
<callout arearefs="pt-xmltransformer-5"
><para
>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 <command
><userinput
>konversation,kmail</userinput
></command
>.</para>
<tip
><para
>Töötavate programmide <guilabel
>rakenduse ID</guilabel
> saab leida programmiga <command
>&kdcop;</command
>. &DCOP;-numbrid tuleb küll sel juhul välja jätta. Kui näiteks &kdcop; näitab rakenduse ID-ks <command
>kopete-3432</command
>, tuleb siin anda lihtsalt <command
><userinput
>kopete</userinput
></command
>.</para
></tip
></callout>
</calloutlist>
</para>

<para
>&XML;-teisenduse filtrit rakendatakse ainult juhul, kui juurelemen või DOCTYPE on määratud ning kõik kastis <guilabel
>Filtri rakendamise tingimused</guilabel
> 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.</para>

</sect2>

<!-- ...................................................................... -->

<sect2 id="talkerchooser">
<title
>Kõneleja valimise filtrite seadistamine</title>

<para
>Kõneleja valimise filtreid saab kasutada kõne suunamiseks vajalikule kõnelejale, mis on seadistatud kaardil <guilabel
>Kõnelejad</guilabel
>, või mis tahes määratud omadustega kõnelejale. Nii saab näiteks määrata, et tekst, mille saadab <command
>kmail</command
>, kõneldakse alati naishäälega. Vaata <xref linkend="configure-plugin"/>.</para>

<para
>Enne seda, kui &ktts; 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 &ktts;-ile saatis, ning kaardil <guilabel
>Kõnelejad</guilabel
> seadistatud kõneleja atribuutidele. Kõneleja valimise filtriga saab tühistada kõneleja vaikevaliku. </para>

<para>
    <screenshot>
        <screeninfo
>Kõneleja valik</screeninfo>
        <mediaobjectco>
            <imageobjectco>
                <areaspec units="calspair">
                    <area id="pt-talkerchooser-1" coords="1 1"/>
                    <area id="pt-talkerchooser-2" coords="1 1"/>
                    <area id="pt-talkerchooser-3" coords="1 1"/>
                    <area id="pt-talkerchooser-4" coords="1 1"/>
                    <area id="pt-talkerchooser-5" coords="1 1"/>
                </areaspec>
                <imageobject>
                    <imagedata fileref="talkerchooser.png" format="PNG"/>
                </imageobject>
            </imageobjectco>
            <textobject>
                <phrase
>Kõneleja valik</phrase>
            </textobject>
        </mediaobjectco>
    </screenshot>
</para>

<para>
<calloutlist>
<callout arearefs="pt-talkerchooser-1"
><para
>Määra siin filtri nimi. See võib olla milline tahes, seda kasutatakse selleks, et sa ise suudaksid üht filtrit teisest eristada.</para
></callout>
<callout arearefs="pt-talkerchooser-2"
><para
>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.</para>
<tip
><para
>Et asjad paremini sujuks, ürita "ankurdada" regulaaravaldis stringi algusse - see tähendab, alusta regulaaravaldist sümboliga <command
><userinput
><![CDATA[^]]></userinput
></command
>.</para
></tip
></callout>
<callout arearefs="pt-talkerchooser-3"
><para
>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 <command
><userinput
>konversation,kmail</userinput
></command
>.</para>
<tip
><para
>Töötavate programmide <guilabel
>rakenduse ID</guilabel
> saab leida programmiga <command
>&kdcop;</command
>. &DCOP;-numbrid tuleb küll sel juhul välja jätta. Kui näiteks &kdcop; näitab rakenduse ID-ks <command
>kopete-3432</command
>, tuleb siin anda lihtsalt <command
><userinput
>kopete</userinput
></command
>.</para
></tip
></callout>
<callout arearefs="pt-talkerchooser-4"
><para
>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 <guilabel
>Kõneleja valik</guilabel
>. Vaata <xref linkend="selecttalker"/>.</para
></callout>
<callout arearefs="pt-talkerchooser-5"
><para
>Nende nuppudega saab salvestada kõneleja valimise seadistused, laadida olemasolevad seadistused failist või puhastada kõik seadistused.</para
></callout>
</calloutlist>
</para>

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

<para
>Kõige lihtsam on kõneleja valimise filtrit seadistama õppida katsetades. Keela kõneleja valija ja saada rakendusele mingi tekst. Pane kaardil <guilabel
>Tööd</guilabel
> tähele, millise kõneleja &ktts; valib. Klõpsa nupule <guibutton
>Muuda kõnelejat</guibutton
>, määra teatud omadused ja saada taas mingi tekst ning vaata, kuidas sinu muudatused mõjuvad. Muidugi on selleks, et kõneleja valija üldse midagi mõistlikku teeks, vajalik seadistada enam kui üks kõneleja.</para>

</sect2>

<!-- ...................................................................... -->

<sect2 id="sbd">
<title
>Lausepiiri tuvastamise filtrite seadistamine</title>

<para
>Lausepiiri tuvastamise (SBD) filtrid lahutavad teksti üksiklauseteks. See on oluline, sest</para>

<itemizedlist>
<listitem
><para
>võimaldab &ktts;-il hakata kiiremini kõnelema, kuna sünteesida on vaja ainult esimene lause, mitte aga terve tekstiblokk, mis võib olla päris pikk</para
></listitem>
<listitem
><para
>võimaldab kaardil <guilabel
>Tööd</guilabel
> lausekaupa edasi ja tagasi liikuda</para
></listitem>
<listitem
><para
>võimaldab kaardil <guilabel
>Tööd</guilabel
> tekstitöid peatada või katkestada isegi juhul, kui kõnesüntesaator ei toeta kõnelemise peatamist.</para
></listitem>
</itemizedlist>

<para
>Mainitud põhjustel seadistatakse lausepiiri tuvastamise filter automaatselt juba <command
>kttsmgr</command
> esimesel käivitamisel ning seda ei saa välja lülitada (kuigi selle võib eemaldada). Me soovitame seda filtrit mitte muuta, kui sa just väga täpselt ei tea, mida teed.</para>

<para
>Mõistagi saab oma mingite probleemide lahendamiseks lisada täiendavaid SBD-filtreid. Nii oli 2005. aasta veebruari seisuga Festivali poola häälel ebameeldiv komme kõnelda ka kirjavahemärke. Näiteks öeldi sõnades välja iga lause lõpus seisev punkt. Seda probleemi ei saa lahendada stringiasendusfiltriga, mis eemaldaks lausest kirjavahemärgid, sest sel juhul ei suudaks standardne sõnapiiri tuvastaja enam ühtegi lauset tuvastada. Selle asemel saab aga luua standardse sõnapiiri tuvastaja modifitseeritud versiooni, mis tuvastab laused ja samal ajal eemaldab kirjavahemärgid. Selleks lisa SBD-filter ning kasuta nuppu <guibutton
>Laadi</guibutton
> &ktts;-iga kaasasoleva faili <filename
>polish_festival_sbdrc</filename
> laadimiseks.</para>

<para
>SBD-filtrid töötavad lause lõpule vastava regulaaravaldise tuvastamise ning tabeldusmärgi lisamisega lausepiiridele (tabeldusmärgid eemaldatakse automaatselt tekstist enne filtreerimist). Pane tähele, et standardne sõnapiiri tuvastaja säilitab lauses kõik kirjavahemärgid. </para>

<para
>SBD-filtreid ei rakendata &kde; märguannete (KNotify), hoiatuste, teadete ega ekraanilugeja väljundi korral.</para>

<para
>Kui eemaldad kogemata standardse sõnapiiri tuvastamise filtri, saad selle taastada &ktts;-iga kaasasolevat faili <filename
>standard_sbdrc</filename
> laadides.</para>

</sect2>

</sect1>

<!-- ...................................................................... -->

<sect1 id="selecttalker">
<title
>Kõnelejate valimine</title>

<para
>Kaardil <guilabel
>Kõnelejad</guilabel
> võib seadistada suvalise arvu kõnelejaid. Vaata <xref linkend="configure-plugin"/>. Kui rakendus saadab teksti &ktts;-ule, võib see määrata atribuudid soovitud kõneleja jaoks. &ktts; valib rakenduse soovile kõige paremini vastava kõneleja. Näiteks võib rakendus soovida, et teksti kõneleks inglise naishääl. Kui oled seadistanud kõneleja, mis kasutab inglise keelt ja naishäält, valitakse see kõneleja. Kui aga oled seadistanud ainult inglise mehehääled, valitakse üks neist. Kui rakendus atribuute ei määra, kasutatakse kaardi <guilabel
>Kõnelejad</guilabel
> nimekirja kõige esimest ehk vaikimisi kõnelejat.</para>

<para
>Rakendused võivad soovitud kõneleja atribuute määrates teatud atribuute teistele "eelistada". Näiteks võib rakendus soovida, et teksti kõneleks vali naishääl ja sealjuures on valju hääle atribuut "eelistatud" naishääle ees. Kui sul on seadistatud vaikne naishääl ja vali mehehääl, valib &ktts; kõnelemiseks valju mehehääle. Kuna keel on teksti mõistetavaksmuutmisel alati kriitilise tähtsusega parameeter, siis see on alati "eelistatud" atribuut.</para>

<para
>Dialoogis <guilabel
>Kõneleja valik</guilabel
> saab tühistada rakenduse kõneleja seadistused. Seda dialoogi näidatakse,</para>

<itemizedlist>
<listitem
><para
>kui klõpsad kaardil <guilabel
>Tööd</guilabel
> nupule <guibutton
>Muuda kõnelejat</guibutton
></para
></listitem>
<listitem
><para
>kui klõpsad dialoogis <guilabel
>Filtri seadistamine</guilabel
> kõneleja valimise filtri korral nupule <guilabel
>Kõneleja</guilabel
></para
></listitem>
<listitem
><para
>kui klõpsad kaardil <guilabel
>Märguanded</guilabel
> nupule <guilabel
>Kõneleja</guilabel
>.</para
></listitem>
</itemizedlist>

<para>
    <screenshot>
        <screeninfo
>Kõneleja valik</screeninfo>
        <mediaobjectco>
            <imageobjectco>
                <areaspec units="calspair">
                    <area id="pt-selecttalker-1" coords="1 1"/>
                    <area id="pt-selecttalker-2" coords="1 1"/>
                    <area id="pt-selecttalker-3" coords="1 1"/>
                    <area id="pt-selecttalker-4" coords="1 1"/>
                    <area id="pt-selecttalker-5" coords="1 1"/>
                </areaspec>
                <imageobject>
                    <imagedata fileref="selecttalker.png" format="PNG"/>
                </imageobject>
            </imageobjectco>
            <textobject>
                <phrase
>Kõneleja valik</phrase>
            </textobject>
        </mediaobjectco>
    </screenshot>
</para>

<para
>Dialoogis saab kolmel viisil määrata kõneleja vajalikud atribuudid:</para>

<itemizedlist>
<listitem
><para
>Kasutades vaikimisi kõnelejat (kaardi <guilabel
>Kõnelejad</guilabel
> nimekirja esimene kirje). See tähendab, et kõneleja atribuute sisuliselt ei määrata.</para
></listitem>
<listitem
><para
>Kasutades kõige paremini sobivat kõnelejat, millel on vähemalt üks määratud atribuut.</para
></listitem>
<listitem
><para
>Kasutades kõige paremini sobivat kõnelejat, millel on kõik seadistatud kõneleja atribuudid. Kui sa kõneleja seadistusi ei kustuta ega muuda, valib &ktts; määratud kõneleja. Kui sa kõneleja seadistused kustutad või neid muudad, valib &ktts; kõneleja algupäraste atribuutidega kõige paremini sobiva kõneleja.</para
></listitem>
</itemizedlist>

<para>
<calloutlist>
<callout arearefs="pt-selecttalker-1"
><para
>Viisi soovitud kõneleja valimiseks saab määrata üht raadionuppu klõpsates.</para
></callout>
<callout arearefs="pt-selecttalker-2"
><para
>Siin saab valida soovitud kõneleja atribuudid. Kui atribuut sulle huvi ei paku, jäta see tühjaks.</para
></callout>
<callout arearefs="pt-selecttalker-3"
><para
>Selle kasti märkimisel "eelistatakse" antud atribuuti teistele. Märkida võib ka mitu kasti.</para
></callout>
<callout arearefs="pt-selecttalker-4"
><para
>Kuna keel on kõneldava teksti mõistmisel kriitilise tähtsusega, on see alati eelistatud atribuut. Selle kasutamine on siiski harv juhus ja ainus mõeldav olukord, kus seda on mõtet määrata, on see, kui sa tead, et rakendus saadab teksti keeles, mis erineb sinu töölaual kasutatavast keelest.</para
></callout>
<callout arearefs="pt-selecttalker-5"
><para
>See on kõnelejate nimekiri, mida sa oled parajasti &ktts;-is seadistanud. Üht neist valides määrad sisuliselt kõik selle kõneleja atribuudid. Kui see kõneleja on teksti saabumisel endiselt olemas, leitakse täpne sobivus ning kõnelemiseks valitakse just see kõneleja. Kui aga kustutad selle kõneleja hiljem või muudad selle seadistusi, ei pruugita seda enam valida, vaid kasutatakse kõnelejat, mille atribuudid sobivad kõige paremini kokku antud kõneleja algupäraste atribuutidega.</para
></callout>
</calloutlist>
</para>

<para
>Omadus <guilabel
>Keel</guilabel
> on mõnevõrra eriline, sest tekst on usutavasti üsna äratundmatu, kui seda kõneleb kõneleja, mis kasutab tekstist erinevat keelt. Seepärast on keel automaatselt <guilabel
>eelistatud</guilabel
> omadus. Kui määrad keele, siis tühistab see valitud keele, kui aga jätad välja tühjaks, kasutatakse olemasolevat keeleseadistust. Kui rakendus, mis saadab teksti &ktts;-ile, ei määra keelt, omistab &ktts; sellele kaardil <guilabel
>Kõnelejad</guilabel
> kõige esimesena seisva kõneleja keele. Teisisõnu eeldatakse, et nimekirjas esimesena seisva kõneleja kõneleb sama keelt, mida kasutad oma töölaual.</para>

<tip
><para
>Kõigi atribuutide puhastamiseks sektsioonis <guilabel
>Sobivaima kõneleja kasutamine</guilabel
> vali kõigepealt raadionupp <guilabel
>Vaikimisi kõneleja kasutamine</guilabel
>, seejärel aga raadionupp <guilabel
>Sobivaima kõneleja kasutamine</guilabel
>.</para
></tip>

</sect1>

</chapter>

<!-- ====================================================================== -->

<chapter id="commands">
<title
>Käskude seletused</title>

<!-- (OPTIONAL, BUT RECOMMENDED) This chapter should list all of the
application windows and their menubar and toolbar commands for easy reference.
Also include any keys that have a special function but have no equivalent in the
menus or toolbars. This may not be necessary for small apps or apps with no tool
or menu bars. -->

<para
>Veel kirjutamata</para>

</chapter>

<!--

<sect1 id="kapp-mainwindow">
<title
>The main &kmyapplication; window</title>

<sect2>
<title
>The File Menu</title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice>
<shortcut>
<keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo>
</shortcut>
<guimenu
>File</guimenu>
<guimenuitem
>New</guimenuitem>
</menuchoice
></term>
<listitem
><para
><action
>Creates a new document</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice>
<shortcut>
<keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo>
</shortcut>
<guimenu
>File</guimenu>
<guimenuitem
>Save</guimenuitem>
</menuchoice
></term>
<listitem
><para
><action
>Saves the document</action
></para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice>
<shortcut>
<keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo>
</shortcut>
<guimenu
>File</guimenu>
<guimenuitem
>Quit</guimenuitem>
</menuchoice
></term>
<listitem
><para
><action
>Quits</action
> &kmyapplication;</para
></listitem>
</varlistentry>
</variablelist>
</para>

</sect2>

-->

<!-- ====================================================================== -->

<chapter id="developers">
<title
>&ktts; arendajatele</title>

<para
>&ktts;-il on kaks programmiliidest (API): </para>

<itemizedlist>
<listitem
><para
>&kde; teksti kõneks muutmise API, mida rakenduse programmeerijad saavad kasutada oma rakendusele TTS-võimaluste lisamiseks. Rakendused suhtlevad KTTSD-ga &DCOP;-i vahendusel.</para
></listitem>
<listitem
><para
>KTTSD plugina API, mida saab kasutada kõnesünteesipluginate lisamiseks KTTSD-le, et &ktts; suudaks kasutada uut kõnesünteesi mootorit.</para
></listitem>
</itemizedlist>

<para
>Järgnevas osas kirjeldame lühidalt &kde; teksti kõneks muutmise API &DCOP;-liidest. Mõlema API täieliku dokumentatsiooni leiab internetist <ulink url="http://accessibility.kde.org/developer/kttsd/"
>&kde; hõlbustuse</ulink
> veebisaidilt (http://accessibility.kde.org). </para>


<!-- ...................................................................... -->


<sect1 id="dcop-interface">
<title
>&ktts; DCOP-liides</title>

<para
>Rakendused saadavad teksti kõneks muutmise teenuse soovid &kde; &DCOP;-liidese vahendusel <command
>kttsd</command
> objektile <command
>KSpeech</command
>. </para>

<para
>Anna järgnevad käsud Konsoolis.</para>

<para
>Kui KTTSD veel ei tööta</para>

<para
><userinput
>kttsd</userinput
></para>

<para
>Kõneldava tekstitöö järjekorda asetamiseks</para>

<para
><userinput
>dcop kttsd KSpeech setText "<replaceable
>tekst</replaceable
>" "<replaceable
>kõneleja</replaceable
>"</userinput
></para>

<para
>kus <userinput
><replaceable
>tekst</replaceable
></userinput
> on kõneldav tekst ja <userinput
><replaceable
>kõneleja</replaceable
></userinput
> keelekood, näiteks <userinput
><replaceable
>en</replaceable
></userinput
>, <userinput
><replaceable
>et</replaceable
></userinput
> &etc; See käsk ei kõnele veel teksti, vaid seab tekstitöö kõnelemise järjekorda.</para>

<para
>Näide:</para>

<para
><userinput
>dcop kttsd KSpeech setText "This is a test." "en"</userinput
></para>

<para
>Viimase järjekorda seatud tekstitöö kõnelemiseks</para>

<para
><userinput
>dcop kttsd KSpeech startText <replaceable
>0</replaceable
></userinput
></para>

<para
>Antud juhul tähendab <userinput
>0</userinput
> järjekorra viimast tekstitööd. Määrata võib ka tekstitöö järjekorranumbri (kui numbrit ei anta, eeldatakse see olevat <userinput
>0</userinput
>).</para>

<para
>Parajasti kõneldava teksti katkestamiseks</para>

<para
><userinput
>dcop kttsd KSpeech stopText 0</userinput
></para>

<para
>Sõltuvalt kasutatavast kõnepluginast ei pruugi kõnelemine otsekohe katkeda.</para>

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

<para
><userinput
>dcop kttsd KSpeech</userinput
></para>

<para
>või tutvu võrgus <ulink url="http://accessibility.kde.org/developer/kttsd/"
> &kde; teksti kõneks muutmise API-ga</ulink
>.</para>

</sect1>

</chapter>

<!-- ====================================================================== -->

<chapter id="faq">
<title
>Küsimused ja vastused</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
><command
>kttsmgr</command
> tabab kohe käivitamisel järel krahh. Ma kompileerisin selle silumistoetusega, kuid ei saa isegi mitte tagasijälitust.</para>
</question>
<answer>
<para
>GStreamerit tabas krahh ja see lõpetas ka &ktts; töö. Arvatavasti tuleb GStreamer "registreerida". GStreamer 0.8x korral on vastav käsk <command
>gst-register-0.8</command
>. Kui see ei lahenda probleemi, on võib-olla paigaldatud sobimatu GStreameri versioon. Sel juhul tasuks proovida GStreamer eemaldada või seda uuendada.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>ALSA audioväljund ei tööta, kui ma kuulan samal ajal muusikat mõne muu rakendusega. Kui ma peatab tekstitöö, &ktts; hangub. Konsoolis näeb väljundina teadet "unable to open PCM".</para>
</question>
<answer>
<para
>Siin on tegemist ALSA seadmete konkureerimise probleemiga, mis takistab korraga avamast rohkem kui üht PCM seadet. Võimalikke lahendusi (dmix) leiab ALSA veebileheküljelt <ulink url="www.alsa-project.org"
>www.alsa-project.org</ulink
>. </para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Mul on vaja uuesti alustada. Kuidas &ktts; täiesti tööst välja lülitada?</para>
</question>
<answer>
<para
>Anna Konsoolis järgmised käsud: <programlisting
>killall kttsd
killall kttsmgr
</programlisting>
</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Kuidas näha <command
>kttsd</command
> silumisväljundit?</para>
</question>
<answer>
<para
>Ava kaks Konsooli akent. Käivita ühes neist <command
>kttsd</command
> ning seejärel teises <command
>kttsmgr</command
>.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Tõmbasin internetist täiendavaid Festivali hääli. Paigaldasin need ja ma saan ka Festivali kasutada, aga <command
>kttsmgr</command
> neid ei näita.</para>
</question>
<answer>
<para
>Redigeeri uue hääle lisamiseks faili <command
>$KDEHOME/share/apps/kttsd/festivalint/voices</command
>. Sealsed kirjed peaksid selgeks tegema, kuidas seda tuleb teha. Kui oled hääle edukalt lisanud, saada palun vastav paik ka arendajatele ning maini ühtlasi, kust sa selle häälefaili hankisid (veebisaidi &URL;).</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Ükski toetatud kõnesüntesaatoritest ei toeta keelt, mida mul vaja läheks. Kuidas siis panna süntesaator minu keeles tööle?</para>
</question>
<answer>
<para
>Siin on sinu sõber Google(tm). Abiks võib olla ka see <ulink url="http://tcts.fpms.ac.be/synthesis/mbrola/mbrtts.html"
>viit</ulink
>. Kui leiad vabatarkvaralise sünteesimootori, mis toetab sinu keelt, ning soovid, et seda toetaks ka &ktts;, 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 &ktts; arendajatele. Seni aga võib olla võimalik oma keel tööle saada <guilabel
>käsurea</guilabel
>pluginaga. Vaata <xref linkend="using-with-command"/>.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>&ktts; kõneleb liiga aeglaselt. Kuidas kõnet kiirendada?</para>
</question>
<answer>
<para
>Kaardil <guilabel
>Audio</guilabel
> on valik <guilabel
>Kiirus</guilabel
>. Et see korralikult toimiks, peab utiliit <command
>sox</command
> olema paigaldatud ja asuma keskkonnamuutujaga PATH määratud asukohas, Mõned sünteesipluginad, näiteks Festival Interactive, pakuvad samuti kõneleja seadistamise dialoogis valikut <guilabel
>Kiirus</guilabel
>. Sõltuvalt kasutatavast häälest võib olla võimalik seda muuta või mitte.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Hmm, mõne asja puhul ju see töötab, aga veebilehekülgesid kõneldakse ikkagi liiga aeglaselt.</para>
</question>
<answer>
<para
>&ktts; ignoreerib kiiruseseadistusi &HTML;-i kõnelemisel (selle põhjuseks on asjaolu, et &HTML; teisendatakse SSML-iks, millel on omaenda kiirusesildid). Sellisel juhul lülita välja &XML;-teisenduse filter (vaata <xref linkend="filters"/>) või kui oled eriti julge, redigeeri &HTML;->SSML teisenduse filtris .xsl-faili ja suurenda vaikimisi kõnekiirust.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Kuidagi ei ole võimalik panna veebilehekülgi kõnelema naishäälega. Olen seadistanud Festivali naishäälega kõneleja, kuid &ktts; kõneleb veebilehekülgi alati meeshäälega.</para>
</question>
<answer>
<para
>Festival 1.95 beta korral ei paistnud silt SABLE GENDER töötavat. Et Festival vigu ei tekitaks, eemaldab SSML->SABLE .xsl-fail soosildi. Sama kehtib ka häälesiltide kohta.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Olen seadistanud &HTML;-i &XML;-teisenduse filtri, aga veebilehekülgede kõnelemisel ei kasutata üldse Festivali pluginat.</para>
</question>
<answer>
<para
>Festival 1.95 beta vea tõttu tuleb paigaldada <command
>rab_diphone</command
> (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 <command
>xsltproc</command
> oleks paigaldatud ja asuks keskkonnamuutujaga PATH määratud asukohas.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>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.</para>
</question>
<answer>
<para
>Kõigepealt kontrolli, et kõneleja seadistustedialoogis oleks valik <guilabel
>Kodeering</guilabel
> sinu keele jaoks korrektselt määratud. Kui probleeme tekitavad teatud sõnad või tähed, võib abi olla stringiasendusfiltrist. Kui süntesaatorit ajavad segadusse teatud kirjavahemärgid, võib abiks olla lausepiiri tuvastamise filtri seadistamine. Vaata <xref linkend="filters"/>.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>Lisasin uue stringiasendusfiltri ja nüüd ei luba &ktts; mul enam lausekaupa edasi või tagasi liikuda. Kaardil <guilabel
>Tööd</guilabel
> antakse teada, et igas töös on ainult üks lause. Mida ma valesti olen teinud?</para>
</question>
<answer>
<para
>Filtreerida ei tohiks kirjavahemärke (punkt, küsimärk, hüüumärk, koolon ja semikoolon). Nende korral tuleb kasutada lausepiiri tuvastamise filtrit.</para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<!-- ====================================================================== -->

<chapter id="credits">

<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE
distribution. -->

<title
>Autorid ja litsents</title>

<para
>&ktts; </para>
<para
>Rakenduse autoriõigus &copy; 2002: Jos&#233; Pablo Ezequiel "Pupeno" Fern&#225;ndez <email
>pupeno@kde.org</email
> </para>
<para
>Praegune hooldaja: Gary Cramblitt <email
>garycramblitt@comcast.net</email
> </para>
<para
>Kaasautorid: <itemizedlist>
<listitem
><para
>Olaf Schmidt <email
>ojschmidt@kde.org</email
></para>
</listitem>
<listitem
><para
>Gunnar Schmi Dt <email
>gunnar@schmi-dt.de</email
></para>
</listitem>
<listitem
><para
>Paul Giannaros <email
>ceruleanblaze@gmail.com</email
></para>
</listitem>
</itemizedlist>
</para>

<para
>Dokumentatsiooni autoriõigus &copy; 2004: Gary R. Cramblitt <email
>garycramblitt@comcast.net</email
> </para>

<para
>Tõlge eesti keelde: Marek Laane <email
>bald@starman.ee</email
></para
> 
&underFDL; &underGPL; <note
><para
>&ktts; kasutatavatel kõnesünteesi mootoritel on omaette litsentsid. Vaata neid mootorite dokumentatsioonist või veebisaidilt. Ka mõnel häälel on omaette litsents.</para
></note>

</chapter>

<!-- ====================================================================== -->

<appendix id="installation">
<title
>Paigaldamine</title>

<!-- ...................................................................... -->


<sect1 id="getting-kapp">
<title
>&ktts; hankimine</title>

<!-- This first entity contains boiler plate for applications that are
part of KDE CVS.  You should remove it if you are releasing your
application --> 

<para
>&install.intro.documentation; </para>

<para
>(TULEVIKUS) Debiani paigaldamiskäsk: <command
>apt-get install kdeaccessibility</command
></para>

<note>
<para
>Viidad lähtetekstile ja binaarpakettidele leiab <ulink url="http://accessibility.kde.org/developer/kttsd/"
> &kde; hõlbustuse</ulink
> veebileheküljelt (http://accessibility.kde.org).</para>

<para
>Kui sul on ligipääs &kde; lähtekoodi hoidlale, võid hankida &ktts;-i moodulit <command
>kdeaccessibility</command
> välja võttes. &ktts; on kataloogis <command
>kttsd</command
>. Samuti võib tõmmata kogu kdeaccessibility igaöise pakitud versiooni aadressilt <ulink url="ftp://ftp.kde.org/pub/kde/"
>ftp://ftp.kde.org/pub/kde/</ulink
>.</para>
</note>

</sect1>

<!-- ...................................................................... -->


<sect1 id="requirements">
<title
>Nõuded</title>

<para
>Kohustuslikud nõdued:</para>

<para>
<itemizedlist>
<listitem
><para
>&kde; versioon 3.2 või uuem.</para
></listitem>
<listitem
><para
>Kõnesünteesi mootor. Praegu on toetatud järgmised mootorid ja kõneldavad keeled.</para>

<para>
<informaltable id="synth-engines">
<tgroup cols="2">
<tbody>

<row>
<entry
>Festival</entry>
<entry
>Ameerika inglise, briti inglise, hispaania, saksa, soome, tšehhi, poola, vene, itaalia, Kanada prantsuse, suahiili, suulu ja ibibio</entry>
</row>

<row>
<entry
>Festival Lite (flite)</entry>
<entry
>Inglise</entry>
</row>

<row>
<entry
>Hadifix (&mbrola; ja txt2pho)</entry>
<entry
>Saksa, ungari</entry>
</row>

<row>
<entry
>Epos</entry>
<entry
>Tšehhi, slovaki</entry>
</row>

<row>
<entry
>FreeTTS</entry>
<entry
>Inglise</entry>
</row>

</tbody>
</tgroup>
</informaltable>
</para>

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

<note
><para
>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 <ulink url="http://accessibility.kde.org/developer/kttsd/index.php"
> &ktts;</ulink
> veebileheküljelt. </para
></note>

<note>
<para
>&ktts; kasutab kõnesünteesi mootorite jaoks paindlikku pluginaarhitektuuri. Kui soovid &ktts;-i veel paremaks muuta mõne mootori lisamisega, võta ühendust arendajatega. </para>
</note>

<para
>Iga mootori kohta annab konkreetseid juhiseid <xref linkend="configuration"/>. </para>

</listitem>

<listitem>
<para
>Vähemalt üks järgmistest audioalamsüsteemidest: <itemizedlist>
<listitem
><para
>&kde; helisüsteem &arts;. &arts; paigaldatakse tavaliselt koos &kde;-ga.</para
></listitem>
<listitem
><para
>ALSA (Advanced &Linux; Sound Architecture). ALSA paigaldatakse koos enamiku &Linux;i süsteemidega (<ulink url="www.alsa-project.org"
>www.alsa-project.org</ulink
>).</para
></listitem>
<listitem
><para
>GStreamer 0.8.7 või uuem. <emphasis
>Märkus</emphasis
>: registreeri kindlasti GStreameri pluginad käsuga <command
>gst-register</command
>, enne kui hakkad GStreamerit &ktts;-is kasutama. (<ulink url="http://gstreamer.freedesktop.org"
> http://gstreamer.freedesktop.org</ulink
>)</para
></listitem>
<listitem
><para
>aKode teek. aKode on dekodeerimisteek, mis kuulub &kde; koosseisu. </para
></listitem>
</itemizedlist>

<note
><para
>&kde; kavatseb versioonis 4 loobuda &arts;i kasutamisest.</para
></note>

<note
><para
>Mõned kasutajad on täheldanud ALSA puhul seadmete konkureerimist. Kui see on probleemiks ka sinu süsteemis, ei saa sa näiteks korraga kuulata muusikat ja lasta &ktts;-il kõnelda, samuti võib viimane hanguda, kui teed ühes tekstitöös pausi ja alustad teist. Võimalikke lahendusi (dmix) pakub ALSA veebilehekülg.</para
></note>

<note
><para
>2005. aasta juulikuu seisuga ei toetanud aKode veel pausivõimalust. Kui teed &ktts;-is tekstitöö esitamises pausi, lõpetab see kõnelemise alles pärast käsilolevat lauset.</para
></note>

</para>
</listitem>

</itemizedlist>
</para>

<para
>Lisakomponendid:</para>

<para>
<itemizedlist>

<listitem>
<para
>Audioutiliiti <command
>sox</command
> läheb vaja üldise kõnekiiruse kohendamiseks. Debiani kasutajad saavad selle paigaldada käsuga <command
>apt-get install sox</command
>. Sox leidub enamikul &Linux; distributsioonide CD-del.</para>
</listitem>

<listitem>
<para
>Utiliiti <command
>xsltproc</command
> on vaja SSML-i toetuse ja &XML;-teisenduse filtri jaoks. Debiani kasutajad saavad selle paigaldada käsuga <command
>apt-get install xsltproc</command
>.</para>
</listitem>

</itemizedlist>
</para>

</sect1>

<!-- ...................................................................... -->


<sect1 id="compilation">
<title
>Kompileerimine ja paigaldamine</title>

<!-- This entity contains the boilerplate text for standard -->
<!-- compilation instructions.  If your application requires any -->
<!-- special handling, remove it, and replace with your own text. -->

<!-- &install.compile.documentation; -->

<para
>&ktts; kompileerimiseks läheb vaja üsna uusi &kde; teeke (&kde; 3.4 või uuem), sealhulgas paketti kdelibs ja arts.</para>

<para
>Kui oled tõmmanud &ktts;-u tar-pakitud failina, logi sisse tavalise kasutajana ja paki fail sobivasse kataloogi lahti, mine sellesse kataloogi ja anna seal järgmised käsud:</para>

<programlisting
>./configure
make
</programlisting>

<para
>Käsuga <command
>configure</command
> saab kasutada järgmisi võtmeid:</para>

<para>
<informaltable id="configure-audio-options">
<tgroup cols="3">
<tbody>

<row>
<entry
><emphasis
>Vaikimisi võti</emphasis
></entry>
<entry
><emphasis
>Kirjeldus</emphasis
></entry>
<entry
><emphasis
>Alternatiiv</emphasis
></entry>
</row>
<row>
<entry
>--with-arts</entry>
<entry
>Ehitab artsi audioplugina.</entry>
<entry
>--without-arts</entry>
</row>
<row>
<entry
>--with-alsa=check</entry>
<entry
>Ehitab ALSA audioplugina.</entry>
<entry
>--with-alsa=no</entry>
</row>
<row>
<entry
>--with-gstreamer=no</entry>
<entry
>Ei ehita GStreameri audiopluginat.</entry>
<entry
>--with-gstreamer=check</entry>
</row>
<row>
<entry
>--with-akode=no</entry>
<entry
>Ei ehita aKode audiopluginat.</entry>
<entry
>--with-akode=check</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>

<note
><para
>&kde; 4 ilmudes &arts;i plugin arvatavasti eemaldatakse või vähemalt ei ehitata seda enam vaikimisi. </para
></note>

<para
>Vaikimisi ehitatakse kõik järgnevad kõnesünteesipluginad. Mõningad neist on käitusajal sõltuvad mittevabast tarkvarast ('mittevaba' Debiani reeglite kohaselt). Veerus "Seadistamisvõti keelamiseks" näidatakse konfigureerimiskäsku, mille kasutamisel pluginat ei ehitata:</para>

<para>
<informaltable id="configure-synth-options">
<tgroup cols="3">
<tbody>

<row>
<entry
><emphasis
>Sünt</emphasis
></entry>
<entry
><emphasis
>Litsents</emphasis
></entry>
<entry
><emphasis
>Seadistamisvõti keelamiseks</emphasis
></entry>
</row>
<row
><entry
>Festival</entry
><entry
>vaba</entry
><entry
>--disable-kttsd-festivalint</entry
></row>
<row
><entry
>Festival Lite</entry
><entry
>vaba</entry
><entry
>--disable-kttsd-flite</entry
></row>
<row
><entry
>Epos</entry
><entry
>vaba</entry
><entry
>--disable-kttsd-epos</entry
></row>
<row
><entry
>Käsk</entry
><entry
>vaba</entry
><entry
>--disable-kttsd-command</entry
></row>
<row
><entry
>Hadifix</entry
><entry
>mittevaba</entry
><entry
>--disable-kttsd-hadifix</entry
></row>
<row
><entry
>FreeTTS</entry
><entry
>mittevaba</entry
><entry
>--disable-kttsd-freetts</entry
></row>
</tbody
></tgroup
></informaltable
></para>

<para
>Vaikimisi paigaldavad toodud käsud &ktts;-i kataloogi <filename
>/opt/kde3</filename
>. Kui see kataloog ei asu keskkonnamuutujaga $<envar
>KDEDIRS</envar
> määratud asukohas, tuleb lisada võti<userinput
>--prefix=<replaceable
>target</replaceable
></userinput
>, näiteks</para>

<programlisting
>./configure --prefix=/usr/local
make
</programlisting>

<note
><para
>Debiani süsteemides on just <filename
><replaceable
>/usr/local</replaceable
></filename
> tavaliselt koht, kuhu paigaldada lähtekoodist kompileeritud rakendused. </para
></note>

<para
>Logi sisse administraatorina (root) ning paigalda kompileeritud &ktts; järgmiste käskudega:</para>

<programlisting
>su
make install
</programlisting>

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

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

</sect1>

<!-- ...................................................................... -->


<sect1 id="configuration">
<title
>Seadistamine</title>

<para
>Kontrolli enne &ktts;-i kasutamist, et kõnesünteesi mootor töötab. Järgi mootoriga kaasasolevaid juhiseid.</para>

<tip>
<para
>Mõnel juhul võib olla vajalik lubada audioseadmesse kirjutamise õigus:</para>
<para
><userinput
>chmod a+rw <replaceable
>/dev/dsp*</replaceable
></userinput
></para>
</tip>

<!-- ...................................................................... -->


<sect2 id="using-with-festival">
<title
>Festivali (Interactive) kasutamine</title>

<para
>Festival on üks paremaid vabu ja avatud tarkvaraga TTS-mootoreid. Häälekvaliteet on üldiselt hea, toetatud on üsna mitu keelt ja häält. Paljude häälte korral saab juhtida helitugevust, tekitatud kõne kiirust ning tooni kohe &ktts;-is.</para>

<para
>Süntesaatori nimi: <guilabel
>Festival Interactive</guilabel
></para>

<para
>&URL;: <ulink url="http://www.cstr.ed.ac.uk/projects/festival/"
> http://www.cstr.ed.ac.uk/projects/festival/</ulink
> </para>

<para
>Debiani paigaldamiskäsk: <userinput
>apt-get install festival</userinput
></para>

<para
>Paigaldada tuleb vähemalt üks keel. Järgi Festivaliga kaasasolevaid juhiseid. Kui soovid lasta kõnelda veebilehekülgi, tuleb paigaldada <command
>rab_diphone</command
> (briti mehehääl). </para>

<para
>Täiendavaid Festivali inglise hääli leiab aadressilt</para>

<para
><ulink url="http://hts.ics.nitech.ac.jp/"
>http://hts.ics.nitech.ac.jp/</ulink
> </para>

<para
>Täiendavaid hispaania, inglise ja saksa hääli leiab aadressilt</para>

<para
><ulink url="http://cslu.cse.ogi.edu/tts/download/"
>http://cslu.cse.ogi.edu/tts/download/</ulink
></para>

<para
>Nende häälte korral tuleb kompileerida lisamoodul, mistõttu sul peab olema käepärast Festivali lähtekood. Saksa häälte levitamine on piiratud. </para>

<para
>Soome mehehääle leiab aadressilt </para>

<para
><ulink url="http://www.ling.helsinki.fi/suopuhe/download/"
> http://www.ling.helsinki.fi/suopuhe/download/</ulink
> </para>

<para
>Poola mehehääle leiab aadressilt </para>

<para
><ulink url="http://www.artegence.com/download/voicexml/speech/festival_polish_voice.tgz"
> http://www.artegence.com/download/voicexml/speech/festival_polish_voice.tgz</ulink
> </para>

<para
>Vene mehehääle leiab aadressilt </para>

<para
><ulink url="http://nshmyrev.narod.ru/festival/festival.html"
>http://nshmyrev.narod.ru/festival/festival.html </ulink
></para>

<para
>Selle hääle kasutamiseks peab sul olema Festival 1.95 beta või uuem. Hääl on veel üsna varases arendusjärgus. Paki see lahti kataloogi <filename
>festival/lib/voices/russian/</filename
>. Vene keele kõnelejat seadistades on hääle kood <userinput
>msu_ru_nsh_diphone</userinput
>. Vali kindlasti 8-bitine kirillitsakodeering, näiteks <userinput
>KOI8-R</userinput
>.</para>

<para
>Itaalia hääli Festival 1.95 beta jaoks leiab aadressilt</para>

<para
><ulink url="http://www.csrf.pd.cnr.it/TTS/It-FESTIVAL-download.htm"
> http://www.csrf.pd.cnr.it/TTS/It-FESTIVAL-download.htm</ulink
>.</para>

<para
>Kui saad lahtipakkimisel CRC-vigu, proovi uuesti alla laadida.</para>

<para
>Suahiili, suulu ja ibibio hääli Festival 1.95 beta jaoks leiab aadressilt</para>

<para
><ulink url="http://www.llsti.org/"
>http://www.llsti.org/</ulink
>.</para>

<para
>Paraku ei tööta &ktts;-is hindi hääl, mida see lehekülg samuti pakub.</para>

<para
>Kommertshääli, sealhulgas Kanada prantsuse häält, saab osta firma Cepstral, LLC käest. Selle leiab aadressil</para>

<para
><ulink url="http://www.cepstral.com/"
>http://www.cepstral.com/</ulink
></para>

<para
>Nende toetuslehekülje KKK pakub infot häälte kasutamise kohta Festivaliga.</para>

<para
>Festival leidub tavaliselt igas &Linux; distributsioonis, nii et kontrolli selle olemasolu oma distributsiooni CD-del.</para>

<note>
<para
>Poola, ungari või tšehhi keele kasutamisel peab <guilabel
>kodeering</guilabel
> kindlasti olema <userinput
>ISO 8859-2</userinput
>. </para>
<para
>Vene hääle kasutamisel peab <guilabel
>kodeering</guilabel
> kindlasti olema 8-bitine kirillitsakodeering, näiteks <userinput
>KOI8-R</userinput
>. </para>
</note>

<!-- ...................................................................... -->


<sect3 id="festival-with-mbrola">
<title
>Festivali kasutamine &mbrola;ga</title>

<para
>Festivali võib kasutada ka koos &mbrola; süntesaatoriga. Sellisel juhul sooritab Festival leksikaalse analüüsi ning &mbrola; tekitab heli. &mbrola; binaarfaili ja &mbrola; häälefailid saab tõmmata aadressilt</para>

<para
><ulink url="http://festvox.org/mbrola/"
>http://festvox.org/mbrola/</ulink
></para>

<para
>Järgi allalaadimisel saadud failis <filename
>readme.txt</filename
> leiduvaid juhiseid.</para>

<para
>Arvesta, et &mbrola; ei ole täielik teksti kõneks muutmise süsteem. &mbrola; sünteesib kõne difoonifailidest. Sul peab järelikult olema ka tarkvara, mis tekitab difoone. Festivaliga kombineeritult tekitab &mbrola;le vajalikke difoone Festival. Saksakeelsest tekstist saab difoone tekitada programmiga <command
>txt2pho</command
>. Täpsemalt räägib sellest <xref linkend="using-with-hadifix"/>.</para>

<para
>Festivali ja &mbrola; üheskoos kasutamiseks on kolm meetodit.</para>

<para>
<itemizedlist>
<listitem
><para
><link linkend="mbrola-wrappers"
>&mbrola; pakendid (wrapper)</link
>. Käsiraamatu kirjutamise ajal oli see meetod piiratud inglise häältega.</para
></listitem>
<listitem
><para
><link linkend="ims-german-festival"
>IMS German Festival</link
>.</para
></listitem>
<listitem
><para
><link linkend="festival-czech"
>Festival-Czech</link
>.</para
></listitem>
</itemizedlist>
</para>

<!-- ...................................................................... -->

<sect4 id="mbrola-wrappers">
<title
>Festivali kasutamine &mbrola; pakendiga</title>

<para
>Selle meetodi korral lisatakse Festivalile täiendab pakendikood, mis võimaldab kõnesünteesi &mbrola; häälefaile kasutades. Arvesta, et &mbrola; häälefaile <emphasis
>ei paigaldata</emphasis
> &mbrola; kataloogipuusse, vaid hoopis <filename
>festival/lib/</filename
> kataloogi. Juhiseid leiab aadressilt</para>

<para
><ulink url="http://www.cstr.ed.ac.uk/projects/festival/mbrola.html"
>http://www.cstr.ed.ac.uk/projects/festival/mbrola.html</ulink
></para>

</sect4>

<!-- ...................................................................... -->

<sect4 id="ims-german-festival">
<title
>IMS German Festivali kasutamine</title>

<para
>IMS German Festival on Festivali modifikatsioon, mis kasutab &mbrola; saksa hääli. See töötab nii Festivali versiooniga 1.4.1 kui ka 2.0 (1.95 beta). Paigalda esmalt Festival ja &mbrola;, kui sa ei ole seda veel teinud. Seejärel tõmba IMS German Festival aadressilt</para>

<para
><ulink url="http://www.ims.uni-stuttgart.de/phonetik/synthesis/festival_opensource.html"
> http://www.ims.uni-stuttgart.de/phonetik/synthesis/festival_opensource.html</ulink
></para>

<para
>Järgi allalaadimisel saadud failis <filename
>README</filename
> leiduvaid juhiseid. (Pane tähele, et kasutatuna koos Festivali versiooniga 2.0, <emphasis
>ei ole</emphasis
> vajalik lisada tar-pakitud faili <filename
>fixes</filename
>, kuid festival tuleb siiski ümber kompileerida.) Lõpuks lisa faili <filename
>festival/lib/siteinit.scm</filename
> järgmised read:</para>

<para>
<programlisting
>(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")
</programlisting>
</para>

<para
>otse rea ette, millel seisab</para>

<para>
<programlisting
>(provide 'siteinit)
</programlisting>
</para>

<para
>Mõnes süsteemis tuleb redigeerida faili <filename
>/etc/festival.scm</filename
>. Lisa ainult need read, mis vastavad paigaldatud saksa häältele. Anna asukoha <userinput
><replaceable
>/usr/local/mbrola/</replaceable
></userinput
> asemel vajaduse korral mõni muu, õige asukoht. Pane tähele ka seda, et (vähemalt käsuraamatu kirjutamise ajal) IMS German Festival ei tööta de4, de5 ega de6 saksa häältega.</para>

</sect4>

<!-- ...................................................................... -->

<sect4 id="festival-czech">
<title
>Festival-Czech kasutamine</title>

<para
>See meetod kasutab teatud erikoodi kõnesünteesi võimaldamiseks Festivali ja &mbrola; tšehhi hääle koostöös. Paigaldamiseks tõmba kõigepealt Festival ja &mbrola;, paigalda need ja kontrolli, et need töötaks. Seejärel tõmba Festival-Czech aadressilt</para>

<para
><ulink url="http://www.freebsoft.org/festival-czech"
>http://www.freebsoft.org/festival-czech</ulink
></para>

<note
><para
>Järgnevates näidetes asenda vajaduse korral kataloogid õigetega.</para
></note>

<para
>Paki tõmmatud fail lahti sobivasse kataloogi ja loo leksikon. Festivali käivitatav fail peab asuma keskkonnamuutujaga <envar
>PATH</envar
> määratud asukohas. </para>

<para>
<programlisting
>cd /usr/local
tar xvfz festival-czech.tar.gz
cd festival-czech
make
</programlisting>
</para>

<para
>Tõmba &mbrola; veebisaidilt <filename
>cz2</filename
> häälefail ja paki see lahti &mbrola; kataloogi.</para>

<para>
<programlisting
>cd /usr/local/mbrola
mkdir cz2
cd cz2
unzip cz2-001009.zip
</programlisting>
</para>

<para
>Lisa järgmised read faili <filename
>festival/lib/siteinit.scm</filename
>:</para>

<para>
<programlisting
>(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)
</programlisting>
</para>

<para
>otse rea ette, millel seisab</para>

<para>
<programlisting
>(provide 'siteinit)
</programlisting>
</para>

<para
>Mõnes süsteemis tuleb redigeerida faili <filename
>/etc/festival.scm</filename
>.</para>

</sect4>

</sect3>

</sect2>

<!-- ...................................................................... -->

<sect2 id="using-with-flite">
<title
>Festival Lite'i (flite) kasutamine</title>

<para
>Festival Lite on vaba avatud tarkvaraga mootor, mis toetab praegu piiratud arvu hääli ja keeli. See on väga väike, mistõttu mõnevõrra kannatab ka häälekvaliteet. &ktts; võimaldab juhtida mootori tooni, helitugevust ja kiirust.</para>

<para
>Süntesaatori nimi: <guilabel
>Festival Lite (flite)</guilabel
></para>

<para
>&URL;: <ulink url="http://www.speech.cs.cmu.edu/flite/index.html"
> http://www.speech.cs.cmu.edu/flite/index.html</ulink
> </para>

<para
>Debiani paigaldamiskäsk: <userinput
>apt-get install flite</userinput
></para>

<para
>flite on tavaliselt kaasas iga &Linux; distributsiooniga, nii et kontrolli oma distributsiooni CD-sid.</para>

<para
>Ehita ja paigalda flite juhiste järgi, mille leiad failist <filename
>README</filename
>.</para>

</sect2>

<!-- ...................................................................... -->


<sect2 id="using-with-hadifix">
<title
>Hadifixi kasutamine (&mbrola; ja txt2pho)</title>

<para
>Hadifix on kaheastmeline difoonipõhine sünteesimootor. Utiliit <command
>txt2pho</command
> teisendab teksti difoonideks ning &mbrola; mootor sünteesib difoonid heliks. Häälekvaliteet on hea, kuid keelte toetus praegu suhteliselt piiratud. <application
>kttsmgr</application
> võimaldab kontrollida häält, tooni, kiirust ja helitugevust. </para>

<para
>Süntesaatori nimi: <guilabel
>Hadifix</guilabel
></para>

<para
>&URL;: vaata allpool</para>

<para
>Debiani paigaldamiskäsk: puudub</para>

<para
>Kui sul ei ole Hadifix veel paigaldatud, tee seda nii:</para>

<procedure>
<step
><para
>Tõmba &mbrola; binaarfail aadressilt <ulink url="http://festvox.org/mbrola/"
>http://festvox.org/mbrola/</ulink
>.</para
></step>
<step
><para
>Paigalda &mbrola; kataloogi <filename
>/usr/local/mbrola</filename
>.</para
></step>
<step
><para
>Tõmba &mbrola; saidilt vähemalt üks saksa keele fail. Paki see lahti kataloogi <filename
>/usr/local/mbrola</filename
>.</para
></step>
<step
><para
>Tõmba txt2pho aadressilt</para>
<para
><ulink url="http://www.ikp.uni-bonn.de/dt/forsch/phonetik/hadifix/HADIFIXforMBROLA.html"
> http://www.ikp.uni-bonn.de/dt/forsch/phonetik/hadifix/HADIFIXforMBROLA.html</ulink
></para>
</step>
<step
><para
>Paki txt2pho lahti kataloogi <filename
>/usr/local/txt2pho</filename
>.</para
></step>
<step
><para
>Redigeeri faili <command
>txt2phorc</command
>, asetades sinna korrektsed andmete asukohad.</para
></step>
<step
><para
>Kopeeri <command
>txt2phorc</command
> asukohta <filename
>~/.txt2phorc</filename
> või <filename
>/etc/txt2pho</filename
>. Pane tähele, et kopeerimisel tuleb loobuda failinime lõputähtedest "rc".</para
></step>
<step
><para
>Vali <application
>kttsmgr</application
> dialoogis saksa keel (<guilabel
>de</guilabel
>) ja lisa <guilabel
>Hadifix</guilabel
>.</para
></step>
<step
><para
>Määra dialoogis <guilabel
>Kõneleja seadistamine</guilabel
> kindlaks hääl ning &mbrola; ja txt2pho asukohad.</para
></step>
<step
><para
>Klõpsa testimiseks nupule <guibutton
>Test</guibutton
>.</para
></step>
</procedure>

<para
>Ungari keelele kohandatud &mbrola; ja txt2pho on saadavad saidilt</para>

<para
><ulink url="http://tkltrans.sourceforge.net/"
>http://tkltrans.sourceforge.net/</ulink
>. </para>

</sect2>

<!-- ...................................................................... -->


<sect2 id="using-with-epos">
    <title
>Epose kasutamine</title>

<para
>Epos on vaba ja avatud tarkvaraga tšehhi ja slovaki keele mootor. See on väga väike, kuid seetõttu ka veidi kehvema häälekvaliteediga. &ktts; ei võimalda juhtida mootori helitugevust.</para>

<para
>Süntesaatori nimi: <guilabel
>Epos TTS sünteesisüsteem</guilabel
></para>

<para
>&URL;: <ulink url="http://epos.ure.cas.cz/"
>http://epos.ure.cas.cz/</ulink
> </para>

<para
>Debiani paigaldamiskäsk: <userinput
>apt-get install epos</userinput
></para>

<para
>Käivita <application
>kttsmgr</application
>. Klõpsa kaardil <guilabel
>Kõnelejad</guilabel
> nupule <guibutton
>Lisa</guibutton
>. Vali tšehhi või slovaki keel ning <guilabel
>EPOS TTS sünteesisüsteem</guilabel
>. Kui epose serveri käivitatav fail ja klient ei asu keskkonnamuutujaga <envar
>PATH</envar
> määratud asukohas, tuleb anda dialoogis <guilabel
>Kõneleja seadistamine</guilabel
> nende täpne asukoht. Lisavõtmete väljadel saab määrata serverile ja kliendile edastatavad lisavõtmed. Täpsemat infot leiab <application
>Konsool</application
>is käskudega <userinput
>epos -h</userinput
> või <userinput
>say -h</userinput
>.</para>

</sect2>

<!-- ...................................................................... -->


<sect2 id="using-with-freetts">
    <title
>FreeTTS kasutamine</title>

<para
>FreeTTS on vaba ja avatud tarkvara kõnemootor, mis on kirjutatud &Java; keeles. See tähendab, et selle kasutamiseks peab olema paigaldatud &Java; virtuaalmasin. Mootoril on praegu piiratud häälte ja keelte toetus. &ktts; ei võimalda juhtida ei helikõrgust, helitugevust ega kiirust.</para>

<para
>Süntesaatori nimi: <guilabel
>FreeTTS</guilabel
></para>

<para
>&URL;: <ulink url="http://sourceforge.net/projects/freetts/"
> http://sourceforge.net/projects/freetts/</ulink
> </para>

<para
>Debiani paigaldamiskäsk: puudub</para>

</sect2>

<!-- ...................................................................... -->


<sect2 id="using-with-command">
    <title
>Käsuplugina kasutamine</title>

<para
>Käsuplugin võimaldab kasutada &ktts;-i iga kõnesünteesi mootoriga, mida on võimalik käivitada käsurealt ehk <application
>Konsool</application
>ist.</para>

<para
>Süntesaatori nimi: <guilabel
>Käsk</guilabel
></para>

<para
>&URL;: puudub</para>

<para
>Debiani paigaldamiskäsk: puudub</para>

<para
>Ideaaljuhul tuleks kasutada käske, mis sünteesivad ajutist audio/wav-faili, mitte aga saata kõnet otse audioseadmele.</para>

<para
>Kui kõnesünteesi mootor nõuab tekstikodeeringut, mis erineb sinu töölaua kodeeringust, tuleb teksti edastamisel mootorile kasutada parameetrit <command
>%f</command
>. &ktts; kodeerib teksti seda ajutisse faili kirjutades sinu määratud kodeeringusse. Kui edastad teksti käsureal parameetriga <command
>%t</command
>, kodeeritakse see sinu töölauale määratud lokaadiga. Selle probleemi lahendamiseks võib kasutada ka valikut <guilabel
>Andmed saadetakse standardsisendina</guilabel
>, kui mootor ikka tunnustab sisendina standardsisendit (stdin). Toome siin näiteks käsu, millega saadetakse poolakeelne tekst Festivalile kodeeringuga ISO 8859-2 ning eemaldatakse kõneks sobimatud kirjavahemärgid.</para>

<para
><command
>cat %f | tr '(){}[]"' ' ' | festival --tts --language polish</command>
</para>

</sect2>

<!-- ====================================================================== -->

</sect1>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab 
-->
