README
1Description
2===========
3
4The XkbInd program (X Keyboard Extension Indicator) is a minimal
5indicator of keyboard layout (XKB group) for the X Window System; it
6indicates current keyboard layout in the title of top-level windows via
7prefix to the original string. It also allows to simulate independent
8keyboard layout for each handled window and it works with most of the
9window managers, including twm, mwm and fvwm.
10
11
12Main Features
13=============
14
15 1. XkbInd simulates independent keyboard layout for each handled
16 top-level window.
17
18 2. XkbInd is very light-weight and uses less than 150 kb of virtual memory
19 (excluding "shared", of course).
20
21 3. XkbInd doesn't grab entries in the default color pallet, doesn't
22 perform any drawing operations on the X display itself, but relies wholly
23 on the window manager.
24
25 4. XkbInd doesn't occupy any area on the screen, and outputs all relevant
26 information to the window title.
27
28 5. XkbInd can be configured to ignore (or accept) particular windows or
29 applications. This feature is based on examination of WM_CLASS property.
30 It is possible to use wildcards in the "ignore" and "accept" lists.
31
32 6. XkbInd is a "true" XKB program, i.e. all interactions with the X-server
33 are carried out through XKB extension protocol.
34
35 7. XkbInd keeps current layout of window at the server side as window
36 property, unlike the most other similar programs which keep this data
37 in the internal storage.
38
39 8. And the last, XkbInd does only what it says -- it is an indicator.
40 Nothing more.
41
42
43Installation
44============
45
46Firstly, you should download and unpack distribution archive:
47
48 $ tar xvzf xkbind-<version>.tar.gz
49
50To install XkbInd you should perform the following:
51
52 $ cd xkbind-<version>
53 $ ./configure
54 $ make
55 # make install (as root)
56
57For details, see INSTALL file.
58
59
60Configuration
61=============
62
63The program is highly configurable; it accepts many options most of which
64can be specified either on the command line, in the user's or system-wide
65configuration files. These files use standard X resources notation.
66For details use "man xkbind".
67
68
69Using
70=====
71
72The best place to run XkbInd is from ~/.xsession or ~/.xinitrc. Add the
73line "xkbind" to one of these files just before "exec" of window manager.
74
75
76Similar Programs
77================
78
79 1. FvwmKb <http://sourceforge.net/projects/fvwmkb>--XKB support module
80 for FVWM window manager.
81
82 2. xxkb <http://www.tsu.ru/~pascal/other/xxkb>--Another XKB indicator
83 with pixmap support.
84
85
86Contacts
87========
88
89Internet: http://xkbind.sf.net
90E-mail: smersh@users.sf.net
91
README.utf8.ru
1Описание
2========
3
4Xkbind (сокращение от X KeyBoard INDicator) показывает текущую раскладку
5клавиатуры в "многоязычных" конфигурациях, что значительно повышает
6удобство и скорость работы с текстами со смешанным набором символов.
7При этом каждому окну верхнего уровня присваивается своя индивидуальная
8группа, которая "включается" автоматически при получении окном фокуса,
9создавая эффект независимости раскладок.
10
11Особенностью программы является то, что номера присвоенных окнам
12групп хранятся не в памяти программы, как это обычно делается в
13аналогичных приложениях, а на стороне X-сервера в виде свойств окна.
14Это позволяет сделать привязку групп независимой от текущего состояния
15управляющей программы. Скажем, если вы перезагрузите Xkbind после
16некорректного завершения ее работы, все ранее установленные настройки
17будут восстановятся автоматически.
18
19Другой отличительной особенностью программы является то, что она
20не занимает места на экране компьютера, так как всю необходимую
21информацию выводит непосредственно в заголовок окна. Конечно,
22конкретное расположение заголовка (и вообще его наличие) целиком
23зависит от используемого менеджера окон. Xkbind поддерживает работу с
24большинством из них, включая TWM, MWM и FVWM.
25
26Xkbind очень экономичен в отношении занимаемой памяти (<150 килобайт)
27и практически не расходует рабочего времени процессора, что немаловажно
28для вспомогательного программного обеспечения.
29
30Xkbind имеет много опций конфигурации, большинство которых может
31задаваться как из командой строки, так и из файлов конфигурации,
32использующих стандартную нотацию X-ресурсов. Подробнее об этом можно
33узнать из прилагающегося файла помощи в man-формате. Xkbind читает
34опции конфигурации в следующей последовательности (в порядке убывания
35приоритета):
36
371. из параметров, заданных в командной строки;
38
392. в файле $(HOME)/.xkbindrc;
40
413. в файле $(HOME)/.Xdefaults или $(HOME)/.Xresources;
42
434. в файле /usr/local/lib/xkbind/app-defaults/Xkbind (конкретный путь
44 может отличаться в вашей системе, смотрите "Установка").
45
46Если одна и та же опция задана более одного раза, используется та,
47что имеет наивысший приоритет.
48
49
50Компиляция
51==========
52
53Для "сборки" программы необходимо выполнить следующие команды:
54
55 $ tar xvzf xkbind-<version>.tar.gz
56 $ cd xkbind-<version>
57 $ ./configure
58 $ make
59
60(Вместо <version> подставьте текущий номер версии.)
61
62
63Установка
64=========
65
66Для установки введите команду:
67
68 $ make install
69
70По умолчанию, установка производится в каталог "/usr/local/".
71Для установки в другом каталоге укажите путь к нему в переменной prefix:
72
73 $ make install prefix=<path>
74
75Подробнее об этом можно прочитать в текстовом файле INSTALL.
76
77
78Как пользоваться
79================
80
81Загружать Xkbind можно из командной строки или любым другим доступным
82способом. Для автоматической загрузки в начале каждой X-сессии, добавьте
83строку "xkbind" в .xsession или .xinitrc перед запуском менеджера окон.
84
85Так как программа не имеет собственного интерфейса, для корректного
86завершения ее работы следует использовать сигнал SIGTERM или SIGINT:
87
88 $ pkill xkbind
89
90Замечания
91=========
92
93Xkbind несовместим с приложениям, отслеживающим изменения в заголовках
94окон (свойств WM_NAME), например, другими индикаторами, работающими по
95тому же принципу, в том числе и со своей второй копией, но последнее
96отслеживается автоматически. Это следует иметь в виду при эксплуатации
97программы. Характерный признак несовместимости--испорченные заголовки
98в окнах.
99
100
101Аналогичные программы
102=====================
103
1041. FvwmKb <http://sourceforge.net/projects/fvwmkb>--модуль поддержки
105 XKB для менеджера окон FVWM.
106
1072. xxkb <http://www.tsu.ru/~pascal/other/xxkb>--индикатор и переключатель
108 раскладок XKB с поддержкой иконок.
109
110
111Контакты
112========
113
114Интернет: http://xkbind.sourceforge.net
115E-mail: smersh@users.sourceforge.net
116