File: HOWTO-configure.txt

package info (click to toggle)
yudit 2.5.4-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 8,528 kB
  • ctags: 8,403
  • sloc: cpp: 59,394; ansic: 2,585; perl: 2,398; makefile: 864; sh: 321
file content (401 lines) | stat: -rw-r--r-- 14,894 bytes parent folder | download
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
Yudit: HOWTO-configure.txt
=====================================================================
Version: 2.2
Author:  Gaspar Sinai <gsinai@yudit.org>
Date:    Tokyo 2001-02-06

This Document describes how to configure Yudit. 
=====================================================================
1 Configuration File Loading

 At start-up Yudit reads the configuration file:
  <prefix>/share/yudit/config/yudit-properties
 where <prefix> is the installation prefix, usually /usr.
 This is the system configuration file. If the file is found, it merges 
 the entries with the default compiled in the binary. After start-up 
 it tries  to create 
   ~/.yudit
   ~/.yudit/fonts
   ~/.yudit/data
 directories, if they are not there. ~/ means the user's home 
 directory, like '/home/gsinai'. It tries to load 
   ~/.yudit/yudit.properties
 file. The existing entries in this file will override the previously
 loaded  system configuration entries.

 When exiting Yudit, yudit will merge certain parameters in this file
 with some parameters that the user can change inside Yudit. Currently
 the overwritten parameters are:
  yudit.editor.font
  yudit.editor.fontsize
  yudit.editor.input
  yudit.filetypes

=====================================================================
2 Configuration File Format

 The configuration files consists of lines of:
  hierarchical.key.string=value
 or
  hierarchical.key.string=value1,value2,value3
 It is very important that no extra space is left anywhere.
 It is possible to use the '\<newline>' character to join two
 separate lines  but it is not desirable, especially in the user 
 config file. Yudit will join these lines in that file.
 
 Keep in mind: when an array is specified in the system config file 
 with value1,value2,value3 and the same array is in the user config
 file, with myvalue1,myvalue2 all elements of the array will be coming
 from the user config file: myvalue1,myvalue2.

=====================================================================
3 Basic Configuration Parameters

These are the parameters that have profound effect on yudit. You can
add virtual fonts, choices to the editor window like font sizes, 
input methods.

---------------------------------------------------------------------
3.1 yudit.datapath

 Array parameter. Example: 
  yudit.datapath=/usr/share/yudit/data,/home/gsinai/data,...
 This is a very important parameter. This will define the search path,
 yudit will locate the my-files it needs to map fonts, create input
 methods and converters.
 Note that 
  <prefix>/yudit/data
  ~/.yudit/data
 directories will always be appended to the list.

---------------------------------------------------------------------
3.2 yudit.fontpath

 Array parameter. Example:
  yudit.fontpath=/usr/share/yudit/fonts,/usr/share/truetype/,...
 This parameter defines the search path for True Types fonts.
 Note that 
  <prefix>/yudit/fonts
  ~/.yudit/fonts
 directories will always be appended to the list.

---------------------------------------------------------------------
3.3 yudit.fonts, yudit.editor.fonts (4.1)

 Array parameters. Both define the available fonts. 
 yudit.editor.fonts(4.1) defines the available fonts that can be selected
 from Yudit in the editor window. The available fonts in other parts of 
 the gui (labels, buttons) are a superset of the two.

 Example:
  yudit.editor.fonts=default,TrueType,Bitmap
  yudit.fonts=buttonfont,labelfont
 With this the following virtual fonts will be available:

 Shift-F1 - default
 Shift-F2 - TrueType
 Shift-F3 - Bitmap

 Any names can be used. The name "None" or "none" are specials they
 mean that no font change is desirable even though the corresponding
 Shift-Fxx combination was pressed.

 These virtual font names should be defined later in
  yudit.font.<fontname>
 parameter. The name default is defined internally, and it is not
 desirable to be defined in yudit.font.default unless you know what
 you are doing.
---------------------------------------------------------------------
3.4 yudit.font.<fontname>

 Array. This defines the virtual font that was specified in 3.3.
 Example:
  yudit.font.TrueType=arial.ttf,cyberbit.ttf,*-iso8859-1
 This defines a virtual font that can be referred to by the TrueType
 alias. This virtual font tries to find, 3 font files in the 
 fontpath (3.2) and if not found it tries to load them as x11 fonts.
 Most likely it will find:
  /usr/share/yudit/font/arial.ttf
  /usr/share/yudit/font/cyberbit.ttf
 and it wont find any file name  *-iso8859-1, so it will try to get 
 the closes match from X11 server, some font like:
    -adobe-courier-bold-o-normal--12-120-75-75-m-70-iso8859-1
 in case the font size we use was 12. The *-iso8859-1 was a bit
 lazy declaration, it can be defined to be more accurate.

 Yudit has built-in converters for most of the standard X11 
 font encodings.(source swindow/sx11/SX11Font.cpp)
  *-iso10646-1 
  *-iso8859-<1-9>
  *-koi8-1
  *-koi8-r
  *-ksc5601*
  *-jisx0208*
  *-jisx0201*
  *-jisx0212*-0
  *-big5*
  *-gb2312*
  *-iso646*
 To check the fonts available in your X11 server types 
  xlsfonts
 at the shell prompt.

 Yudit has has built-in ucs-2 converter for True Type fonts. 
 This is good for True Type fonts that have platform=3 encoding=1
 platform=2 encoding=1 or platform=1 attributes. If you have a font
 that does not have unicode table I need to modify the encodingVector
 in swindow/SFontTTF.cpp in the yudit source tree to add an encoder.
 Please send me your modifications if any.

=====================================================================
4 Menu Configuration Parameters

These configuration parameters will make up choices in the editor.

---------------------------------------------------------------------
4.1 yudit.editor.fonts

 Array. It defines the font choices in the gui. See also
 
  yudit.fonts

---------------------------------------------------------------------
4.2 yudit.editor.fontsizes

 Array. It defines the available font sizes.
 Example:
  yudit.editor.fontsize=12,14,16,18,24,48

 As X11 font sizes will be defined as integers, please do not use
 floating point values here. This value will replace the font size
 in XLFD for X11 fonts. True Type fonts will be scaled as if the screen
 were 72dpi.  

---------------------------------------------------------------------
4.3 yudit.editor.inputs

 Array. It defines the user-selectable input methods. These input methods
 can come from a .my file  on yudit.datapath (3.1.). Please note the the
 kmap files in <prefix>/yudit/src are installed for reference only. 
 They can only be used after being converted into .my format and properly 
 put in a directory on yudit.datapath - most of them are.

 config example:
  yudit.editor.inputs=straight,unicode,kinput2,Hungarian,None,Esperanto\
     freehand
  
 This will load:
 F1 straight: built-in - no mapping
 F2 unicode: build-in - \uxxxx escapes
 F3 kinput2: built-in - _JAPANESE_CONVERSION
 F4 Hungarian: external Hungarian.my file is searched and
  possibly found in /usr/share/yudit/data/Hungarian.my
 F5 None: nothing will happen when pressing F5
 F6 Esperanto: external, like Hungarian
 F7 freehand: internal, handwriting engine with external handwriting 
  description files.

 If you want to create you own .my keyboard input file, you should 
 read the <prefix>/share/yudit/doc/keymap-format.txt
 file, and consult the man page for the mytool program.

 As kmaps can be used as external text converters, uniconv -h will
 list the ones it can find on the datapath.

 You can also create your own freehand recognitin file. Please read
 <prefix>/share/yudit/doc/README-FREEHAND for a recepie. 

---------------------------------------------------------------------
4.4 yudit.editor.filetypes

 Array. This list will be appended to the original list of file types in
 the File Dialog. Normally File Dialog would show the built-in types 
 only. This is also known as encoding (3.6.)
 Exapmle:
  yudit.editor.filetypes=Hungarian,Hangul
 I use these key maps to transliterate Hungarian or Hangul text.

=====================================================================
5. Default Configuration Parameters

These parameters set some initial values.

---------------------------------------------------------------------
5.1 yudit.default.filtype

 String. It defines the encoding used initially when invoking Yudit.
 To get a full list of supported encodings type 
  uniconv -h
 in a shell window. This is also known as File Type in the file dialog
 window.
 Example:
 yudit.default.filetype=utf-8

---------------------------------------------------------------------
5.2 yudit.default.printer.options

 String. It defines the options that is passed to the 'lpr' command
 when printing.
 Example:
  yudit.default.printer.options=-P PrinterName

---------------------------------------------------------------------
5.3 yudit.default.preview.command

 String. It defines the command used when the preview button is 
 pressed. This is a full unix command that will be executed by
  /bin/sh -c 'whatever you configured'
 and the postscript output will be piped into this command.
 Example:
  yudit.default.preview.command=ghostview -

---------------------------------------------------------------------
5.4 yudit.default.clipboard.encoding

 This is the clipboard encoder to cut and paste in X11 if the requested
 text type is COMPOUND_TEXT. COMPOUND_TEXT could be decoded with yudit
 if there were an universal decoder. Encoding on the other hand, has
 some ambiguity as there are characters that occupy the same unicode
 character but they are distinct in COMPOUND_TEXT. For this, reason,
 and because yudit does not have a universal decoder, we need to 
 explicitly set this encoder. Try to use some iso-2022-x11 for Japanese
 XWindow or ksc-5601-x11 for Korean XWindow.

5.5 yudit.default.geometry

 This specifies the initial size of the editor window. The default
 value is "780x480". That is 780 pixels wide 480 pixels high.

=====================================================================
6 Configuration Parameters to Change Appearance

These parameters change the colors, fonts in the gui and the editing
area. All these parameters are strings. All colors can be color names
or #rrggbb values where rr,gg and bb are 8-bit hexadecimal color codes
for red, green and blue color components. Boolean values can be true or
false.

---------------------------------------------------------------------
6.1 yudit.default.language

 The language of the user interface. Please take a look at
  <prefix>/share/yudit/locale/
 to see the two letter names the are supported.
 Example:
 yudit.default.language=ja
 If this parameter is not present or it is a zero sized string the
 environment variable LANG or if not present LANGUAGE is used. 
 If everything fails English is used.
 If you are interested in translating yudit to your own language
 you should read  <prefix>/share/yudit/README.TXT
---------------------------------------------------------------------
6.2 yudit.default.font

 While yudit.editor.font sets the initial font in the editing area
 this will set the font in  other components, labels and buttons.

---------------------------------------------------------------------
6.3 yudit.default.fontsize

 While yudit.editor.fontsize sets the initial font size in the
 editing area this will set the font size in other components,
 labels and buttons.
---------------------------------------------------------------------
6.4 yudit.background

 The background color of Yudit windows.
---------------------------------------------------------------------
6.5 yudit.label.foreground

 The foreground color of labels-like windows.
---------------------------------------------------------------------
6.6 yudit.title.foreground

  The foreground color of title-like windows.
---------------------------------------------------------------------
6.7 yudit.editor.background

 The background color of the editor area.
---------------------------------------------------------------------
6.8 yudit.editor.left.foreground

 The foreground color of left-to-right text in editor window.
---------------------------------------------------------------------
6.9 yudit.editor.right.foreground

 The foreground color of right-to-left text in editor window.
---------------------------------------------------------------------
6.10 yudit.editor.caret.left.foreground

 The color of the left-to-right caret in the editor window.

---------------------------------------------------------------------
6.11 yudit.editor.caret.right.foreground
 The color of the right-to-left caret in the editor window.

---------------------------------------------------------------------
6.12 yudit.editor.showbreak

 Boolean. Accepted values: true or false.
If this is true yudit will visually indicate the end of line characters.

---------------------------------------------------------------------
6.13 yudit.command.background

 The background color of the command area.
---------------------------------------------------------------------
6.14 yudit.command.left.foreground

 The foreground color of left-to-right text in command area.

---------------------------------------------------------------------
6.15 yudit.command.right.foreground=yellow

 The foreground color of right-to-left text in command area.

---------------------------------------------------------------------
6.16 yudit.command.caret.left.foreground

 The color of the left-to-right caret in the command area.

---------------------------------------------------------------------
6.17 yudit.command.caret.right.foreground

 The color of the right-to-left caret in the command area.

---------------------------------------------------------------------
6.18 yudit.command.font

 String. Virtual font in the command area

---------------------------------------------------------------------
6.19 yudit.command.fontsize

 String. The font size in the command area.

---------------------------------------------------------------------
6.20 yudit.slider.background
 The color of the slider. 

=====================================================================
7 Configuration Parameters Overwritten by Yudit

The following parameters are updated by yudit when it exists.

---------------------------------------------------------------------
7.1 yudit.editor.input

 String. Last input that was used by the editor when it exited. 
 See yudit.editor.inputs.

---------------------------------------------------------------------
7.2 yudit.editor.font

 String. Virtual font that was used by the editor when it exited.. 
 See yudit.editor.fonts.

---------------------------------------------------------------------
7.3 yudit.editor.fontsize

 String. The font size that was used by the editor when it exited. 
 See yudit.editor.fontsizes.