]> code.delx.au - spectrwm/blob - scrotwm_ru.1
ef91e5ee7b3eb3182458a6f0538cf092899bc671
[spectrwm] / scrotwm_ru.1
1 .\" $scrotwm$
2 .\"
3 .\" Copyright (c) 2009 Marco Peereboom <marco@peereboom.us>
4 .\" Copyright (c) 2009 Darrin Chandler <dwchandler@stilyagin.com>
5 .\"
6 .\" Permission to use, copy, modify, and distribute this software for any
7 .\" purpose with or without fee is hereby granted, provided that the above
8 .\" copyright notice and this permission notice appear in all copies.
9 .\"
10 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 .\"
18 .Dd $Mdocdate$
19 .Dt SCROTWM 1
20 .Os
21 .Sh НАЗВАНИЕ
22 .Nm scrotwm
23 .Nd Оконный менеджер для X11
24 .Sh ИСПОЛЬЗОВАНИЕ
25 .Nm scrotwm
26 .Sh ОПИСАНИЕ
27 .Nm
28 это минималистичный менеджер окон, ставящий своей целью не мешать вам и не
29 занимать ценное пространство экрана. Его настройки по-умолчанию разумны и,
30 кроме того, он не требует знания языков программирования для работы с
31 конфигурационным файлом. Он написан хакерами для хакеров и старается быть
32 легким, компактным и быстрым.
33 .Pp
34 Когда
35 .Nm
36 запускается, он читает настройки из своего конфигурационного файла,
37 .Pa scrotwm.conf .
38 Смотрите секцию
39 .Sx КОНФИГУРАЦИОННЫЕ ФАЙЛЫ
40 ниже.
41 .Pp
42 На этой странице используются следующие обозначения:
43 .Pp
44 .Bl -tag -width Ds -offset indent -compact
45 .It Cm M
46 Мета-клавиша
47 .It Cm S
48 Shift
49 .It Aq Cm Name
50 Имя клавиши
51 .It Cm M1
52 Кнопка мыши 1
53 .It Cm M3
54 Кнопка мыши 3
55 .El
56 .Pp
57 .Nm
58 должен быть понятным и очевидным.
59 Большинство действий выполняется комбинациями клавиш.
60 Смотрите секцию
61 .Sx ПРИВЯЗКИ
62 ниже, чтобы узнать о стандартных настройках.
63 .Sh КОНФИГУРАЦИОННЫЕ ФАЙЛЫ
64 .Nm
65 пытается прочитать файл в домашнем каталоге,
66 .Pa ~/.scrotwm.conf .
67 В случае, если он недоступен,
68 происходит обращение к глобальному файлу настроек,
69 .Pa /etc/scrotwm.conf .
70 .Pp
71 Формат файла следующий: \*(Ltключ\*(Gt = \*(Ltзначение\*(Gt.
72 Например:
73 .Pp
74 .Dl color_focus = red
75 .Pp
76 Однозначное включение и выключение задается значениями 1 и 0.
77 .Pp
78 Поддерживаются следующие ключевые слова:
79 .Pp
80 .Bl -tag -width "title_class_enabledXXX" -offset indent -compact
81 .It Cm color_focus
82 Цвет рамки окна в фокусе.
83 .It Cm color_unfocus
84 Цвет рамки окон не в фокусе.
85 .It Cm bar_enabled
86 Включение статусной строки.
87 .It Cm bar_border Ns Bq Ar x
88 Цвет рамки статусной строки
89 .Ar x .
90 .It Cm bar_color Ns Bq Ar x
91 Цвет статусной строки
92 .Ar x .
93 .It Cm bar_font_color Ns Bq Ar x
94 Цвет шрифта статусной строки
95 .Ar x .
96 .It Cm bar_font
97 Тип шрифта статусной строки.
98 .It Cm bar_action
99 Внешний файл скрипта для статусной строки, выводящий туда информацию,
100 например, уровень заряда батарей.
101 .It Cm bar_delay
102 Частота выполнения внешнего скрипта статусной строки, секунды.
103 .It Cm stack_enabled
104 Включить отображение способа укладки окон в статусной строке.
105 .It Cm clock_enabled
106 Включить часы в статусной строке.
107 Можно отключить, установив 0, и Вы сможете использовать
108 собственные часы из внешнего скрипта.
109 .It Cm dialog_ratio
110 Ряд приложений имеет слишком маленькие диалоговые окна.
111 Это значение - доля размера экрана, к которой они будут приведены.
112 Например, значение 0.6 будет соответствовать 60% от реального размера экрана.
113 .It Cm region
114 Выделяет область экрана на Ваше усмотрение, уничтожает все перекрытые области
115 экрана, определенные автоматически.
116 Формат: screen[<idx>]:WIDTHxHEIGHT+X+Y,
117 например\& screen[1]:1280x800+0+0.
118 .It Cm term_width
119 Установить минимальную допустимую ширину эмулятора терминала.
120 Если это значение больше 0,
121 .Nm
122 попытается отмасштабировать шрифты в терминале, чтобы ширина
123 была больше этого значения
124 .
125 Поодерживается только
126 .Xr xterm 1
127 .
128 Также
129 .Xr xterm 1
130 не может быть с setuid или setgid, хотя это так на многих системах.
131 Возможно необходимо задать program[term] (Смотрите секцию
132 .Sx ПРОГРАММЫ
133 ) чтобы использовалась другая копия
134 .Xr xterm 1
135 без заданного бита setgid.
136 .It Cm title_class_enabled
137 Отображать класс окна в статусной строке.
138 Обычно выключено
139 .It Cm title_name_enabled
140 Отображать заголовок окна в статусной строке.
141 Обычно выключено
142 .It Cm modkey
143 Назначить Мета-клавишу, клавишу-модификатор.
144 Mod1 соответствует клавише ALT, а Mod4 соответствует клавише WIN на PC.
145 .It Cm program Ns Bq Ar p
146 Добавить пользовательскую программу для назначения привязки
147 .Ar p .
148 Смотрите секцию
149 .Sx ПРОГРАММЫ
150 ниже.
151 .It Cm bind Ns Bq Ar x
152 Назначить привязку на действие
153 .Ar x .
154 Смотрите секцию
155 .Sx ПРИВЯЗКИ
156 ниже.
157 .It Cm quirk Ns Bq Ar c:n
158 Добавить костыль для окон с классом
159 .Ar c
160 и именем
161 .Ar n .
162 Смотрите секцию
163 .Sx КОСТЫЛИ
164 ниже.
165 .El
166 .Pp
167 Цвета задаются с помощью
168 .Xr XQueryColor 3
169 А шрифты задаются с использованием
170 .Xr XQueryFont 3
171 .
172 .Sh ПРОГРАММЫ
173 .Nm
174 позволяет Вам добавлять Ваши собственные действия для запуска
175 программ и делать к ним привязки как ко всем остальным действиям
176 Смотрите секцию
177 .Sx ПРИВЯЗКИ
178 ниже.
179 .Pp
180 Стандартные программы:
181 .Pp
182 .Bl -tag -width "screenshot_wind" -offset indent -compact
183 .It Cm term
184 xterm
185 .It Cm screenshot_all
186 screenshot.sh full
187 .It Cm screenshot_wind
188 screenshot.sh window
189 .It Cm lock
190 xlock
191 .It Cm initscr
192 initscreen.sh
193 .It Cm menu
194 dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
195 .El
196 .Pp
197 Ваши собственные программы задаются следующим образом:
198 .Pp
199 .Dl program[<name>] = <progpath> [<arg> [... <arg>]]
200 .Pp
201 .Aq name
202 это любой идентификатор, не мешающийся с уже существующими,
203 .Aq progpath
204 это собственно путь к программе,
205 .Aq arg
206 это список передаваемых аргументов или оставьте пустым.
207 .Pp
208 Следующие переменные можно получать из
209 .Nm
210 (Смотрите секцию
211 .Sx КОНФИГУРАЦИОННЫЕ ФАЙЛЫ
212 выше),
213 и их можно использовать как
214 .Aq arg
215 (в момент запуска программы будет выполнена подстановка значений):
216 .Pp
217 .Bl -tag -width "$bar_font_color" -offset indent -compact
218 .It Cm $bar_border
219 .It Cm $bar_color
220 .It Cm $bar_font
221 .It Cm $bar_font_color
222 .It Cm $color_focus
223 .It Cm $color_unfocus
224 .El
225 .Pp
226 Например:
227 .Bd -literal -offset indent
228 program[ff] = /usr/local/bin/firefox http://scrotwm.org/
229 bind[ff] = Mod+f # Значит Mod+F запускает firefox
230 .Ed
231 .Pp
232 Чтобы отменить назначение:
233 .Bd -literal -offset indent
234 bind[] = Mod+f
235 program[ff] =
236 .Ed
237 .Pp
238 .Sh ПРИВЯЗКИ
239 .Nm
240 предоставляет доступ к действиям с помощью клавиатурных комбинаций.
241 .Pp
242 Установленные привязки для мыши:
243 .Pp
244 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
245 .It Cm M1
246 Сфокусироваться на окне
247 .It Cm M-M1
248 Переместить окно
249 .It Cm M-M3
250 Изменить размер окна
251 .It Cm M-S-M3
252 Изменить размер окна, удерживая его в центре
253 .El
254 .Pp
255 Стандартные клавиатурные привязки:
256 .Pp
257 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
258 .It Cm M-S- Ns Aq Cm Return
259 term
260 .It Cm M-p
261 menu
262 .It Cm M-S-q
263 quit
264 .It Cm M-q
265 restart
266 .Nm
267 .It Cm M- Ns Aq Cm Space
268 cycle_layout
269 .It Cm M-S- Ns Aq Cm Space
270 reset_layout
271 .It Cm M-h
272 master_shrink
273 .It Cm M-l
274 master_grow
275 .It Cm M-,
276 master_add
277 .It Cm M-.
278 master_del
279 .It Cm M-S-,
280 stack_inc
281 .It Cm M-S-.
282 stack_del
283 .It Cm M- Ns Aq Cm Return
284 swap_main
285 .It Xo
286 .Cm M-j ,
287 .Cm M- Ns Aq Cm TAB
288 .Xc
289 focus_next
290 .It Xo
291 .Cm M-k ,
292 .Cm M-S- Ns Aq Cm TAB
293 .Xc
294 focus_prev
295 .It Cm M-m
296 focus_main
297 .It Cm M-S-j
298 swap_next
299 .It Cm M-S-k
300 swap_prev
301 .It Cm M-b
302 bar_toggle
303 .It Cm M-x
304 wind_del
305 .It Cm M-S-x
306 wind_kill
307 .It Cm M- Ns Aq Ar n
308 .Ns ws_ Ns Ar n
309 .It Cm M-S- Ns Aq Ar n
310 .Ns mvws_ Ns Ar n
311 .It Cm M- Ns Aq Cm Right
312 ws_next
313 .It Cm M- Ns Aq Cm Left
314 ws_prev
315 .It Cm M-S- Ns Aq Cm Right
316 screen_next
317 .It Cm M-S- Ns Aq Cm Left
318 screen_prev
319 .It Cm M-s
320 screenshot_all
321 .It Cm M-S-s
322 screenshot_wind
323 .It Cm M-S-v
324 version
325 .It Cm M-t
326 float_toggle
327 .It Cm M-S Aq Cm Delete
328 lock
329 .It Cm M-S-i
330 initscr
331 .El
332 .Pp
333 Описания действий перечислены ниже:
334 .Pp
335 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
336 .It Cm term
337 Запустить эмулятор терминала
338 (Смотрите секцию
339 .Sx ПРОГРАММЫ
340 выше)
341 .It Cm menu
342 Меню
343 (Смотрите секцию
344 .Sx ПРОГРАММЫ
345 выше)
346 .It Cm quit
347 Выйти
348 .Nm
349 .It Cm restart
350 Перезапустить
351 .Nm
352 .It Cm cycle_layout
353 Менять укладку окон
354 .It Cm reset_layout
355 Стандартная укладка
356 .It Cm master_shrink
357 Сжать область главного окна
358 .It Cm master_grow
359 Расширить область главного окна
360 .It Cm master_add
361 Добавить окна в главную область
362 .It Cm master_del
363 Убрать окна из главной области
364 .It Cm stack_inc
365 Увеличить число столбцов или рядов в текущей укладке
366 .It Cm stack_del
367 Уменьшить число столбцов или рядов в текущей укладке
368 .It Cm swap_main
369 Отправить текущее окно в главную область, сделать главным
370 .It Cm focus_next
371 Фокусироваться на следующем окне
372 .It Cm focus_prev
373 Фокусироваться на предыдущем окне
374 .It Cm focus_main
375 Фокусироваться на главном окне
376 .It Cm swap_next
377 Поменять со следующим окном
378 .It Cm swap_prev
379 Поменять со предыдущим окном
380 .It Cm bar_toggle
381 Выключить статусную строку на всех рабочих столах
382 .It Cm wind_del
383 Закрыть фокусированное окно
384 .It Cm wind_kill
385 Грохнуть фокусированное окно
386 .It Cm ws_ Ns Ar n
387 Переключиться на рабочий стол
388 .Ar n ,
389 где
390 .Ar n
391 от 1 до 10
392 .It Cm mvws_ Ns Ar n
393 Переместить фокусированное окно в рабочий стол
394 .Ar n ,
395 где
396 .Ar n
397 от 1 до 10
398 .It Cm ws_next
399 Перейти к следующему не пустому рабочему столу
400 .It Cm ws_prev
401 Перейти к следующему не пустому рабочему столу
402 .It Cm screen_next
403 Переместить указатель в следующую область
404 .It Cm screen_prev
405 Переместить указатель в следующую область
406 .It Cm screenshot_all
407 Сделать снимок всего экрана (если возможно)
408 (Смотрите секцию
409 .Sx ПРОГРАММЫ
410 выше)
411 .It Cm screenshot_wind
412 Сделать снимок окна (если возможно)
413 (Смотрите секцию
414 .Sx ПРОГРАММЫ
415 выше)
416 .It Cm version
417 Показать версию в статусной строке
418 .It Cm float_toggle
419 Переключить окно в фокусе в плавающий режим, float
420 .It Cm lock
421 Заблокировать экран
422 (Смотрите секцию
423 .Sx ПРОГРАММЫ
424 выше)
425 .It Cm initscr
426 Инициализировать экран еще раз
427 (Смотрите секцию
428 .Sx ПРОГРАММЫ
429 выше)
430 .El
431 .Pp
432 Собственные привязки назначаются следующим образом:
433 .Pp
434 .Dl bind[<action>] = <keys>
435 .Pp
436 .Aq action
437 это действие из списка программ
438 .Aq keys
439 это не более одной клавиши-модификатора
440 (MOD, Mod1, Shift, и.т.п.) и обычные клавиши
441 (b, space, и.т.п.), разделенные "+".
442 Например:
443 .Bd -literal -offset indent
444 bind[reset] = Mod4+q # назначить WIN + q на действие reset
445 bind[] = Mod1+q # снять все действия с Alt + q
446 .Ed
447 .Pp
448 На одно действие можно назначить несколько комбинаций.
449 .Sh КОСТЫЛИ
450 .Nm
451 позволяет настроить костыли, нужные для специальной работы scrotwm
452 с рядом приложений, который вы определяете сами. То есть, Вы можете
453 принудительно установить способ тайлинга для какого-нибудь приложения
454 .Pp
455 Список стандартных костылей:
456 .Pp
457 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
458 .It Firefox\-bin:firefox\-bin
459 TRANSSZ
460 .It Firefox:Dialog
461 FLOAT
462 .It Gimp:gimp
463 FLOAT + ANYWHERE
464 .It MPlayer:xv
465 FLOAT + FULLSCREEN
466 .It OpenOffice.org 2.4:VCLSalFrame
467 FLOAT
468 .It OpenOffice.org 3.1:VCLSalFrame
469 FLOAT
470 .It pcb:pcb
471 FLOAT
472 .It xine:Xine Window
473 FLOAT + ANYWHERE
474 .It xine:xine Panel
475 FLOAT + ANYWHERE
476 .It xine:xine Video Fullscreen Window
477 FULLSCREEN + FLOAT
478 .It Xitk:Xitk Combo
479 FLOAT + ANYWHERE
480 .It Xitk:Xine Window
481 FLOAT + ANYWHERE
482 .It XTerm:xterm
483 XTERM_FONTADJ
484 .El
485 .Pp
486 Описание:
487 .Pp
488 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
489 .It FLOAT
490 Такое окно не нужно тайлить вообще, разрешить ему float
491 .It TRANSSZ
492 Тразиентое окно
493 (Смотрите секцию
494 .Sx КОНФИГУРАЦИОННЫЕ ФАЙЛЫ) .
495 .It ANYWHERE
496 Позволить окну самостоятельно выбрать местоположение
497 .It XTERM_FONTADJ
498 Изменять шрифты xterm при изменении размеров окна
499 .It FULLSCREEN
500 Позволить окну запускаться в полноэкранном режиме
501 .El
502 .Pp
503 Назначать костыли можно следующим образом:
504 .Pp
505 .Dl quirk[<class>:<name>] = <quirk> [ + <quirk> ... ]
506 .Pp
507 .Aq class
508 и
509 .Aq name
510 определяют к какому окну будет применяться костыль, а
511 .Aq quirk
512 один из вышеперечисленных способов.
513 Например:
514 .Bd -literal -offset indent
515 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # mplayer настроен
516 quirk[pcb:pcb] = NONE # убрать существующий костыль
517 .Ed
518 .Pp
519 Вы можете узнать
520 .Aq class
521 и
522 .Aq name
523 запустив xprop и нажав в интересующее окно.
524 Вот как будет выглядеть вывод для Firefox:
525 .Bd -literal -offset indent
526 $ xprop | grep WM_CLASS
527 WM_CLASS(STRING) = "Navigator", "Firefox"
528 .Ed
529 .Pp
530 Обратите внимание, класс и имя меняются местами,
531 правильный костыль будет выглядеть так:
532 .Bd -literal -offset indent
533 quirk[Firefox:Navigator] = FLOAT
534 .Ed
535 .Sh ФАЙЛЫ
536 .Bl -tag -width "/etc/scrotwm.confXXX" -compact
537 .It Pa ~/.scrotwm.conf
538 .Nm
539 Личные настройки пользователя.
540 .It Pa /etc/scrotwm.conf
541 .Nm
542 Глобавльные настройки.
543 .El
544 .Sh ИСТОРИЯ
545 .Nm
546 идейно основан на dwm и xmonad
547 .Sh АВТОРЫ
548 .An -nosplit
549 .Pp
550 .Nm
551 написан:
552 .An Marco Peereboom Aq marco@peereboom.us ,
553 .An Ryan Thomas McBride Aq mcbride@countersiege.com
554 and
555 .An Darrin Chandler Aq dwchandler@stilyagin.com .
556 .Sh БАГИ
557 При вызове меню с помощью
558 .Cm M-p ,
559 необходима корректная работа dmenu.