all repos — fluxbox @ 949a932036354d9b7ce8cc31b2c153c9acfaf4be

custom fork of the fluxbox windowmanager

Add russian manpage (although recursive build fails to work).
grubert grubert
commit

949a932036354d9b7ce8cc31b2c153c9acfaf4be

parent

36a848c4a54bfd7f6b7daa345f14fe0dd332468f

5 files changed, 1268 insertions(+), 1 deletions(-)

jump to
M doc/Makefile.amdoc/Makefile.am

@@ -1,9 +1,10 @@

# doc/Makefile.am for Fluxbox 0.9 - an X11 Window manager +SUBDIRS = ru CLEANFILES = fluxbox.1 MAINTAINERCLEANFILES = Makefile.in man_MANS = fluxbox.1 bsetroot.1 fbrun.1 fbsetbg.1 \ - startfluxbox.1 fluxstyle.1 fbrun.1 + startfluxbox.1 fluxstyle.1 fbrun.1 EXTRA_DIST=fluxbox.1.in bsetroot.1 fbrun.1 startfluxbox.1 fbsetbg.1 \ fluxstyle.1 Coding_style distclean-local:
M doc/fluxbox.1.indoc/fluxbox.1.in

@@ -123,6 +123,7 @@ On exit or restart, Fluxbox will save user defaults in the file

.I ~/.fluxbox/init in the user's home directory. Some resources in this file can be edited by hand. +.\" ----------------------- .SH USING FLUXBOX Fluxbox includes keyboard handling. In order to customize your keybindings, edit the file
M doc/fluxstyle.1doc/fluxstyle.1

@@ -387,6 +387,17 @@ toolbar.workspace.color: <color>

toolbar.workspace.colorTo: <color> toolbar.workspace.borderWidth: <integer> toolbar.workspace.borderColor: <color> +toolbar.button.size for fixed buttons in the toolbar +toolbar.button.borderWidth +toolbar.button.borderColor +toolbar.button +toolbar.button.color +toolbar.button.colorTo +toolbar.button.pixmap +toolbar.button.picColor +toolbar.button.pressed.color +toolbar.button.pressed.colorTo +toolbar.button.pressed toolbar.iconbar.focused: <texture type> toolbar.iconbar.focused.pixmap: <filename> toolbar.iconbar.focused.color: <color>
A doc/ru/Makefile.am

@@ -0,0 +1,11 @@

+# doc/ru/Makefile.am for Fluxbox 0.9 - an X11 Window manager + +CLEANFILES = fluxbox.1 +MAINTAINERCLEANFILES = Makefile.in +man_MANS = fluxbox.1 +EXTRA_DIST=fluxbox.1.in +distclean-local: + rm -f *\~ + +fluxbox.1: fluxbox.1.in + @regex_cmd@ -e "s,@pkgdatadir@,$(pkgdatadir)," $(srcdir)/fluxbox.1.in > fluxbox.1
A doc/ru/fluxbox.1.in

@@ -0,0 +1,1243 @@

+.\" -*- mode: nroff -*- +.\" Man page for Fluxbox +.\" +.\" Copyright (c) 2000 by Wilbert Berendsen <wbsoft@xs4all.nl> +.\" Copyright (c) 2001 by Matthew Hawkins <matt@mh.dropbear.id.au> +.\" +.\" This manual page may be freely distributed and modified. +.\" Parts of the text are taken from website and several README's +.\" by His Great Hughesness himself. Why reinvent wheels? +.\" +.\" Created with NEdit, tested with ``man'' and ``tkman.'' +.\" This manpage uses only standard groff and tmac.an macros. +.\" To all translators who didn't do manpages earlier (like me ;-): +.\" Read the Man-Page-Mini-HOWTO and the LDP manpage ``man 7 man'' +.\" There's all I needed to know about these macros. +.\" +.\" Updated for bb 0.61 at Sat Sep 9 06:56:04 CEST 2000 +.\" +.\" Changed to fluxbox by Henrik Kinnunen (fluxgen@linuxmail.org) +.\" +.\" Updated for fluxbox 0.1.5 by Matthew Hawkins <matt@mh.dropbear.id.au> +.\" +.\" Updated for version 0.1.6 by Rando Christensen <eyez@babblica.net> +.\" +.\" Updated for version 0.1.7.1 by Stanislav Karchebny <berk@madfire.net> +.\" +.\" Updated for version 0.1.15 by Tobias Klausmann <klausman@users.sourceforge.net> +.\" +.\" Updating for version 0.9.6 by <grubert@users.sourceforge.net> +.\" +.\" translation by Andrey Balaguta. +.\" +.\" ..define sort of <blockquote><pre> macro +.de EX +.ne 5 +.if n .sp 1 +.if t .sp .5 +.nf +.in +.5i +.. +.de EE +.fi +.in -.5i +.if n .sp 1 +.if t .sp .5 +.. +.TH fluxbox 1 "September 26th, 2003" "0.9.6" +.SH +НАЗВАНИЕ +fluxbox \- менеджер окон для системы X11 +.SH СИНТАКСИС +.BR fluxbox " \-help | \-version" +.br +.B fluxbox +.RI "[ \-rc" " rcfile " "] [ \-display" " display " ] +.SH ОПИСАНИЕ +.\" +.\" Phirst Phew ParagraPhs taken from blackbox.alug.org +.\" +Fluxbox -- это оконный менеджер для X Window System версии 11R6 и +новее. Он написан на C++ и основан на исходных кодах Blackbox 0.61.0. Это +.BR быстрый +оконный менеджер. +.PP +Fluxbox поддерживает настраиваемое оформление окон, главное меню для +запуска приложений и панель инструментов, на которой отображается +имя рабочего стола, название активного приложения и текущее время. +Из меню рабочего стола вы можете добавлять новые или удалять +существующие рабочие столы. `Докер' (slit) используется как контейнер +для небольших приложений (dock-apps); например, большинство утилит bbtools без проблем +используют докер. +.PP +При минимизации окна Fluxbox помещает его на панель инструментов, а +также в подменю `Icons' меню рабочего стола. Один щелчок +мышью -- и окно снова на экране. Если дважды щелкнуть на заголовке +окна, то оно будет свернуто в заголовок. +.PP +Для генерации изображений fluxbox использует свой +собственный класс. Файлы стилей позволяют вам настроить вид +десктопа по своему вкусу. Стили Fluxbox и Blackbox совместимы, +поэтому пользователи Blackbox легко могут использовать свои любимые +темы в Fluxbox. +.PP +.\" TODO wmhints support +.\" TODO KDE2 GNome support +Пока wmhints оконного менеджера KDE не поддерживаются, но Fluxbox уже +подготовлен для поддержки новой спецификации оконных менеджеров, +разрабатываемой для Gnome и KDE2.0. +.SH ПАРАМЕТРЫ +При запуске Fluxbox из командной строки вам доступны следующие +параметры: +.TP +.B \-help +Отобразить список ключей командной строки и завершить Fluxbox. +.TP +.B \-version +Отобразить информацию о версии и завершить Fluxbox. +.TP +.BI \-rc \ rcfile +Использовать файл ресурсов, отличный от стандартного +.IR "~/.fluxbox/init". +.TP +.BI \-display \ дисплей +Запустить Fluxbox на указанном дисплее. +Это же значение будет использовано в качестве переменной окружения +.B DISPLAY +для всех программ, запускаемых из Fluxbox. +.TP +.B \-info +Показать информацию о программе (параметры по умолчанию и +подключенные возможности) и завершить Fluxbox. +.TP +.B \-log \ filename +Журналировать вывод в указанный файл. +.\" --------------------- +.SH ЗАПУСК FLUXBOX +Обычно Fluxbox запускается стартовым скриптом пользователя, который в большинстве случаев +хранится в файле +.IR ~/.xinitrc . +Чтобы запустить fluxbox, добавьте в конец скрипта строчку +.EX 0 +exec fluxbox +.EE +Закрытие Fluxbox повлечет завершение сеанса X. +.PP +При запуске Fluxbox сначала ищет файл общесистемного меню +.IR @pkgdatadir@/menu . +В этом файле вы можете задать общее меню для всех пользователей системы. +.PP +При завершении и перезапуске Fluxbox локальные настройки сохраняются в файле +.I ~/.fluxbox/init +в домашнем каталоге пользователя. Некоторые ресурсы из этого файла вы можете +отредактировать вручную. +.SH ИСПОЛЬЗОВАНИЕ FLUXBOX +Fluxbox включает возможности управления с клавиатуры. Привязки сочетаний клавиш +хранятся в файле +.I ~/.fluxbox/keys. +Дополнительную информацию можно найти в разделе ФАЙЛ СОЧЕТАНИЙ КЛАВИШ. +.SS Главное окно (фон): +По щелчку правой кнопкой мыши открывается контекстное меню, из +которого можно запускать приложения. Это меню можно перенастроить +по своему усмотрению. +Щелчок средней кнопкой мыши вызывает меню рабочего стола, из которого вы +можете добавить новые и удалить существующие +рабочие столы, просмотреть списки запущенных приложений и свернутых +окон. Посредством данного меню можно переключиться на нужный +рабочий стол или приложение. +.PP +Щелчок левой кнопкой мыши на имени приложения в меню рабочего стола +сделает этот рабочий стол и приложение активными; щелчок средней +кнопкой мыши перенесет приложение на текущий рабочий стол. +.SS Панель инструментов: +Панель инструментов состоит из поля имя рабочего стола, области +свернутых окон и часов. + +.\" A left click on the toolbar will bring it to the foreground, a +.\" middle click will hide it behind other windows (if AlwaysOnTop is not set), and +.\" the right button brings up a little menu. +Щелчок правой кнопкой мыши на поле имени рабочего стола вызывает меню панели инструментов. +Вращение скроллера мыши на имени рабочего стола или часах +переключает рабочие столы. Из меню Fluxbox такое поведение +можно установить и для всего рабочего стола. +.PP +Меню панели инструментов позволяет вам переименовать текущий рабочий стол (после +ввода нового названия нажмите Enter), настроить позицию панели инструментов, +слой, в котором она будет находиться (см. раздел СЛОИ), а также установить +автоскрытие панели (панель будет исчезать с экрана, когда курсор мыши выходит +за ее пределы). В этом же меню можно установить режим панели: None -- отключить +область свернутых окон, Icons -- показывать свернутые окна со всех рабочих +столов, Workspace Icons -- свернутые окна текущего рабочего стола, Workspace -- все окна текущего +рабочего стола, All Windows -- окна со всех рабочих столов. +.SS Слой: +Под слоем понимается некоторый "уровень", на котором могут быть расположены +окна. Слои расположены один под другим в следующем порядке (сверху вниз): +Above Dock, Dock, Top, Normal, Bottom, Desktop. Чтобы переместить докер или панель +инструментов в другой слой, воспользуйтесь контекстным меню. Для обычных приложений +слой может быть указан в файле apps. +.\" TODO the apps file has numbers for layers +.SS Строка заголовка и границы окна: +Щелчок левой кнопкой мыши в любой точке границы окна помещает его +на передний план. +Последующее перемещение мыши перемещает окно. Изменение размера окон +производится посредством элементов управления размером окна, расположенных в левом нижнем и +правом нижнем углах окна. Щелчок средней кнопкой мыши на границе или +заголовке окна приводит к помещению данного окна на задний план. +Щелчок правой кнопкой вызывает контекстное меню окна, которое содержит следующие +команды: +.TP +.B Send To... (нет в 0.9.6) +Перемещает окно на другой рабочий стол. Если при +выборе щелкнуть не левой кнопкой мыши, а средней, то +выбранный рабочий стол станет текущим. +.TP +.B Send Group To... (нет в 0.9.6) +Позволяет переместить всю группу окон на другой рабочий стол. Поведение +при щелчке средней кнопкой мыши такое же, как у предыдущей команды. +.TP +.B Shade +Скрыть окно (отображается только строка заголовка). +.TP +.B Iconify +Минимизировать окно. После минимизации данное окно добавляется на панель инструментов и +в подменю 'Icons' меню рабочего стола. +.TP +.B Maximize +Распахнуть/восстановить окно. При развертывании окна на весь экран +оно может покрывать докер и панель инструментов, в зависимости от настроек последних. +.TP +.B Maximize Vertical +Распахнуть/восстановить окно только по вертикали. +.TP +.B Maximize Horizontal +Распахнуть/восстановить окно только по горизонтали. +.TP +.B Raise +Поместить окно на передний план. +.TP +.B Lower +Поместить окно на задний план. +.TP +.B Stick +Прикрепить/отклеить окно. Прикрепленное окно всегда находится на текущем рабочем столе. +.TP +.B Next Client +Передать фокус следующему окну в группе. +.TP +.B Prev Client +Передать фокус предыдущему окну в группе. +.TP +.B Layer ... +Изменить слой окна. +.TP +.B Remeber ... +Запомнить настройки окна в файле apps. В подменю нужно выбрать, какие +именно настройки нужно сохранить. +.TP +.B Close +Завершить работу приложения +.PP +Двойной щелчок по заголовку окна эквивалентен команде Shade -- окно +будет свернуто в заголовок; при следующем двойном щелчке окно будет +восстановлено. +.SS Кнопки в заголовке окна: +Установки для этих кнопок хранятся в файле init. Стандартные настройки: +.EX 0 +session.titlebar.left: Stick +session.titlebar.right: Minimize Maximize Close +.EE +Щелчок мышью на кнопке Minimize сворачивает окно. Щелчок на кнопке Close +позволяет закрыть приложение. Кнопка Maximize (если присутствует) позволяет +развернуть окно тремя способами: щелчок левой кнопкой мыши вызывает развертывание +окна на весь экран, средней кнопкой -- только по вертикали, правой -- только +по горизонтали. Действие кнопки Stick аналогично действию команды +.I (Un)Stick window. +.SS Все меню: +Щелчок правой кнопкой мыши в пределах меню закрывает +его. Перетаскивание меню при помощи левой кнопки мыши за заголовок +позволяет сделать меню постоянно видимым (оно не исчезает после выбора +команды). +.SS Дополнительные возможности: +Левый щелчок мыши в любом месте окна при нажатой клавише Alt также позволяет +перемещать окно по экрану, при этом окно сразу же переносится на передний план. +Это может быть полезно, если заголовок или границы окна скрыты другими окнами +или выходят за пределы экрана. Щелчок правой кнопкой мыши при нажатой клавише Alt +переносит окно на задний план, и, наконец, щелчок средней кнопкой позволяет +изменять размеры окна. +.SH ФАЙЛ МЕНЮ +По умолчанию файл меню расположен в +.IR @pkgdatadir@/menu. +Это файл общесистемного меню, и его изменение влияет на структуру меню +всех пользователей сразу. +Но можно создавать и персональные меню. По традиции файл меню создается в +подкаталоге +.IR "~/.fluxbox/" " (или " "~/fluxbox/" ")" +в домашнем каталоге пользователя, и имеет имя +.I menu. +Вы можете просто скопировать сюда общее меню. После этого +нужно указать Fluxbox использовать персональное меню вместо общесистемного. +Это достигается добавлением (или изменением) значения ресурса session.menuFile +в файле +.I ~/.fluxbox/init +, например: +.EX +session.menuFile: ~/.fluxbox/menu +.EE +Чтобы изменения вступили в силу, нужно перезапустить Fluxbox. +Настройте меню по своему усмотрению, а затем выполните команду 'Restart' +из главного меню Fluxbox. Если вы меняли только содержание файла меню, +можно просто перезагрузить настройки вызовом команды +.I 'Reload config'. +.SS Синтаксис файла меню +Синтаксис файла меню достаточно прост, но в тоже время он довольно +гибкий. В каждой строке меню может располагаться до трех аттрибутов, +записанных в следующей форме: +.EX +[тэг] (надпись или имя файла) {команда или имя файла} +.EE +Допустимы следующие тэги: +.TP +.B [begin] (надпись в заголовке главного меню) +Этот тэг идентифицирует начало меню. Если его +не будет, Fluxbox просто проигнорирует файл и загрузит +общесистемное меню. +.TP +.B [end] +Используется для указания конца меню (либо подчиненного, +либо главного меню). +В файле должен присутствовать по крайней мере один +такой тэг, соответствующий необходимому тэгу [begin]. +.TP +.B [exec] (надпись) {команда оболочки} +Добавляет в меню команду. При выборе такого +пункта меню Fluxbox будет выполнять `команду оболочки'. +.TP +.B [exit] (надпись) +Добавляет команду завершения Fluxbox. В качестве родителя +всех открытых окон устанавливается главное окно. +.TP +.B [include] (имя файла) +Анализирует содержание файла +.I имя файла +и добавляет полученные в результате анализа пункты меню +в текущую позицию. Имени файла может предшествовать либо +полный путь, либо путь с сокращением +.IR ~/ , +которое развертывается в путь к домашнему каталогу +пользователя (например, +.EX +[include] (~/fluxbox/stylesmenu) +.EE +добавляет файл +.I /home/yourusername/fluxbox/stylesmenu +в моё меню). +.TP +.B [nop] (надпись - необязательно) +Добавить в текущее меню элемент, с которым не связаны +какие-либо действия. Это может быть полезно при +формировании в меню блоков или секций. +.B [nop] +дополнительно может иметь метку; если она не будет указана, +будет добавлен пустой пункт. +.TP +.B [style] (надпись) {имя файла} +Этот тэг позволяет добавить элемент меню, который при выборе +будет загружать стиль +.I имя файла. +.TP +.B [stylesdir] (имя каталога) +Считывает имена всех файлов в указанном каталоге, предполагая, что все эти файлы +содержат стили (подкаталоги игнорируются), и добавляет пункты меню, соответствующие +всем найденным файлам, которые при выборе будут устанавливать соответствующий стиль +для текущего сеанса. Надписи к пунктам меню соответствуют именам файлов. +.TP +.B [stylesmenu] (надпись) {имя каталога} +Создает подменю с +.I надписью +(которая является также и заголовком нового подменю), и добавляет в него пункты, соответствующие +файлам в указанном каталоге, подразумевая, что все они являются файлами стилей (подкаталоги +игнорируются), аналогично тэгу +.B [stylesdir]. +.IP +.RB Тэги\ [stylesdir] \ и\ [stylesmenu] +позволяют устанавливать новые стили, не редактируя файл меню. +.TP +.B [submenu] (надпись) {заголовок меню - необязательно} +Добавляет вложенное меню. Такого рода меню +анализируются рекурсивно, а, значит, нет ограничений +на количество подобных `вложений'. +Заголовок для нового меню указывать необязательно; если он +не указан, в качестве заголовка будет использоваться указанная +надпись. Для завершения описания меню используется тэг +.B [end]. +.IP +Если в качестве аттрибута 'надпись' указать 'Startup', то +приложения, расположенные в этом подменю, будут запускаться при +запуске Fluxbox. +.TP +.B [reconfig] (надпись) +При выборе данной команды Fluxbox будет перечитывать текущие файлы +стиля и меню. +Эта возможность полезна при создании нового стиля или темы, поскольку +вам не придется перезапускать Fluxbox после каждого сохранения вашего +файла стиля. Тем не менее, при каждом изменении файла меню Fluxbox +автоматически перечитывает этот файл. +.TP +.B [restart] (надпись) {команда оболочки - необязательно} +Перезапускает Fluxbox. Если задана команда оболочки, Fluxbox +завершает свою работу и запускает указанную команду (обычно это +команда запуска другого оконного менеджера). Если команда не указана, +снова запускается Fluxbox. +.TP +.B [config] (надпись) +Добавляет встроенное подменю Fluxbox, содержащее различные настройки +расположения окон, способов фокусировки, перемещения окон и т.д. +.TP +.B [workspaces] (надпись) +Добавляет подменю рабочих столов. Это удобно для тех, +кто не может получить доступ к меню рабочих столов непосредственно +(например, если у вас двухкнопочная мышь и щелчок средней кнопкой мыши +для вас затруднен). +.PP +Если строка начинается с символа `#', она считается комментарием и +игнорируется парсером. В полях надписей, команд или +имен файлов можно использовать бэк-слеши для вставки +зарезервированных символов: +.EX +[exec] (\\(my cool\\) \\{XTERM\\}) {xterm -T \\"cool XTERM\\"} +.EE +Вставка символа бэк-слеша осуществляется простым дублированием (`\\\\'). +.SS Пример меню +Подводя итоги вышесказанному, приведем небольшой пример файла меню: +.PP +.nf +# файл меню Fluxbox +[begin] (Fluxbox) + [exec] (rxvt) {rxvt -ls} + [exec] (netscape) {netscape -install} + [exec] (The GIMP) {gimp} + [exec] (XV) {xv} + [exec] (Vim) {rxvt -geometry 132x60 -name VIM -e screen vim} + [exec] (Mutt) {rxvt -name mutt -e mutt} + [submenu] (mozilla) + [exec] (browser) {mozilla -browser} + [exec] (news) {mozilla -news} + [exec] (mail) {mozilla -mail} + [exec] (edit) {mozilla -edit} + [exec] (compose) {mozilla -compose} + [end] + [submenu] (Startup) + [exec] (gkrellm) {gkrellm -w} + [exec] (xmms) {xmms -p} + [exec] (galeon) {galeon -s} + [exec] (kdeinit) {kdeinit} + [end] + [submenu] (Window Manager) + [exec] (Edit Menus) {nedit ~/.fluxbox/menu} + [submenu] (Style) {Which Style?} + [stylesdir] (~/.fluxbox/styles) + [stylesmenu] (Fluxbox Styles) {@pkgdatadir@/styles} + [end] + [config] (Config Options) + [reconfig] (Reconfigure) + [restart] (Restart) + [end] + [exit] (Log Out) +[end] +# конец файла меню +.fi +.B FROM HERE ON UNREVISITED +.SH СТИЛИ +Для отображения декораций окон, меню и других элементов оконного интерфейса +Fluxbox использует специальные файлы, в которых в виде последовательности +.IR X (1)-ресурсов +хранятся описания цветов, текстур, изображений и шрифтов. +.PP +Стандартная установка Fluxbox содержит несколько таких стилевых файлов. +Обычно они расположены в каталоге +.IR @pkgdatadir@/styles . +Изучая и изменяя эти файлы, вы поймете, как устроен механизм стилей Fluxbox. +Добавив в свой файл меню команды +.BR [style] ", " [stylesdir] " или " [stylesmenu], +вы сможете менять текущий стиль простым выбором нужного пункта из меню. +.PP +Также можно создать в своем домашнем каталоге подкаталог +.I ~/.fluxbox/styles +и размещать там свои собственные стилевые файлы. Безусловно, +вы можете выбрать любое другое имя для данного каталога, но многие +темы, доступные в Интернет, помещают стили именно в подкаталог +.I styles +(согласно схеме именования, принятой на bb.themes.org). +.PP +Чтобы понять, как работает механизм стилей, вы должны уяснить, как работают +X-ресурсы. +.PP +X-ресурс состоит из ключа и значения. Ключ строится из нескольких +меньших ключей (т.н. "дети"), разделенных точкой (`.'). Ключи могут +содержать символ звездочки (`*'), который позволяет задавать шаблоны +(с данной строкой текста могут совпасть сразу несколько ключей). Это +полезно в стилях, содержащих один или два цвета. +.PP +Fluxbox позволяет настроить три компонента: панель инструментов, меню и +оформление окон. +.PP +Маленькое окно, которое показывает позицию при перемещении или изменении размеров +окна, копирует стиль заголовка обычного окна. +.PP +Приведем несколько небольших примеров: +.EX +toolbar.clock.color: green +.EE +Эта строка устанавливает цвет часов на панели инструментов в значение 'green' (зеленый). +Другой пример: +.EX +menu*color: rgb:3/4/5 +.EE +Устанавливает цвет меню +.I и всех его `детей' +в значение `rgb:3/4/5' +(схемы именования цветов описаны на странице руководства +.IR X (1).) +Таким образом, эта же строка описывает ключи +.IR menu.title.color " и " menu.frame.color . +Указав ключ +.EX +*font: -b&h-lucida-medium-r-normal-*-*-140-*, +.EE +вы устанавливаете шрифт сразу для всех ключей. +(информацию об установленных шрифтах можно узнать при помощи +утилит +.IR xfontsel "(1), " gtkfontsel ", или " xlsfonts "(1).)" +.PP +Одно из самых выдающихся преимуществ Fluxbox -- возможность генерировать +текстуры "на лету". Текстуры задаются непосредственно в ключах, например: +.ta \w'toolbar.clock.colorTo:\ 'u +.EX +toolbar.clock: Raised Gradient Diagonal Bevel1 +toolbar.clock.color: rgb:8/6/4 +toolbar.clock.colorTo: rgb:4/3/2 +.EE +Сейчас мы подробно разберем каждый аргумент, описывающий +текстуру. Описание текстуры может содержать до пяти полей: +.TP +.B Flat / Raised / Sunken +компонент отображается плоским (Flat), выпуклым (Raised) или утопленным (Sunken). +.TP +.B Gradient / Solid +компомнент заполняется либо сплошным цветом (Solid), либо градиентной заливкой (Gradient). +.TP +.B Horizontal / Vertical / Diagonal / Crossdiagonal / Pipecross / Elliptic / Rectangle / Pyramid +различные типы градиентной заливки (предыдущее поле должно иметь значение +.B Gradient +!) +.TP +.B Interlaced +выполнять заливку в черезстрочном режиме (каждая вторая линия темнее). +Обычно эта опция используется в градиентных текстурах, но, начиная с версии +0.60.3, работает и для однотонных. +.TP +.B Bevel1 / Bevel2 +указывает тип используемой рамки. По умолчанию используется Bevel1. +Эта рамка располагается непосредственно на границе изображения. Bevel2 позволяет +указать рамку, которая смещена на один пиксель внутрь изображения. +.PP +Вместо описания текстуры можно указать значение +.B ParentRelative, +которое делает компонент полностью прозрачным. +.PP +Все градиентные текстуры генерируются на основе значений двух цветовых ресурсов +.IR color " и " colorTo " ." +При использовании режима +.B Interlaced +в одноцветной текстуре ( +.B Solid +) значение ресурса +.I colorTo +используется в качестве альтернативного цвета (этим цветом будет отображаться каждая +вторая линия). +.PP +Приведем полный список компонент с указанием типов значений для них. Строки, +которые начинаются с восклицательного знака -- это комментарии. +.PP +.ta \w'window.button.unfocus.picColor:\ 'u +.nf +.\" +.\" The comments also to be translated! +.\" +! Панель инструментов +toolbar: Текстура +toolbar.color: Цвет +toolbar.colorTo: Цвет + +! Кнопка на панели инструментов +toolbar.button: Текстура или \fIParentRelative\fR +toolbar.button.color: Цвет +toolbar.button.colorTo: Цвет + +! Цвет стрелок на кнопках +toolbar.button.picColor: Цвет + +! Кнопка в нажатом состоянии +toolbar.button.pressed: Текстура \fI(например, Sunken)\fR или \fIParentRelative\fR +toolbar.button.pressed.color: Цвет +toolbar.button.pressed.colorTo: Цвет + +! Цвет стрелок на кнопках в нажатом состоянии +toolbar.button.pressed.picColor: Цвет + +! Метка рабочего стола на панели инструментов +toolbar.label: Текстура или \fIParentRelative\fR +toolbar.label.color: Цвет +toolbar.label.colorTo: Цвет +toolbar.label.textColor: Цвет + +! Метка окна на панели инструментов +toolbar.windowLabel: Текстура или \fIParentRelative\fR +toolbar.windowLabel.color: Цвет +toolbar.windowLabel.colorTo: Цвет +toolbar.windowLabel.textColor: Цвет + +! Часы на панели инструментов +toolbar.clock: Текстура или \fIParentRelative\fR +toolbar.clock.color: Цвет +toolbar.clock.colorTo: Цвет +toolbar.clock.textColor: Цвет + +! Выравнивание текста на панели инструментов +toolbar.justify: \fIcenter\fR, \fIleft\fR, или \fIright\fR + +! Шрифт, используемый во всех элементах панели инструментов +toolbar.font: Шрифт \fI(например, -*-helvetica-medium-r-normal-*-*-100-*)\fR + +! Заголовок меню +menu.title: Текстура +menu.title.color: Цвет +menu.title.colorTo: Цвет +menu.title.textColor: Цвет +menu.title.font: Шрифт +menu.title.justify: \fIcenter\fR, \fIleft\fR, или \fIright\fR + +! Фрейм меню +menu.frame: Текстура +menu.frame.color: Цвет +menu.frame.colorTo: Цвет +menu.frame.textColor: Цвет +menu.frame.disableColor: Цвет +menu.frame.font: Шрифт +menu.frame.justify: \fIcenter\fR, \fIleft\fR, или \fIright\fR + +! Значки входа в подменю +menu.bullet: \fIempty\fR, \fItriangle\fR, \fIsquare\fR, или \fIdiamond\fR +menu.bullet.position: \fIright\fR или \fIleft\fR + +! Выбранный пункт меню +menu.hilite: Текстура (например, \fIRaised\fR) +menu.hilite.color: Цвет +menu.hilite.colorTo: Цвет +menu.hilite.textColor: Цвет + +! Активное окно +window.title.focus: Текстура +window.title.focus.color: Цвет +window.title.focus.colorTo: Цвет + +! Неактивное окно +window.title.unfocus: Текстура +window.title.unfocus.color: Цвет +window.title.unfocus.colorTo: Цвет + +! Название окна (в заголовке) +window.label.focus: Текстура или \fIParentRelative\fR +window.label.focus.color: Цвет +window.label.focus.colorTo: Цвет +window.label.focus.textColor: Цвет + +window.label.unfocus: Текстура или \fIParentRelative\fR +window.label.unfocus.color: Цвет +window.label.unfocus.colorTo: Цвет +window.label.unfocus.textColor: Цвет + +! Полоска внизу окна +window.handle.focus: Текстура +window.handle.focus.color: Цвет +window.handle.focus.colorTo: Цвет + +window.handle.unfocus: Текстура +window.handle.unfocus.color: Цвет +window.handle.unfocus.colorTo: Цвет + +! Элементы управления размером окна +window.grip.focus: Текстура +window.grip.focus.color: Цвет +window.grip.focus.colorTo: Цвет + +window.grip.unfocus: Текстура +window.grip.unfocus.color: Цвет +window.grip.unfocus.colorTo: Цвет + +! Кнопки окна +window.button.focus: Текстура или \fIParentRelative\fR +window.button.focus.color: Цвет +window.button.focus.colorTo: Цвет +window.button.focus.picColor: Цвет + +window.button.unfocus: Текстура или \fIParentRelative\fR +window.button.unfocus.color: Цвет +window.button.unfocus.colorTo: Цвет +window.button.unfocus.picColor: Цвет + +window.button.pressed: Текстура (например, \fISunken\fR) +window.button.pressed.color: Цвет +window.button.pressed.colorTo: Цвет + +! Обрамление окна +window.frame.focusColor: Цвет +window.frame.unfocusColor: Цвет + +! Шрифт и выравнивание заголовка окна +window.font: Шрифт +window.justify: \fIcenter\fR, \fIleft\fR или \fIright\fR + +! Настройки докера +slit: +slit.color: Цвет +slit.colorTo: Цвет + +! Другие ресурсы + +! вокруг любого компонента может отображаться рамка +borderWidth: Число пикселей, например, \fI1\fR +borderColor: Цвет + +bevelWidth: Число пикселей > 0 +handleWidth: Число пикселей > 0 + +! Ширина рамки вокруг окна. +! Если не указана, используется значение bevelWidth +frameWidth: a number of pixels >= 0 + + +! Эта команда выполняется каждый раз при выборе данного стиля. +! Обычно используется для установки каких-нибудь красивых обоев. +rootCommand: Shell command, e.g. \fIbsetroot -mod 4 4 -fg rgb: 5/6/6 -bg grey20\fR + +! Некоторые программы из пакета bbtools используют эти устаревшие настройки +menuFont: Шрифт +titleFont: Шрифт +.fi +.PP +Как видите, список более чем велик. При создании собственных стилей не +забывайте о такой возможности, как подстановка ресурсов, этим вы +сэкономите себе и время, и количество набранных строк. Приведем +небольшой пример: +.EX +.ta \w'*unfocus.textColor:\ 'u +*color: slategrey +*colorTo: darkslategrey +*unfocus.color: darkslategrey +*unfocus.colorTo: black +*textColor: white +*unfocus.textColor: lightgrey +*font: lucidasans-10 +.EE +Этого вполне достаточно, чтобы почти все компоненты выглядели хорошо. +.SH ФАЙЛ СОЧЕТАНИЙ КЛАВИШ +Управление привязками клавиш в Fluxbox производится посредством файла +.IR ~/.fluxbox/keys. +Формат файла прост: +.EX +<модификатор> <клавиша> [...] :<действие> +.EE +В следующем примере Mod1 соответствует клавише 'Alt' на клавиатурах +PC, а Mod4 -- одной из трех дополнительных клавиш на pc104 с логотипом +известной мелкомягкой корпорации. +.EX +# Файл сочетаний клавиш Fluxbox. +# Строка, которая начинается с # есть комментарий. +Mod1 Tab :NextWindow +Mod1 F1 :Workspace1 +Mod1 F2 :Workspace2 +Mod1 F3 :Workspace3 +Mod1 F4 :Workspace4 +Mod1 F5 :Workspace5 +Mod1 F6 :Workspace6 +Mod1 F7 :Workspace7 +Mod1 F8 :Workspace8 +Mod1 F9 :Workspace9 +Mod1 F10 :Workspace10 +Mod1 F11 :Workspace11 +Mod1 F12 :Workspace12 +Mod4 b :PrevWorkspace +Mod4 c :Minimize +Mod4 r :ExecCommand rxvt +Mod4 v :NextWorkspace +Mod4 x :Close +Mod4 m :RootMenu +Control n Mod1 n :NextTab +.EE +В последней строке вы видите цепочку сочетаний клавиш; подобные +цепочки используются в Emacs. +Приведем список возможных действий: +.EX +Minimize +Raise +Lower +RaiseLayer +LowerLayer +TopLayer +BottomLayer +AlwaysOnTop (это алиас для TopLayer) +AlwaysOnBottom (аналогично) +Close +Quit +RootMenu +Workspace N (N -- положительное целое число) +Workspace1 +Workspace2 +Workspace3 +Workspace4 +Workspace5 +Workspace6 +Workspace7 +Workspace8 +Workspace9 +Workspace10 +Workspace11 +Workspace12 +NextWorkspace +PrevWorkspace +LeftWorkspace +RightWorkspace +KillWindow +NextWindow +PrevWindow +NextTab +PrevTab +ShadeWindow +MaximizeWindow +StickWindow +ExecCommand +MaximizeVertical +MaximizeHorizontal +NudgeRight +NudgeLeft +NudgeUp +NudgeDown +BigNudgeRight +BigNudgeLeft +BigNudgeUp +BigNudgeDown +HorizontalIncrement +VerticalIncrement +HorizontalDecrement +VerticalDecrement +ToggleDecor +.EE +.SH ФАЙЛ ГРУПП +Начиная с версии 0.1.11, Fluxbox поддерживает автогруппировку, что +означает возможность автоматически группировать приложения, +принадлежащие одной и той же группе. +Чтобы добавить или удалить группу, просто отредактируйте файл +.IR ~/.fluxbox/groups. +Формат файла такой: +.EX +<app1> <app2> <app3> ... <appN> +.EE +где каждый из элементов может быть определен при помощи следующей +команды: +.EX +xprop WM_CLASS +.EE +Просто запустите эту команду в терминале и кликните мышкой по окну +нужного приложения. Элементом будет появившееся в консоли +название. Каждая строка файла групп формирует отдельную группу, +например: +.EX +Navigator nedit +xterm +.EE +Этот пример создает две группы: одну для netscape и nedit, и вторую +для xterm. Новое окно будет группироваться к другим окнам только на +текущем рабочем столе к последнему активному окну. +.SH ДОКЕР +Докер -- это обрамление специального вида, в которое будут помещаться +все окна, поддерживающие пристыковку (docking), например, 'bbtools'. +Когда приложение запускается в докере, оно не имеет собственного +обрамления; вместо обрамления используется докер. Такие приложения +видимы на всех рабочих столах. +Щелкнув правой кнопкой мыши на границе докера, вы получите доступ к +меню, позволяющему настроить порядок приложений в нем, направление +докера (вертикальное или горизонтальное), а также автоскрытие докера. +.PP +Большинство док-приложений для запуска в докере должны быть запущены с ключом +.B -w. +Например, вы можете добавить в +.IR ~/.xinitrc +следующие строки: +.EX +bbmail -w & +bbpager -w & +exec fluxbox +.EE +Естественно, докер доступен только тогда, когда Fluxbox скомпилирован с поддержкой докера. +.SH ФАЙЛ SLITLIST +Начиная с версии 0.1.10, Fluxbox поддерживает запуск док-приложений в +порядке, определенном файлом +.IR ~/.fluxbox/slitlist. +.PP +Простая процедура получения нужной последовательности такова: +.EX +1) Запускаем Fluxbox без запущенных док-приложений. +2) По очереди запускаем док-приложения в нужном порядке. +3) Добавляем эти док-приложения в загрузочный скрипт (например, .xinitrc или .xsession). +Здесь порядок указания уже не играет роли! +.EE +Полученная последовательность по умолчанию будет сохранена в файл +.IR ~/.fluxbox/slitlist +и будет использоваться в последующих сеансах работы Fluxbox. +.PP +Файл slitlist можно модифицировать вручную. Это просто список названий +окон, по приложению на строчку. Аналогично файлу init, файл slitlist +нужно редактировать при незапущенном Fluxbox; иначе изменения будут +переписаны менеджером. +.PP +Файл списка док-приложений может располагаться в любом каталоге и +иметь произвольное имя. Для этого нужно отредактировать файл +.B init +так, как показано в следующем примере: +.EX +session.slitlistFile: /home/me/etc/slitsort +.EE +.SH МЕНЮ НАСТРОЙКИ +Некоторые параметры Fluxbox можно настроить непосредственно из главного +меню в подменю настройки. Большинство из них понятны без лишних +комментариев, но кое-какие все же требуют разъяснений: +.TP +.B Sloppy Window Grouping +Если эта опция включена, то при группировке двух окон заголовок +первого можно отпустить на любой части второго окна; если же +выключена, то "область попадания" несколько сужается -- вы должны +будете отпустить заголовок первого окна точно на заголовке второго. +.TP +.B Полная максимизация +Если этот параметр включен, то распахнутое окно будет перекрывать +докер. Чтобы докер был постоянно виден, выключите эту опцию. +.SH ФАЙЛ РЕСУРСОВ +Обычно файл +.I ~/.fluxbox/init +создается и модифицируется менеджером автоматически. +В этом файле хранятся настройки всех параметров из меню конфигурации ( +.B [config] +), используемый файл стиля, названия рабочих столов и т.д. Тем не +менее, некоторые ресурсы вы можете изменять вручную: +.TP +.B session.menuFile: +Определяет расположение файла меню. +.EX +session.menuFile: /home/myself/.fluxbox/menu +.EE +.TP +.B session.keyFile: +Определяет расположение файла сочетаний клавиш. +.EX +session.keyFile: /home/myself/.fluxbox/keys +.EE +.TP +.B session.styleFile: +Определяет расположение файла стиля (темы) для текущего сеанса. +.EX +session.styleFile: @pkgdatadir@/styles/Flux +.EE +.TP +.B session.groupFile: +Определяет расположение файла групп. +.EX +session.groupFile: /home/myself/.fluxbox/groups +.EE +.TP +.B session.slitlistFile: +Определяет расположение файла, задающего порядок расположения +док-приложений в докере. +.EX +session.slitlistFile: /home/myself/.fluxbox/slitlist +.EE +.TP +.B session.screen0.toolbar.widthPercent: +Определяет ширину панели инструментов (в процентах от общей ширины экрана). +По умолчанию имеет значение +.IR 66 . +.TP +.B session.screen0.strftimeFormat: +Позволяет настроить вид часов на панели инструментов. Для данного +ресурса используется формат +.IR strftime (3). +По умолчанию имеет значение +.IR "%I:%M %p" . +.TP +.B session.screen0.rootCommand: +Этот ресурс перекрывает одноименный в файле стиля. Если он установлен, +фоновое изображение не будет меняться при смене текущего стиля. +.TP +.B session.autoRaiseDelay: +При использовании режима автовсплытия позволяет настроить задержку (в +миллисекундах) перед тем как активное окно будет помещено на передний +план. По умолчанию имеет значение +.IR 250 . +.TP +.B session.doubleClickInterval: +Позволяет настроить максимальный временной интервал (в миллисекундах) между +кликами, при котором Fluxbox распознает их как двойной клик. По +умолчанию имеет значение +.IR 250 . +.TP +.B session.screen0.edgeSnapThreshold: +Наверняка вы заметили, что при перемещении окон по экрану они как-бы +прилипают к его краям. Вышеуказанный параметр позволяет задать +расстояние (в пикселях), при котором окно будет прилипать к границе. +По умолчанию имеет значение +.IR 0 . +.TP +.B session.cacheMax: +Определяет количество памяти (в КБ), используемое Fluxbox для +кэширования растров на стороне X-сервера. Если на вашем компьютере +не очень много памяти, можете уменьшить это значение. +По умолчанию имеет значение +.IR 200 . +.TP +.B session.cacheLife: +Определяет время (в минутах), после истечения которого неиспользуемые +растры будут выгружены из памяти X-сервера. +По умолчанию имеет значение +.IR 5 . +.TP +.B session.opaqueMove: +Этот параметр влияет на отрисовку окна при перемещении: если он равен +.IR True , +то по мере перемещения будет перерисовываться все окно (не очень +приятное зрелище на медленных машинах), если же он равен +.IR False , +то при перемещении будет отображаться только контур окна. +.TP +.B session.imageDither: +.IR True +или +.IR False +чтобы, соответственно, разрешить или запретить генерацию полутонов для +изображений. Необходимо только на системах с небольшой глубиной цвета +(8bpp и менее). +.TP +.B session.colorsPerChannel: +Определяет количество цветов, получаемых от X-сервера, на +псевдоцветных дисплеях. Канал может быть красным, синим или зеленым; +соответсвенно, Fluxbox резервирует colorsPerChannel^3 цветов. Значение +должно быть между 2 и 6. Если вы используете восьмибитный дисплей, +установите это значение в 4. +По умолчанию имеет значение +.IR 4. +.TP +.B session.iconbar: +.IR True +или +.IR False , +чтобы разрешить или запретить использование панели инструментов для +отображения свернутых окон. +.TP +.B session.tabs: +.IR True +или +.IR False , +чтобы разрешить/запретить оконные вкладки в стиле PWM. Вкладки +позволяют вам группировать окна. Последние после группировки +занимают одинаковое пространство на рабочем столе (размер окна +изменяется автоматически) и перемещаются одновременно с группой. +По умолчанию имеет значение +.IR True . +.TP +.B session.screen0.tab.placement: +Указывает, с какой стороны окна располагать вкладки. Этот параметр +также можно настроить из меню настройки Fluxbox, подменю Tab +Placement. Возможны значения +.IR Top +.IR Bottom +.IR Left +.IR Right . +.TP +.B session.screen0.tab.alignment: +Определяет, каким образом выравнивать вкладки. Допустимы значения +.IR Top +.IR Bottom +.IR Left +.IR Right +.IR Center +.IR Relative . +Этот параметр также можно настроить через меню Tab Placement. +.TP +.B session.screen0.tab.rotatevertical: +Если установлен в True, текст на вертикально-расположенных вкладках +будет повернут таким образом, чтоб его можно было прочитать. Опять же, +используйте меню Tab Placement. +.TP +.B session.screen0.tab.width: +Ширина вкладки окна в пикселях. +.TP +.B session.screen0.tab.height: +Высота вкладки окна в пикселях. +.PP +При запуске Fluxbox на системе с несколькими десктопами ключ +.B screen0 +может быть заменен на +.B screen1, 2 +и т.д., соответственно имеющимся десктопам. Это позволяет настроить +каждый десктоп по отдельности. Автор данной страницы, владеющий картой +Matrox G450 с двумя выходами, предпочитает следующую конфигурацию: +screen0 -- докер и панель инструментов автоматически убираются с +экрана (установлено автоскрытие), screen1 -- докер и панель всегда на +экране и всегда на верху (установлен параметр OnTop), в часах +установлен расширенный формат времени. +.EX +session.screen0.toolbar.onTop: False +session.screen0.toolbar.autoHide: True +session.screen0.toolbar.placement: BottomCenter +session.screen0.toolbar.widthPercent: 42 +session.screen0.slit.onTop: False +session.screen0.slit.autoHide: True +session.screen0.slit.placement: TopLeft +session.screen0.slit.direction: Vertical +session.screen0.strftimeFormat: %I:%M %p +session.screen1.toolbar.onTop: True +session.screen1.toolbar.autoHide: False +session.screen1.toolbar.placement: BottomCenter +session.screen1.toolbar.widthPercent: 69 +session.screen1.slit.onTop: True +session.screen1.slit.autoHide: False +session.screen1.slit.placement: CenterRight +session.screen1.slit.direction: Vertical +session.screen1.strftimeFormat: %a %d %R [%s] +.EE +Таким образом, рабочие приложения максимально используют свободное +пространство экрана на screen0, а на screen1 можно посмотреть время +или запустить докапы. +.SH ПАРАМЕТРЫ ЗАПУСКА ПРИЛОЖЕНИЙ +Иногда бывает очень удобно, чтобы некоторое приложение всегда запускалось с +одной и той же геометрией, на одном и том же рабочем столе и +т.п. Теперь это стало возможным благодаря подменю 'Remember...' в меню +окна. Настройки, сохраненные посредством этого меню, записываются в файл +.I ~/.fluxbox/apps. +Редактировать этот файл вручную зачастую лишено смысла, поскольку все +настройки можно установить при помощи меню 'Remember...'. +.TP +.B Workspace [0-N] +Принудительно запускает приложение на указанном рабочем столе, даже +если оно было запущено с другого рабочего стола. +.TP +.B Dimensions [Width Height] +Запомнить размеры окна. +.TP +.B Position [X Y] +Запомнить позицию окна. +.TP +.B Shaded state [yes|no] +Запомнить, свернуто ли окно в заголовок. +.TP +.B Tab state [yes|no] +Запомнить текущее состояние группировки. +.TP +.B Decoration state [NONE|NORMAL|TOOL|TINY] +Запомнить декорации окна. +.TP +.B Sticky state [yes|no] +Если окно в данный момент "приклеено", то при каждом следующем запуске +оно будет изначально в этом состоянии. +.TP +.B Jump to workspace [yes|no] +Эта опция полезна в паре с параметром 'Workspace'. При запуске +приложения текущий рабочий стол будет сменяться на тот, на котором +запущено приложение. +.TP +.B Save settings on close [yes|no] +По умолчанию, параметры запуска приложений не сохраняются при закрытии +окна. Если вы хотите обратного, установите эту опцию. +.SS Пример файла apps +Приведем небольшой пример: +.PP +.nf +[app] (kate) + [Dimensions] {1022 747} + [Position] {0 0} + [Close] {yes} +[end] +[app] (konqueror) + [Workspace] {1} + [Dimensions] {1006 749} + [Position] {16 0} + [Jump] {yes} +[end] +[app] (xterm) + [Deco] {NONE} +[end] +.fi + +Параметры в этом файле чувствительны к смене регистра. Имя приложения +берется по первому атрибуту WM_CLASS. Чтобы получить это значение, +запустите программу xprop и щелкните на нужном окне. Параметры +приложений не влияют на временные окна. +.SH ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ +.TP +.B HOME +Fluxbox использует +.RB $ HOME +для определения местоположения файла +.I .fluxbox/init, +а также для разрешения имен каталогов и файла стиля. +.TP +.B DISPLAY +Fluxbox будет запущен на экране, указанном в этой переменной, если +иное не указано в командной строке. +.SH АВТОРЫ и БЛАГОДАРНОСТИ + +Blackbox был написан Брэдом Хьюисом (Brad Hughes, +.nh \" hyphenation off +blackbox@alug.org) +.hy \" on again +и Джефом Рэйвеном (Jeff Raven, +.nh +jraven@psu.edu), +.hy +сопровождался ими же. +Fluxbox был написан и сопровождался Хенриком Киннаненом (Henrik Kinnunen, +.nh +fluxgen@linuxmail.org), +.hy +много людей со всего мира помогали ему в этой работе. +.PP +Официальный сайт Fluxbox: +.nh +.B http://fluxbox.sf.net/ +.hy +.br +Много совместимых тем можно найти здесь: +.nh +.B http://themes.freshmeat.net/ +.hy +.PP +Эта страница была собрана Мэттью Хокинсом (Matthew Hawkins, +.nh +matt@mh.dropbear.id.au) +.hy +из страницы руководства Blackbox, написанного Вилбертом Берендсеном (Wilbert Berendsen, +.nh +wbsoft@xs4all.nl), +.hy +после чего эта страница была значительно переработана Тобиасом +Клаусманом (Tobias Klausmann, +.nh +klausman@users.sourceforge.net). +.hy +Данный перевод осуществлен Андреем Балагутой +.nh +(uj2@mail.ru). +.hy +.SH СМ. ТАКЖЕ +.IR bsetroot (1) \" not there, yet ;-( + +