요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Punctuation과 review speech
sysfs-driver-speakup:87-164화면 출력과 review command의 punctuation level, repeated character 읽기, control-key announcement와 spelling delay를 다룹니다.
Synthesizer 선택과 direct access
sysfs-driver-speakup:166-188현재 synthesizer driver를 조회·교체하고 Speakup 처리를 우회해 문자열이나 control sequence를 직접 보냅니다.
Internationalization message table
sysfs-driver-speakup:190-265Announcement, key·function·state name, character pronunciation, color와 formatted message를 변경합니다.
Synthesizer-specific parameter
sysfs-driver-speakup:267-395Synthesizer directory의 uppercase marker, punctuation ownership, frequency, timeout, timing, pitch·inflection·rate·tone·voice·volume를 제어합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/accessibility/speakup/attrib_bleep
2
KernelVersion: 2.6
3
Contact: speakup@linux-speakup.org
4
Description: Beeps the PC speaker when there is an attribute change such as
5
foreground or background color when using speakup review
6
commands. One = on, zero = off.
8
What: /sys/accessibility/speakup/bell_pos
9
KernelVersion: 2.6
10
Contact: speakup@linux-speakup.org
11
Description: This works much like a typewriter bell. If for example 72 is
12
echoed to bell_pos, it will beep the PC speaker when typing on
13
a line past character 72.
15
What: /sys/accessibility/speakup/bleeps
16
KernelVersion: 2.6
17
Contact: speakup@linux-speakup.org
18
Description: This controls whether one hears beeps through the PC speaker
19
when using speakup's review commands.
20
TODO: what values does it accept?
22
What: /sys/accessibility/speakup/bleep_time
23
KernelVersion: 2.6
24
Contact: speakup@linux-speakup.org
25
Description: This controls the duration of the PC speaker beeps speakup
26
produces.
27
TODO: What are the units? Jiffies?
29
What: /sys/accessibility/speakup/cursor_time
30
KernelVersion: 2.6
31
Contact: speakup@linux-speakup.org
32
Description: This controls cursor delay when using arrow keys. When a
33
connection is very slow, with the default setting, when moving
34
with the arrows, or backspacing etc. speakup says the incorrect
35
characters. Set this to a higher value to adjust for the delay
36
and better synchronisation between cursor position and speech.
38
What: /sys/accessibility/speakup/cur_phonetic
39
KernelVersion: 6.2
40
Contact: speakup@linux-speakup.org
41
Description: This allows speakup to speak letters phoneticaly when arrowing through
42
a word letter by letter. This doesn't affect the spelling when typing
43
the characters. When cur_phonetic=1, speakup will speak characters
44
phoneticaly when arrowing over a letter. When cur_phonetic=0, speakup
45
will speak letters as normally.
47
What: /sys/accessibility/speakup/delimiters
48
KernelVersion: 2.6
49
Contact: speakup@linux-speakup.org
50
Description: Delimit a word from speakup.
51
TODO: add more info
53
What: /sys/accessibility/speakup/ex_num
54
KernelVersion: 2.6
55
Contact: speakup@linux-speakup.org
56
Description: TODO:
58
What: /sys/accessibility/speakup/key_echo
59
KernelVersion: 2.6
60
Contact: speakup@linux-speakup.org
61
Description: Controls if speakup speaks keys when they are typed. One = on,
62
zero = off or don't echo keys.
64
What: /sys/accessibility/speakup/keymap
65
KernelVersion: 2.6
66
Contact: speakup@linux-speakup.org
67
Description: Speakup keymap remaps keys to Speakup functions.
68
It uses a binary
69
format. A special program called genmap is needed to compile a
70
textual keymap into the binary format which is then loaded into
71
/sys/accessibility/speakup/keymap.
73
What: /sys/accessibility/speakup/no_interrupt
74
KernelVersion: 2.6
75
Contact: speakup@linux-speakup.org
76
Description: Controls if typing interrupts output from speakup. With
77
no_interrupt set to zero, typing on the keyboard will interrupt
78
speakup if for example
79
the say screen command is used before the
80
entire screen is read.
82
With no_interrupt set to one, if the say
83
screen command is used, and one then types on the keyboard,
84
speakup will continue to say the whole screen regardless until
85
it finishes.
87
What: /sys/accessibility/speakup/punc_all
88
KernelVersion: 2.6
89
Contact: speakup@linux-speakup.org
90
Description: This is a list of all the punctuation speakup should speak when
91
punc_level is set to four.
93
What: /sys/accessibility/speakup/punc_level
94
KernelVersion: 2.6
95
Contact: speakup@linux-speakup.org
96
Description: Controls the level of punctuation spoken as the screen is
97
displayed, not reviewed. Levels range from zero no punctuation,
98
to four, all punctuation. One corresponds to punc_some, two
99
corresponds to punc_most, and three as well as four both
100
correspond to punc_all. Some hardware synthesizers may have
101
different levels each corresponding to three and four for
102
punc_level. Also note that if punc_level is set to zero, and
103
key_echo is set to one, typed punctuation is still spoken as it
104
is typed.
106
What: /sys/accessibility/speakup/punc_most
107
KernelVersion: 2.6
108
Contact: speakup@linux-speakup.org
109
Description: This is a list of all the punctuation speakup should speak when
110
punc_level is set to two.
112
What: /sys/accessibility/speakup/punc_some
113
KernelVersion: 2.6
114
Contact: speakup@linux-speakup.org
115
Description: This is a list of all the punctuation speakup should speak when
116
punc_level is set to one.
118
What: /sys/accessibility/speakup/reading_punc
119
KernelVersion: 2.6
120
Contact: speakup@linux-speakup.org
121
Description: Almost the same as punc_level, the differences being that
122
reading_punc controls the level of punctuation when reviewing
123
the screen with speakup's screen review commands. The other
124
difference is that reading_punc set to three speaks punc_all,
125
and reading_punc set to four speaks all punctuation, including
126
spaces.
128
What: /sys/accessibility/speakup/repeats
129
KernelVersion: 2.6
130
Contact: speakup@linux-speakup.org
131
Description: A list of characters speakup repeats. Normally, when there are
132
more than three characters in a row, speakup
133
just reads three of
134
those characters. For example, "......" would be read as dot,
135
dot, dot. If a . is added to the list of characters in repeats,
136
"......" would be read as dot, dot, dot, times six.
138
What: /sys/accessibility/speakup/say_control
139
KernelVersion: 2.6
140
Contact: speakup@linux-speakup.org
141
Description: If set to one, speakup speaks shift, alt and control when those
142
keys are pressed. If say_control is set to zero, shift, ctrl,
143
and alt are not spoken when they are pressed.
145
What: /sys/accessibility/speakup/say_word_ctl
146
KernelVersion: 2.6
147
Contact: speakup@linux-speakup.org
148
Description: TODO:
150
What: /sys/accessibility/speakup/silent
151
KernelVersion: 2.6
152
Contact: speakup@linux-speakup.org
153
Description: TODO:
155
What: /sys/accessibility/speakup/spell_delay
156
KernelVersion: 2.6
157
Contact: speakup@linux-speakup.org
158
Description: This controls how fast a word is spelled
159
when speakup's say word
160
review command is pressed twice quickly to speak the current
161
word being reviewed. Zero just speaks the letters one after
162
another, while values one through four
163
seem to introduce more of
164
a pause between the spelling of each letter by speakup.
166
What: /sys/accessibility/speakup/synth
167
KernelVersion: 2.6
168
Contact: speakup@linux-speakup.org
169
Description: Gets or sets the synthesizer driver currently in use. Reading
170
synth returns the synthesizer driver currently in use. Writing
171
synth switches to the given synthesizer driver, provided it is
172
either built into the kernel, or already loaded as a module.
174
What: /sys/accessibility/speakup/synth_direct
175
KernelVersion: 2.6
176
Contact: speakup@linux-speakup.org
177
Description: Sends whatever is written to synth_direct
178
directly to the speech synthesizer in use, bypassing speakup.
179
This could be used to make the synthesizer speak
180
a string, or to
181
send control sequences to the synthesizer to change how the
182
synthesizer behaves.
184
What: /sys/accessibility/speakup/version
185
KernelVersion: 2.6
186
Contact: speakup@linux-speakup.org
187
Description: Reading version returns the version of speakup, and the version
188
of the synthesizer driver currently in use.
190
What: /sys/accessibility/speakup/i18n/announcements
191
KernelVersion: 2.6
192
Contact: speakup@linux-speakup.org
193
Description: This file contains various general announcements, most of which
194
cannot be categorized. You will find messages such as "You
195
killed Speakup", "I'm alive", "leaving help", "parked",
196
"unparked", and others. You will also find the names of the
197
screen edges and cursor tracking modes here.
199
What: /sys/accessibility/speakup/i18n/chartab
200
KernelVersion: 2.6
201
Contact: speakup@linux-speakup.org
202
Description: TODO
204
What: /sys/accessibility/speakup/i18n/ctl_keys
205
KernelVersion: 2.6
206
Contact: speakup@linux-speakup.org
207
Description: Here, you will find names of control keys. These are used with
208
Speakup's say_control feature.
210
What: /sys/accessibility/speakup/i18n/function_names
211
KernelVersion: 2.6
212
Contact: speakup@linux-speakup.org
213
Description: Here, you will find a list of names for Speakup functions.
214
These are used by the help system. For example, suppose that
215
you have activated help mode, and you pressed
216
keypad 3. Speakup
217
says: "keypad 3 is character, say next."
218
The message "character, say next" names a Speakup function, and
219
it comes from this function_names file.
221
What: /sys/accessibility/speakup/i18n/states
222
KernelVersion: 2.6
223
Contact: speakup@linux-speakup.org
224
Description: This file contains names for key states.
225
Again, these are part of the help system. For instance, if you
226
had pressed speakup + keypad 3, you would hear:
227
"speakup keypad 3 is go to bottom edge."
229
The speakup key is depressed, so the name of the key state is
230
speakup.
232
This part of the message comes from the states collection.
234
What: /sys/accessibility/speakup/i18n/characters
235
KernelVersion: 2.6
236
Contact: speakup@linux-speakup.org
237
Description: Through this sys entry, Speakup gives you the ability to change
238
how Speakup pronounces a given character. You could, for
239
example, change how some punctuation characters are spoken. You
240
can even change how Speakup will pronounce certain letters. For
241
further details see '12. Changing the Pronunciation of
242
Characters' in Speakup User's Guide (file spkguide.txt in
243
source).
245
What: /sys/accessibility/speakup/i18n/colors
246
KernelVersion: 2.6
247
Contact: speakup@linux-speakup.org
248
Description: When you use the "say attributes" function, Speakup says the
249
name of the foreground and background colors. These names come
250
from the i18n/colors file.
252
What: /sys/accessibility/speakup/i18n/formatted
253
KernelVersion: 2.6
254
Contact: speakup@linux-speakup.org
255
Description: This group of messages contains embedded formatting codes, to
256
specify the type and width of displayed data. If you change
257
these, you must preserve all of the formatting codes, and they
258
must appear in the order used by the default messages.
260
What: /sys/accessibility/speakup/i18n/key_names
261
KernelVersion: 2.6
262
Contact: speakup@linux-speakup.org
263
Description: Again, key_names is used by Speakup's help system. In the
264
previous example, Speakup said that you pressed "keypad 3."
265
This name came from the key_names file.
267
What: /sys/accessibility/speakup/<synth-name>/
268
KernelVersion: 2.6
269
Contact: speakup@linux-speakup.org
270
Description: In `/sys/accessibility/speakup` is a directory corresponding to
271
the synthesizer driver currently in use (E.G) `soft` for the
272
soft driver. This directory contains files which control the
273
speech synthesizer itself,
274
as opposed to controlling the speakup
275
screen reader. The parameters in this directory have the same
276
names and functions across all
277
supported synthesizers. The range
278
of values for freq, pitch, rate, and vol is the same for all
279
supported synthesizers, with the given range being internally
280
mapped by the driver to more or less fit the range of values
281
supported for a given parameter by the individual synthesizer.
282
Below is a description of values and parameters for soft
283
synthesizer, which is currently the most commonly used.
285
What: /sys/accessibility/speakup/<synth-name>/caps_start
286
KernelVersion: 2.6
287
Contact: speakup@linux-speakup.org
288
Description: This is the string that is sent to the synthesizer to cause it
289
to start speaking uppercase letters. For the soft synthesizer
290
and most others, this causes the pitch of the voice to rise
291
above the currently set pitch.
293
What: /sys/accessibility/speakup/<synth-name>/caps_stop
294
KernelVersion: 2.6
295
Contact: speakup@linux-speakup.org
296
Description: This is the string sent to the synthesizer to cause it to stop
297
speaking uppercase letters. In the case of the soft synthesizer
298
and most others, this returns the pitch of the voice
299
down to the
300
currently set pitch.
302
What: /sys/accessibility/speakup/<synth-name>/delay_time
303
KernelVersion: 2.6
304
Contact: speakup@linux-speakup.org
305
Description: TODO:
307
What: /sys/accessibility/speakup/<synth-name>/direct
308
KernelVersion: 2.6
309
Contact: speakup@linux-speakup.org
310
Description: Controls if punctuation is spoken by speakup, or by the
311
synthesizer.
313
For example, speakup speaks ">" as "greater", while
314
the espeak synthesizer used by the soft driver speaks "greater
315
than". Zero lets speakup speak the punctuation. One lets the
316
synthesizer itself speak punctuation.
318
What: /sys/accessibility/speakup/<synth-name>/freq
319
KernelVersion: 2.6
320
Contact: speakup@linux-speakup.org
321
Description: Gets or sets the frequency of the speech synthesizer. Range is
322
0-9.
324
What: /sys/accessibility/speakup/<synth-name>/flush_time
325
KernelVersion: 5.12
326
Contact: speakup@linux-speakup.org
327
Description: Gets or sets the timeout to wait for the synthesizer flush to
328
complete. This can be used when the cable gets faulty and flush
329
notifications are getting lost.
331
What: /sys/accessibility/speakup/<synth-name>/full_time
332
KernelVersion: 2.6
333
Contact: speakup@linux-speakup.org
334
Description: TODO:
336
What: /sys/accessibility/speakup/<synth-name>/jiffy_delta
337
KernelVersion: 2.6
338
Contact: speakup@linux-speakup.org
339
Description: This controls how many jiffys the kernel gives to the
340
synthesizer. Setting this too high can make a system unstable,
341
or even crash it.
343
What: /sys/accessibility/speakup/<synth-name>/pitch
344
KernelVersion: 2.6
345
Contact: speakup@linux-speakup.org
346
Description: Gets or sets the pitch of the synthesizer. The range is 0-9.
348
What: /sys/accessibility/speakup/<synth-name>/inflection
349
KernelVersion: 5.8
350
Contact: speakup@linux-speakup.org
351
Description: Gets or sets the inflection of the synthesizer, i.e. the pitch
352
range. The range is 0-9.
354
What: /sys/accessibility/speakup/<synth-name>/punct
355
KernelVersion: 2.6
356
Contact: speakup@linux-speakup.org
357
Description: Gets or sets the amount of punctuation spoken by the
358
synthesizer. The range for the soft driver seems to be 0-2.
359
TODO: How is this related to speakup's punc_level, or
360
reading_punc.
362
What: /sys/accessibility/speakup/<synth-name>/rate
363
KernelVersion: 2.6
364
Contact: speakup@linux-speakup.org
365
Description: Gets or sets the rate of the synthesizer. Range is from zero
366
slowest, to nine fastest.
368
What: /sys/accessibility/speakup/<synth-name>/tone
369
KernelVersion: 2.6
370
Contact: speakup@linux-speakup.org
371
Description: Gets or sets the tone of the speech synthesizer. The range for
372
the soft driver seems to be 0-2. This seems to make no
373
difference if using espeak and the espeakup connector.
374
TODO: does espeakup support different tonalities?
376
What: /sys/accessibility/speakup/<synth-name>/trigger_time
377
KernelVersion: 2.6
378
Contact: speakup@linux-speakup.org
379
Description: TODO:
381
What: /sys/accessibility/speakup/<synth-name>/voice
382
KernelVersion: 2.6
383
Contact: speakup@linux-speakup.org
384
Description: Gets or sets the voice used by the synthesizer if the
385
synthesizer can speak in more than one voice. The range for the
386
soft driver is 0-7. Note that while espeak supports multiple
387
voices, this parameter will not set the voice when the espeakup
388
connector is used between speakup and espeak.
390
What: /sys/accessibility/speakup/<synth-name>/vol
391
KernelVersion: 2.6
392
Contact: speakup@linux-speakup.org
393
Description: Gets or sets the volume of the speech synthesizer. Range is 0-9,
394
with zero being the softest, and nine being the loudest.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Speakup sysfs ABI 공통 사항
1-395모든 항목의 담당자는 speakup@linux-speakup.org다. 별도 표기가 없으면 kernel 2.6부터 제공된다. 원문에 TODO만 있거나 값·단위가 미정인 항목은 문서에 없는 의미를 추정하지 않고 그대로 표시한다.
PC speaker, cursor와 phonetic reading
1-51| Attribute | Kernel | 설명 |
|---|---|---|
| attrib_bleep | 2.6 | Speakup review command를 사용할 때 foreground·background color 같은 attribute가 바뀌면 PC speaker로 beep한다. 1은 on, 0은 off다. |
| bell_pos | 2.6 | Typewriter bell처럼 동작한다. 예를 들어 72를 쓰면 한 line에서 72번째 character를 지나 입력할 때 PC speaker가 beep한다. |
| bleeps | 2.6 | Speakup review command 사용 중 PC speaker beep를 들을지 제어한다. 원문에는 허용값을 확인해야 한다는 TODO가 남아 있다. |
| bleep_time | 2.6 | Speakup이 만드는 PC-speaker beep의 지속 시간을 제어한다. 단위가 jiffy인지 원문 TODO로 남아 있어 확정되지 않았다. |
| cursor_time | 2.6 | Arrow key 사용 시 cursor delay를 조정한다. Connection이 매우 느릴 때 기본값으로 이동·backspace를 하면 잘못된 character를 말할 수 있으므로 값을 높여 cursor position과 speech의 synchronization을 맞춘다. |
| cur_phonetic | 6.2 | Word를 letter 단위로 arrow 이동할 때 phonetic pronunciation을 사용할지 정한다. Typing 중 spelling에는 영향이 없다. 1이면 phonetic, 0이면 normal pronunciation이다. |
| delimiters | 2.6 | Speakup에서 word를 구분하는 delimiter다. 원문에는 세부 설명을 추가해야 한다는 TODO가 남아 있다. |
Key echo, binary keymap과 speech interruption
53-86| Attribute | 설명 |
|---|---|
| ex_num | 원문 Description이 TODO뿐이며 의미가 정의되어 있지 않다. |
| key_echo | 입력한 key를 Speakup이 말할지 제어한다. 1은 on, 0은 off 또는 key echo 없음이다. |
| keymap | Key를 Speakup function으로 remap한다. Binary format을 사용하므로 textual keymap을 genmap program으로 compile한 뒤 이 파일에 load해야 한다. |
| no_interrupt | Typing이 Speakup output을 interrupt할지 제어한다. 0이면 say-screen 도중 key를 누를 때 speech가 중단된다. 1이면 typing과 관계없이 전체 screen 읽기를 끝까지 계속한다. |
Textual keymap에서 key와 Speakup function 정의→genmap으로 binary format compile→/sys/accessibility/speakup/keymap에 load→Speakup이 새 key binding 사용
Sysfs keymap은 사람이 읽는 text가 아니라 genmap이 만든 binary data를 받는다.
화면 출력과 review의 punctuation level
87-127| Attribute | 설명 |
|---|---|
| punc_all | punc_level=4일 때 Speakup이 말해야 하는 모든 punctuation 목록이다. |
| punc_level | Screen이 표시될 때, review가 아닌 일반 speech에서 읽는 punctuation level이다. 0은 없음, 1은 punc_some, 2는 punc_most, 3과 4는 punc_all에 대응한다. 일부 hardware synthesizer는 3과 4를 서로 다른 level로 취급할 수 있다. punc_level=0이어도 key_echo=1이면 입력한 punctuation은 말한다. |
| punc_most | punc_level=2일 때 읽는 punctuation 목록이다. |
| punc_some | punc_level=1일 때 읽는 punctuation 목록이다. |
| reading_punc | Speakup screen-review command로 화면을 검토할 때 읽는 punctuation level이다. punc_level과 거의 같지만 3은 punc_all, 4는 space까지 포함한 모든 punctuation을 말한다. |
Levelpunc_levelreading_punc
01
0Punctuation 없음Punctuation 없음
02
1punc_somepunc_some
03
2punc_mostpunc_most
04
3punc_allpunc_all
05
4punc_all 또는 hardware-specificSpace 포함 모든 punctuation
같은 punctuation 목록을 참조하지만 일반 screen speech와 review command의 level 3·4 의미가 다르다.
Repeated character, control key와 spelling
128-164| Attribute | 설명 |
|---|---|
| repeats | Speakup이 반복 횟수를 함께 말할 character 목록이다. 보통 같은 character가 세 개보다 많이 이어지면 처음 세 개만 읽는다. 예를 들어 목록에 '.'이 없으면 '......'을 'dot, dot, dot'으로 읽고, '.'을 repeats에 넣으면 'dot, dot, dot, times six'으로 읽는다. |
| say_control | 1이면 shift, alt, control key를 눌렀을 때 그 이름을 말하고 0이면 말하지 않는다. |
| say_word_ctl | 원문 Description이 TODO뿐이며 의미가 정의되어 있지 않다. |
| silent | 원문 Description이 TODO뿐이며 의미가 정의되어 있지 않다. |
| spell_delay | Say-word review command를 빠르게 두 번 눌러 현재 word를 spell할 때 letter 사이의 속도를 제어한다. 0은 letter를 연속으로 말하고, 1부터 4는 값이 커질수록 각 letter 사이 pause가 늘어나는 것으로 설명돼 있다. |
Synthesizer driver 선택과 우회 전송
166-188| Attribute | 설명 |
|---|---|
| synth | 현재 사용 중인 synthesizer driver를 읽거나 설정한다. 읽으면 driver 이름을 반환한다. 쓰면 kernel에 built-in이거나 module로 이미 load된 지정 driver로 전환한다. |
| synth_direct | 쓴 내용을 Speakup 처리를 우회해 현재 speech synthesizer로 직접 보낸다. String을 말하게 하거나 synthesizer 동작을 바꾸는 control sequence를 보낼 수 있다. |
| version | Speakup version과 현재 사용 중인 synthesizer-driver version을 반환한다. |
입력Speakup layerSynthesizer
01
Screen textReview·punctuation·key policy 적용가공된 speech command
02
synth_direct writeBypassRaw string 또는 control sequence
synth_direct는 pronunciation·punctuation 같은 Speakup processing을 거치지 않는다.
Announcement, help function과 key-state 이름
190-233| i18n attribute | 설명 |
|---|---|
| announcements | 분류하기 어려운 일반 announcement를 담는다. 예로 'You killed Speakup', 'I'm alive', 'leaving help', 'parked', 'unparked'와 screen edge·cursor tracking mode 이름이 있다. |
| chartab | 원문 Description이 TODO뿐이며 의미가 정의되어 있지 않다. |
| ctl_keys | Control key 이름을 담으며 say_control 기능이 사용한다. |
| function_names | Help system이 사용하는 Speakup function 이름 목록이다. Help mode에서 keypad 3을 누를 때 나오는 'character, say next' 같은 function 설명이 여기서 온다. |
| states | Help system이 사용하는 key-state 이름을 담는다. 예를 들어 Speakup key를 누른 채 keypad 3을 누르면 'speakup keypad 3 is go to bottom edge'라고 말하며, 여기서 'speakup' state 이름이 이 collection에서 온다. |
Character pronunciation, color와 formatted message
234-265| i18n attribute | 설명 |
|---|---|
| characters | 특정 character의 pronunciation을 바꾼다. Punctuation뿐 아니라 letter 발음도 변경할 수 있다. 자세한 내용은 source의 spkguide.txt, '12. Changing the Pronunciation of Characters'를 참조한다. |
| colors | Say-attributes function이 말하는 foreground·background color 이름을 제공한다. |
| formatted | 표시 data의 type과 width를 지정하는 embedded formatting code가 들어간 message group이다. 변경할 때 모든 formatting code를 보존하고 default message와 같은 순서로 유지해야 한다. |
| key_names | Help system이 사용하는 key 이름이다. 예를 들어 'keypad 3'이라는 이름이 이 파일에서 온다. |
Synthesizer-specific directory
267-283/sys/accessibility/speakup/<synth-name>/은 현재 사용 중인 synthesizer driver에 대응하는 directory다. 예를 들어 soft driver는 soft directory를 사용한다.
이 directory의 파일은 Speakup screen reader가 아니라 speech synthesizer 자체를 제어한다. 지원되는 모든 synthesizer에서 parameter 이름과 기능은 같고 freq, pitch, rate, vol의 사용자 범위도 같다. Driver는 이 공통 범위를 개별 synthesizer가 지원하는 실제 값 범위에 대략 맞게 내부 mapping한다.
이후 설명은 현재 가장 흔히 쓰이는 soft synthesizer의 값과 동작을 기준으로 한다.
Uppercase marker, direct punctuation과 timing
285-341| Synth attribute | Kernel | 설명 |
|---|---|---|
| caps_start | 2.6 | Uppercase letter를 말하기 시작할 때 synthesizer로 보내는 string이다. Soft synthesizer와 대부분의 다른 driver에서는 현재 pitch보다 voice pitch를 올린다. |
| caps_stop | 2.6 | Uppercase letter 읽기를 끝낼 때 보내는 string이다. Soft synthesizer와 대부분의 driver에서 voice pitch를 현재 설정값으로 되돌린다. |
| delay_time | 2.6 | 원문 Description이 TODO뿐이며 의미가 정의되어 있지 않다. |
| direct | 2.6 | Punctuation을 Speakup이 말할지 synthesizer가 말할지 정한다. 0이면 Speakup, 1이면 synthesizer가 담당한다. 예를 들어 '>'를 Speakup은 'greater', soft driver의 espeak는 'greater than'으로 말할 수 있다. |
| freq | 2.6 | Speech synthesizer frequency를 읽거나 설정한다. 범위는 0..9다. |
| flush_time | 5.12 | Synthesizer flush 완료를 기다리는 timeout을 읽거나 설정한다. Cable fault 때문에 flush notification을 잃는 경우 사용할 수 있다. |
| full_time | 2.6 | 원문 Description이 TODO뿐이며 의미가 정의되어 있지 않다. |
| jiffy_delta | 2.6 | Kernel이 synthesizer에 주는 jiffy 수를 제어한다. 너무 높게 설정하면 system이 불안정해지거나 crash할 수 있다. |
Pitch, inflection, punctuation, rate, tone, voice와 volume
343-395| Synth attribute | Kernel | 범위와 설명 |
|---|---|---|
| pitch | 2.6 | Synthesizer pitch를 읽거나 설정한다. 범위는 0..9다. |
| inflection | 5.8 | Synthesizer inflection, 즉 pitch range를 읽거나 설정한다. 범위는 0..9다. |
| punct | 2.6 | Synthesizer가 말하는 punctuation 양을 읽거나 설정한다. Soft driver 범위는 0..2로 보인다. Speakup punc_level·reading_punc와의 관계는 원문 TODO로 남아 있다. |
| rate | 2.6 | Synthesizer speech rate를 읽거나 설정한다. 0은 가장 느리고 9는 가장 빠르다. |
| tone | 2.6 | Synthesizer tone을 읽거나 설정한다. Soft driver 범위는 0..2로 보인다. espeak와 espeakup connector 조합에서는 차이가 없는 것으로 보이며 espeakup의 다른 tonality 지원 여부는 원문 TODO다. |
| trigger_time | 2.6 | 원문 Description이 TODO뿐이며 의미가 정의되어 있지 않다. |
| voice | 2.6 | 여러 voice를 지원하는 synthesizer에서 사용할 voice를 읽거나 설정한다. Soft driver 범위는 0..7이다. espeak는 여러 voice를 지원하지만 Speakup과 espeak 사이에 espeakup connector를 쓰면 이 parameter로 voice를 설정할 수 없다. |
| vol | 2.6 | Synthesizer volume을 읽거나 설정한다. 범위는 0..9이며 0은 가장 작고 9는 가장 크다. |
Keyboard, cursor와 beep feedback
sysfs-driver-speakup:1-86Attribute change beep, typewriter bell, cursor synchronization, phonetic cursor reading, key echo와 speech interruption을 제어합니다.