Changed layout of Setting page and added ZH/JA translations
[sgc2.git] / ManPages / Speech_Synthesis_in_SpeakGoodChinese.man
bloba1867020510133db3b7147ba787925b9b5e25e11
1 ManPagesTextFile
2 "Speech Synthesis in SpeakGoodChinese" "R.J.J.H. van Son" 20150916 0
3 <intro> "How to change the pinyin synthesis"
5 <entry> "Text-To-Speech synthesis in SpeakGoodChinese"
6 <normal> "SpeakGoodChinese uses the %%eSpeak% Text-To-Speech (%%TTS%) 
7 engine that is build into Praat. %%eSpeak% has several Mandarin voices. 
8 You cycle through them when you click on the %%Voice% button on the 
9 %%Settings% page. Voices that start with an %%F% are supposed to be 
10 ""female"" voices, those starting with an %%M% are supposed to be ""male"" voices. "
11 <normal> "The voice labled ""*"" is the system's default synthesizer. 
12 On a Macintosh computer, this is the %%Say% program. On Linux this will 
13 be the %%spd-say% speech dispatcher, if it is installed. The Macintosh %%Say% 
14 program has a rather good synthesis quality. The Linux %%spd-say% program 
15 is more like another %%eSpeak% instance."
17 <entry> "Installing chinese voices on the Macintosh (OSX)"
18 <normal> "If the ""*"" voice does not work on your Macintosh computer, 
19 you probably do not have the correct Mandarin voice installed. 
20 To install Mandarin speech synthesis on you Macintosh, open 
21 %%System Preferences...%. Locate and open the %%Dictation & Speech% item. 
22 Select the %%Text to Speech% tab. Click on the %%System voice% menu. 
23 At the bottom of the %%System voice% menu, select %%Customize...% and 
24 scroll down until you find %%Chinese (China)% and tick the box for 
25 %%Ting-Ting%."
26 <normal> "Your computer will download and install the selected voices. 
27 This can take a lot of time."
29 <entry> "Changing to another speech synthesis program"
30 <normal> "%%SpeakGoodChinese% can use external Text-To-Speech synthesis 
31 programs as long as they have a %%command-line interface% (%%CLI%). 
32 The command to call this program on the computer must be stored in a 
33 text file in the %%TTS% folder in the %%Preferences% directory. "
34 <normal> "%%Note: This has not yet been tested on Windows.%"
36 <normal> "First, locate the %%Preferences% directory on the computer. "
38 <normal> "For a single user %%<User name>%, the local %%Preferences% directory is:"
39 <list_item> "\bu MS Windows: %%C:\bsDocuments and Settings\bs<User name>\bsSpeakGoodChinese2\bsTTS%"
40 <list_item> "\bu Mac OSX: %%/Users/<User name>/Library/Preferences/SpeakGoodChinese2/TTS%"
41 <list_item> "\bu Linux: %%/home/<User name>/.SpeakGoodChinese2/TTS%"
43 <normal> "To install this for all users, place them in the global %%Preferences% directory:"
44 <list_item> "\bu MS Windows: %%C:\bsDocuments and Settings\bsAll Users\bsApplication Data\bsSpeakGoodChinese2\bsTTS%"
45 <list_item> "\bu Mac OSX: %%/Library/Preferences/SpeakGoodChinese2/TTS%"
46 <list_item> "\bu Linux: %%/etc/SpeakGoodChinese2/TTS%"
48 <normal> "The name of the text file containing the %%TTS% command depends on the computer platform:"
49 <list_item> "\bu MS Windows: %%TTS_WINDOWS_eSpeak_command.txt%"
50 <list_item> "\bu Mac OSX: %%TTS_OSX_eSpeak_command.txt%"
51 <list_item> "\bu Linux: %%TTS_UNIX_eSpeak_command.txt%"
53 <normal> "The command file should only contain a single line of text 
54 with the command to speak the text. The commands to call the TTS synthesis 
55 should be constructed in such a way that a pinyin string can be appended at the end."
56 <normal> "Examples are:"
57 <list_item> "\bu Mac OSX: $$say -vTing-Ting$"
58 <list_item> "\bu Linux: $$spd-say -l zh -t female1 -r -60$"
60 <normal> "While such a file is present for the operating system running 
61 %%SpeakGoodChinese%, the program will only use that to synthesize speech. "