summaryrefslogtreecommitdiffstats
path: root/tde-i18n-et/docs/tdeaccessibility/kttsd/index.docbook
blob: 137ed1f7e7e8a52b2238c84b77ad5c7085a42bf3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY ktts "<application>KTTS</application>">
  <!ENTITY kappname "&ktts;">
  <!ENTITY package "tdeaccessibility">
  <!ENTITY mbrola "<application>MBROLA</application>">
  <!ENTITY % imageobjectco.module "INCLUDE">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Estonian  "INCLUDE">
]>
<!-- 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 [email protected]
with lots of help from: Eric Bischoff [email protected]
and Frederik Fouvry [email protected]
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>[email protected]</email> </author>

<othercredit role="translator"><firstname>Marek</firstname> <surname>Laane</surname> <affiliation><address><email>[email protected]</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>tdeaccessibility</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>libtdehtmlkttsdplugin</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>tdetexteditor_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.trinitydesktop.org/">http://bugs.trinitydesktop.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>tdeutils</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 &ktts; 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> &ktts;</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>$TDEHOME/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>[email protected]</email> </para>
<para>Praegune hooldaja: Gary Cramblitt <email>[email protected]</email> </para>
<para>Kaasautorid: <itemizedlist>
<listitem><para>Olaf Schmidt <email>[email protected]</email></para>
</listitem>
<listitem><para>Gunnar Schmi Dt <email>[email protected]</email></para>
</listitem>
<listitem><para>Paul Giannaros <email>[email protected]</email></para>
</listitem>
</itemizedlist>
</para>

<para>Dokumentatsiooni autoriõigus &copy; 2004: Gary R. Cramblitt <email>[email protected]</email> </para>

<para>Tõlge eesti keelde: Marek Laane <email>[email protected]</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 tdeaccessibility</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>tdeaccessibility</command> välja võttes. &ktts; on kataloogis <command>kttsd</command>. Samuti võib tõmmata kogu tdeaccessibility 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 tdelibs 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>TDEDIRS</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>tdeaccessibility</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 tdeaccessibility
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 
-->