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