updated on Sun Jan 15 16:02:00 UTC 2012
[aur-mirror.git] / staybox / README
blobb6e4c8311e489194b5ef103cc9f54e09775951aa
1 /***************************** РУССКИЙ ************************************/
2  
3  staybox  - легкий менеджер сесии для *box оконных менеджеров.
4  Не использует для работы GDM & KDM, а скорее всего конфликтует с ними. 
5  Поддержку DM реализовывать не планируется, в мажорной версии будет реализована 
6  поддержка XDM (опционально).
7  
8  Внимание! Проект заточен под использование механизмов HAL для управления
9  режимов работы компьютера. Настройки политик HAL смотрите в FAQ вашего 
10  дистрибутива.
11  Зависимости:
12         gtk+-2.0 >= 2.6.0 
13         glib-2.0 >= 2.6.0 
14         dbus-1
16   Использован код проeктов XFCE, LXDE, значки ob-logout.
19  Установка стандартным способом. 
20  ________________________________
21     ./configure --sysconfdir=/etc --prefix=/usr
22     make
23     make install
24  ________________________________
26 В текущей версии поставляется скрипт staybox-session, для вызова из .xinitrc
27 В альфа версии офиициальный баг - необходимо вручную установить на него 
28 права на выполнение.
29     chmod +x $pkgdir/usr/bin/staybox-session || return 1
30     
31  Для использование в качестве менеджера сессии при запуске startx   
32  vi .xinitrc
33  ___________________
34         #!/bin/sh
35         #
36         # ~/.xinitrc
37         #
38         # Executed by startx (run your window manager from here)
40         exec staybox-session
41  _________________      
43 Для выхода из сесии выполните команду staybox-logout, или внесите её в меню Вашего 
44 менеджера окон.
46 Настройка. 
47 Openbox - менеджер окон по умолчанию.
48 Оконный менеджер указывается глобально, в файле /etc/xdg/staybox/config
49 _____________
50 [general]
51 manager=openbox
52 _____________
54 Все другие настройки производятся и находятся в пространстве пользователя.
55 Каталог настроечных файлов - ~/config/staybox
57 Автозагрузка приложений.
58 Автозагрузка производится двумя способами:
59 1) Из конфигурационного файла менеджера сесии в каталоге пользователя.
61 ~/.config/staybox/autostart
63 Формат файла - команда запуска приложения с параметрами, 
64 отдельно для каждого приложения.
65 Пример:
66 ___________________________________________
67 setxkbmap -rules evdev -model sven -layout "us,ru" -variant ",winkeys" -option "grp:rctrl_toggle,grp_led:scroll"
68 setxkbmap -option terminate:ctrl_alt_bksp
69 ____________________________________________
71 Строка может начинаться с символа @ - в таком случае приложение отслеживается 
72 менеджером сессии и при падении будет перезапущено. Остановленные пользователем
73 игнорируются.
74 Пример:
75 ______________
76 @xscreensaver -no-splash
77 @tint2
78 setxkbmap -rules evdev -model sven -layout "us,ru" -variant ",winkeys" -option "grp:rctrl_toggle,grp_led:scroll"
79 setxkbmap -option terminate:ctrl_alt_bksp
80 ______________
82 Комментарии ( строки начинающиеся с # ) игнорируются.
84 2) Автозапуск приложений из каталога ~/.config/autostart пользователя.
85 Обрабатываются стандартные .desktop файлы в соответствии со спецификацией XDG.
86 Примеры и документация доступны в сети.
88 Настройка внешнего вида окна выхода.
89 Файл конфигурации ~/.config/staybox/logout
91 -------
92 [general]
93 theme=oxygen 
94 -------
95 Тема кнопок действий. Тема по умолчанию находится в %PREFIX%/share/staybox/themes
96 Пользовательские темы должны находиться в каталоге ~/.icons/staybox/ИМЯ_ТЕМЫ
97 ---------
98 [button]
99 bgcolor=#4D4D4D
100 size=100
101 ---------
102 Цвет подсветки кнопки при наведении и размер кнопки.
104 [label]
105 color=#E5E5E5
106 Цвет подписи к кнопкам. Стили шрифтов в текущем релизе не поддерживаются.
109 / *************************** ENG **************************************/
110         I am sorry for my English.
112  staybox - the easy manager сесии for *box window managers.
113  Does not use for operation GDM and KDM, and most likely clashes with them. 
114  Support DM it is not planned to realise, in the major version it will be realised 
115  Support XDM (option).
117  Attention! The project is ground under usage of mechanisms HAL for handle
118  Computer operating modes. Customisations of policies HAL look in FAQ yours 
119  The distribution kit.
120  Dependences:
121         gtk +-2.0> = 2.6.0 
122         glib-2.0> = 2.6.0 
123         dbus-1
125   The code проeктов XFCE, LXDE, tags ob-logout is used.
128  Installation by standard way. 
129  ________________________________
130     ./configure - sysconfdir =/etc - prefix =/usr
131     make
132     make instal
133  ________________________________
135 In the current version the script staybox-session, for call from.xinitrc is delivered
136 In a version alpha the bug - is necessary for installing manually on it 
137 The rights to performance.
138     chmod +x $pkgdir/usr/bin/staybox-session || return 1
139        
140  For usage as the manager of session at start startx   
141  VI. xinitrc
142  ___________________
143         #!/bin/sh
144         #
145         # ~/.xinitrc
146         #
147         # Executed by startx (run your window manager from here)
149         exec staybox-session
150  ____________________
152 For exit, run staybox-logout, or add this in menu your WM.
154  Customisation. 
155 Openbox - the manager of windows by default.
156 The window manager is underlined globally, in a file/etc/xdg/staybox/config
157 _____________
158 [general]
159 manager=openbox
160 _____________
162 All other customisations are made and are in a user space.
163 The directory of adjusting files - ~/config/staybox
165 Autoload of applications.
166 Autoload is made in two ways:
167 1) From a configuration file of the manager сесии in the directory of the user.
169 ~/.config/staybox/autostart
171 The file format - the command of an application launch with parametres, 
172 Separately for each application.
173 Example:
174 ___________________________________________
175 setxkbmap-rules evdev-model sven-layout "us, ru"-variant ", winkeys"-option "grp:rctrl_toggle, grp_led:scroll"
176 setxkbmap-option terminate:ctrl_alt_bksp
177 ____________________________________________
179 The string can start with character - in that case the application is watched 
180 By the manager of session and at falling it will be restarted. Stopped by the user
181 Are ignored.
182 Example:
183 ______________
184 @xscreensaver-no-splash
185 @tint2
186 setxkbmap-rules evdev-model sven-layout "us, ru"-variant ", winkeys"-option "grp:rctrl_toggle, grp_led:scroll"
187 setxkbmap-option terminate:ctrl_alt_bksp
188 ______________
190 Remarks (strings starting with #) are ignored.
192 2) the StartUp of applications from the directory ~/.config/autostart the user.
193 Are handled standard.desktop files according to specification XDG.
194 Examples and the documentation are accessible in a network.
196 Customisation of appearance of a window of an output.
197 The configuration file ~/.config/staybox/logout
199 -------
200 [general]
201 theme=oxygen 
202 -------
203 Theme of buttons of operations. The theme by default is in %PREFIX %/share/staybox/themes
204 User's themes should be in the directory ~/.icons/staybox/THEME_NAME
205 ---------
206 [button]
207 bgcolor = # 4D4D4D
208 size=100
209 ---------
210 Colour of highlighting of the button at prompting and the button size.
212 [label]
213 colour = # E5E5E5
214 Colour of the signature to buttons. Styles of fonts in current release are not supported.