1 .\" Copyright (c) 2009 Marco Peereboom <marco@peereboom.us>
2 .\" Copyright (c) 2009 Darrin Chandler <dwchandler@stilyagin.com>
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.
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.
21 .Nd Оконный менеджер для X11
26 это минималистичный менеджер окон, ставящий своей целью не мешать вам и не
27 занимать ценное пространство экрана. Его настройки по-умолчанию разумны и,
28 кроме того, он не требует знания языков программирования для работы с
29 конфигурационным файлом. Он написан хакерами для хакеров и старается быть
30 легким, компактным и быстрым.
34 запускается, он читает настройки из своего конфигурационного файла,
37 .Sx КОНФИГУРАЦИОННЫЕ ФАЙЛЫ
40 На этой странице используются следующие обозначения:
42 .Bl -tag -width Ds -offset indent -compact
56 должен быть понятным и очевидным.
57 Большинство действий выполняется комбинациями клавиш.
60 ниже, чтобы узнать о стандартных настройках.
61 .Sh КОНФИГУРАЦИОННЫЕ ФАЙЛЫ
63 пытается прочитать файл в домашнем каталоге,
64 .Pa ~/.spectrwm.conf .
65 В случае, если он недоступен,
66 происходит обращение к глобальному файлу настроек,
67 .Pa /etc/spectrwm.conf .
69 Формат файла следующий: \*(Ltключ\*(Gt = \*(Ltзначение\*(Gt.
74 Однозначное включение и выключение задается значениями 1 и 0.
76 Поддерживаются следующие ключевые слова:
78 .Bl -tag -width "title_class_enabledXXX" -offset indent -compact
80 Цвет рамки окна в фокусе.
82 Цвет рамки окон не в фокусе.
84 Включение статусной строки.
85 .It Cm bar_border Ns Bq Ar x
86 Цвет рамки статусной строки
88 .It Cm bar_color Ns Bq Ar x
91 .It Cm bar_font_color Ns Bq Ar x
92 Цвет шрифта статусной строки
95 Тип шрифта статусной строки.
97 Внешний файл скрипта для статусной строки, выводящий туда информацию,
98 например, уровень заряда батарей.
100 Включить отображение способа укладки окон в статусной строке.
102 Включить часы в статусной строке.
103 Можно отключить, установив 0, и Вы сможете использовать
104 собственные часы из внешнего скрипта.
106 Ряд приложений имеет слишком маленькие диалоговые окна.
107 Это значение - доля размера экрана, к которой они будут приведены.
108 Например, значение 0.6 будет соответствовать 60% от реального размера экрана.
110 Выделяет область экрана на Ваше усмотрение, уничтожает все перекрытые области
111 экрана, определенные автоматически.
112 Формат: screen[<idx>]:WIDTHxHEIGHT+X+Y,
113 например\& screen[1]:1280x800+0+0.
115 Установить минимальную допустимую ширину эмулятора терминала.
116 Если это значение больше 0,
118 попытается отмасштабировать шрифты в терминале, чтобы ширина
119 была больше этого значения
121 Поодерживается только
126 не может быть с setuid или setgid, хотя это так на многих системах.
127 Возможно необходимо задать program[term] (Смотрите секцию
129 ) чтобы использовалась другая копия
131 без заданного бита setgid.
132 .It Cm title_class_enabled
133 Отображать класс окна в статусной строке.
135 .It Cm title_name_enabled
136 Отображать заголовок окна в статусной строке.
139 Назначить Мета-клавишу, клавишу-модификатор.
140 Mod1 соответствует клавише ALT, а Mod4 соответствует клавише WIN на PC.
141 .It Cm program Ns Bq Ar p
142 Добавить пользовательскую программу для назначения привязки
147 .It Cm bind Ns Bq Ar x
148 Назначить привязку на действие
153 .It Cm quirk Ns Bq Ar c:n
154 Добавить костыль для окон с классом
163 Цвета задаются с помощью
165 А шрифты задаются с использованием
170 позволяет Вам добавлять Ваши собственные действия для запуска
171 программ и делать к ним привязки как ко всем остальным действиям
176 Стандартные программы:
178 .Bl -tag -width "screenshot_wind" -offset indent -compact
181 .It Cm screenshot_all
183 .It Cm screenshot_wind
190 dmenu_run \-fn $bar_font \-nb $bar_color \-nf $bar_font_color \-sb $bar_border \-sf $bar_color
193 Ваши собственные программы задаются следующим образом:
195 .Dl program[<name>] = <progpath> [<arg> [... <arg>]]
198 это любой идентификатор, не мешающийся с уже существующими,
200 это собственно путь к программе,
202 это список передаваемых аргументов или оставьте пустым.
204 Следующие переменные можно получать из
207 .Sx КОНФИГУРАЦИОННЫЕ ФАЙЛЫ
209 и их можно использовать как
211 (в момент запуска программы будет выполнена подстановка значений):
213 .Bl -tag -width "$bar_font_color" -offset indent -compact
217 .It Cm $bar_font_color
219 .It Cm $color_unfocus
223 .Bd -literal -offset indent
224 program[ff] = /usr/local/bin/firefox http://spectrwm.org/
225 bind[ff] = Mod+f # Значит Mod+F запускает firefox
228 Чтобы отменить назначение:
229 .Bd -literal -offset indent
236 предоставляет доступ к действиям с помощью клавиатурных комбинаций.
238 Установленные привязки для мыши:
240 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
242 Сфокусироваться на окне
248 Изменить размер окна, удерживая его в центре
251 Стандартные клавиатурные привязки:
253 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
254 .It Cm M-S- Ns Aq Cm Return
263 .It Cm M- Ns Aq Cm Space
265 .It Cm M-S- Ns Aq Cm Space
279 .It Cm M- Ns Aq Cm Return
288 .Cm M-S- Ns Aq Cm TAB
305 .It Cm M-S- Ns Aq Ar n
307 .It Cm M- Ns Aq Cm Right
309 .It Cm M- Ns Aq Cm Left
311 .It Cm M-S- Ns Aq Cm Right
313 .It Cm M-S- Ns Aq Cm Left
323 .It Cm M-S Aq Cm Delete
329 Описания действий перечислены ниже:
331 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
333 Запустить эмулятор терминала
353 Сжать область главного окна
355 Расширить область главного окна
357 Добавить окна в главную область
359 Убрать окна из главной области
361 Увеличить число столбцов или рядов в текущей укладке
363 Уменьшить число столбцов или рядов в текущей укладке
365 Отправить текущее окно в главную область, сделать главным
367 Фокусироваться на следующем окне
369 Фокусироваться на предыдущем окне
371 Фокусироваться на главном окне
373 Поменять со следующим окном
375 Поменять со предыдущим окном
377 Выключить статусную строку на всех рабочих столах
379 Закрыть фокусированное окно
381 Грохнуть фокусированное окно
383 Переключиться на рабочий стол
389 Переместить фокусированное окно в рабочий стол
395 Перейти к следующему не пустому рабочему столу
397 Перейти к следующему не пустому рабочему столу
399 Переместить указатель в следующую область
401 Переместить указатель в следующую область
402 .It Cm screenshot_all
403 Сделать снимок всего экрана (если возможно)
407 .It Cm screenshot_wind
408 Сделать снимок окна (если возможно)
413 Показать версию в статусной строке
415 Переключить окно в фокусе в плавающий режим, float
422 Инициализировать экран еще раз
428 Собственные привязки назначаются следующим образом:
430 .Dl bind[<action>] = <keys>
433 это действие из списка программ
435 это не более одной клавиши-модификатора
436 (MOD, Mod1, Shift, и.т.п.) и обычные клавиши
437 (b, space, и.т.п.), разделенные "+".
439 .Bd -literal -offset indent
440 bind[reset] = Mod4+q # назначить WIN + q на действие reset
441 bind[] = Mod1+q # снять все действия с Alt + q
444 На одно действие можно назначить несколько комбинаций.
447 позволяет настроить костыли, нужные для специальной работы spectrwm
448 с рядом приложений, который вы определяете сами. То есть, Вы можете
449 принудительно установить способ тайлинга для какого-нибудь приложения
451 Список стандартных костылей:
453 .Bl -tag -width "OpenOffice.org N.M:VCLSalFrame<TAB>XXX" -offset indent -compact
454 .It Firefox\-bin:firefox\-bin
462 .It OpenOffice.org 2.4:VCLSalFrame
464 .It OpenOffice.org 3.1:VCLSalFrame
472 .It xine:xine Video Fullscreen Window
484 .Bl -tag -width "XTERM_FONTADJ<TAB>XXX" -offset indent -compact
486 Такое окно не нужно тайлить вообще, разрешить ему float
490 .Sx КОНФИГУРАЦИОННЫЕ ФАЙЛЫ) .
492 Позволить окну самостоятельно выбрать местоположение
494 Изменять шрифты xterm при изменении размеров окна
496 Позволить окну запускаться в полноэкранном режиме
499 Назначать костыли можно следующим образом:
501 .Dl quirk[<class>:<name>] = <quirk> [ + <quirk> ... ]
506 определяют к какому окну будет применяться костыль, а
508 один из вышеперечисленных способов.
510 .Bd -literal -offset indent
511 quirk[MPlayer:xv] = FLOAT + FULLSCREEN # mplayer настроен
512 quirk[pcb:pcb] = NONE # убрать существующий костыль
519 запустив xprop и нажав в интересующее окно.
520 Вот как будет выглядеть вывод для Firefox:
521 .Bd -literal -offset indent
522 $ xprop | grep WM_CLASS
523 WM_CLASS(STRING) = "Navigator", "Firefox"
526 Обратите внимание, класс и имя меняются местами,
527 правильный костыль будет выглядеть так:
528 .Bd -literal -offset indent
529 quirk[Firefox:Navigator] = FLOAT
532 .Bl -tag -width "/etc/spectrwm.confXXX" -compact
533 .It Pa ~/.spectrwm.conf
535 Личные настройки пользователя.
536 .It Pa /etc/spectrwm.conf
538 Глобавльные настройки.
542 идейно основан на dwm и xmonad
548 .An Marco Peereboom Aq marco@peereboom.us ,
549 .An Ryan Thomas McBride Aq mcbride@countersiege.com
551 .An Darrin Chandler Aq dwchandler@stilyagin.com .
553 При вызове меню с помощью
555 необходима корректная работа dmenu.