<?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 kmyapplication "<application
>KTTS</application
>">
  <!ENTITY kappname "&kmyapplication;"
><!-- 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. -->
]>
<!-- 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
>&kmyapplication; käsiraamat</title>

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

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

<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-02-01</date>
<releaseinfo
>1.03.00</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para
>KDE teksti kõneks muutmise süsteem &kmyapplication; 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
>&kmyapplication; 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
>&kmyapplication; 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 Konqueroris.</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 aRtsi või GStreameri (versioon 0.8.7 või uuem) vahendusel.</para
></listitem>
<listitem
><para
>Seadistatavad filtrid valesti kõneldud sõnade asendamiseks, kõnesüntesaatori valimiseks ja 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
>&kmyapplication; 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 &kmyapplication; 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
>&kmyapplication; kasutamine</title>

<para>
<warning
><para
>Enne &kmyapplication; 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
>&kmyapplication; süsteemi käivitamiseks anna Konsoolil järgmine käsk </para>

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

<para
>või klõpsa &kmyapplication; 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="select-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="select-plugin">
<title
>Kõnesünteesi plugina (kõneleja) valik</title>

<para
>Klõpsuga kirjele <guilabel
>Kõnelejad</guilabel
> <command
>kttsmgr</command
> dialoogis ilmub nähtavale kaart <guilabel
>Kõnelejad</guilabel
>.</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 siia uue kõneleja ehk kõnesünteesiplugina 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.</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 &kmyapplication; süsteemis.</para
></callout>
</calloutlist>
</para>

<para
>Klõpsuga nupule <guilabel
>Lisa</guilabel
> 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. Vaata <xref linkend="configure-plugin"/>.</para
></callout>
</calloutlist>
</para>


<warning
><para
>Enne seda, kui saad käivitada &kmyapplication; süsteemi ja lasta arvutil teksti kõnelda, tuleb määrata vähemalt üks kõneleja ja klõpsata nupule <guilabel
>Rakenda</guilabel
> või <guilabel
>OK</guilabel
>. &kmyapplication; süsteemi käivitamiseks klõpsa kaardile <guilabel
>Üldine</guilabel
> ja märgi ära valik <guilabel
>Teksti kõneks muutmise süsteemi (KTTSD) lubamine</guilabel
>. Vaata <xref linkend="general"/>. </para>
</warning>

</sect1>

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


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

<para
>Kaardil <guilabel
>Kõnelejad</guilabel
> nupule <guilabel
>Lisa</guilabel
> klõpsates ja kõnelejat lisades või nupule <guilabel
>Muuda</guilabel
> 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"/>
			</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
>Klõpsa siia testimiseks. Peaksid kuulma testlauset.</para
></callout>
<callout arearefs="pt-prop-5"
><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-6"
><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 &kmyapplication; süsteemis. </para
></warning>

<para
>Kui test õnnestus, on &kmyapplication; 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 &kmyapplication;-d 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"/>
                    <area id="pt-gen-7" 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 &kmyapplication; 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 sees, ei ole sa veel määranud ühtegi kõnelejat (või oled unustanud klõpsata nupule <guilabel
>Rakenda</guilabel
>). Vaata <xref linkend="select-plugin"/>.</para
></note>
</para
></callout>
<callout arearefs="pt-gen-2"
><para
>Selle kasti märkimisel saab lasta kõnelda KDE märguandeid. Vaata <xref linkend="knotify"/>  .</para
></callout>
<callout arearefs="pt-gen-3"
><para
>Selle kasti märkimisel kõneldakse ainult neid KDE märguandeid, mida näidatakse hüpikaknas.</para
></callout>
<callout arearefs="pt-gen-4"
><para
>Selle kasti märkimisel kõneldakse ainult neid KDE märguandeid, mida näidatakse passiivses hüpikaknas.</para
></callout>
<callout arearefs="pt-gen-5"
><para
>Selle kasti märkimisel ilmub <command
>kttsmgr</command
> käivitamisel ikoon süsteemsesse salve. Selle korral ei põhjusta klõps nupule <guilabel
>OK</guilabel
> või <guilabel
>Loobu</guilabel
> 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 <guilabel
>OK</guilabel
> või <guilabel
>Loobu</guilabel
> lõpetab ühtlasi <command
>kttsmgr</command
> töö. <note
><para
>Kui <command
>kttsmgr</command
> lõpetab töö, jääb &kmyapplication; 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 KDE juhtimiskeskuses.</para
></note>
</para
></callout>
<callout arearefs="pt-gen-6"
><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-7"
><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"/>
			</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
>Selle tööriistariba nuppudega saab tekstitöid käivitada, kustutada ja peatada. Vali allolevast nimekirjast töö ja kasuta siis vajalikku nuppu.</para
></callout>
<callout arearefs="pt-jobmgr-2"
><para
>Selle tööriistariba 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-3"
><para
>Selle tööriistariba 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.</para
></callout>
<callout arearefs="pt-jobmgr-4"
><para
>Siin on näha parajasti kõneldav lause. Vajaduse korral saab paneeli suurust muuta, lohistades eraldajat üles- või allapoole.</para
></callout>
<callout arearefs="pt-jobmgr-5"
><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>
</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>

</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 <guilabel
>GStreamer</guilabel
> ei ole kasutatav, tähendab see, et &kmyapplication; on kompileeritud ilma GStreameri toetuseta või ei suuda &kmyapplication; laadida vajalikke GStreameri teeke. </para
></callout>
<callout arearefs="pt-audio-2"
><para
>Kui heliväljundiks on valitud GStreamer, vali siin GStreameri audioneelu meetod. Kui ühtegi neelu ei ole näha, tuleb vähemalt üks paigaldada. Vaata <xref linkend="requirements"/>. </para
></callout>
<callout arearefs="pt-audio-3"
><para
>Siin saab reguleerida kõneleimise 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-3"
><para
>Selle kasti märkimisel kopeerib &kmyapplication; 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 &kmyapplication; süsteemis. </para
></callout>
</calloutlist>
</para>

<note
><para
>&kmyapplication; 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>

</sect1>

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

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

<para
>Filtrid kujutavad endast &kmyapplication; võimsat lisaomadust. &kmyapplication; 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>

<para
>Filtrite kasutamiseks tuleks kõigepealt üritada mõista, kuidas &kmyapplication; teksti töötleb. &kmyapplication; 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
>Liigi määrab rakendus, mis saadab teksti &kmyapplication;-le. Ekraanilugeja väljundit kasutavad rakendused, mis on mõeldud pimedatele või vaegnägijatele. Ekraanilugeja väljund kõneldakse alati enne muid liike ning see katkestab kõik muud kõneliigid. Hoiatused ja teated on lühisõnumid, mis annavad teada mingist kiireloomulisest asjast. Need võivad katkestada tekstitöid. Hoiatustel on suurem prioriteet kui teadetel. Üks rakendusi, mis kasutab kõnelemisel teateid, on KMouth. Ka KDE märguanded on teated. Kõik muu on tavaline tekstitöö. Kõik tööd, mille käivitad kaardil <guilabel
>Tööd</guilabel
>, on tavalised tekstitööd. Üks rakendusi, mis kasutab tekstitöid, on KSayit. Tekstitööd on mõeldud pikemaks kõneks, mis ei ole väga prioriteetne.</para>

<para
>Filtrite juures tasuks kõigepealt tähele panna, et nad rakenduvad ainult tavalistele tekstitöödele ja KDE märguannetele. Filtreid ei rakendata ekraanilugeja väljundi, hoiatuste ega muude teadete korral.</para>

<para
>Filtreid on kaht tüüpo: tavalised filtrid ja lausepiiri tuvastamise (SBD) filtrid. SBD-filtrid jagavad teksti üksiklauseteks. See võimaldab &kmyapplication;-l 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. &kmyapplication; kasutab eelnevalt määratud stringasendusfiltreid lühendite, kiirsuhtluse emotikonide (näiteks ":-)") kõnelemiseks või Konversationi ja KMaili märguannete vorminduse muutmiseks mõistetavamaks. </para>

<para
>XML-i transformeerijad kasutavad XML-keele stiiliteisenduste (XSLT) faili ühes vormingus XML-i teisendamiseks teise vormingusse. &kmyapplication; pakub välja XSLT-faili XHTML-i teisendamiseks SSML-iks, kuid see on veel väga eksperimentaalne. </para>

<para
>Kõneleja valijad võimaldavad suuna töid kõnelejale vastavalt teksti sisule või rakendusele, mis töö &kmyapplication;-le saadab. Kui oled näiteks määratud kaardil <guilabel
>Kõnelejad</guilabel
> naishäälega kõneleja, võid saata kõik KDE märguanded just sellele kõnelejale. Vaata <xref linkend="select-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öö või KDE märguande saatmisel &kmyapplication;-le 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 SBD-filtreid ei läbi). Erinevalt tavalistest filtritest peatab esimene SBD-filter, mis teksti muudab, selle edasise töötlemise. </para>

<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. &kmyapplication; esmakäivitusel täidetakse nimekiri automaatselt kõigi filtritega, kuid nad ei ole aktiivsed. 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. Kui sellist laadi filtrit rohkem nimekirjas ei esine, seda ei eemaldata, vaid muudetakse ainult mitteaktiivseks.</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. &kmyapplication; 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 algajatele 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 id="stringreplacer">
<title
>Stringasendusfiltrite 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
>.</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. Nimekirja läbitakse siin antud järjekorras ülalt alla.</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 keelel. 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
>knotify,konversation</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 programm. 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
>&kmyapplication; 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 <guilabel
>Salvesta</guilabel
> selle salvestamiseks failina ning saada see siis &kmyapplication; meeskonnale, kes võib selle järgmise versiooniga juba kaasa panna.</para>

</sect2>

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

<sect2 id="xmltransformer">
<title
>XML-teisenduse filtrite seadistamine</title>

<para
>XML-teisenduse filter kasutab XSLT-faile XML-i teisendamiseks ühest vromingust 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.</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"/>
                    <area id="pt-xmltransformer-6" 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. See eristab üht XML-i vormi teisest.</para
></callout>
<callout arearefs="pt-xmltransformer-5"
><para
>Kui see ei ole tühi, rakendatakse filtrit ainult siis, kui XML-il määratud stringiga algav <command
><![CDATA[<!DOCTYPE]]></command
> spetsifikatsioon. Näiteks <command
><userinput
>html</userinput
></command
> korral on see <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-6"
><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
>knotify,konversation</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 programm. 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 kõik kastis <guilabel
>Filtri rakendamise tingimused</guilabel
> esinevad mittetühjad tingimused on täidetud.</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
>knotify</command
>, kõneldakse alati naishäälega. Vaata <xref linkend="select-plugin"/>.</para>

<para
>Enne seda, kui &kmyapplication; 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 &kmyapplication;-le 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"/>
                    <area id="pt-talkerchooser-6" 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
>knotify,konversation</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 programm. 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. Sellele nupule klõpsates saab määrata kindlaks keele.</para
></callout>
<callout arearefs="pt-talkerchooser-5"
><para
>Ka nende kirjetega saab määrata selle kõneleja omadusi, mida soovid teksti kõnelemiseks kasutada. Kõiki omadusi ei pruugi tingimata kindlaks määrata.</para
></callout>
<callout arearefs="pt-talkerchooser-6"
><para
>Neid kaste märkides saad määrata, et mingi omadus on tähtsam kui ülejäänud.</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.</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 keelt, mille &kmyapplication; on juba vaikimisi valinud. Kui rakendus, mis saadab teksti &kmyapplication;-le, ei määra keelt, omistab &kmyapplication; sellele kaardil <guilabel
>Kõnelejad</guilabel
> kõige esimesena seisva kõneleja keele. Ülejäänud omadused tühistavad alati vaikeväärtused. See tähendab, et kui jätad näiteks välja <guilabel
>Hinnang</guilabel
> tühjaks, kasutab kõneleja valija kõige paremini sobivat kõnelejat.</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 &kmyapplication; valib. Lülita kõneleja valija sisse, määra teatud omadused ja saada taas mingi teksti 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 &kmyapplication;-l 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 lausd ja samal ajal eemaldab kirjavahemärgid. Selleks lisa SBD-filter ning kasuta nuppu <guilabel
>Laadi</guilabel
> &kmyapplication;-ga 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) korral.</para>

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

</sect2>

</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. &kmyapplication; 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 seda 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 &kmyapplication; 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 &kmyapplication; 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
>Veebilehitsejat Konqueror kasutades võib lasta kõnelda näidatavaid veebilehekülgi. Selleks kontrolli esmalt, et &kmyapplication; 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 &kmyapplication; 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. &kmyapplication; 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. &kmyapplication; 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ärguannete seadistamine</guilabel
> menüüs <guilabel
>Seadistused</guilabel
>. Kuidas ja mida seadistada saab, sõltub muidugi ennekõike vastavast rakendusest endast.</para>

<para
>Kui soovid, et &kmyapplication; kõneleks KNotify tekstimärguandeid, käivita <command
>kttsmgr</command
>, vali kaart <guilabel
>Üldine</guilabel
> ning märgi ära kast <guilabel
>Märguannete kõnelemine (KNotify)</guilabel
>. Seejärel klõpsa nupule <guibutton
>Rakenda</guibutton
>.</para>

</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 &kmyapplication; ü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
>&kmyapplication; järgmises versioonis peaks SSML-i toetus olema juba palju parem ja korralikum. </para>

</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
>&kmyapplication; arendajatele</title>

<para
>&kmyapplication;-l on kaks programmiliidest (API): </para>

<itemizedlist>
<listitem
><para
>KDE tekst 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 &kmyapplication; 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
>&kmyapplication; 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
> vms. See käsk ei kõnele veel teksti, vaid seal 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
>Mul on vaja uuesti alustada. Kuidas &kmyapplication; 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 aadress).</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 &kmyapplication;, 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 &kmyapplication; 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>
</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
>&kmyapplication; </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
>&kmyapplication; kasutatavatel kõnesünteesi mootoritel on omaette litsentsid. Vaata neid mootorite dokumentatsioonist või veebisaidilt.</para
></note>

</chapter>

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

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

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


<sect1 id="getting-kapp">
<title
>&kmyapplication; 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 CVS-hoidlale, võid hankida &kmyapplication; moodulit <command
>kdeaccessibility</command
> välja võttes. &kmyapplication; on kataloogis <command
>kttsd</command
>. Samuti võib tõmmata kogu kdeaccessibility igaöise pakitud versiooni <ulink url="ftp://ftp.kde.org/pub/kde/unstable/latest/kdeaccessibility.tar.bz2"
> ftp://ftp.kde.org/pub/kde/unstable/latest/kdeaccessibility.tar.bz2</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</entry>
</row>

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

<row>
<entry
>Hadifix (MBROLA ja txt2pho)</entry>
<entry
>Saksa</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. </para
></note>

<note>
<para
>&kmyapplication; kasutab kõnesünteesi mootorite jaoks paindlikku pluginaarhitektuuri. Kui soovid &kmyapplication;-d 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>
</itemizedlist>
</para>

<para
>Lisakomponendid:</para>

<para>
<itemizedlist>

<listitem>
<para
>Audioutiliiti <command
></command
> läheb vaja üldise kõnelemiskiiruse 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>

<listitem>
<para
>GStreamer versioon 0.8.7 või uuem. Vaikimisi kasutab &kmyapplication; heliväljundina aRts'i, kuid GStreameri paigaldamisel võid ka selle valida. GStreameri saab hankida aadressilt </para>

<para
><ulink url="http://gstreamer.freedesktop.org/"
>http://gstreamer.freedesktop.org/</ulink
></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
>&kmyapplication; 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 &kmyapplication; 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
>Kui sul on paigaldatud GStreamer 0.8.7 või uuem ning soovid ehitada &kmyapplication; GStreameri toetusega, anna järgmised käsud:</para>

<programlisting
>./configure --enable-kttsd-gstreamer
make
</programlisting>

<para
>Vaikimisi paigaldavad toodud käsud &kmyapplication; 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 &kmyapplication; järgmiste käskudega:</para>

<programlisting
>su
make install
</programlisting>

<para
>Kui oled tõmmanud &kmyapplication; lähtekoodi <filename
>kdeaccessibility</filename
> CVS-moodulist või laadinud alla CVS-i 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 &kmyapplication; kasutamist, et kõnesünteesi mootor töötab. Järgi mootoriga kaasasolevaid juhiseid.</para>

<tip>
<para
>Mõnel juhul võib olla vajalik lubada audioseadmele 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 &kmyapplication;-s.</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. </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 ühebaidine kirillitsakodeering, näiteks <userinput
>KOI8-R</userinput
>.</para>

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

<para
>Käivita <userinput
>kttsmgr</userinput
>. Klõpsa kaardil <guilabel
>Kõnelejad</guilabel
> nupule <guilabel
>Lisa</guilabel
>. Vali <guilabel
>Festival Interactive</guilabel
> ja <guilabel
>Keel</guilabel
>. Kui dialoogi <guilabel
>Kõneleja seadistamine</guilabel
> ei ilmu, klõpsa nupule <guibutton
>Muuda</guibutton
>. Kui Festivali käivitatav fail ei asu keskkonnamuutujaga <envar
>PATH</envar
> määratud asukohas, anna käivitatava faili täielik asukoht. Klõpsa nupule <guibutton
>Otsi uuesti</guibutton
>. vali hääl ja klõpsa nupule <guibutton
>Test</guibutton
>. Seejärel peaksid kuulma testlauset.</para>

<note>
<para
>Poola või tšehhi keele kasutamisel peab <guilabel
>kKodeering</guilabel
> kindlasti olema <userinput
>ISO 8859-2</userinput
>. </para>
<para
>Vene hääle kasutamisel peab <guilabel
>kKodeering</guilabel
> kindlasti olema ühebaidine kirilitsakodeering, 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 teksti 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. &kmyapplication; 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 aadressitl <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>

</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. &kmyapplication; 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 <guilabel
>Lisa</guilabel
>. 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(tm)-keeles. See tähendab, et selle kasutamiseks peab olema paigaldatud Java virtuaalmasin. Mootoril on praegu piiratud häälte ja keelte toetus. &kmyapplication; 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 &kmyapplication;-d 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
>. &kmyapplication; 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 
-->
