scrotwm_ru.1

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