Doc map
[sgc.git] / doc / sgcmanual-en.pango.html
blob5ef75af48a84b6645d7627c15c30345fcd4e83e6
1 <br/>
2 <span size="xx-large"><b>SpeakGoodChinese</b></span><br/>
3 <span size="small">(shuo1 hao3 zhong1 wen2)</span><br/>
4 <br/>
5 <span size="x-large"><b>Manual</b></span><br/>
6 <br/>
7 <br/>
8 <span size="large">Aim</span><br/>
9 <br/>
10 The SpeakGoodChinese tone recognizer (SGC) helps you to practise pronouncing Mandarin Chinese tones.<br/>
11 <br/>
12 <br/>
13 <span size="large">Features</span><br/>
14 <br/>
15 - The tone recogniser analyses your pronunciation of the Chinese tones by using techniques in speech recognition.<br/>
16 - It shows you via a graphical presentation the difference between your pronunciation of the tones and the standard pronunciation.<br/>
17 - It also gives you a written analysis of your pronunciation.<br/>
18 - You can listen to a hummed example of a tone or tone combination, before you record your pronunciation.<br/>
19 - You can listen to your own recorded pronunciation.<br/>
20 - You can practise all one or two syllabic words of Mandarin Chinese by simply adding them to the wordlist yourself. The wordlist is then saved automatically for your future visits.<br/>
21 <br/>
22 <br/>
23 <span size="large">Preconditions</span><br/>
24 <br/>
25 You need a headset with a microphone. The tone recogniser will only work reliably when your surroundings are quiet during the recording. Check the settings of the audio-mixer to ensure that your voice is neither recorded too loudly (clipped sounds) or too softly.<br/>
26 <br/>
27 <i>Please note:</i><br/>
28 You should always type in the pinyin as is it featured in the dictionary. Tone changes in words with two syllables are a built-in feature of SGC. That means that, e.g SGC will recognise ni2hao3 as the correct pronunciation for ni3hao3. There are, however, exceptions to this:<br/>
29 <br/>
30 - Yi1 (written as a horizontal one-stroke character) can change from a first tone into a second or a fourth tone, depending on the following syllable. SGC does not automatically convert yi1 into the desired tone. We advise you to type in the required tone for yi yourself.<br/>
31 <br/>
32 - Bu4 (not) In Mandarin Chinese the word bu4 (= not) changes its fourth tone into a second tone when followed by a verb carrying a fourth tone. For example bu4kan4 (to not look) is pronounced as bu2kan4. SGC does not automatically.<br/>
33 This is due to the fact that there are other words pronounced as bu4 that carry meanings other than 'not', to which therefore the tone change does not apply. We advise you to type in the second tone for bu in combination with a fourth tone verb to ensure you practise the right pronunciation.<br/>
34 <br/>
35 <br/>
36 <span size="x-large"><b>Display</b></span><br/>
37 <br/>
38 <span size="large">Tone contours</span><br/>
39 <br/>
40 The black line on the display screen, called the reference pitch, is the graphical representation of the requested tone / tones. After recording the contour of your own pronunciation of the tone / tones appears in red. <br/>
41 <br/>
42 <br/>
43 <span size="large">Pinyin</span><br/>
44 <br/>
45 On the display, you can read the pinyin transcription of the requested word including a number for the tone. The neutral tone is depicted by 0, a first tone by 1 etc. After you have recorded your own pronunciation, it will be replaced by the written recognition result.<br/>
46 <br/>
47 <br/>
48 <span size="large">Recognition result</span><br/>
49 <br/>
50 After processing your pronunciation, SGC will give you the result printed out below the graphical recognition result. If your rendition of the tones was acceptable, you will receive a positive result, such as 'correct'. If not, SGC will try to tell you what you pronounced instead. When your pronunciation of the tones is not clear enough for the application to recognise, a question mark [?] appears instead. The advice will try to explain what has happened. We also advise you to compare your pitch in red to the reference pitch. Before trying again you might want to listen to the audio example of the requested tone(s).<br/>
51 <br/>
52 <br/>
53 <span size="x-large"><b>Buttons</b></span><br/>
54 <br/>
55 <span size="large">Record</span><br/>
56 <br/>
57 Record your voice.<br/>
58 You have 5 seconds to pronounce the requested word. The recording stops automatically. SpeakGoodChinese does not work well if there is background noise. Also, some microphones can add a lot of noise, which can interfere with the recognition. The tone recognizer assumes that you try to speak the requested word. If you pronounce a different word, the results are unpredictable. SpeakGoodChinese will try to isolate the word you speak from other sounds. This means that if you pause between syllables, either syllable might be cut off. In this case, the results of the recognition will be completely random.<br/>
59 <br/>
60 <br/>
61 <span size="large">Play</span><br/>
62 <br/>
63 Replay the recorded pronunciation.<br/>
64 <br/>
65 <br/>
66 <span size="large">Example</span><br/>
67 <br/>
68 Play an example. In the Play menu, you can choose whether to play hummed tones, or existing recordings. The hummed tones (without the words) help you understand how the tones should sound. You can play them every time before you record your pronunciation. See Menu - Play.<br/>
69 <br/>
70 <br/>
71 <span size="large">Previous</span><br/>
72 <br/>
73 Go to the previous item on the list.<br/>
74 <br/>
75 <br/>
76 <span size="large">Next</span><br/>
77 <br/>
78 Go to the next item on the list. See Add on how to add you own new words. <br/>
79 <br/>
80 <br/>
81 <span size="x-large"><b>Menu</b></span><br/>
82 <br/>
83 <span size="large">File - Open</span><br/>
84 <br/>
85 Open a wordlist or distribution from your computer.<br/>
86 <br/>
87 <br/>
88 <span size="large">File - Quit</span><br/>
89 <br/>
90 Leave the application.<br/>
91 <br/>
92 <br/>
93 <span size="large">Play</span><br/>
94 <br/>
95 <i>Before - Voice</i> Play a recording made before.<br/>
96 <br/>
97 <i>Before - Hum</i> Resynthesize the last recording with the correct tones.<br/>
98 <br/>
99 <br/>
100 <i>Example - Voice</i> Play a pre-recorded example or resynthesize the last recording with the correct tones.<br/>
101 <br/>
102 <i>Example - Hum</i> Generate a hummed tone contour of the pinyin on the display, before you record the word. This is an example of how your tone or tone combination should sound.<br/>
103 <br/>
104 <br/>
105 <span size="large">Voice</span><br/>
106 <br/>
107 Choose what type of voice you have.<br/>
108 If the written feedback says that your voice is too high or too low, this might mean that your tones are correct but your choice of the voice register (hertz) needs to be adjusted. You can change the base register of your voice in the Voice Menu, i.e. by choosing a higher or a lower hertz and try to find a voice register that makes your own voice (red line) match the Reference Pitch (black line) best. The frequency (in Hz) indicated is the ideal frequency of the first tone.<br/>
109 <i>Male (150Hz)</i> - Low range male<br/>
110 <i>Male (200Hz)</i> - Medium range male<br/>
111 <i>Female (300Hz)</i> - Mid range female<br/>
112 <i>Child (450Hz)</i> - High pitch voice, child<br/>
113 <br/>
114 <br/>
115 <span size="large">Wordlists</span><br/>
116 <br/>
117 <i>Installed wordlists</i> - These wordlists are installed.<br/>
118 <br/>
119 <i>Edit</i> - This screen allows you to add, remove, store and distribute your wordlists. See: The Editor.<br/>
120 <br/>
121 <br/>
122 <span size="large">Help</span><br/>
123 <br/>
124 <i>Help</i> - This text and Mandarin Theory<br/>
125 <br/>
126 <i>About</i> - About the SpeakGoodChinese application<br/>
127 <br/>
128 <br/>
129 <span size="x-large"><b>The Editor</b></span><br/>
130 <br/>
131 <span size="large">Buttons</span><br/>
132 <br/>
133 <i>Add</i> - Adds a new word (san1) on the end of the list.<br/>
134 <i>Remove</i> - Removes the current selection word from the list.<br/>
135 <i>Close</i> - Closes the current window.<br/>
136 <br/>
137 <br/>
138 <span size="large">The Wordlist</span><br/>
139 <br/>
140 You are able to click on a word to select it, another click would allow you to edit this word. In order move the word sequence you can drag an unselected word to another position.<br/>
141 <br/>
142 You can add one or two syllable words in Mandarin Chinese pinyin. Do not use spaces between pinyin syllables. Use numbers to indicate the tones. Each syllable is followed by a number to represent the tone. 1 resembles the first tone, etc. For example: ni3hao3 (hello). Use number 0 for a neutral tone (also referred to as 5th tone), e.g. ma1ma0 (mother). Type v for pinyin ü, e.g. type nv3 for nü3 (female).<br/>
143 <br/>
144 <br/>
145 <span size="large">Menu</span><br/>
146 <br/>
147 <i>New</i> - Clears the current wordlist.<br/>
148 <i>Open</i> - Opens a wordlist, stored vertically in a plain text file (dos format).<br/>
149 <i>Save</i> - Saves the current wordlist.<br/>
150 <i>Save As</i> - Saves the current wordlist under another name.<br/>
151 <i>Distribute</i> - Saves the current wordlist inside a SpeakGoodChinese distribution file (zip deflated).<br/>
152 <i>Close</i> - Closes the current window.<br/>
153 <br/>
154 <br/>
155 <span size="x-large"><b>Contact</b></span><br/>
156 <br/>
157 Contact us at mail@speakgoodchinese.org<br/>
158 <br/>
159 <br/>
160 <i>Xue2xi2 jin4bu4! Wishing you progress in your studies!</i><br/>