all repos — fluxbox @ 4929bda39e7cbeb2ed594436ccac5d32f1815cb3

custom fork of the fluxbox windowmanager

use asciidoc-generated manpages from now on
mathias mathias
commit

4929bda39e7cbeb2ed594436ccac5d32f1815cb3

parent

cd238a475b96806752a0d232c6b09d1627de58c1

M ChangeLogChangeLog

@@ -1,6 +1,7 @@

(Format: Year/Month/Day) Changes for 1.0.0: *07/04/23: + * Use asciidoc-generated manpages as the default from now on (Mathias) * Disabled resizing shaded windows (Mark) FbWinFrame.cc Window.cc *07/04/20:
M doc/asciidoc/README.txtdoc/asciidoc/README.txt

@@ -1,7 +1,7 @@

whats this? this is the attempt to write the documentation for fluxbox in ascii-doc format. how does it work? -well, we just edit fluxbox.txt from this directory. save it. +well, just edit fluxbox.txt from this directory. save it. then we can produce pretty much any format we like: man:
D doc/asciidoc/fluxbox-style.1

@@ -1,483 +0,0 @@

-.\"Generated by db2man.xsl. Don't modify this, modify the source. -.de Sh \" Subsection -.br -.if t .Sp -.ne 5 -.PP -\fB\\$1\fR -.PP -.. -.de Sp \" Vertical space (when we can't use .PP) -.if t .sp .5v -.if n .sp -.. -.de Ip \" List item -.br -.ie \\n(.$>=3 .ne \\$3 -.el .ne 3 -.IP "\\$1" \\$2 -.. -.TH "FLUXSTYLE" 1 "" "" "" -.SH NAME -fluxstyle \- A comprehensive look at styles/themes for fluxbox(1). -.SH "SYNOPSIS" - -.SH "DESCRIPTION" - - -What is a Style? - - -Styles, sometimes referred to as Themes, are a graphical overlay for the fluxbox(1) window manager\&. If you wanted to get to know fluxbox, the styles would be the \fIlook\fR of the \fIlook and feel\fR\&. - - -Styles are simple ASCII text files that tell fluxbox(1) how to generate the appearance of different components of the window manager\&. The default installation of fluxbox(1) is shipped with many classic examples that show a great deal of what one could do\&. To use one of the standard styles navigate to the \fISystem Styles\fR menu under your main fluxbox(1) menu\&. - - -fluxbox(1) uses its own graphics class to render its images on the fly\&. By using styles you can determine, at a great level of configurability, what your desktop will look like\&. Since fluxbox(1) was derived from blackbox many often wonder if old themes will work on the latest releases of fluxbox(1)\&. Well they basically do, but you will have to tune them since the fluxbox(1) code has changed quite a bit since the initial grab\&. - -.SH "STRUCTURE" - - -A style is made up of a few major components which then have their own sub\-directives\&. The major components are as follows: - - -The \fIwindow\&.*\fR directives control the appearance of the window frames, window\&.tab\&.* controls the appearance of the window tabs, \fImenu\&.*\fR controls the appearance of the popup menu that you see when you right click on the desktop\&. \fItoolbar\&.*\fR is the bar you will see at the top or bottom of your screen\&. Finally the \fIslit\&.*\fR has options you can use to customize the appearance of the slit\&. However if you don't set the slit directives specifically, the slit's appearance is controlled by the toolbar directives instead\&. - - -To understand how the style mechanism works, it is nice to know a little about how X11 resources work\&. X11 resources consist of a key and a value\&. The key is constructed of several smaller keys (sometimes referred to as children), delimited by a period (\&.)\&. Keys may also contain an asterisk (*) to serve as a wildcard, which means that one line of text will match several keys\&. This is useful for styles that are based on one or two colors\&. - - -A more complete reference to this can be found in X(7), section \fIRESOURCES\fR\&. - -.SH "LOCATION" - - -There are many places to store your styles, the most common is in your \fI~/\&.fluxbox/styles\fR directory\&. The initial installation will place the default styles in \fI/usr/share/fluxbox/styles\fR providing a basic usable configuration\&. - - -When creating your own style, create a directory (normally the name of your style) in \fI~/\&.fluxbox/styles/\fR (If the \fIstyles\fR directory doesn't exist, create that also)\&. While there isn't an official structure, it is common to create a directory named after your style and place your pixmaps directory (if required) in there along with a file called theme\&.cfg (may also be named style\&.cfg)\&. This file is where you will construct your style using the components covered later in this manual page\&. An example of steps taken when beginning a style project of your own may look like: - -.nf -$ cd -$ mkdir \-p ~/\&.fluxbox/styles/YourStyle/pixmaps -$ cd ~/\&.fluxbox/styles/YourStyle -$ nano theme\&.cfg -.fi - - -Output of a packaged style should look like the following: - -.nf -$ cd -$ tar \-tjvf YourStyle\&.tar\&.bz2 - \&.fluxbox/styles/YourStyle/theme\&.cfg - \&.fluxbox/styles/YourStyle/pixmaps - \&.fluxbox/styles/YourStyle/pixmaps/stick\&.xpm - \&.\&.\&. -.fi - - -Of course, all of these are just preferences, fluxbox(1) allows for the customization of many things, including how you handle your styles\&. Just remember, however, that if you plan to distribute your style you may find some community bickering if you don't follow practices\&. :) - -.SH "CREATING YOUR STYLE" - - -As discussed above, fluxbox(1) allows you to configure its four main components: the toolbar, menus, slit and window decorations\&. Remember that you can customize the slit with its own directives, otherwise the slit will take the appearance of the toolbar\&. - - -Here are some quick examples to illustrate basic syntax: - -.nf -toolbar\&.clock\&.color: green -.fi - - -This sets the color resource of the toolbar clock to \fIgreen\fR\&. Another example: - -.nf -menu*color: rgb:3/4/5 -.fi - - -This sets the color resource of the menu and all of its \fIchildren\fR to `rgb:3/4/5'\&. (For a description of color names, see X(1)\&.) So this one also applies to \fImenu\&.title\&.color\fR and \fImenu\&.frame\&.color\fR\&. And with - -.nf -*font: \-b&h\-lucida\-medium\-r\-normal\-*\-*\-140\-* -.fi - - -you set the font resource for all keys to this font name all at once (For information about the fonts installed on your system, you can use a program like xfontsel(1), gtkfontsel, or xlsfonts(1)\&.) - - -In the last example you will notice the wildcard (*) before font\&. In a Fluxbox style you can set a value with a wildcard\&. The example means that every font in the style will be what is specified\&. You can do this with any component/value\&. For example if you wanted all of the text to be one color you would do: - -.nf -*textColor: rgb:3/4/5 -.fi - - -This means that you can setup a very simple style with very few properties\&. See the EXAMPLES below for an example of this in practice\&. fluxbox(1) also allows you to override wildcards in your style\&. Lets take our example above and add an override for the toolbar\&.clock\&.textColor component: - -.nf -*textColor: rgb:3/4/5 -toolbar\&.clock\&.textColor: rgb:255/0/0 -.fi - - -With that all of the text will be \fIrgb:3/4/5\fR except the toolbar clock text which will be \fIrgb:255/0/0\fR\&. - - -Now what makes fluxbox(1) so spectacular is its ability to render textures on the fly\&. A texture is a fillpattern that you see on some styles\&. Texture descriptions are specified directly to the key that they should apply to, e\&.g\&.: - -.nf -toolbar\&.clock: Raised Gradient Diagonal Bevel1 -toolbar\&.clock\&.color: rgb:8/6/4 -toolbar\&.clock\&.colorTo: rgb:4/3/2 -.fi - - -Don't worry, we will explain what these mean\&. A texture description consists of up to five fields, which are as follows: - -.PP -gives the component either a flat, raised or sunken appearance\&. - -.PP -tells fluxbox(1) to draw either a solid color or a gradient texture\&. - -.PP -Select one of these texture types\&. They only work when \fIGradient\fR is specified\&. - -.PP -tells fluxbox(1) to interlace the texture (darken every other line)\&. This option is most commonly used with gradiented textures, but it also works in solid textures\&. - -.PP -tells fluxbox(1) which type of bevel to use\&. Bevel1 is the default bevel\&. The shading is placed on the edge of the image\&. Bevel2 is an alternative\&. The shading is placed one pixel in from the edge of the image\&. - - -Instead of a texture description, also the option \fIParentRelative\fR is available, which makes the component appear as a part of its parent, e\&.g\&. totally transparent\&. - - -Or for even more possibilities Pixmap\&. If pixmap texture is specified (it might not be necessary on every occasion) the pixmap file is specified in a separate pixmap resource\&. - -.nf -toolbar\&.clock: pixmap -toolbar\&.clock\&.pixmap: clock_background\&.xpm -.fi - - -This feature might need some investigation, reports say that sometimes the resources color and colorTo must be set and then they may not be set\&. - - -All gradiented textures are composed of two color values: the \fIcolor\fR and \fIcolorTo\fR resources\&. When \fIInterlaced\fR is used in \fISolid\fR mode, the \fIcolorTo\fR resource is used to find the interlacing color\&. - -.SH "A WORD ABOUT FONTS" - - -We should comment about fonts before we move on to the complete component list\&. fluxbox(1) supports different options for text\&. These options currently include bold, halo and shadow\&. To set these do this: fontname\-size:options for any of the font components in the style file\&. For example: - -.nf -menu\&.title\&.font: sans\-8:bold,shadow -.fi - - -The latest versions of fluxbox(1) (> 0\&.9\&.8) also support different values for these text options\&. The possibilities are as follows: - -.nf -\-\-\-\-\-\-\-\- -Shadow color=<colorname> offsetx=<integer> offsety=<integer> Halo color=<colorâ\\u20acname> -\-\-\-\-\-\-\-\- -.fi - - -For the case of completeness, here are some real world examples: - -.nf -*\&.font: Verdana\-10:bold,shadow:offsetx=2;offsety=4;color=green -*\&.font: Verdana\-10:halo:color=blue -.fi - - -Of course this could all be placed on one line\&. Also note that for the offset options, negative integers are allowed\&. - -.SS "FONT PROBLEMS" - - -If you have problems installing fonts or getting them to work, you should read the docs page at xfree\&.org\&. Here is a link to one of these: http://xfree\&.org/4\&.3\&.0/fonts2\&.html#3 - -.SH "FULL COMPONENT LIST" - - -Here is the exhaustive component list for fluxbox(1) styles\&. Each one is listed with their type of value required\&. Comments in a style file are preceded with an exclamation point (!) which we also use here so that these can be pasted into a new theme\&.cfg to be customized appropiately\&. Please note that in order to keep styles consistent it is often the practice of stylists to provide all of the theme\-items in their style file even if they are not used\&. This allows the user the ease of changing different components\&. - -.SH "WINDOW OPTIONS" - - -Many, many things you can do with window design in fluxbox(1), below are your options\&. Have fun\&. - -.nf -\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -window\&.bevelWidth: <integer> -window\&.borderColor: <color> -window\&.borderWidth: <integer> -window\&.button\&.focus: <texture type> -window\&.button\&.focus\&.color: <color> -window\&.button\&.focus\&.colorTo: <color> -window\&.button\&.focus\&.picColor: <color> -window\&.button\&.focus\&.pixmap: <filename> -window\&.button\&.pressed: <texture type> -window\&.button\&.pressed\&.color: <color> -window\&.button\&.pressed\&.colorTo: <color> -window\&.button\&.pressed\&.pixmap: <filename> -window\&.button\&.unfocus: <texture type> -window\&.button\&.unfocus\&.color: <color> -window\&.button\&.unfocus\&.colorTo: <color> -window\&.button\&.unfocus\&.picColor: <color> -window\&.button\&.unfocus\&.pixmap: <filename> -window\&.close\&.pixmap: <filename> -window\&.close\&.pressed\&.pixmap: <filename> -window\&.close\&.unfocus\&.pixmap: <filename> -window\&.font: <font> -window\&.frame\&.focusColor: <color> -window\&.frame\&.unfocusColor: <color> -window\&.grip\&.focus: <texture type> -window\&.grip\&.focus\&.color: <color> -window\&.grip\&.focus\&.colorTo: <color> -window\&.grip\&.focus\&.pixmap: <filename> -window\&.grip\&.unfocus: <texture type> -window\&.grip\&.unfocus\&.color: <color> -window\&.grip\&.unfocus\&.colorTo: <color> -window\&.grip\&.unfocus\&.pixmap: <filename> -window\&.handle\&.focus: <texture type> -window\&.handle\&.focus\&.color: <color> -window\&.handle\&.focus\&.colorTo: <color> -window\&.handle\&.focus\&.pixmap: <filename> -window\&.handle\&.unfocus: <texture type> -window\&.handle\&.unfocus\&.color: <color> -window\&.handle\&.unfocus\&.colorTo: <color> -window\&.handle\&.unfocus\&.pixmap: <filename> -window\&.handleWidth: <integer> -window\&.iconify\&.pixmap: <filename> -window\&.iconify\&.pressed\&.pixmap: <filename> -window\&.iconify\&.unfocus\&.pixmap: <filename> -window\&.justify: <{Left|Right|Center}> -window\&.label\&.active: <texture type> -window\&.label\&.active\&.textColor: <color> -window\&.label\&.focus: <texture type> -window\&.label\&.focus\&.color: <color> -window\&.label\&.focus\&.colorTo: <color> -window\&.label\&.focus\&.pixmap: <filename> -window\&.label\&.unfocus: <texture type> -window\&.label\&.unfocus\&.color: <color> -window\&.label\&.unfocus\&.colorTo: <color> -window\&.label\&.unfocus\&.pixmap: <filename> -window\&.label\&.focus\&.textColor: <color> -window\&.label\&.unfocus\&.textColor: <color> -window\&.maximize\&.pixmap: <filename> -window\&.maximize\&.pressed\&.pixmap: <filename> -window\&.maximize\&.unfocus\&.pixmap: <filename> -window\&.roundCorners: <{Top|Bottom}{Left|Right}> -window\&.shade\&.pixmap: <filename> -window\&.shade\&.pressed\&.pixmap: <filename> -window\&.shade\&.unfocus\&.pixmap: <filename> -window\&.stick\&.pixmap: <filename> -window\&.stick\&.pressed\&.pixmap: <filename> -window\&.stick\&.unfocus\&.pixmap: <filename> -window\&.stuck\&.pixmap: <filename> -window\&.stuck\&.unfocus\&.pixmap: <filename> -window\&.title\&.focus: <texture type> -window\&.title\&.focus\&.color: <color> -window\&.title\&.focus\&.colorTo: <color> -window\&.title\&.focus\&.pixmap: <filename> -window\&.title\&.height: <integer> -window\&.title\&.unfocus: <texture type> -window\&.title\&.unfocus\&.color: <color> -window\&.title\&.unfocus\&.colorTo: <color> -window\&.title\&.unfocus\&.pixmap: <filename> -\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -.fi - -.SH "MENU OPTIONS" - - -Everything you need to make your menu look pretty\&. - -.nf -\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -menu\&.bevelWidth: <integer> -menu\&.borderColor: <color> -menu\&.borderWidth: <integer> -menu\&.bullet: <{empty|square|triangle|diamond}> -menu\&.bullet\&.position: <{left|right}> -menu\&.frame: <texture type> -menu\&.frame\&.color: <color> -menu\&.frame\&.colorTo: <color> -menu\&.frame\&.disableColor: <color> -menu\&.frame\&.font: <font> -menu\&.frame\&.justify: <{Left|Right|Center}> -menu\&.frame\&.pixmap: <filename> -menu\&.frame\&.textColor: <color> -menu\&.hilite: <texture type> -menu\&.hilite\&.color: <color> -menu\&.hilite\&.colorTo: <color> -menu\&.hilite\&.pixmap: <filename> -menu\&.hilite\&.textColor: <color> -menu\&.itemHeight: <integer> -menu\&.title: <texture type> -menu\&.title\&.color: <color> -menu\&.title\&.colorTo: <color> -menu\&.title\&.font: <font> -menu\&.title\&.pixmap: <filename> -menu\&.title\&.textColor: <color> -menu\&.title\&.justify: <{Left|Right|Center}> -menu\&.titleHeight: <integer> -menu\&.roundCorners: <{Top|Bottom}{Left|Right}> -menu\&.selected\&.pixmap: <filename> -menu\&.submenu\&.pixmap: <filename> -menu\&.unselected\&.pixmap: <filename> -\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -.fi - -.SH "BACKGROUND" - - -Rarely are you going to want to use this option\&. There is a command that is similar that is used in the init file\&. It is bad style to use this in your style, as it forces the user to use your background\&. So note that it is good practice to leave this blank or out of the style altogether\&. - -.nf -background: centered|aspect|tiled|fullscreen|random|solid|gradient <texture> -background\&.pixmap: <file (or directory for random)> -background\&.color: <color> -background\&.colorTo: <color> -.fi - -.SH "SLIT" - - -Here are all of the options for the slit\&. - -.nf -\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -slit: <texture type> -slit\&.bevelWidth: <integer> -slit\&.borderColor: <color> -slit\&.borderWidth: <integer> -slit\&.color: <color> -slit\&.colorTo: <color> -slit\&.pixmap: <filename> -\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -.fi - -.SH "TOOLBAR OPTIONS" - - -Below you will find all of the configuration possibilities for the toolbar\&. The list is pretty extensive and offers you many options to make your toolbar look just the way you want it\&. - -.nf -\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -toolbar: <texture type> -toolbar\&.bevelWidth: <integer (0\-255)> -toolbar\&.borderColor: <color> -toolbar\&.borderWidth: <integer> -toolbar\&.button\&.scale: <integer> -toolbar\&.color: <color> -toolbar\&.colorTo: <color> -toolbar\&.clock: <texture type> -toolbar\&.clock\&.borderColor: <color> -toolbar\&.clock\&.borderWidth: <integer> -toolbar\&.clock\&.font: <font> -toolbar\&.clock\&.justify: <{Left|Right|Center}> -toolbar\&.clock\&.pixmap: <filename> -toolbar\&.clock\&.color: <color> -toolbar\&.clock\&.colorTo: <color> -toolbar\&.clock\&.textColor: <color> -toolbar\&.height: <integer> -toolbar\&.iconbar\&.focused: <texture type> -toolbar\&.iconbar\&.focused\&.color: <color> -toolbar\&.iconbar\&.focused\&.colorTo:<color> -toolbar\&.iconbar\&.focused\&.pixmap: <filename> -toolbar\&.iconbar\&.unfocused: <texture type> -toolbar\&.iconbar\&.unfocused\&.color: <color> -toolbar\&.iconbar\&.unfocused\&.colorTo: <color> -toolbar\&.iconbar\&.unfocused\&.pixmap: <filename> -toolbar\&.iconbar\&.empty: <texture type> -toolbar\&.iconbar\&.empty\&.color: <color> -toolbar\&.iconbar\&.empty\&.colorTo: <color> -toolbar\&.iconbar\&.empty\&.pixmap: <filename> -toolbar\&.iconbar\&.focused\&.borderColor: <color> -toolbar\&.iconbar\&.focused\&.borderWidth: <integer> -toolbar\&.iconbar\&.unfocused\&.borderColor: <color> -toolbar\&.iconbar\&.unfocused\&.borderWidth: <integer> -toolbar\&.iconbar\&.borderColor: <color> -toolbar\&.iconbar\&.borderWidth: <integer> -toolbar\&.iconbar\&.focused\&.font: <font> -toolbar\&.iconbar\&.focused\&.justify: <{Left|Right|Center}> -toolbar\&.iconbar\&.focused\&.textColor: <color> -toolbar\&.iconbar\&.unfocused\&.font: <font> -toolbar\&.iconbar\&.unfocused\&.justify: <{Left|Right|Center}> -toolbar\&.iconbar\&.unfocused\&.textColor: <color> -toolbar\&.pixmap: <filename> -toolbar\&.shaped: <boolean> -toolbar\&.workspace\&.font: <font> -toolbar\&.workspace\&.justify: <{Left|Right|Center}> -toolbar\&.workspace\&.textColor: <color> -toolbar\&.workspace: <texture type> -toolbar\&.workspace\&.borderColor: <color> -toolbar\&.workspace\&.borderWidth: <integer> -toolbar\&.workspace\&.color: <color> -toolbar\&.workspace\&.colorTo: <color> -toolbar\&.workspace\&.pixmap: <filename> -\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -.fi - -.SH "EXAMPLES" - - -This list may seem intimidating, but remember, when you create your own style you can easily set a majority of these keys with a single component\&. For an example of this: - -.nf -\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -*color: slategrey -*colorTo: darkslategrey -*unfocus\&.color: darkslategrey -*unfocus\&.colorTo: black -*textColor: white -*unfocus\&.textColor: lightgrey -*font: lucidasans\-10 -\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -.fi - - -This sets nice defaults for many components\&. - -.SH "COLOR FORMATS" - - -These are the color formats for styles: - -.nf -#000000 (Hexadecimal) -rgb:<0\-255>/<0\-255>/<0\-255> -.fi - - -See /usr/X11R6/lib/X11/rgb\&.txt for an explaination\&. - -.SH "AUTHOR AND CREDITS" - - -Blackbox was written and maintained by Brad Hughes <blackbox@alug\&.org> and Jeff Raven <jraven@psu\&.edu>\&. - - -fluxbox(1) is written and maintained by Henrik Kinnunen <fluxgen@fluxbox(1)\&.org> with contributions and patches merged from many individuals around the world\&. - - -The Official fluxbox(1) website: http://www\&.fluxbox(1)\&.org You can find a lot of styles here: http://fluxmod\&.org/ - - -This manpage was composed from various resources including the official documentation, fluxbox(1) man page and numerous other resources by Curt "Asenchi" Micol\&. If you notice any errors or problems with this page, please contact him here: <asenchi@asenchi\&.com> and using the great contributions of <grubert@users\&.sourceforge\&.net>\&. Numerous other languages could be available if someone jumps in\&. - -.SH "SEE ALSO" - - -fluxbox(1) fbsetbg(1) fbsetroot(1) -
M doc/asciidoc/fluxbox-style.txtdoc/asciidoc/fluxstyle.txt

@@ -1,7 +1,7 @@

fluxstyle(1) ============ -Henrik Kinnunen <fluxgen@fluxbox(1).org> -v1.0rc2 3rd October 2006 +Henrik Kinnunen <fluxgen@fluxbox.org> +v1.0rc3 21th April 2007 NAME ----

@@ -9,6 +9,7 @@ fluxstyle - A comprehensive look at styles/themes for fluxbox(1).

SYNOPSIS -------- +This document describes various options available for fluxbox styles. DESCRIPTION -----------

@@ -59,7 +60,7 @@ LOCATION

-------- There are many places to store your styles, the most common is in your '~/.fluxbox/styles' directory. The initial installation will place the default -styles in '/usr/share/fluxbox/styles' providing a basic usable configuration. +styles in '@pkg_datadir@/styles' providing a basic usable configuration. When creating your own style, create a directory (normally the name of your style) in '~/.fluxbox/styles/' (If the 'styles' directory doesn't exist,

@@ -196,7 +197,7 @@ The latest versions of fluxbox(1) (> 0.9.8) also support different values for

these text options. The possibilities are as follows: -------- - Shadow color=<colorname> offsetx=<integer> offsety=<integer> Halo color=<colorâ\u20acname> + Shadow color=<colorname> offsetx=<integer> offsety=<integer> Halo color=<colorname> -------- For the case of completeness, here are some real world examples:

@@ -477,7 +478,7 @@ fluxbox(1) is written and maintained by Henrik Kinnunen <fluxgen@fluxbox.org>

with contributions and patches merged from many individuals around the world. The Official fluxbox(1) website: http://www.fluxbox.org[] -You can find a lot of styles here: http://fluxmod.org/[] +You can find a lot of styles here: http://tenr.de/[] This manpage was composed from various resources including the official documentation, fluxbox(1) man page and numerous other resources by Curt
M doc/asciidoc/fluxbox.1doc/asciidoc/fluxbox.1

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

.\" Title: fluxbox .\" Author: .\" Generator: DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/> -.\" Date: 04/11/2007 +.\" Date: 04/21/2007 .\" Manual: .\" Source: .\" -.TH "FLUXBOX" "1" "04/11/2007" "" "" +.TH "FLUXBOX" "1" "04/21/2007" "" "" .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only)
A doc/asciidoc/fluxbox.de.1

@@ -0,0 +1,1737 @@

+.\" Title: fluxbox +.\" Author: +.\" Generator: DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/> +.\" Date: 04/21/2007 +.\" Manual: +.\" Source: +.\" +.TH "FLUXBOX" "1" "04/21/2007" "" "" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +fluxbox \- Ein schneller, hochkonfigurierbarer Fenstermanager fuer X11 +.SH "SYNOPSIS" +\fIfluxbox\fR [\-v | \-version] [\-h | \-help] [\-i | \-info] +.sp +\fIfluxbox\fR [\-rc rcfile] [\-log logfile] [\-display display] [\-screen scr,scr|all] [\-verbose] +.sp +.SH "BESCHREIBUNG" +fluxbox(1) stellt unter anderem konfigurierbare Fensterverzierungen, ein Menue zum starten von Anwendungen sowie eine Toolbar, welche den Namen der aktuellen Arbeitsflaeche, ausgewaehlte Fenster und die aktuelle Uhrzeit anzeigt. Ueber ein Arbeitsflaechenmenue koennen Arbeitsflaechen hinzugefuegt, entfernt oder umbenannt werden. Der Slit ermoeglicht kleine Anwendungen anzudocken, als Beispiel seien die bbtools oder Dockapps genannt. +.sp +fluxbox(1) kann Fenster in die Toolbar minimieren und zusaetzlich ins \fIIcons\fR Untermenue des Arbeitsflaechenmenues hinzufuegen. Ein einziger Klick und die Fenster sind wieder da. Ein Doppelklick auf den Fenstertitel und das Fenster wird auf/abgerollt, will heissen: nur noch der Fenstertitel ist sichtbar. +.sp +fluxbox(1) verwendet eine eigene Graphikklasse um die benoetigten Graphiken darzustellen. Mit Farbschemadateien kann der Nutzer den Desktop bis ins Detail persoenlich gestalten. Farbschemata von Blackbox 0.65 (oder aelter) koennen in fluxbox verwendet werden, so dass bei einer Umstellung von blackbox das Aussehen genau gleich bleibt. +.sp +fluxbox(1) unterstuetzt weitgehend die EWMH Spezifikationen sowie andere Standards der Fensterverwaltung. Das ermoeglicht eine einheitliche Ansteuerung aller Fenstermanager und vereinfacht die Interoperabilitaet zwischen verschiedenen Anwendungen, Werkzeugen und Desktops. +.sp +.SH "OPTIONS" +.PP +\-display display +.RS 4 +Startet fluxbox auf der angegebenen Anzeige. Von fluxbox gestartete Anwendungen uebernehmen diese Einstellung +.RE +.PP +\-h, \-help +.RS 4 +Zeigt eine Kurzhilfe mit den typischen Optionen an +.RE +.PP +\-i, \-info +.RS 4 +Zeigt wichtige Informationen wie die Version sowie einkompilierte Funktionen an +.RE +.PP +\-log logfile +.RS 4 +fluxbox wird das angegebene Logfile benutzen +.RE +.PP +\-rc rcfile +.RS 4 +fluxbox verwendet eine andere Konfigurationsdatei als ~/.fluxbox/init +.RE +.PP +\-v, \-version +.RS 4 +Zeigt die Versionsnummer an +.RE +.PP +\-screen scr,scr|all +.RS 4 +fluxbox wird auf den angegebenen screens ausgefuehrt +.RE +.PP +\-verbose +.RS 4 +fluxbox gibt waehrend der Laufzeit zusaetzliche Informationen aus +.RE +.SH "FLUXBOX STARTEN" +fluxbox(1) bringt ein weiteres Programm namens startfluxbox(8) mit, welches sich ueblicherweise in dem selben Verzeichnis befindet wie fluxbox selber. Dieses Skript ermoeglicht es, zusaetzliche Variablen und Optionen anzupassen. fluxbox sollte ueber startfluxbox gestartet werden, ergo kann man "exec startfluxbox" in der /.xinitrc oder /.xsession (je nach verwendeter Distribution oder verwendetem Desktopmanager) als letzten Befehl eintragen. Dabei muss sich startfluxbox und fluxbox in $PATH befindet, was ueblicherweise der Fall ist. +.sp +fluxbox \-i zeigt die von fluxbox(1) verwendeten Standarddateien und Optionen an. Diese Dateien koennen fuer Systemweite Einstellungen / Menues verwendet werden, die dann fuer alle Anwender gelten. +.sp +Beim Beenden oder Neustarten speichert fluxbox die Anwendereinstellungen in der Datei ~/.fluxbox/init Die Einstellungen koennen von Hand mit einem Texteditor oder ueber die verschiedenen fluxboxmenues konfiguriert werden. +.sp +.SH "FLUXBOX BENUTZEN" +Viele Nutzer, die sich eine Desktopumgebung wie Gnome oder KDE gewohnt sind, sind beim ersten Start von fluxbox ein wenig ueberrascht, da sich fast nichts auf dem Bildschirm befindet. fluxbox ist auf auf Schnelligkeit und Konfigurierbarkeit getrimmt, ergo wird man sicher ein wenig Zeit brauchen um sich umzugewoehnen. Viele finden aber, dass sich der einmalige Zeitaufwand durchaus lohnt. +.sp +Es folgt nun eine Kurzuebersicht ueber die allgemeinen Dinge in fluxbox. Wir empfehlen allerdings, dass man die entsprechenden Abschnitte in dieser Anleitung liest um sich mit den Details vertraut zu machen. +.sp +.SS "Root Window (Main)" +Beim ersten Start von fluxbox sieht man lediglich die Toolbar. Ein Rechtsklick (dritter Mausknopf) auf den leeren Desktop bringt das RootMenue hervor. Ein Klick auf den mittleren Mausknopf (zweiter Mausknopf, meist das Mausrad) bringt das Arbeitsflaechenmenue hervor. +.sp +.SS "RootMenue und das Arbeitsflaechenmenue" +Ueber das RootMenue kann man Anwendungen starten und fluxbox konfigurieren. Das Arbeitsflaechenmenue zeigt alle Fenster auf den einzelnen Arbeitsflaechen. Im Abschnitt MENUES steht wie die beiden Menues angepasst werden koennen. +.sp +.SS "Toolbar" +Der Inhalt der Toolbar kann in der init Datei konfiguriert werden. Diese Datei wird im Abschnitt RESSOURCEN genau beschrieben. In der Toolbar befindet sich eine Kombination aus folgenden Werkzeugen: +.sp +.TP 4 +\(bu + +\fBWorkspace Name\fR: Der Name der aktuellen Arbeitsflaeche +.TP 4 +\(bu + +\fBIconbar\fR: Eine Liste der von fluxbox verwalteten Fenster +.TP 4 +\(bu + +\fBSystem Tray\fR: Systemabschnitt fuer Applets +.TP 4 +\(bu + +\fBClock\fR: Uhrzeit und Datum (standardmaessig nur Uhrzeit) +.TP 4 +\(bu + +\fBWorkspace Arrows\fR: Vorige/Naechste Arbeitsflaeche +.TP 4 +\(bu + +\fBWindow Arrows\fR: Voriges/Naechstes Fenster (fokussieren) +.SS "Slit" +Der Slit wird von vielen nicht wahrgenommen, weil man ihn nicht sehen kann solange er nicht Benutzt wird. Der Slit ist ein Ort an dem sich kleine Programme andocken koennen. Applikationen wie gkrellm oder fbpager koennen anstelle von Fenstern gedockte Applikationen sein. Dem Slit ist in dieser Anleitung weiter unten ein ganzer Abschnitt gewidmet. +.sp +.SS "Ebenen" +Fenster auf einer hoeheren Ebene werden automatisch oberhalb von denen auf tieferen Ebenen platziert, unabhaengig vom Fokus. Nebst den Fenstern koennen auch der Slit und die Toolbar auf eine Ebene gelegt werden. Anwendungen koennen mit Hilfe der `apps' Datei oder ueber das Fenstermenue einer Ebene zugewiesen werden. Mehr ueber die `apps' Datei steht im ANWENDUNGEN Abschnitt, mehr ueber das Fenstermenue im Abschnitt MENU. Die Ebenen werden im gleichnamigen Abschnitt genauer behandelt. fluxbox platziert Fenster auf folgenden Ebenen: (von oben nach unten) +.sp +.TP 4 +\(bu +ueberDock +.TP 4 +\(bu +Dock +.TP 4 +\(bu +Oben +.TP 4 +\(bu +Normal +.TP 4 +\(bu +Unten +.TP 4 +\(bu +Desktop +.SS "Fokustyp" +Maus\- und Tastatureingaben werden jeweils an das Fenster mit Fokus weitergegeben (Globale Tastenkuerzel ausgenommen). Ueber das fluxboxmenue kann das Fokusverhalten festgelegt werden. Im Abschnitt FOKUS sind die verschiedenen Modelle genauer beschrieben. +.sp +.SS "Fenster" +Ein Linksklick auf einen beliebigen Teil des Fensterrahmens bringt das Fenster in den Vordergrund. Wird die Maus dabei bewegt kann das Fenster verschoben werden. ueber die unteren Ecken kann das Fenster so auch vergroessert oder verkleinert werden. Ein Klick mit der mittleren Maustaste legt das Fenster unter alle anderen. Ein Rechtsklick auf den Fenstertitel blendet das Fenstermenue ein, welches im Abschnitt MENU genauer beschrieben wird. +.sp +.SS "Reiter (Tabs)" +fluxbox ermoeglicht es Fenster zu gruppieren, indem man ein Fenster mit der mittleren Maustaste packt und in ein anderes zieht. Dieses tabben ermoeglicht es mehrere Anwendungen an einem zentralen Ort zu haben und gleichzeitig zu verschieben/vergroessern/verkleinern. Standardmaessig werden die Reiter ausserhalb des Fensters angezeigt, sie koennen allerdings auch in den Fenstertitel eingebettet werden. Die Konfiguration der Reiter wird im Abschnitt REITEROPTIONEN erlaeutert. +.sp +.SH "MENU" +fluxbox installiert eine Standard\-Menuedatei unter @pkgdatadir/menu. Beim Aufruf von fluxbox \-i wird diese mit Pfad angezeigt. Dieses Systemweite Menue gilt fuer alle Nutzer. Es ist natuerlich moeglich, dass jeder Nutzer seine eigene Menuedatei hat. Diese liegt normalerweise unter ~/.fluxbox/menu. In der ~/.fluxbox/init Datei wird angegeben welche Menuedatei fluxbox verwenden soll. Die Option dazu ist: +.sp +.sp +.RS 4 +.nf +session.menuFile: <menufile> +.fi +.RE +Um eine Aenderung daran wirksam werden zu lassen, muss fluxbox neu gestartet werden. Vorher sollte man sicherstellen, dass die Menuedatei korrekt ist und von fluxbox verwendet werden kann. Aenderungen in der Menuedatei selber erfordern keinen Neustart, sie werden von fluxbox sofort uebernommen. +.sp +In saemtlichen Menues hat man die Moeglichkeiten von typeahead, will heissen man kann Eintraege auch durch schreiben der ersten paar Buchstaben auswaehlen. Der aktuelle Eintrag wird dabei jeweils von fluxbox unterstrichen. Die Tabulator\-Taste oeffnet ein Untermenue wenn die Zeichenfolge einmalig ist, backspace schliesst, wenn nichts getippt wurde, das aktuell geoeffnete Menue. +.sp +.SS "Root Menu" +Das Rootmenue wird unter anderem verwendet, um fluxbox zu konfigurieren. Die meisten Konfigurationen koennen auch von Hand in der `init' Datei durchgefuehrt werden. Allerdings ist die Verwendung des Rootmenues meist schneller als einen Texteditor zu nutzen und die entsprechende Einstellung zu suchen. Es folgen die wichtigsten Menuepunkte: +.sp +.TP 4 +\(bu + +\fBConfigure\fR: In dem Untermenue koennen die meisten Einstellungen bezueglich dem Verhalten von fluxbox und den Werkzeugen vorgenommen werden. +.TP 4 +\(bu + +\fBSystem Styles\fR: Hier werden die Systemweiten Farbschemata gelistet. Ein einfaches Auswaehlen per Mausklick reicht, allerdings muss je nach dem welche Elemente von den Stilaenderungen betroffen sind fluxbox neu gestartet werden. Die Farbschemata befinden sich unter @pkgdatadir@/styles/ bei einer Standardinstallation. Mit fluxbox \-i kann man das ueberpruefen. +.TP 4 +\(bu + +\fBUser Styles\fR: Die Farbschemata, die sich unter ~/.fluxbox/styles befinden werden hier aufgelistet. +.TP 4 +\(bu + +\fBWorkspace List\fR: Listet die eingerichteten Arbeitsflaechen und die sich darauf befindenden Fenster auf +.TP 4 +\(bu + +\fBTools\fR: Diverse kleine Werkzeuge die von fluxbox mitgeliefert werden, zum Beispiel um eine Arbeitsflaeche umzubenennen. +.TP 4 +\(bu + +\fBWindow\fR: Kann verwendet werden um zu einem anderen Fenstermanager oder einer Desktopumgebung umzuschalten. fluxbox wird dabei beendet, die Fenster aber nicht geschlossen. +.TP 4 +\(bu + +\fBLock Screen\fR: Sperrt den Bildschirm +.TP 4 +\(bu + +\fBfluxbox Command\fR: Ein kleiner Dialog um einen Befehl auszufuehren +.TP 4 +\(bu + +\fBReload Config\fR: Liest die Konfigurationsdateien neu ein +.TP 4 +\(bu + +\fBRestart\fR: Startet fluxbox neu. Saemtliche Konfigurationsdateien werden neu eingelesen, alle graphischen Elemente neu gezeichnet. Die Anwendungen werden dabei nicht geschlossen. +.TP 4 +\(bu + +\fBExit\fR: Beendet fluxbox und den X Server +.SS "Konfigurationsmenue" +Hier kann fluxbox konfiguriert werden. Die Verwendung dieses Menues ist meist schneller als das editieren der init Datei und sollte von daher bevorzugt werden. Zudem entfaellt so die Moeglichkeit eines Tippfehlers. Die Bezeichnungen sind: Deutsche uebersetzung / Original +.sp +.TP 4 +\(bu + +\fBFokustyp / Focus Model\fR: Mehr dazu unter FOKUSTYP am Ende dieser Anleitung +.TP 4 +\(bu + +\fBTab\-Einstellungen / Tab Options\fR: Ermoeglicht die Konfiguration der Reiter (Tabs) +.TP 4 +\(bu + +\fBSlit / Slit\fR: Damit kann der Slit konfiguriert werden. Mehr dazu steht im Abschnitt SLIT +.TP 4 +\(bu + +\fBToolbar / Toolbar\fR: Alles dazu steht im Abschnitt TOOLBAR, unter Toolbar ueber das Menue konfigurieren. +.TP 4 +\(bu + +\fBBilddithering / image dithering\fR: Bilddithering aktivieren/deaktvieren +.TP 4 +\(bu + +\fBFensterinhalt beim Verschieben anzeigen / Opaque Window Moving\fR: Falls eingeschaltet, wird beim Verschieben von Fenstern deren Inhalt angezeigt, ansonsten nur der Fensterrahmen. Vor allem bei langsamen Rechnern nuetzlich. +.TP 4 +\(bu + +\fBVollstaendig maximieren / Full Maximization\fR: Maximiert Fenster auf volle Bildschirmgroesse, auch wenn sie dabei unter/ueber den Slit oder die Toolbar geraten. +.TP 4 +\(bu + +\fBNeue Fenster fokussieren / Focus New Window\fR: Wenn diese Option aktiviert ist bekommt ein neu erstelltes Fenster automatisch den Fokus. +.TP 4 +\(bu + +\fBFenster ueber Desktopgrenzen verschieben / Windows Warping\fR: Ermoeglicht es Fenster ueber mehrere Arbeitsflaechen zu verschieben. +.TP 4 +\(bu + +\fBDesktop mit Mausrad wechseln / Desktop MouseWheel Switching\fR: Das Mausrad wechselt die Arbeitsflaeche wenn sich die Maus ueber dem leeren Desktop oder der Toolbar befindet. +.TP 4 +\(bu + +\fBFluechtige (Dialoge) Fenster dekorieren / Decorate Transient Windows\fR: Wenn diese Option aktiviert wird haben auch fluechtige Fenster, wie etwa Speicher\-Dialoge oder aehniches, einen Rahmen und grips in den Ecken. +.TP 4 +\(bu + +\fBKlick holt in den Vordergrund / Click Raises\fR: Wenn diese Option aktiviert ist holt ein Klick auf einen beliebigen Fensterteil das Fenster in den Vordergrund. Ansonsten muss auf den Fenstertitel geklickt werden. +.TP 4 +\(bu + +\fBTransparenz / Transparency\fR: setzt Transparenzwerte fuer Fenster (fokussiert/unfokussiert) und das Menue +.SS "Fenstermenue" +Das Fenstermenue wird bei einem Rechtsklick auf den Fenstertitel oder den Eintrag in der Toolbar angezeigt. Es enthaelt folgende Eintraege: (uebersetzt / Original) +.sp +.TP 4 +\(bu + +\fBSenden an / Send To\&...\fR: Platziert das Fenster auf einer anderen Arbeitsflaeche. Wenn diese mit einem Mittelklick ausgewaehlt wird wechselt fluxbox sofort zu dieser Arbeitsflaeche. +.TP 4 +\(bu + +\fBAufrollen / Shade\fR: Rollt das Fenster auf/ab (nur der Fenstertitel wird angezeigt). +.TP 4 +\(bu + +\fBMinimieren / Iconify\fR: Minimiert das Fenster. Es ist dann ueber das Arbeitsflaechenmenue oder die Toolbar anwaehlbar. +.TP 4 +\(bu + +\fBMaximieren / Maximize\fR: Maximiert ein Fenster. Je nach Maustaste wird das Fenster anders maximiert: +.sp +.RS 4 +.nf +Taste 1 Normales Maximieren +Taste 2 Vertikales Maximieren +Taste 3 Horizontales Maximieren +.fi +.RE +.TP 4 +\(bu + +\fBNach vorne / Raise\fR: Bringt das Fenster ganz nach vorne. +.TP 4 +\(bu + +\fBNach hinten / Lower\fR: Setzt das Fenster ganz nach hinten. +.TP 4 +\(bu + +\fBAuf allen Desktops sichtbar / Stick\fR: Schaltet den Klebezustand des Fenster um. Wenn das Fenster auf klebrig (sticky) geschaltet ist wird es auf allen Arbeitsflaechen angezeigt. +.TP 4 +\(bu + +\fBEbene / Layer\fR: Setzt das Fenster auf die angegebene Ebene. +.TP 4 +\(bu + +\fBTransparenz / Alpha\fR: Setzt den Transparenzwert des Fensters +.TP 4 +\(bu + +\fBEinstellungen merken / Remember\&...\fR: Legt fest welche Fenstereigenschaften dauerhaft in der apps Datei gespeichert werden sollen. Mehr dazu unter ANWENDUNGEN. +.TP 4 +\(bu + +\fBClose\fR: Schliesst die Anwendung. +.SS "Arbeitsflaechenmenue" +Das Arbeitsflaechenmenue erscheint bei einem Klick mit der mittleren Maustaste auf den leeren Desktop. Es ermoeglicht das Hinzufuegen oder Entfernen einer Arbeitslaeche. Zudem sind alle Arbeitsflaechen mit den sich darauf befindenden Fenstern aufgelistet. Ein Mittelklick auf den Namen einer Arbeitsflaeche schaltet auf diese um, ein Linksklick auf einen Fensternamen schaltet auf die entsprechende Arbeitsflaeche und fokussiert das gewaehlte Fenster. Im Icons Untermenue sind zudem alle minimierten Fenster gelistet. +.sp +.SS "Menueverhalten" +Das Verhalten des Menues kann in der Initdatei festgelegt werden. Die Optionen sind folgende: (standardmaessig ist fuer beide 0 gesetzt): +.sp +.sp +.RS 4 +.nf +session.screen0.menuDelay: <msec> +session.screen0.menuDelayClose: <msec> +.fi +.RE +.SS "Menu Syntax" +Eine Zeile in der Menue Datei besteht aus 4 Teilen: +.sp +.sp +.RS 4 +.nf +[tag] (Bezeichnung) {Befehl|Dateiname} <icon> +.fi +.RE +Die Bezeichnung ist dabei jeweils der Text, der im Menue erscheint. +.sp +Tags sind: +.sp +.PP +[begin] (Titel) +.RS 4 +Dieser tag muss unbedingt gesetzt werden, er kennzeichnet den Anfang der Menuedatei. Der Titel des Menues kann man selber setzen. +.RE +.PP +[end] +.RS 4 +Kennzeichnet den Schluss eines Menues oder Untermenues. Mindestens ein end tag muss vorhanden sein, zusaetzlich muss jedes Untermenue mit einem end tag geschlossen weden. +.RE +.PP +[exec] (Bezeichnung) {Befehl} +.RS 4 +Fuegt einen Programm\- oder Skriptaufruf in das Menue ein. Dies ist der haeufigste Eintrag. +.RE +.PP +[exit] (Bezeichnung) +.RS 4 +Beendet fluxbox. +.RE +.PP +[include] (Datei oder Verzeichnis) +.RS 4 +Parst die angegebene Datei Der Dateiname kann eine volle Pfadangabe zu einer Datei oder nur eine Pfadangabe sein. Wenn keine Datei sondern ein Verzeichnis angegeben wird werden saemtliche Dateien darin verarbeitet. +.RE +.PP +[nop] (Bezeichnung) +.RS 4 +Fuegt einen Dummy ein der keine Funktion hat. Kann verwendet werden um das Menue in Bloecken zu gruppieren. Wenn keine Bezeichnung angegeben wird setzt fluxbox einfach eine Leerzeile im Menue. +.RE +.PP +[separator] +.RS 4 +Fuegt eine Trennlinie in das Menue ein. +.RE +.PP +[style] (Bezeichnung) {Dateiname} +.RS 4 +Fuegt ein Farbschema als Menueeintrag hinzu +.RE +.PP +[stylesdir] (Bezeichnung) {Verzeichnis} +.RS 4 +Erstellt ein Untermenue mit dem Namen des angegebenen Bezeichners und listet in diesem alle enhaltenen Dateien, die im angegebenen Verzeichnis gefunden werden, als Farbschemata auf. +.RE +.PP +[stylesmenu] (Verzeichnis) +.RS 4 +Liest alle Dateien in dem Verzeichnis und listet sie als Farbschemata auf, die ausgewaehlt werden koennen. +.RE +.PP +[submenu] (Bezeichnung) {menuetitel} +.RS 4 +Erstellt ein neues Untermenue. Die Angabe eines Menuetitels ist hierbei nicht zwingend. Verschachtelung ist moeglich, die Untermenues sind in der Tiefe nicht beschraenkt. +.RE +.PP +[reconfig] (Bezeichnung) +.RS 4 +Erstellt einen Menueeintrag, der die Konfigurationsdateien und das Farbschema neu einliest. Sehr praktisch wenn man ein Farbschema editiert und fluxbox nicht immer neu starten will. +.RE +.PP +[restart] (Bezeichnung) {Befehl} +.RS 4 +Erstellt einen Menuepunkt der fluxbox neu startet oder, wenn ein Befehl angegeben, ist fluxbox beendet und den Befehl ausfuehrt. (Zum Beispiel um zu einem anderen Fenstermanager zu wechseln) +.RE +.PP +[config] (Bezeichnung) +.RS 4 +Fuegt das fluxbox Konfigurationsuntermenue hinzu +.RE +.PP +[wallpapermenu] (Verzeichnis) {Befehl} +.RS 4 +Listet alle (Bild)Dateien in dem angegebenen Verzeichnis als Menueintraege auf. Der Befehl wird benutzt um das Bild als Hintergrund zu setzen. Wenn kein Befehl angegeben wird nutzt fluxbox fbsetbg(1) +.RE +.PP +[workspaces] (Bezeichnung) +.RS 4 +Fuegt das Arbeitsflaechenmenue zum Menue hinzu, praktisch fuer Leute die das Arbeitsflaechenmenue nicht so aufrufen koennen. (Zweitastenmaus ohne Emulation des dritten Knopfes) +.RE +Alle Zeilen die mit # oder ! beginnen werden von fluxbox als Kommentar gesehen und ignoriert. Sonderzeichen koennen mit \\ escaped werden. +.sp +Ein Menue koennte zum Beispiel so aussehen: +.sp +.sp +.RS 4 +.nf +# fluxbox menu file +[begin] (fluxbox) + [exec] (rxvt) {rxvt \-ls} </usr/X11R6/share/icons/terminal.xpm> + [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] (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 +.RE +.SH "TOOLBAR" +Die Toolbar ist ein Platzhalter fuer diverse Werkzeuge, wie zum Beispiel eine Uhr, die Anzeige der aktuellen Arbeitsflaeche, ein Systemabschnitt oder die Iconbar, welche von fluxbox verwaltete Fenster anzeigt. Ihr aussehen kann in dem Farbschema konfiguriert werden. +.sp +Die einzelnen Werkzeuge koennen in der init Datei ein/ausgeschaltet werden. Zudem kann so ihre Platzierung festgelegt werden. Zustaendig dafuer ist die Zeile +.sp +.sp +.RS 4 +.nf +session.screen0.Toolbar.tools +.fi +.RE +Die Anzahl und Reihenfolge der Werkzeuge ist frei waehlbar, einzelne muessen mit einem Komma (,) getrennt werden. Beispiel: +.sp +.sp +.RS 4 +.nf +session.screen0.Toolbar.tools: workspacename, systemtray, iconbar, clock +.fi +.RE +Als Werkzeuge stehen zur Auswahl: +.sp +.TP 4 +\(bu + +\fBclock\fR: Zeigt die Uhrzeit und je nach Konfiguration das Datum an, das Format wird in der init Datei festgelegt und entspricht dem von "man strtftime" +.TP 4 +\(bu + +\fBiconbar\fR: Zeigt die von fluxbox verwalteten Fenster an. Je nach Einstellung alle Fenster, nur minimierte Fenster oder nur die Fenster der aktuellen Arbeitsflaeche. +.TP 4 +\(bu + +\fBsystemtray\fR: Der Systemabschnitt, einige Applikationen koennen sich in die Systemtray minimieren. Bekannt dafuer sind InstantMessenger wie Gaim/Kopete, Audioplayer wie amaroK oder zum Beispiel Lautstaerkeregler. +.TP 4 +\(bu + +\fBworkspacename\fR: Zeigt den Namen der aktuellen Arbeitsflaeche an +.TP 4 +\(bu + +\fBprevworkspace\fR: Zeigt einen Knopf mit einem Pfeil an. Bei Klick wird auf die vorige Arbeitsflaeche umgeschaltet. +.TP 4 +\(bu + +\fBnextworkspace\fR: Zeigt einen Knopf mit einem Pfeil an. Bei Klick wird auf die naechste Arbeitsflaeche umgeschaltet. +.TP 4 +\(bu + +\fBprevwindow\fR: Zeigt einen Knopf mit einem Pfeil an. Bei Klick wird das letzte sichtbare Fenster fokussiert. +.TP 4 +\(bu + +\fBnextwindow\fR: Zeigt einen Knopf mit einem Pfeil an. Bei Klick wird das naechste sichtbare Fenster fokussiert. +Alle anderen Dinge koennen auf zwei Arten konfiguriert werden: mit einem Texteditor kann die init Datei manuell bearbeitet werden. Komfortabler ist das Toolbarmenue, welches mit einem Rechtsklick auf die Toolbar aufgerufen werden kann. +.sp +.SS "Konfiguration ueber das Toolbarmenue" +Alle aenderungen werden von fluxbox sofort uebernommen, bis auf die Transparenzeinstellungen welche einen Neustart von fluxbox erfordern: (Die Eintraege stehen jeweils uebersetzt und als englisches Original, zudem ist die passende Zeile in der init Datei angegeben) +.sp +.TP 4 +\(bu + +\fBSichtbar / Visible\fR: Macht die Toolbar sichtbar/unsichtbar. +.sp +.RS 4 +.nf +session.screen0.Toolbar.visible: <boolean> +.fi +.RE +.TP 4 +\(bu + +\fBAutomatisch Ausblenden / Auto hide\fR: Die Toolbar wird nach der angegebenen Verzoegerung ausgeblendet wenn der Mauszeiger nicht mehr auf ihr ruht. Ein Bewegen des Mauszeigers auf dem Rand der Toolbar blendet sie wieder ein. +.sp +.RS 4 +.nf +session.screen0.Toolbar.autoHide: <boolean> +session.autoRaiseDelay: <int> +.fi +.RE +.TP 4 +\(bu + +\fBToolbar Laenge / Toolbar width percentage\fR: Gibt die Breite der Toolbar im Verhaeltnis zum Bildschirm an. Ein Linksklick verkleinert den Wert, ein Rechtsklick erhoeht ihn. Alternativ kann das Mausrad benutzt werden. +.sp +.RS 4 +.nf +session.screen0.Toolbar.widthPercent: <int> +.fi +.RE +.TP 4 +\(bu + +\fBvon maximierten Fenstern verdecken / Maximize Over\fR: Ermoeglicht das vollstaendige ueberdecken der Toolbar durch ein maximiertes Fenster. Vollstaendiges Maximieren im Konfigurationsmenue ueberschreibt diese Option. +.sp +.RS 4 +.nf +session.screen0.Toolbar.maxOver: <boolean> +session.screen0.fullMaximization: <boolean> +.fi +.RE +.TP 4 +\(bu + +\fBEbene / Layer\fR: Die Toolbar wird auf die angegebene Ebene gesetzt. Somit kann sie auf Wunsch alle Fenster ueberdecken. +.sp +.RS 4 +.nf +session.screen0.Toolbar.layer: <layer> +.fi +.RE +.TP 4 +\(bu + +\fBPlatzierung / Placement\fR: Platziert die Toolbar an einem Bildschirmrand, entweder zentriert oder an einer Ecke ausgerichtet. +.sp +.RS 4 +.nf +session.screen0.Toolbar.placement: <direction> +.fi +.RE +.TP 4 +\(bu + +\fBTransparenz / Alpha\fR: Definiert wie durchsichtig die Toolbar sein soll. Bei einem Wert von 0 ist sie unsichtbar, bei einem Wert von 255 gar nicht transparent. Text ist niemals transparent. +.sp +.RS 4 +.nf +session.screen0.Toolbar.alpha: <int> +.fi +.RE +.TP 4 +\(bu + +\fBSymbolleistenmodus / Iconbar Mode\fR: +.sp +.RS 4 +.nf +Gibt an welche Fenster in der Symbolleiste angezeigt werden: +.fi +.RE +.sp +.RS 4 +.nf +Keine / None: + Zeigt gar keine +Symbole / Icons: + Zeigt die minimierten Fenster aller Arbeitsflaechen +Keine Symbole / NoIcons: + Zeigt die nicht minimierten Fenster aller Arbeitsflaechen +Arbeitsflaeche: Symbole / WorkspaceIcons: + Zeigt alle minimierten Fenster der aktuellen Arbeitsflaeche +Arbeitsflaeche: Keine Symbole / WorkspaceNoIcons: + Zeigt alle nicht minimierten Fenster der aktuellen Arbeitsflaeche + (iconified) +Arbeitsflaeche / Workspace: + Zeigt alle Fenster der aktuellen Arbeitsflaeche +Alle Fenster / All Windows: + Zeigt alle Fenster aller Arbeitsflaechen +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.iconbar.mode: <mode> +.fi +.RE +.TP 4 +\(bu + +\fBAusrichtung\fR: +.sp +.RS 4 +.nf +Links / Left: + Alle Fenstereintraege werden linksbuendig angezeigt +Relativ / Relative: + Die Fenstereintraege werden so breit gezeigt, dass die Iconbar voll ist +Rechts / Right: + Alle Fenstereintraege werden rechtsbuendig angezeigt +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.iconbar.alignment: <alignment> +session.screen0.iconbar.iconWidth: <int> +.fi +.RE +.TP 4 +\(bu + +\fBProgramm\-Icons anzeigen / Show Pictures\fR: Wenn diese Einstellung aktiv ist werden die Icons (in diesem Fall Bilder) neben dem Programmnamen angezeigt. +.sp +.RS 4 +.nf +session.screen0.iconbar.usePixmap: <boolean> +.fi +.RE +.TP 4 +\(bu + +\fBZeitformat / Clock\fR: Ermoeglicht eine Umstellung vom 12 zum 24 Stunden Format +.TP 4 +\(bu + +\fBUhrformat bearbeiten / Edit Clock Format\fR: Ein kleines Fenster zum Bearbeiten des Uhrformates wird angezeigt. Die Formatierung ist wie in man strftime beschrieben. +.sp +.RS 4 +.nf +session.screen0.strftimeFormat: <format> +.fi +.RE +.SH "RESSOURCEN" +Ueblicherweise wird die ~/.fluxbox/init Datei von fluxbox erstellt und verwaltet. Fast alle Einstellungen koennen ueber das Konfigurationsmenue vorgenommen werden. Wenn die Datei von Hand editiert wird muss fluxbox neu gestartet werden damit aenderungen uebernommen werden. +.sp +Wenn fluxbox auf mehreren Bildschirmen laeuft muss screen0 je nach dem angepasst werden. Einstellungen koennen fuer jeden Bildschirm einzeln vorgenommen werden. +.sp +Folgende Optionen koennen in der Init Datei angepasst werden: +.sp +.sp +.RS 4 +.nf +Transparenz (alpha) + +session.screen0.menu.alpha: <integer> +session.screen0.slit.alpha: <integer> +session.screen0.Toolbar.alpha: <integer> +session.screen0.window.focus.alpha: <integer> +session.screen0.window.unfocus.alpha: <integer> + Mit diesen Zeilen kann die Transparenz der einzelnen + fluxboxkomponenten angepasst werden. Der Wert ist dabei + eine Ganzzahl zwischen 0 und 255, wobei 0 vollstaendig + transparent und 255 deaktivierte Transparenz bedeutet. + Standardwert: 255 + +Automatisches Ausblenden (autohide) + +session.screen0.slit.autoHide: <boolean> +session.screen0.Toolbar.autoHide: <boolean> + Mit diesen Einstellungen kann man bewirken, dass + Toolbar oder slit bei Nichtgebrauch automatisch ausgeblendet werden. + Der Wert ist dabei true (aktiviert) oder false (staendig sichtbar) + Standardwert: false + +Mausrad (wheeling) + +session.screen0.desktopwheeling: <boolean> + Sind diese Einstellungen aktiviert (true) kann mit dem + Mausrad zwischen den Arbeitsflaechen umgeschaltet werden + wenn sich die Maus ueber einem freien Desktopbereich befindet. + Standardwert: true + +Ebenen (layer) + +session.screen0.slit.layer: <layer> +session.screen0.Toolbar.layer: <layer> + Ebene auf der sich Slit und Toolbar befinden + Standardwert: Desktop + +onTop Einstellungen + +session.screen0.slit.onTop: <boolean> +session.screen0.Toolbar.onTop: <boolean> + Werden diese Einstellungen aktiviert befinden sich + Toolbar/Slit immer oberhalb aller anderer Fenster + Standardwert: False + +Standort (placement) + +session.screen0.slit.placement: <placement> +session.screen0.Toolbar.placement: <placement> + Standort von Toolbar und Slit. Moegliche Optionen sind: + \- BottomCenter Unten zentriert + \- BottomLeft Unten links + \- BottomRight Unten rechts + \- LeftCenter Links zentriert + \- RightCenter Rechts zentriert + \- TopCenter Oben zentriert + \- TopLeft Oben links + \- TopRight Oben rechts + +maxOver + +session.screen0.slit.maxOver: <boolean> +session.screen0.Toolbar.maxOver: <boolean> + Sind diese Einstellungen aktiviert ueberdecken + maximierte Fenster die Toolbar/den Slit. + Standardwert: false + +Toolbar + +session.screen0.Toolbar.height: <integer> + Hier kann die Hoehe der Toolbar eingestellt werden. + Wird sie auf 0 gesetzt bestimmt der verwendete + Stil wie hoch sie ist + Standardwert: 0 + +session.screen0.Toolbar.visible: <boolean> + Wird diese Option deaktiviert (false) ist die + Toolbar komplett ausgeblendet + Standardwert: true + +session.screen0.Toolbar.widthPercent: <integer> + Die Breite der Toolbar, angegeben in Prozent der Bildschirmbreite + Standardwert: 100 + +session.screen0.Toolbar.tools: <tools> + Definiert welche Werkzeuge die Toolbar zur Verfuegung stellen soll. + Mehr dazu steht im Abschnitt Toolbar in der manpage. + Moegliche Auswahl: + \- clock (Uhr) + \- iconbar (Fensterleiste) + \- nextwindow (Naechstes Fenster) + \- prevwindow (Vorheriges Fenster) + \- nextworkspace (Naechste Arbeitsflaeche) + \- prevworkspace (Vorherige Arbeitsflaeche) + \- systemtray (Systemabschnitt) + \- workspacename (Name der Arbeitsflaeche) + +session.screen0.slit.onhead: <integer> +session.screen0.Toolbar.onhead: <integer> + Bestimmt bei Systemen mit mehreren Monitoren auf welchem + sich die Toolbar/der Slit befinden + Standardwert: 0 + +session.screen0.slit.direction: <alignment> + Ausrichtung des Slits, Horizontal oder Vertikal + +Iconbar + +session.screen0.iconbar.mode: <mode> + Welche Fenster sollen in der Fensterleiste angezeigt werden? + \- All Windows (alle) + \- Icons (minimierte) + \- None (keine) + \- Workspace (alle der aktuellen Arbeitsflaeche) + \- WorkspaceIcons (alle minimierten der aktuellen Arbeitsflaeche) + +session.screen0.iconbar.usePixmap: <boolean> + Sollen Icons in der Fensterleiste angezeigt werden? + Ja (true) oder nein (false) + Standardwert: true + +session.screen0.iconbar.iconTextPadding: <integer> +session.screen0.iconbar.deiconifyMode: Current +session.screen0.iconbar.wheelMode: Screen +session.screen0.iconbar.alignment: <position> + Anordnung der Eintraege in der Fensterleiste + Zur Auswahl stehen: + \- Left: Feste Breite, linksbuendig + \- Relative: flexible Breite + \- Right: Feste Breite, rechtsbuendig + Standardwert: Relative + +Reiter (tabs) + +session.screen0.tab.alignment: Left + Anordnung der Reiter (tabs) + +session.screen0.tab.height: 16 + Hoehe der Reiter (tabs) + +session.screen0.tab.placement: <position> + Platzierung der Reiter (tabs) + moeglich ist: + \- TopLeft + \- LeftTop + \- LeftBottom + \- BottomLeft + \- TopRight + \- RightTop + \- RightBottom + \- BottomRight + +session.screen0.tab.rotatevertical: True +session.screen0.tab.width: 64 + Breite der Reiter (tabs) + +Magneteffekt + +session.screen0.edgeSnapThreshold: <integer> + Magneteffekt, damit Fenster sich an anderen oder an + den Seitenraendern festkleben. Die Zahl gibt den Abstand + an ab dem dieser Effekt aktiviert wird + Standardwert: 0 + +Diverses + +session.screen0.followModel: Ignore +session.screen0.rowPlacementDirection: LeftToRight +session.screen0.colPlacementDirection: TopToBottom + Konfiguriert das Vehalten der Fensterplatzierung + +session.screen0.resizeMode: Bottom + Konfiguriert die Art der Fenstervergroesserung + +session.screen0.focusModel: ClickToFocus + Setzt das Fokusmodell + +session.screen0.autoRaise: <boolean> +session.screen0.clickRaises: <boolean> + Konfiguriert das Verhalten beim Anheben von Fenstern + +session.screen0.workspacewarping: <boolean> + Ist diese Option aktiviert koennen Fenster auf eine + andere Arbeitsflaeche gezogen werden. + Standardwert: true + +session.screen0.showwindowposition: <boolean> + Ist diese Option aktiviert wird beim Verschieben/Vergroessern + eines Fensters die momentane Position/Groesse in Form + von x/y eingeblendet + Standardwert: true + +session.screen0.decorateTransient: <boolean> +session.screen0.workspaceNames: workspace1, workspaceN + Standardwert: one, two, three, four + +session.screen0.strftimeFormat: <date> + Format der Uhr in der Toolbar. Naeheres dazu in der manpage von strftime(3) + Standardwert: %I:%M %p + +session.screen0.windowPlacement: <Strategie> + Diese Option gibt an wie fluxbox neue Fenster automatisch platzieren soll + RowSmartPlacement reiht die Fenster ueberlappend auf, + ColSmartPlacement reiht sie ohne Ueberlappung nebeneinander, + CascadePlacement setzt es unter den Fenstertitel des letzten Fensters, + UnderMousePlacement setzt sie unter die aktuelle Mausposition + Standardwert: RowSmartPlacement + +session.screen0.rowPlacementDirection: LeftToRight|RightToLeft +session.screen0.colPlacementDirection: TopToBottom|BottomToTop + Setzt die Richtung in der fluxbox neue Fenster bei + RowSmartPlacement respektive ColSmartPlacement setzen soll. + +session.screen0.workspaces: <integer> + Anzahl Arbeitsflaechen + Standardwert: 4 + +session.appsFile: <Pfad> +session.groupFile: <Pfad> +session.keyFile: <Pfad> +session.menuFile: <Pfad> +session.slitlistFile: <Pfad> +session.styleFile: <Pfad> + Standort der Konfigurationsdateien. Normalerweise werden + die Dateien im ~/.fluxbox Verzeichnis abgelegt/verwendet + +session.doubleClickInterval: <integer> + Abstand (in Millisekunden) zwischen zwei Mausklicks damit + diese noch als Doppelklick gewertet werden + Standardwert: 250 + +session.forcePseudoTransparency: <boolean> + Erzwingt Pseudotransparenz ueber echte Transparenz + +session.opaqueMove: <boolean> + Anzeigen des Inhalts beim Verschieben eines Fensters. + Sollte auf langsamen Systemen deaktiviert (false) werden + Standardwert: true + +session.tabs: <boolean> +session.tabsAttachArea: Window + Aktiviert/Deaktiviert Tabs und setzt sie + innerhalb oder ausserhalb des Fensters + +session.titlebar.left: Stick +session.titlebar.right: Minimize Maximize Close + Welche Knoepfe sollen im Fenstertitel angezeigt werden, + in welcher Reihenfolge und auf welcher Seite. + Auswahl: + Stick (Klebezustand) + Menu (Fenstermenue) + Shade (Auf/Abrollen) + Minimize (Minimieren) + Maximize (Maximieren) + Close (Schliessen) +.fi +.RE +.SH "TASTEN" +Tastenkombinationen koennen in der Datei ~/.fluxbox/keys festgelegt werden. Das Format der Eintraege ist wie folgt: +.sp +KeyMode <Modtaste> <Taste> :<Befehl> +.sp +Dabei ist Mod1 die ALT Taste, Control ist Ctrl/Strg, Shift ist die Shifttaste und Mod4 die Windowstaste. None als Modtaste bewirkt, dass der Befehl bei direktem Druck auf <Taste> ausgefuehrt wird. +.sp +Eine Liste der moeglichen Modtasten liefert \fIxmodmap \-pm\fR. Diese Zeigt auch welche Taste mit welchem Modifikator belegt ist. +.sp +Neu koennen auch Maustasten (Mouse1, Mouse2 etc.) belegt werden. +.sp +Eine keys Datei koennte so aussehen: +.sp +.sp +.RS 4 +.nf +# fluxbox keys file. +OnDesktop Mouse1 :hideMenus +OnDesktop Mouse2 :workspaceMenu +OnDesktop Mouse3 :rootMenu +OnDesktop Mouse4 :nextWorkspace +OnDesktop Mouse5 :prevWorkspace +OnToolbar Mouse4 :nextWorkspace +OnToolbar Mouse5 :prevWorkspace + +Mod1 Tab :NextWindow +Mod1 Shift Tab :PrevWindow +Mod1 F1 :Workspace 1 +Mod1 F2 :Workspace 2 +Mod1 F3 :Workspace 3 +Mod1 F4 :Workspace 4 +Mod1 F5 :Workspace 5 +Mod1 F6 :Workspace 6 +Mod1 F7 :Workspace 7 +Mod1 F8 :Workspace 8 +Mod1 F9 :Workspace 9 +Mod4 b :PrevWorkspace +Mod4 c :Minimize +Mod4 r :ExecCommand rxvt +Mod4 v :NextWorkspace +Mod4 x :Close +Mod4 m :RootMenu +Control n Mod1 n :NextTab +.fi +.RE +Die letzte Zeile zeigt, dass auch Tastensketten wie zum Beispiel von Emacs bekannt verwendet werden koennen +.sp +Wichtig zu wissen: Befehle sind case\-insensitive Die Arbeitsflaechen beginnen bei "1" Fuer diverse Befehle gibt es Synonyme. Der Abstand zwischen der letzten Taste und dem ":" ist zwingend. +.sp +.SS "Window\-Manager\-Befehle" +.TP 4 +\(bu +Restart <argument> #Startet fluxbox neu +.TP 4 +\(bu +Quit #Beendet fluxbox +.TP 4 +\(bu +Exit #Beendet fluxbox +.TP 4 +\(bu +Reconfigure #Liest die Konfiguration neu ein +.TP 4 +\(bu +Reload Style #Laedt den verwendeten Stil neu +.TP 4 +\(bu +SetStyle <argument> #Schaltet zu dem gewaehlten Stil +.TP 4 +\(bu +ExecCommand <argument> #Fuehrt einen Befehl aus +.TP 4 +\(bu +Exec <argument> #Fuehrt einen Befehl aus +.SS "Befehle fuer das fokussierte Fenster" +.TP 4 +\(bu +Fullscreen #Schaltet das Fenster auf Vollbild +.TP 4 +\(bu +Minimize #Minimiert das Fenster +.TP 4 +\(bu +MinimizeWindow #Minimiert das Fenster +.TP 4 +\(bu +Iconify #Minimiert das Fenster +.TP 4 +\(bu +Maximize #Maximiert das Fenster +.TP 4 +\(bu +MaximizeWindow #Maximiert das Fenster +.TP 4 +\(bu +MaximizeHorizontal #Maximiert das Fenster horizontal +.TP 4 +\(bu +MaximizeVertical #Maximiert das Fenster vertikal +.TP 4 +\(bu +ResizeTo <breite> <hoehe> #aendert die Fenstergroesse +.TP 4 +\(bu +Resize <delta\-breite> <delta\-hoehe> #Siehe weiter unten +.TP 4 +\(bu +ResizeHorizontal <delta\-breite> #Siehe weiter unten +.TP 4 +\(bu +ResizeVertical <delta\-hoehe> #Siehe weiter unten +.TP 4 +\(bu +MoveTo <x> <y> <Ecke> #Siehe weiter unten +.TP 4 +\(bu +Move <delta\-x> <delta\-y> #Siehe weiter unten +.TP 4 +\(bu +MoveRight <delta\-x> #Siehe weiter unten +.TP 4 +\(bu +MoveLeft <delta\-x> #Siehe weiter unten +.TP 4 +\(bu +MoveUp <delta\-y> #Siehe weiter unten +.TP 4 +\(bu +MoveDown <delta\-y> #Siehe weiter unten +.TP 4 +\(bu +Raise #Bringt das Fenster in den Vordergrund +.TP 4 +\(bu +RaiseLayer #Bringt das Fenster eine Ebene nach vorne +.TP 4 +\(bu +Lower #Bringt das Fenster in den Hintergrund +.TP 4 +\(bu +LowerLayer #Bringt das Fenster eine Ebene nach hinten +.TP 4 +\(bu +Close #Schliesst das Fenster +.TP 4 +\(bu +Shade #Schliesst das Fenster +.TP 4 +\(bu +ShadeWindow #Rollt das Fenster auf/ab +.TP 4 +\(bu +Stick #Schaltet den Klebezustand um +.TP 4 +\(bu +StickWindow #Schaltet den Klebezustand um +.TP 4 +\(bu +ToggleDecor #Deaktiviert den Fensterrahmen +.TP 4 +\(bu +SendToWorkspace <Arbeitsflaeche> #Verschiebt das Fenster auf Arbeitsflaeche +.TP 4 +\(bu +SendToNextWorkspace <nummer> #Verschiebt das Fenster auf Flaeche + Nummer +.TP 4 +\(bu +SendToPrevWorkspace <number> #Verschiebt das Fenster auf Flaeche \- Nummer +.TP 4 +\(bu +TakeToWorkspace <num> #Zeigt die neue Arbeitsfläche gleich an +.TP 4 +\(bu +KillWindow #Forciert das Schliessen des Fensters (kill) +.TP 4 +\(bu +NextTab #Schaltet zum naechsten Reiter um +.TP 4 +\(bu +PrevTab #Schaltet zum vorherigen Reiter um +.TP 4 +\(bu +MoveTabLeft #Verschiebt das Fenster nach links +.TP 4 +\(bu +MoveTabRight #Verschiebt das Fenster nach rechts +.TP 4 +\(bu +DetachClient #Loest das Fenster von einer Gruppe +.TP 4 +\(bu +SetHead <int> #Verschiebt das Fenster auf Bildschirm <int> +.SS "Befehle fuer die Arbeitsflaeche" +.TP 4 +\(bu +NextWorkspace #Schaltet zur naechsten Arbeitsflaeche +.TP 4 +\(bu +PrevWorkspace #Schaltet zur vorherigen Arbeitsflaeche +.TP 4 +\(bu +RightWorkspace <anzahl> #Schaltet um "anzahl" nach rechts +.TP 4 +\(bu +LeftWorkspace <anzahl> #Schaltet um "anzahl" nach links +.TP 4 +\(bu +Workspace <n> #Schaltet zur Arbeitsflaeche n +.TP 4 +\(bu +NextWindow <bitmask> #siehe weiter unten +.TP 4 +\(bu +PrevWindow <bitmask> #siehe weiter unten +.TP 4 +\(bu +ArrangeWindows #Ordnet die Fenster nebeneinander an +.TP 4 +\(bu +ShowDesktop #Minimiert alle Fenster der Arbeitsflaeche +.TP 4 +\(bu +RootMenu #Zeigt das fluxboxmenu an +.TP 4 +\(bu +WorkspaceMenu #Zeigt das Arbeitsflaechenmenu an +.TP 4 +\(bu +WindowMenu #Zeigt das Fenstermenue an +.TP 4 +\(bu +SetWorkspaceName <name> #Bennennt die aktuelle Arbeitslaeche um +.TP 4 +\(bu +ShowDesktop #Minimiert alle Fenster +.TP 4 +\(bu +Deiconify all|allworkspace|last|lastworkspace current|origin|originquiet +.TP 4 +\(bu +FocusUp #Fokussiert das noerdlich liegende Fenster +.TP 4 +\(bu +FocusDown #Fokussiert das suedlich liegende Fenster +.TP 4 +\(bu +FocusLeft #Fokussiert das westlich liegende Fenster +.TP 4 +\(bu +FocusRight #Fokussiert das oestlich liegende Fenster +.SS "Spezielle Befehle" +.TP 4 +\(bu +MacroCmd #Befehlsreihen, MacroCmd {command1} {command2}\&... +.TP 4 +\(bu +ReloadStyle #Der Stil wird neu geladen +.TP 4 +\(bu +SetResourceValue <resourcename> <resource> wert +.TP 4 +\(bu +BindKey <key><value>: <action> #Weist eine Taste einem Befehl zu +.SS "Diverses" +.TP 4 +\(bu +Exec: fluxbox nutzt /bin/sh um Befehle auszuefuehren. Will heissen, dass man Umgebungsvariablen nutzen kann. :Exec $XTERM Sartet zum Beispiel das der Variable $XTERM zugewiesene Terminal. +.TP 4 +\(bu +TakeToWorkspace: Sendet das Fenster an eine bestimmte Arbeitsflaeche und schaltet anschliessend auch zu dieser um. +.TP 4 +\(bu +TakeToNextWorkspace <offset>: Sendet das Fenster an die aktuelle Arbeitsflaeche + Offset und schaltet zu ebendieser um. +.TP 4 +\(bu +PrevWindow/NextWindow braucht eine Zahl als Parameter: 0 oder nichts = aktuelles / Standardverhalten 1 = Nur ein Tab pro Gruppe 2 = Keine klebenden Fenster 4 = Keine aufgerollten Fenster 8 = Lineares Umschalten zwischen allen Fenstern 16 = Keine minimierten Fenster +.sp +.RS 4 +.nf +Diese Optionen koennen miteinander kombiniert werden, +dazu muss man nur die entsprechenden Zahlen addieren +und das Ergebnis als Parameter nehmen. +.fi +.RE +.TP 4 +\(bu +KeyMode ermoeglicht es verschiedene Gruppen von Tastenzuweisungen zu haben, die nicht alle gleichzeitig aktiv sind. Zum Beispiel kann man per +\fIKeyMode Xnest\fR +zum XNest Modus wechseln, bei dem alle Tastenzuweisungen, die nicht mit Xnest: beginnen, deaktiviert sind. <return key sequence> schaltet auf den Standardmodus. +.TP 4 +\(bu +Der Delta\-Wert entspricht der Differenz zischen dem aktuellen und dem gewuenschten Wert. Nehmen wir an ein Fenster ist 100 Pixel breit +.sp +.RS 4 +.nf +Mod1 r :ResizeHorizontal 10 +.fi +.RE +wuerde das Fenster auf 110 Pixel vergroessern, +.sp +.sp +.RS 4 +.nf +Mod1 R :ResizeHorizontal \-10 +.fi +.RE +verkleinert es um 10, also auf 90 Pixel. +.sp +.TP 4 +\(bu +MacroCmd: +.sp +.RS 4 +.nf +Mod1 r :MacroCmd {Befehl1} {Befehl2} +.fi +.RE +.sp +.RS 4 +.nf +Ermoeglicht das serielle ausfuehren mehrerer Befehle. +.fi +.RE +.TP 4 +\(bu +ToggleCmd: +.sp +.RS 4 +.nf +Mod1 t :ToggleCmd {command1} {command2} +.fi +.RE +.sp +.RS 4 +.nf +Wechselt zwischen den Kommandos bei jedem Tastendruck +.fi +.RE +.TP 4 +\(bu +SetAlpha [[\-]<int> [[\-]<int>]]: Beinflusst nur das aktuelle Fenster. Die Parameter sind: +.RS 4 +.TP 4 +\(bu +keine: Standard wiederherstellen +.TP 4 +\(bu +Eine Zahl: Setzt den Wert fuer fokussierte und unfokussierte Fenster +.TP 4 +\(bu +zwei Zahlen: erste fuer fokussierte, zweite fuer unfokussierte Fenster +.RE +.SH "EBENEN" +Ebenen beinflussen die Fensterreihenfolge, ergo welche Fenster ueber welchen stehen. Eine Anwendung auf einer hoeheren Ebene liegt immer ueber einer Anwendung auf einer tieferen Ebene und ueberdeckt diese, selbst wenn die hintere den Fokus hat. +.sp +Es gibt zwei Moeglichkeiten die Ebene einer Anwendung festzulegen: Entweder ueber das Fenstermenue, welches 6 Ebenen zur Auswahl bietet: +.sp +.TP 4 +\(bu +2 \- ueber Dock +.TP 4 +\(bu +4 \- Dock +.TP 4 +\(bu +6 \- Oben +.TP 4 +\(bu +8 \- Normal +.TP 4 +\(bu +10 \- Unten +.TP 4 +\(bu +12 \- Desktop +Die andere Moeglichkeit ist die apps Datei, die weiter unten im Abschnitt ANWENDUNGEN beschrieben wird. +.sp +.SH "FOKUS" +Das Fokusmodell definiert wie ein Fenster den Fokus bekommen kann. (Will heissen: wie es das aktive Fenster, welches Maus und Tastatureingaben entgegennimmt, wird) Das Fokusmodell kann im Konfigurationsmenue, welches sich im Root Menue befindet, ausgewaehlt werden. +.sp +Zur Auswahl stehen 4 Optionen, von den oberen beiden und von den unteren beiden sollte jeweils eine gewaehlt werden. +.sp +.TP 4 +\(bu + +\fBClick To Focus\fR: Mausklick fokussiert ein Fenster +.TP 4 +\(bu + +\fBMouse Focus\fR: Ein Fenster wird fokussiert wenn sich die Maus darueber befindet +.TP 4 +\(bu + +\fBClickTabFocus\fR: Mausklick fokussiert ein Reiter (Tab) +.TP 4 +\(bu + +\fBMouseTabFocus\fR: Der Reiter unter der Maus wird fokussiert +Die letzte Option automatisches Hervorheben bewirkt, dass ein neu fokussiertes Fenster ueber die anderen Fenster auf der selben Ebene gehoben wird. +.sp +.SH "REITER OPTIONEN" +In dem Teil des Konfigurationsmenues koennen die Reiter (Tabs) konfiguriert werden. Er besteht aus 3 Optionen: +.sp +.TP 4 +\(bu + +\fBPlatzierung / Placement\fR: Gibt an wo sich die externen Reiter am Fenster befinden: +.sp +.RS 4 +.nf +Oben Links / Top Left +Oben Rechts / Top Right +Links Oben / Left Top +Rechts Oben / Right Top +Links Unten / Left Bottom +Rechts Unten / Right Bottom +Unten Links / Bottom Left +Unten Rechts / Bottom Right +.fi +.RE +.TP 4 +\(bu + +\fBTabs in der Titelleiste / Tabs in Titlebar\fR: Diese Option platziert die Tabs im Fenstertitel anstelle von aussen am Fenster. +.TP 4 +\(bu + +\fBvon maximierten Fenstern verdecken / Maximize Over\fR: Wenn diese Option eingeschaltet wird werden externe Tabs beim Maximieren von Fenstern nicht beachtet. +.TP 4 +\(bu + +\fBBreite fuer externe Tabs / External Tab Width\fR: Die Breite der externen Tabs in Pixel +.SH "FARBSCHEMATA" +Das Aussehen von fluxbox, also die Schriftart, die Fensterdekoration inklusive Fenstertitel, Rahmen, Knoepfe, Menuefarbe, kann bis ins Detail angepasst werden. Dafuer zustaendig sind Farbschemata, eigentlich ganz normale Textdateien die gewisse Informationen beinhalten. Naeheres dazu steht in der separaten Anleitung fluxstyle(1) +.sp +.SH "STYLE OVERLAY" +Zusaetzlich zu dem Farbschema gibt es noch das Overlay, welches in der init Datei mit session.screen0.styleOverlay (standard: ~/.fluxbox/overlay ) festgelegt ist. Darin koennen diverse Konfigurationen des Aussehens von fluxbox so gesetzt werden, dass sie die Einstellungen in dem verwendeten Farbschema ueberschreiben. Mehr dazu steht auch in fluxstyle(1). +.sp +.SH "ANWENDUNGEN" +fluxbox kann diverse Fenstereinstellungen dauerhaft speichern. Dazu wird die apps Datei benutzt. Diese kann entweder von Hand angepasst werden oder man fuegt die Eintraege ueber das Fenstermenue der entsprechenden Anwendung hinzu. +.sp +Das Format fuer Eintraege in der apps Datei sieht wie folgt aus: +.sp +.sp +.RS 4 +.nf +[app] (Name der Anwendung) + [Einstellung1] /{Wert1/} + [Einstellung2] /{Wert2/} + ... +[end] +.fi +.RE +Der Name kann dabei ein String oder ein regulaerer Ausdruck (RegExp) sein. Dabei koennen diverse Dinge als Name verwendet werden, unter anderem der im Fenstertitel erscheinende Name oder auch die "Rolle" des Fensters. Diese Werte koennen sehr gut mit dem Programm xprop ausgelesen werden. +.sp +\fBEin paar Beispiele\fR +.sp +.sp +.RS 4 +.nf +# Ein Standard XTerm ohne speziell gesetzten Titel: +[app] (xterm) + ... Einstellungen ... +[end] +.fi +.RE +.sp +.RS 4 +.nf +# Ein XTerm mit speziell gesetztem Titel: (xterm \-name myshell) +[app] (myshell) + ... Einstellungen ... +[end] +.fi +.RE +.sp +.RS 4 +.nf +# Ein beliebiges Firefox Fenster +[app] (class=Firefox\-bin) {1} + ... Einstellungen ... +[end] +.fi +.RE +.sp +.RS 4 +.nf +# Die Kontaktliste von GAIM (allerdings nicht das Chatfenster) +[app] (role=buddy_list) + ... Einstellungen ... +[end] +.fi +.RE +.sp +.RS 4 +.nf +#Ein RDesktop Fenster zu einem bestimmten Host: +[app] (title=rdesktop \- hostname.*) + ... Einstellungen ... +[end] +.fi +.RE +\fBEinstellungen\fR +.sp +Folgende Einstellungen koennen pro [app] Eintrag gemacht werden: (Die Bezeichnung ist dabei in eckigen, der wert in geschweiften Klammern zu schreiben) +.sp +.TP 4 +\(bu +[Workspace] /{0\-N/} oeffnet die Anwendung auf der angegeben Arbeitsflaeche. Die Arbeitsflaechen werden von 0 hochgezaehlt. +.TP 4 +\(bu +[Dimensions] /{Width Height/}: Setzt die Groesse einer Anwendung (Breite Hoehe) +.TP 4 +\(bu +[Position] (refspot)) /{X Y/}: Position der Anwendung, relativ zu: +.RS 4 +.TP 4 +\(bu +WINCENTER Fenstermitte +.TP 4 +\(bu +CENTER Bildschirmmitte +.TP 4 +\(bu +UPPERLEFT Obere linke Ecke +.TP 4 +\(bu +UPPERRIGHT Obere rechte Ecke +.TP 4 +\(bu +LOWERLEFT Untere linke Ecke +.TP 4 +\(bu +LOWERRIGHT Untere rechte Ecke +.sp +.RS 4 +.nf +Wird kein Referenzpunkt angegeben geht fluxbox +von der linken oberen Ecke aus. +.fi +.RE +.RE +.TP 4 +\(bu +[Layer] Ebene auf der die Anwendung gestartet wird. (in Klammern die Originalnamen): +.RS 4 +.TP 4 +\(bu +2 \- ueber Dock (AboveDock) +.TP 4 +\(bu +4 \- Dock +.TP 4 +\(bu +6 \- Oben (Top) +.TP 4 +\(bu +8 \- Normal +.TP 4 +\(bu +10 \- Unten (Bottom) +.TP 4 +\(bu +12 \- Desktop +.RE +.TP 4 +\(bu +[Shaded] Soll das Fenster aufgerollt gestartet werden +.TP 4 +\(bu +[Tab] Ist das Fenster tabbar +.TP 4 +\(bu +[IconHidden] Soll das Fenster in der Fensterleiste gezeigt werden +.TP 4 +\(bu +[FocusHidden] Soll das Fenster von Prev/NextWindow ausgenommen werden +.TP 4 +\(bu +[Hidden] Aktiviert sowohl [IconHidden] als auch [FocusHidden] +.TP 4 +\(bu +[Deco] /{NONE|NORMAL|TOOL|TINY|BORDER|TAB/} Definiert aktive Fensterdekos +.RS 4 +.TP 4 +\(bu +NORMAL \- Standarddekoration +.TP 4 +\(bu +NONE \- Ohne Dekoration (Ohne Fenstertitel, ohne Rahmen) +.TP 4 +\(bu +BORDER \- Nur einen Fensterrahmen aber ohne Titel +.TP 4 +\(bu +TINY \- Fenstertitel nur mit Minimieren\-Knopf +.TP 4 +\(bu +TOOL \- Nur ein Fenstertitel +.TP 4 +\(bu +TAB \- Wie NONE, allerdings werden externe Reiter (tabs) angezeigt +.sp +.RS 4 +.nf +Eine Bitmask kann fuer die Einstellung verwendet werden, die bits sind +(von "1" bis 1<<10): Fenstertitel, handle/grips, Rahmen, minimieren, +maximieren, schliessen, Menue aktiviert, Klebezustandsknopf, Aufrollknopf, +Reiter aktiviert, Fokus aktiviert. +.fi +.RE +.RE +.TP 4 +\(bu +[Sticky] Wird das Fenster auf allen Arbeitsflaechen angezeigt +.TP 4 +\(bu +[Close] Sollen die Einstellungen beim Schliessen gespeichert werden +.TP 4 +\(bu +[Alpha] {int [int]} Setzt die Transparenz fuer das Fenster +Fenster koennen mit Hilfe der Apps Datei gruppiert werden: +.sp +.sp +.RS 4 +.nf +[app] (Eigenschaft=expr) ... {number} +.fi +.RE +Eigenschaften koennen sein: +.sp +o name \- Fenstername (erstes WM_CLASS Feld) o class \- Fensterklasse (zweites WM_CLASS Feld) o title \- Fenstertitel ( WM_NAME Wert) o role \- Fensterrolle (WM_WINDOW_ROLE Wert) +.sp +Standardmaessig wird als Eigenschaft der Fenstername angenommen. Diese Informationen kann man mit hilfe von xprop(1) bekommen. +.sp +Die apps Datei kann auch als Autostart verwendet werden, allerdings ist dies noch nicht direkt ueber das Menue konfigurierbar und die startup Datei sollte ausreichen. +.sp +Es folgt ein kleines Beispiel einer solchen Datei: +.sp +.sp +.RS 4 +.nf + [startup] {xterm} + # Betrifft alle Term Fenster, bis zu zwei Instanzen + [app] (.*[tT]erm) {2} + # Betrifft alle Fenster mit *gaim* im Titel + [app] (title=.*gaim.*) + [app] (kate) + [Dimensions] {1022 747} + [Position] (WINCENTER) {0 0} + [Close] {yes} + [end] + [app] (konqueror) + [Workspace] {1} + [Dimensions] {1006 749} + [Position] {16 0} + [Jump] {yes} + [end] + # Alle Aterms ohne Fensterdekorationen + [app] (aterm) + [Deco] {NONE} + [end] + # Eine Gruppe mit GIMP Dock und Toolbox + # wir auf die vierte Ebene gesetzt + [group] + [app] (gimp) (role=gimp\-dock) + [app] (gimp) (role=gimp\-toolbox) + [Layer] {4} + [end] +.fi +.RE +.SH "DER SLIT" +Der Slit ist ein Platz an dem sich diverse Applikationen wie zum Beispiel die BB Tools oder gkrellm andocken koennen. +.sp +Anwendungen im Slit haben keinen Rahmen, keine Dekoration, sind auf allen Arbeitsflaechen sichtbar und werden nicht wie normale Fenster behandelt. +.sp +Viele Anwendungen nutzen die \-w Option um in den Slit verschoben zu werden. Beispiele sind (aus einer xinitrc): +.sp +.sp +.RS 4 +.nf +bbmail \-w & +bbpager \-w & +wmdrawer & +exec fluxbox +.fi +.RE +Die Slitfunktionalitaet wird standardmaessig in fluxbox einkompiliert, kann aber entfernt werden. fluxbox \-i gibt dabei aus ob sie einkompiliert wurde oder nicht. +.sp +.SH "SLIT MENUE" +Bei einem Rechtsklick auf den Rahmen des Slits oeffnet sich das Slitmenue, welches folgende Konfigurationsmoeglichkeiten bietet: +.sp +.TP 4 +\(bu + +\fBPlatzierung / Placement\fR: Legt fest wo sich der Slit befindet. +.TP 4 +\(bu + +\fBEbene / Layer\fR: Legt fest auf welcher Ebene sich der Slit befindet. +.TP 4 +\(bu + +\fBAutomatisches Ausblenden / Auto hide\fR: Genau gleich wie das automatische Ausblenden der Toolbar, der Slit wird ausgeblendet wenn sich die Maus eine gewisse Zeit nicht mehr darueber befindet. +.TP 4 +\(bu + +\fBvon maximierten Fenstern verdecken / Maximize over\fR: Wenn diese Option eingeschaltet ist werden maximierte Fenster ueber/unter den Slit gelegt. Ansonsten wird das Fenster nur bis zum Slit maximiert. +.TP 4 +\(bu + +\fBTransparenz / Alpha\fR: Mit dieser Einstellung kann die Transparenz des Slits (achtung: nur des Slits, nicht der Anwendungen darin) festgelegt werden. +.TP 4 +\(bu + +\fBAusrichtung / Slit direction\fR: Ausrichtung des Slits. Horizontal oder Vertikal. +.TP 4 +\(bu + +\fBClients\fR: Mit diesem Untermenue koennen die einzelnen Applikationen im Slit geordnet oder ausgeblendet werden. Die Einstellungen werden in der Datei slitlist gespeichert. +.SH "SLITLIST" +In der Datei slitlist speichert fluxbox die Reihenfolge der Applikationen in dem Slit. +.sp +Diese Datei kann bei Bedarf von Hand editiert werden, sie ist eine einfache Liste der Fensternamen. Die Datei sollte nicht editiert werden waehrend fluxbox laeuft, ansonsten koennten aenderungen verlorengehen. +.sp +In der init Datei kann auch eine andere Datei als slitlist angegeben werden: +.sp +.sp +.RS 4 +.nf +session.session0.slitlistFile: <Dateiname> +.fi +.RE +.SH "UMGEBUNGSVARIABLEN" +HOME: fluxbox nutzt die HOME Variable um die .fluxbox/init Datei sowie Verzeichnisse fuer Farbschemata zu finden +.sp +DISPLAY: Wenn auf der Kommandozeile keine andere Anzeige angegeben wird nutzt fluxbox die in der Variable DISPLAY angegebene. +.sp +Andere Umgebungsvariablen koennen von Vorteil sein. Wenn zum Beispiel $TERM gesetzt ist, dann ist diese kann diese Variable von fluxbox verwendet werden, zum Beispiel mit einem Eintrag in die keys Datei: +.sp +.sp +.RS 4 +.nf +Mod1 x ExecCommand :$TERM +.fi +.RE +Weiteres zu Umgebungsvariablen steht in der manpage der verwendeten Shell. +.sp +.SH "SIGNALE" +fluxbox reagiert auf folgende Signale: +.sp +.TP 4 +\(bu +SIGHUP fluxbox laedt die Konfiguration +.TP 4 +\(bu +SIGUSR1 Erzwingt ein neues Einlesen der Konfiguration +.TP 4 +\(bu +SIGUSR2 Erzwingt ein neues Einlesen der Menuedatei +.SH "AUTOR UND DANKSAGUNGEN" +fluxbox wurde geschrieben und wird gepflegt von Henrik Kinnunen <fluxgen at fluxbox org> Simon Bowden <rathnor at fluxbox org> Mathias Gumz <akira at fluxbox org> Mark Tiefenbruck <mark at fluxbox org> +.sp +Zudem tragen viele Leute weltweit mit Patches, Bugreports, Uebersetzungen oder anderen Hilfestellungen zu dem Projekt bei. +.sp +Blackbox wurde geschrieben und verwaltet durch: Brad Hughes <blackbox at alug org> Jeff Raven <jraven at psu edu> +.sp +Die offizielle fluxbox Webseite: http://www.fluxbox.org +.sp +Viele Farbschemata findet man unter: \- http://boxwhore.org \- http://themes.freshmeat.net/ +.sp +Diese Anleitung wurde geschrieben von: +.sp +.TP 4 +\(bu +Curt Micol <asenchi at asenchi com> (>fluxbox\-0.9.11) +.TP 4 +\(bu +Tobias Klausmann <klausman at users sourceforge net> (<=fluxbox\-0.9.11) +.TP 4 +\(bu +Grubert <grubert at users sourceforge net> (fluxbox) +.TP 4 +\(bu +Matthew Hawkins <matt at mh dropbear id au> (blackbox) +.TP 4 +\(bu +Wilbert Berendsen <wbsoft at xs4all nl> (blackbox) +Deutsche Uebersetzung der Anleitung: +.sp +.TP 4 +\(bu +Christian (Fuchs) Loosli <develop at fuchsnet ch> +.SH "BUGS" +Fehler in fluxbox koennen entweder im #fluxbox irc channel im irc.freenode.net Netzwerk oder noch besser direkt auf http://sf.net/projects/fluxbox gemeldet werden. Zudem gibt es mehrere Mailinglisten. Informationen dazu gibt es auf der offiziellen Projektseite. +.sp +.SH "SIEHE AUCH" +bsetroot(1) fbsetbg(1) fbrun(1) fluxstyle(1) +.sp
M doc/asciidoc/fluxbox.de.txtdoc/asciidoc/fluxbox.de.txt

@@ -1,7 +1,7 @@

fluxbox(1) ========== Henrik Kinnunen <fluxgen@fluxbox.org> -v1.0rc3, 16th April 2007 +v1.0rc3, 21th April 2007 NAME ----
A doc/asciidoc/fluxbox.es.1

@@ -0,0 +1,1873 @@

+.\" Title: fluxbox +.\" Author: +.\" Generator: DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/> +.\" Date: 04/21/2007 +.\" Manual: +.\" Source: +.\" +.TH "FLUXBOX" "1" "04/21/2007" "" "" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +fluxbox \- Un liviano manejador de ventanas para el X Windowing System +.SH "SYNOPSIS" +\fIfluxbox\fR [\-v | \-version] [\-h | \-help] [\-i | \-info] \fIfluxbox\fR [\-rc rcfile] [\-log logfile] [\-display display] [\-screen scr,scr|all] [\-verbose] +.sp +.SH "DESCRIPCION" +fluxbox(1) provee decoraciones de ventanas configurables, un menu root para lanzar aplicaciones y una barra de tareas que muestra el nombre del \fIworkspace\fR actual, la aplicacion activa y la hora actual. Tambien hay un menu de workspace para agregar o remover espacios de trabajo. La \fIslit\fR puede ser usada para \fIdockear\fR pequenias aplicaciones, por ej.: la mayoria de las bbtools pueden usar la slit. +.sp +fluxbox(1) puede iconificar las ventanas a la barra de tareas, agregando la ventana al submenu \fIIcons\fR del menu workspace. Con un click reapareceran las ventanas iconificadas. Doble\-click en la barra de titulo de una ventana la \fIfoldeara\fR (shade), por ej.: desaparecera la ventana y quedara visible solamente la barra de titulo. +.sp +fluxbox(1) usa su propia clase de graficos para renderizar sus imagenes al vuelo. Mediante el uso de \fIestilos\fR se puede determinar en gran nivel la apariencia de un escritorio. Los estilos de Fluxbox son compatibles con los de Blackbox 0.65 o versiones anteriores, de modo que los usuarios que esten migrando aun pueden usar sus temas favoritos. +.sp +Fluxbox cumple con la mayoria de las especificaciones Extended Window Manager Hints (EWMH), asi como otros numerosos standards de Window Hinting. Esto permite a todos los window managers que las cumplen proveer una interfaz comun para caracteristicas standard usadas por aplicaciones y utilidades de escritorio. +.sp +.SH "OPCIONES" +.PP +\-d display |\-display display +.RS 4 +Inicia fluxbox en el +\fIdisplay\fR +especificado. Los programas iniciados por Fluxbox tendran el mismo valor de la variable de entorno DISPLAY. +.RE +.PP +\-h | \-help +.RS 4 +Muestra las opciones de lineas de comandos y sale. +.RE +.PP +\-i | \-info +.RS 4 +Muestra informacion util concerniente a las opciones por defecto y las compiladas. +.RE +.PP +\-l logfile +.RS 4 +Iniciando Fluxbox con esta opcion creara un archivo en el que se guardara un +\fIlog\fR +de los eventos. +.RE +.PP +\-rc archivo rc +.RS 4 +Usa otro archivo rc que el por defecto "~/.fluxbox/init". \-version Muestra la version de Fluxbox instalada. +.RE +.SH "INICIANDO FLUXBOX" +fluxbox(1) viene con un programa llamado startfluxbox(8) localizado generalmente donde se instalo Fluxbox. Este script nos provee con muchas opciones y variables que pueden ser indicadas cuando al inicio de Fluxbox. Para utilizarlo cuando se inicia Fluxbox, se debe colocar \fIexec startfluxbox\fR como ultimo comando en el /.xinitrc o /.xsession del usuario (dependiendo de las distribuciones y del display manager que se utilice), asumiendo que la localizacion de fluxbox(1) y startfluxbox(8) estan en el $PATH del \fIshell\fR. Tambien hay que notar que tal vez haya que crear el archivo /.xinitrc o tal vez el setup use /.xsession. Para mas informacion ver el manual del shell. +.sp +Usando \fIfluxbox \-i\fR se veran las opciones por defecto utilizadas por fluxbox(1). Estas son las que busca al inicio. En la lista de \fIDefaults:\fR la ubicacion de archivo menu, ahi se puede proveer un menu comun para todos los usuarios. +.sp +Saliendo o reiniciando, Fluxbox guardara las configuraciones del usuario en el archivo ~/.fluxbox/init. Los recursos en este archivo pueden ser editados a mano. Fluxbox tambien tiene muchas herramientas para modificar esto. Hay que mirar en el menu principal una vez que Fluxbox ha iniciado para encontrar diferentes maneras de administrar la sesion. +.sp +.SH "USANDO FLUXBOX" +Cuando se usa Fluxbox por primera vez, los usuarios acostumbrados a ambientes de escritorios completos tales como KDE o Gnome pueden quedar un poco sorprendidos por el contenido de pantalla minimo. Fluxbox esta diseniado para ser rapido y potente, asi que puede llevar un poco de tiempo acostumbrarse, sin embargo los resultados que se pueden obtener valen la pena. Daremos un sumario rapido de las cosas comunes en esta seccion. De todas maneras recomendamos que consulte las secciones referenciadas de este manual para posterior desarrollo de su entendimiento de lo que puede hacer con Fluxbox. +.sp +.SS "Root Window (ventana principal)" +Observando el escritorio de Fluxbox inmediatamente despues del startup generalmente se vera solo una cosa: la barra de tareas (Toolbar). Si se hace click derecho (boton 3 del mouse) en algun lugar vacio se podra acceder al RootMenu (menu principal), con un click del boton del medio (boton 2 del mouse) en el escritorio muestra el WorkspaceMenu (menu de escritorio). +.sp +.SS "RootMenu y WorkspaceMenu" +Desde el RootMenu se pueden lanzar aplicaciones y configurar Fluxbox. El WorkspaceMenu muestra todas las ventanas y en que escritorios estan. Vea la seccion MENUS para saber como personalizar estos. +.sp +.SS "Toolbar" +La Toolbar contiene hasta ocho campos/herramientas: +.sp +.TP 4 +\(bu + +\fBWorkspace Name\fR: Nombre del escritorio actual +.TP 4 +\(bu + +\fBIconbar\fR: Muestra las ventanas +.TP 4 +\(bu + +\fBSystem Tray\fR: Area para +\fIapplets\fR +.TP 4 +\(bu + +\fBClock\fR: Hora y fecha +.TP 4 +\(bu + +\fBWorkspace Arrows\fR: +\fIFlechas\fR +para cambiar de escritorio +.TP 4 +\(bu + +\fBWindow Arrows\fR: +\fIFlechas\fR +para cambiar de ventana +Los contenidos de la Toolbar pueden ser configurados en el archivo \fIinit\fR. Hablaremos sobre este archivo en gran extension en la seccion RECURSOS. +.sp +.SS "Slit" +Inicialmente no se podra ver la Slit. Esta ahi, es solo que aun no esta siendo utilizada. La Slit confunde a algunos al principio. Hay que pensar en ella como un \fImuelle\fR (dock) al que se pueden anclar pequenios programas. Si se han mirado capturas de pantalla en el sitio oficial de Fluxbox probablemente se hayan notado pequenias aplicaciones en el borde de algunas de las pantallas. Estas muy probablemente estaban \fIdockeadas\fR en la Slit. Para aprender mas sobre la Slit hay una seccion entera mas adelante que entra en detalle acerca de las opciones de que dispone. +.sp +.SS "Layers" +Fluxbox maneja las siguientes Layers (capas) \fB Above Dock \fR Dock \fB Top \fR Normal \fB Bottom \fR Desktop +.sp +Las ventanas en una capa mas alta aparecen sobre las que estan en una mas baja. Estas capas pueden ser usadas en ventanas de aplicaciones, en la Slit o en la Toolbar. Se pueden asignar aplicaciones a una cierta capa especificandolo en el archivo apps. Hablaremos sobre el archivo \fIapps\fR en la seccion APLICACIONES. Se discutira en mas detalle sobre las capas en la seccion LAYERS. +.sp +.SS "Focus Model" +La ventana que esta enfocada es la que recibe los eventos de teclado y mouse. El tipo de enfocado (Focus Model) es seleccionable via menu de Configuracion localizado en el RootMenu. Discutiremos sobre los diferentes modos de enfocado en la seccion FOCUS MODEL. +.sp +.SS "Ventanas" +Un click izquierdo del mouse en cualquier parte del borde de la ventana la \fIelevara\fR sobre las otras. Manteniendo apretado el boton y arrastrando la desplazara a otra parte del escritorio. Arrastrando los \fIgrips\fR de tamanio en las esquinas inferiores izquierda y derecha cambiaran el tamanio de la ventana. Click del medio en un borde o la barra de titulo inmediatamente la \fIbajara\fR. Click derecho en un borde o la barra de titulo muestra el WindowMenu. Los comandos en este menu en particular se comentan en detalle en la seccion MENUS. +.sp +.SS "Tabs" +Fluxbox permite que las ventanas sean \fIagrupadas\fR haciendo click con el boton del medio en la barra de titulo y luego arrastrando y soltando en otra ventana. De esta manera las barras de título se convertiran en pestanias permitiendo al usuario seleccionar cada ventana individualmente. Este metodo nos permite poner multiples aplicaciones en una sola localizacion en el escritorio, y hacer muchas operaciones (por ej. mover o cambiar de tamanio) a todas las ventanas del grupo. Las opciones se detallan en la seccion TAB OPTIONS +.sp +.SS "Miscelaneas" +Cuando se quiere arrastrar una ventana, pero no se puede ver el borde inferior o la barra de titulo se puede apretar (y sostener!) +.sp +.sp +.RS 4 +.nf +ALT + Boton Izquierdo del Mouse (Boton 1) +.fi +.RE +y moverla a cualquier parte del espacio de trabajo actual. Esta combinacion de teclas puede ser usada tambien para traer el frente ventanas parcialmente visibles. +.sp +La combinacion +.sp +.sp +.RS 4 +.nf +ALT + Boton Derecho del Mouse (Boton 3) +.fi +.RE +permitira cambiar el tamanio de la ventana. Esto puede se deshabilitado en el archivo \fIinit\fR (por defecto ~/.fluxbox/init) con: +.sp +.sp +.RS 4 +.nf +session.session0.useMod1: <logica> +.fi +.RE +.SS "MENUS" +Fluxbox instala un archivo de menu por defecto en /user/local/share/fluxbox/menu. Para confirmar esto podemos usar el comando fluxbox \-i desde una terminal. Por supuesto este menu puede ser modificado para todos los usuarios de una sola vez, pero tambien es posible crear un menu individual para cada usuario. Por convencion los usuarios crean su archivo menu en ~/.fluxbox. Una vez que hemos creado nuestro propia menu, querremos asegurarnos que indicamos adecuadamente su localizacion en nuestro archivo \fIinit\fR asi fluxbox sabra donde buscar. El valor que debemos agregar o cambiar es: +.sp +.sp +.RS 4 +.nf +session.session0.menuFile: <archivo_menu> +.fi +.RE +Para que este cambio tenga efecto debemos reiniciar Fluxbox. Nos aseguramos que nuestro menu sea utilizable, luego elegimos \fIRestar\fR del menu root. Este reinicio es necesario solamente si hacemos cambios al archivo \fIinit\fR, de otra manera alcanza con \fIReload config\fR. Una recarga del menu tambien puede ser forzada enviando una senial SIGUSR2 (ver la seccion SENIALES). +.sp +.SS "Menu Root" +El menu root es donde se pueden cambiar diferentes aspectos de fluxbox simplemente haciendo click en un item del mismo. La mayoria de los cambios en este menu tambien se pueden hacer en el archivo \fIinit\fR. Sin embargo es mucho mas facil cambiar ciertas opciones sin tener que abrir un editor de texto y buscar el recurso. En el menu root generalmente se tiene un submenu llamado'fluxbox menu' o \fIsettings\fR, donde se encontrara una cantidad de opciones diferentes. Le echaremos una mirada a la mayoria, si no a todas, aqui. +.sp +.TP 4 +\(bu + +\fBConfigure\fR: El proximo nivel bajo este menu es donde se pueden indicar ciertas opciones y realmente empezar a personalizar el +\fIlook and feel\fR +del escritorio. +.TP 4 +\(bu + +\fBSystem Styles\fR: Aca es donde se encuentra la lista de los estilos estandar. Se puede seleccionar uno de ellos con un simple click. Es probable que se tenga que recargar la configuracion o reiniciar para que cada elemento grafico corresponda al nuevo estilo. Los estilos de sistema estan localizados en /usr/local/share/fluxbox/styles de acuerdo a una instalacion por defecto. Cabe recordar que se puede confirmar esto con fluxbox \-i. +.TP 4 +\(bu + +\fBUser Styles\fR: ~/.fluxbox/styles es la ubicacion donde se almacenaran los estilos nuevos que se consigan de Internet. Si se crean estilos propios tambien es este el directorio donde colocarlos (siguiendo los +\fIstandards\fR +descriptos en fluxstyle(1)). +.TP 4 +\(bu + +\fBWorkspace List\fR: Esta es una lista de los espacios de trabajo configurados en +\fIinit\fR. Si hay programas ejecutandose en alguno de los +\fIescritorios\fR +apareceran listados un nivel mas abajo. +.TP 4 +\(bu + +\fBTools\fR: Aparecen listadas diferentes herramientas que se pueden utilizar. Se puede renombrar ventanas o regenerar el menu. +.TP 4 +\(bu + +\fBWindow\fR: Permite cambiar el manejador de ventanas (aparece solamente si se tienen instalados otros manejadores de ventanas o ambientes de escritorio). +.TP 4 +\(bu + +\fBLock Screen\fR: Bloquea la pantalla\&... +.TP 4 +\(bu + +\fBFluxbox Command\fR: Una pequenia linea de comandos aparecera donde se podra ingresar un comando Fluxbox. +.TP 4 +\(bu + +\fBReload Config\fR: Se utiliza para recargar cualquier archivo de menu o estilo. Es solo una re\-lectura basica de los archivos usados por Fluxbox. +.TP 4 +\(bu + +\fBRestart\fR: Reinicia todo, esto relee archivos y redibuja elementos graficos. +.TP 4 +\(bu + +\fBExit\fR: Sale de fluxbox y termina el servidor X. +.SS "Menu de Configuracion" +Este menu ofrece la oportunidad de configurar fluxbox. Tambien puede ser hecho editando el archivo init, pero es mas facil y mas rapido para la mayoria de los usuarios hacerlo desde el menu. +.sp +.TP 4 +\(bu + +\fBFocus Model\fR: Por favor leer la seccion FOCUS MODEL al final de este manual. +.TP 4 +\(bu + +\fBTab Options\fR: Nos permite configurar las propiedades de las +\fItabs\fR. Se detalla en la seccion TAB OPTIONS. +.TP 4 +\(bu + +\fBSlit\fR: Este menu puede ser abierto clickeando sobre la Slit (si esta visible). +.TP 4 +\(bu + +\fBLayer\fR: Mirar dentro de este submenu las distintas prioridades de Layer. +.TP 4 +\(bu + +\fBAuto Hide\fR: Si esta activado, la slit desaparecera luego de cierto tiempo y se escondera de la vista del usuario. Se puede hacer aparecer si se mueve el mouse hacia el borde del escritorio donde la slit esta posicionada. +.TP 4 +\(bu + +\fBMaximize Over\fR: Si activado, todas las ventanas al ser maximizadas se estiraran hasta pasar por encima o por debajo de la slit. De otro modo seran limitadas por el borde de esta. +.TP 4 +\(bu + +\fBAlpha\fR: Cambiando este valor la slit se volvera mas o menos transparente (solamente su decoracion, no las aplicaciones en ella). 0 (transparente) \- 255 (opaco) +.TP 4 +\(bu + +\fBSlit Direction\fR: Alterando este valor se indicara la direccion de la slit para ordenar las aplicaciones cargadas en la slit. No hay efecto con solo una aplicacion. +.TP 4 +\(bu + +\fBClients\fR: Este submenu nos deja reordenar las aplicaciones corriendo en la slit. Se pueden esconder deseleccionandolas en la lista que las muestra. Esto no matara la aplicacion. Se hacen aparecer seleccionandolas en la lista. La opcion "Save Slitlist" guarda el nuevo orden en el archivo +\fIslitlist\fR +localizado en ~/.fluxbox (util si se reordenan las aplicaciones con las opciones +\fICycle Up\fR +y +\fICycle Down\fR). +.TP 4 +\(bu + +\fBToolbar\fR: Observar la parte de la seccion TOOLBAR denominada "Configuracion a traves del menu de la Barra de Herramientas". +.TP 4 +\(bu + +\fBImage dithering\fR: Activa o desactiva el dithering de imagenes. +.TP 4 +\(bu + +\fBOpaque Window Moving\fR: Si esta activado, se vera el contenido de la ventana mientras se la arrastra. De otro modo se vera solo el borde durante el movimiento. +.TP 4 +\(bu + +\fBFull Maximization\fR: Activando esta opcion actuara sobre las configuraciones por separado de la slit y la toolbar. Las ventanas siempre se maximizaran por encima o por debajo de ellas. +.TP 4 +\(bu + +\fBFocus New Window\fR: Si activado, cada nueva ventana que se abra aparecera enfocada. +.TP 4 +\(bu + +\fBFocus Last Window on Workspace\fR: Enfoca la ultima ventana cuando se vuelve a un espacio de trabajo. +.TP 4 +\(bu + +\fBWorkspace warping\fR: Activar esta opcion permite arrastrar ventanas de un escritorio hacia otro. +.TP 4 +\(bu + +\fBDesktop MouseWhell Switching\fR: Con esta opción se puede cambiar de escritorio haciendo girar la rueda del mouse sobre la toolbar o sobre el fondo de escritorio. +.TP 4 +\(bu + +\fBDecorate transient windows\fR: Cuando se selecciona esta opción todas las ventanas temporales tienen borde y +\fIgrips\fR. +.TP 4 +\(bu + +\fBClick Raises\fR: Cuando activada, un click en cualquier parte de la ventana (incluida la decoracion) la traera al frente. De otro modo solamente se podra hacer con un click en la barra de titulo. +.TP 4 +\(bu + +\fBTransparency\fR: Permite configurar la transparencia para el menu y las ventanas enfocadas y desenfocadas. +.SS "Menu Window" +Este menu es mostrado cuando se hace click derecho sobre la barra de titulo o el borde de una ventana. Las opciones disponibles son: +.sp +.TP 4 +\(bu + +\fBSend To\&...\fR: Manda una ventana a otro escritorio. Cuando se selecciona el escritorio con click del medio, Fluxbox nos enviara junto con la aplicacion al espacio seleccionado. +.TP 4 +\(bu + +\fBShade\fR: Hace un +\fIshade\fR +a la ventana (muestra solamente la barra de titulo). +.TP 4 +\(bu + +\fBIconify\fR: Iconifica la ventana. El +\fIicono\fR +puede encontrarse en el submenu Icons del menu workspace asi como en la toolbar (si se ha seleccionado un modo para la toolbar que muestre los iconos. +.TP 4 +\(bu + +\fBMaximize\fR: (Des)Maximiza la ventana. Dependiendo de la configuracion de la toolbar y de la slit, la maximizacion puede cubrirlas. Se pueden usar los diferentes botones del mouse para diferentes aspectos de la funcion Maximize. +.RS 4 +.TP 4 +\(bu +Boton 1 (Des)Maximiza normalmente. +.TP 4 +\(bu +Boton 2 (Des)Maximiza la ventana verticalmente. +.TP 4 +\(bu +Boton 3 (Des)Maximiza la ventana horizontalmente. +.RE +.TP 4 +\(bu + +\fBRaise\fR: Trae la ventana al frente. +.TP 4 +\(bu + +\fBLower\fR: Envia la ventana al fondo. +.TP 4 +\(bu + +\fBStick\fR: (De)Stickea la ventana. Una ventana stickeada es mostrada en todos los escritorios al mismo tiempo. +.TP 4 +\(bu + +\fBNext Client\fR: Activa el proximo cliente en este grupo de ventanas. +.TP 4 +\(bu + +\fBPrev Client\fR: Activa el cliente anterior en este grupo de ventanas. +.TP 4 +\(bu + +\fBLayer\&...\fR: Cambia la capa de esta ventana. +.TP 4 +\(bu + +\fBRemember\&...\fR: Especifica que configuracion de ventana debe ser almacenada en el archivo apps, cubierto mas adelante en la seccion APLICACIONES. +.TP 4 +\(bu + +\fBClose\fR: Cierra la aplicacion. +.SS "Menu Workspace" +El menu Workspace puede encontrarse clickeando con el boton del medio en el fondo de escritorio. Aparecera un menu dando la opcion de agregar o quitar un escritorio. Tambien se veran los escritorios listados, un menu por debajo se veran los programas que estan ejecutandose en los respectivos espacios de trabajo. Por ultimo pero no menos importante se vera el menu Icons que muestra las aplicaciones que han sido iconificadas. +.sp +.SS "Comportamiento de los menus" +Dicho comportamiento puede ser configurado en el archivo \fIinit\fR con las siguientes entradas (el valor por defecto para ambas es 0): +.sp +.sp +.RS 4 +.nf +session.screen0.menuDelay: <msec> +session.screen0.menuDelayClose: <msec> +.fi +.RE +.SS "Sintaxis del Menu" +Existen hasta cuatro campos en una linea de menu. Son de la forma: +.sp +.sp +.RS 4 +.nf +[tag] (nombre|etiqueta) {comando|nombre_del_archivo} </ruta/al/icono> +.fi +.RE +Los tags reconocidos son: +.sp +.PP +[begin] (etiqueta) +.RS 4 +Le indica a fluxbox donde inicia a analizar el menu. Este tag es requerido para que Fluxbox lea el archivo de menu. Si no lo puede encontrar sera usado el menu por defecto. +.RE +.PP +[end] +.RS 4 +Le dice a Fluxbox que es el final de un menu. Puede ser tanto un submenu como el Menu root. Debe haber por lo menos uno de estos tags que se corresponda con el tag requerido [begin]. +.RE +.PP +.RS 4 +Inserta un comando en el menu. Cuando se selecciona este item en el menu Fluxbox ejecuta el comando. +.RE +.PP +[exit] (etiqueta) +.RS 4 +Inserta un item que sale de Fluxbox. Cualquier ventana abierta es redireccionada a la ventana root y se cierra. +.RE +.PP +[include] (nombre\-de\-archivo\-o\-directorio) +.RS 4 +Analiza el archivo especificado por nombre en linea con el menu actual. El nombre puede ser la ruta completa al archivo, o puede empezar con ~/, el cual sera buscado en el directorio home del usuario. Si la ruta es un directorio entonces todos los archivos que contenga seran incluidos. +.RE +.PP +[nop] (etiqueta) +.RS 4 +Inserta un item no operacional en el menu actual. Esto puede ser usado para ayudar a dar formato al menu dividiendolo en bloques o secciones si asi se desea. Este tag soporta una etiqueta pero no es necesaria, en tal caso se obtendra un item en blanco. +.RE +.PP +[separator] +.RS 4 +Esto creara una bonita linea de separacion. Util para dividir secciones de una manera vistosa. +.RE +.PP +[style] (etiqueta) {nombre_de_archivo} +.RS 4 +Le dice a Fluxbox que inserte un item que, cuando seleccionado, lee el estilo nombrado en nombre_de_archivo y aplica las nuevas texturas, colores y fuentes a la sesion ejecutandose actualmente. +.RE +.PP +[stylesmenu] (directorio) +.RS 4 +Lee todos los nombres de archivo dentro del directorio especificado, asumiendo que todos son archivos de estilo validos, y crea items del menu dentro del menu actual para cada archivo, que, cuando seleccionados por el usuario aplicaran el estilo elegido a la sesion actual. Las etiquetas que son creadas en el menu son los nombres de los archivos de estilos. +.RE +.PP +[stylesdir] (etiquteta) {titulo_del_menu} +.RS 4 +Crea un entrada de submenu con etiqueta (que es tambien el titulo del nuevo submenu), e inserta en ese submenu todos los nombres de archivo en el directorio especificado, asumiendo que todos son archivos validos de estilo (los directorios son ignorados) en la misma manera que el comando [stylesmenu]. Tanto [stylesdir] como [stylesmenu] hacen posible instalar estilos sin editar el archivo init. +.RE +.PP +[submenu] (etiqueta) {titulo_de_menu} +.RS 4 +Este comando le dice a Fluxbox que cree y analice un nuevo menu. Este menu es insertado como submenu dentro de menu principal. Estos menus son analizados recursivamente, de modo que no hay limite para el numero de niveles o submenus anidados que se puedan tener. El titulo del nuevo menu es opcional, si no se especifica ninguno el titulo del menu sera el mismo que el de la etiqueta. Es requerido el tag [end] para finalizar el submenu. +.RE +.PP +[reconfig] (label) +.RS 4 +Cuando seleccionado este item relee el estilo actual y el archivo de menu y aplica cualquier cambio. Es util para crear un nuevo tema o estilo sin que haya que reiniciar fluxbox cada vez que guardamos algun cambio. Sin embargo Fluxbox relee el menu automaticamente cada vez que cambia. +.RE +.PP +[restart] (etiqueta) {comando} +.RS 4 +Le dice a Fluxbox que reinicie. Si se provee un comando sale y ejecuta el comando (el cual es habitualmente el nombre de otro window manager). Si el comando es omitido Fluxbox se reinicia a si mismo. +.RE +.PP +[config] (label) +.RS 4 +Inserta submenu Fluxbox nativo, conteniendo numerosas opciones de configuracion relacionadas a la localizacion de ventanas, estilo de foco, estilo de movimiento de ventana, etc. +.RE +.PP +[wallpaper] (etiqueta) +.RS 4 +Este item nos permite enlistar nuestros fondos de pantalla. Esta hecho para trabajar junto con fbsetbg(1) y permite con un simple click en una imagen cambiar de fondo. Se nota? Fluxbox lo hace facil\&... +.RE +.PP +[workspaces] (etiqueta) +.RS 4 +Le dice a Fluxbox que inserte un enlace al menu workspaces directamente a nuestro menu. Particularmente util para los usuarios que no pueden acceder a dicho menu directamente (por ej.: si no se tiene un mouse de tres botones es bastante dificil clickear con el boton del medio para que nos lo muestre). +.RE +Cualquier linea que empiece con un \fI#\fR o \fI!\fR es considerada un comentario e ignorada por Fluxbox. Tambien, en los campos etiqueta/comando/nombre_de_archivo se puede usar cualquier caracter. Usando \fI\\\fR se inserta una barra invertida literal en los campos etiqueta/comando/nombre_de_archivo. +.sp +.sp +.RS 4 +.nf + Menu Ejemplo + # menu de Fluxbox + [begin] (Fluxbox) + [exec] (rxvt) {rxvt \-ls} </usr/X11R6/share/icons/terminal.xpm> + [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] (navegador) {mozilla \-browser} + [exec] (noticias) {mozilla \-news} + [exec] (correo) {mozilla \-mail} + [exec] (edit) {mozilla \-edit} + [exec] (compose) {mozilla \-compose} + [end] + [submenu] (Window Manager) + [exec] (Editar Menus) {nedit ~/.fluxbox/menu} + [submenu] (Estilo) {Que estilo?} + [stylesdir] (~/.fluxbox/styles) + [stylesmenu] (Fluxbox Styles) {@pkgdatadir@/styles} + [end] + [config] (Opciones de configuracion) + [reconfig] (Reconfigurar) + [restart] (Reiniciar) + [end] + [exit] (Salir) + [end] +.fi +.RE +.SH "TOOLBAR" +La toolbar (barra de tareas) es un area donde Fluxbox muestra informacion, como un reloj, el identificador de workspaces (espacios de trabajo o escritorios), una systemtray (bandeja del sistema) u una taskbar (llamada iconbar) que puede contener los programas en ejecucion. El color, aspecto, fuente, etc, son definidos en el estilo y no pueden ser definidos como configuraciones globales. +.sp +Las partes de la toolbar pueden ser activadas o desactivadas en el archivo \fIinit\fR con los argumentos definidos a continuacion: +.sp +.sp +.RS 4 +.nf +session.screen0.toolbar.tools +.fi +.RE +El orden y la cantidad de herramientas son libremente seleccionables y deben estar separadas por comas.Ej.: +.sp +.sp +.RS 4 +.nf +session.screen0.toolbar.tools: workspacename, systemtray, iconbar, clock +.fi +.RE +las posibles partes o herramientas de la toolbar son: +.sp +.TP 4 +\(bu + +\fBClock\fR: Mostrara el area donde apareceran de acuerdo a la especificacion del formato listado en "man strftime". +.TP 4 +\(bu + +\fBIconbar\fR: Esta es el area que contiene todas las ventanas (todas las aplicaciones en ejecucion, todas las ventanas minimizadas o tal vez ninguna ventana, todo dependiendo de la configuracion de la toolbar. +.TP 4 +\(bu + +\fBSystemtray\fR: La Systemtray (bandeja del sistema) puede contener aplicaciones que estan hechas para correr sobre ella. +.TP 4 +\(bu + +\fBWorkspaceName\fR: Muestra el nombre del espacio de trabajo actual. +.TP 4 +\(bu + +\fBPrevWorkspace\fR: Muestra una flecha que permite cambiar al Workspace siguiente que se encuentra a la izquierda del actual. Lo mismo que MouseWheelDown con "Desktop MouseWheel Switching" activado. +.TP 4 +\(bu + +\fBNextWorkspace\fR: Muestra una flecha que permite cambiar al siguiente Workspace a la derecha del actual. Lo mismo que MouseWheelUp con "Desktop MouseWheel Switching" activado. +.TP 4 +\(bu + +\fBPrevWindow\fR: Muestra una flecha que permite enfocar la ventana visible anterior en el workspace actual. +.TP 4 +\(bu + +\fBNextWindow\fR: Muestra una flecha que permite enfocar la ventana visible posterior en el workspace actual. +La Toolbar puede ser configurada de dos maneras. Tanto a traves de el Menu de configuracion de la misma, el cual es accesible desde el Menu de Configuracion en el Root\-Menu o con click derecho sobre Nombre de Workspace/Flechas/Reloj en la toolbar, o editando el archivo Init a mano (Observar la seccion RESOURCES para mas informacion sobre como hacerlo. +.sp +.SS "Configuracion a traves del menu de la Barra de Herramientas." +Todos los cambios tienen efecto mientras trabajas y puedes notarlo de inmediato, exceptuando cambios en el "Alpha de la barra de herramientas" (toolbar Alpha) , que necesita que se reinicie fluxbox para que los cambios tengan efecto. +.sp +.TP 4 +\(bu + +\fBVisible\fR: Setea la barra de herramientas en modo visible o invisible (bueno, esto deberia ser mas que obvio ;) ) +.sp +.RS 4 +.nf +session.screen0.toolbar.visible: <booleana> +.fi +.RE +.TP 4 +\(bu + +\fBAuto hide\fR: Si esta variable es seteada la barra de herramientas va a desaparecer despues de un tiempo definido cuando el puntero del mouse salga del area de la barra de herramientas. La barra va a aparecer cuando el mouse entre en la zona restante de los bordes de la barra de herramientas. El tiempo de espera puede ser seteado en init. +.sp +.RS 4 +.nf +session.screen0.toolbar.autoHide: <booleana> +session.autoRaiseDelay: <int> +.fi +.RE +.TP 4 +\(bu + +\fBToolbar width percentage\fR: Setea el ancho de la barra de herramienta en forma de porcentaje. Use el boton izquierdo del mouse para disminuir y el boton derecho para incrementar el valor. El valor puede variar entre 0 y 100. +.sp +.RS 4 +.nf +session.screen0.toolbar.widthPercent: <int> +.fi +.RE +.TP 4 +\(bu + +\fBMaximize Over\fR: Esta opcion permitira a las ventanas ser maximizadas sobre la barra de herramientas. Con esta opcion deshabilitada solo se "dockearan" en el borde de la barra. Para usar esta opcion, la opcion de "Full Maximization" de la configuracion de fluxbox menu debera estar deshabilitada, de otra manera esta opcion "Maximize over" no funcionara. +.sp +.RS 4 +.nf +session.screen0.toolbar.maxOver: <booleana> +session.screen0.fullMaximization: <booleana> +.fi +.RE +\-\fBLayer\&...\fR: Esta opcion configura la capa donde la barra de herramientas es seteada. Con esta misma uno puede configurar la barra de herramientas para que este siempre arriba de todo con "Always on top" +.sp +.sp +.RS 4 +.nf +session.screen0.toolbar.layer: <layer> +.fi +.RE +\-\fBPlacement\fR: Configura el lugar donde la barra de herramientas se encontrara, arriba, abajo, con una alineacion de derecha, izquierda o en el centro. +.sp +.sp +.RS 4 +.nf +session.screen0.toolbar.alpha: <int> +.fi +.RE +\-\fBAlpha\fR: Esta opcion configura el valor alpha (transparencia) para la barra de herramientas. Use el boton izquierdo del mouse para disminuir y el derecho para incrementar el valor. 0 es invisible y 255 es sin ninguna transparencia (color solido). +.sp +.sp +.RS 4 +.nf +session.screen0.toolbar.alpha: <int> +.fi +.RE +\-\fBIconbar Mode\fR: +.sp +.sp +.RS 4 +.nf +Especifica el modo de la barra de iconos "iconbar": +.fi +.RE +.sp +.RS 4 +.nf +\-None: + No mostrara ninguna ventana +\-Icons: + Solo mostrara las ventanas de todos los escritorios que estan minimizadas. +\-NoIcons: + Solo mostrara las ventanas de todos los escritorios que no estan minimizadas. +\-WorkspaceIcons: + Solo mostrara las ventanas del escritorio en donde se encuentra que esten + minimizadas. +\-WorkspaceNoIcons: + Solo mostrara las ventanas del escritorio en donde se encuentra que no esten + minimizadas. +\-Workspace: + Mostrara todas las ventanas del escritorio en donde se encuentra. +\-All WIndows: + Mostrara todas las ventanas de todos los escritorios. +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.iconbar.mode: <mode> +.fi +.RE +\-\fBAlignment\fR: +.sp +.sp +.RS 4 +.nf +\-Left: + Todos los iconos y ventanas seran alineados segun el ancho seteado en init. +\-Relative: + Todos los iconos y ventanas seran arreglados para que la barra de iconos + siempre este completa. +\-Right: + Todos los iconos y ventanas seran alineados segun el ancho seteado en init. +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.iconbar.aligment: <alignment> +session.screen0.iconbar.iconWidth: <int> +.fi +.RE +\-\fBShow Pictures\fR: Si esta variable esta habilitada la barra de iconos mostrara los iconos de las aplicaciones , si esta posee alguno. +.sp +.sp +.RS 4 +.nf +session.screen0.iconbar.usePixmap: <booleana> +.fi +.RE +\-\fBClock\fR: Deja que cambies el estilo de la hora entre 00:00am \- 12:00pm y 00:00\-24:00. +.sp +\-\fBEdit Clock Format\fR: Clickeando esta opcion abrira una pequenia ventana en la cual el el formato de hora podra ser modificado de acuerdo a \fIman strftime\fR. +.sp +.sp +.RS 4 +.nf +session.screen0.strftimeFormat: <formato> +.fi +.RE +.SS "RESOURCES" +Usualmente el archivo de resource ~/.fluxbox/init es creado y mantenido por Fluxbox. Uno puede usar el menu [config] para setear la mayoria de estas opciones. Sin embargo, nosotros vamos a contemplar todas las opciones disponibles de resource para el usuario. Si editas este archivo mientras estas corriendo Fluxbox, deberas reiniciar el mismo para que carguen las opciones de resource. +.sp +Cuando estamos corriendo Fluxbox en un ambiente de multiples escritorios la screen0 puede ser tambien screen1, screenN, etc. Uno puede customizar el comportamiento de Fluxbox en cada uno de los escritorios. A continuacion damos un ejemplo favorito de Fluxbox documentation manager: +.sp +.sp +.RS 4 +.nf + 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.slit.autoHide: False + session.screen1.slit.placement: CenterRight + session.screen1.slit.direction: Vertical + session.screen1.strftimeFormat: %a %d %R [%s] +.fi +.RE +Aqui estan los resources que estan actualmente disponibles: +.sp +.sp +.RS 4 +.nf +session.screen0.menu.alpha: <entero> +session.screen0.slit.alpha: <entero> +session.screen0.toolbar.alpha: <entero> +session.screen0.window.focus.alpha: <entero> +session.screen0.window.unfocus.alpha: <entero> + Estos resources estan disponibles para que el usuario pueda configurar +diferentes niveles de transparencia para diferentes componentes +de Fluxbox. Cada uno acepta un valor entre 0\-255 siendo 255 el +mas opaco y 0 completamente transparente. El default es 255. +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.slit.autoHide: <booleana> +session.screen0.toolbar.autoHide: <booleana> + El resource autoHide permite al usuario que configure el comportamiento +de la barra de herramientas y el slit. Este comportamiento puede ser +que estos desaparezcan cuando estos no estan siendo activamente usados +por el usuario, o que permanezcan visibles todo el tiempo. Default <booleana> +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.desktopwheeling: <booleana> +session.screen0.toolbar.wheeling: <booleana> +Esto marca la posibilidad de utlizar el scroll del mouse del usuario. +Configurando estos valores a '<booleana>' (true o false) permite que el usuario +pueda literalmente navegar entre escritorios o aplicaciones en la barra de +herramientas. Default: <booleana> +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.slit.layer: <layer> +session.screen0.toolbar.layer: <layer +Con estos dos resources, uno puede marcar las capas en que uno quiere +que aparezcan la barra de herramientas y el slit. Por favor lea la +seccion de LAYER para mas informacion. +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.slit.onTop: <booleana> +session.screen0.toolbar.onTop: <booleana> +Un usuario puede configurar si la barra de herramientas o el slit +siempre estan en el frente de la pantalla. Configurando estos +resources va a llevar a la barra de herramientas y el slit por +encima de todas las otras ventanas. Por defecto: False +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.slit.placement: <posicion> +session.screen0.toolbar.placement: <posicion> +Esto permite al usuario poner el split y la barra de herramientas +donde el usuario desee. Las opciones disponibles son: + \- BottomCenter + \- BottomLeft + \- BottomRight + \- LeftCenter + \- RightCenter + \- TopCenter + \- TopLeft +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.slit.maxOver: <booleana> +session.screen0.toolbar.maxOver: <booleana> + Seteando estas a '<booleana>' permitira la ventana de aplicacion +maximizarse completamente. configurando estas a '<booleana>' permitira +a la slit y la barra de herramientas conservar sus correspondientes +territorios y siempre seran visibles cuando una aplicacion sea +maximizada. El default es: <booleana> +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.toolbar.height: <entero> +Setea la altura de la barra de herramientas. Default: 0 + Si el valor es seteado a 0, el archivo de estilo <style> va a tomar +control sobre la altura de la barra de herramientas. Es posible +cambiar el tamanio de la misma seteandola con un valor > 0. +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.toolbar.visible: <booleana> + El usuario puede setear si quiere o no una barra de herramientas + visible en la pantalla. Configurando la variable a '<booleana>' remueve + la barra de herramientas de la pantalla. Esto tambien depende + obviamente de que si fue o no compilada la barra de herramientas + cuando se compilo fluxbox. El default es que la barra sea visible. +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.toolbar.widthPercent: <entero> + Esta variable permite configurar el ancho (largo) de la barra de + herramientas. El default es: 100 +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.toolbar.tools: <tools> + Esto especifica las herramientas en la barra de herramientas. Para mas + informacion leer la seccion TOOLBAR en este manual para una + descripcion detallada de cada una de estas herramientas. + Las posibles herramientas son:: + \- clock + \- iconbar + \- nextwindow + \- prevwindow + \- nextworkspace + \- prevworkspace + \- systemtray + \- workspacename +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.slit.onhead: <entero> +session.screen0.toolbar.onhead: <entero> + Para aquellos usuarios que tienen sistemas de doble cabeza <varios + monitores>, puede setear esta variable al numero de pantalla en el + cual quieren ver el slit y la barra de herramientas. Default: 0 +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.iconbar.iconWidth: 70 +session.screen0.iconbar.mode: <mode> + Este valor es seteado en el menu de Iconbar Mode. Las opciones + disponibles son:: + \- All Windows + \- Icons + \- None + \- Workspace + \- WorkspaceIcons +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.iconbar.usePixmap: <booleana> + Esto tambien es seteado en el menu de Iconbar Mode. Cuando ponemos + esta variable en '<booleana>' mostrara los iconos nativos de las + aplicaciones. El Default: <booleana> +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.iconbar.iconTextPadding: 10l +session.screen0.iconbar.deiconifyMode: Current +session.screen0.iconbar.wheelMode: Screen +session.screen0.iconbar.alignment: <position> + Este valor deberia cambiarse en el menu Iconbar Mode. + El default es: Relative (relativo) +.fi +.RE +.sp +.RS 4 +.nf +Opciones Disponibles: +\- Left: ancho, alineado izquierda +\- Relative +\- Right: ancho, alineado derecha +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.iconbar.clientWidth: <entero> + Usado para especificar el ancho de alineacion izquierda/derecha del + boton Iconbar. Default: 0 +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.overlay.lineWidth: 1 +session.screen0.overlay.lineStyle: LineSolid +session.screen0.overlay.joinStyle: JoinMiter +session.screen0.overlay.capStyle: CapNotLast +session.screen0.slit.direction: Vertical +session.screen0.strftimeFormat: <fecha> + Esto ajusta la forma en que la hora es mostrada en la barra de + herramientas. El formato usado es strftime(3). default %I %M %p +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.tab.alignment: Left +session.screen0.tab.height: 16 +session.screen0.tab.placement: Top +session.screen0.tab.rotatevertical: True +session.screen0.tab.width: 64 +session.screen0.followModel: Ignore +session.screen0.rowPlacementDirection: LeftToRight +session.screen0.colPlacementDirection: TopToBottom +session.screen0.resizeMode: Bottom +session.screen0.focusModel: ClickToFocus +session.screen0.autoRaise: <booleana> +session.screen0.clickRaises: <booleana> +session.screen0.workspacewarping: <booleana> +session.screen0.showwindowposition: <booleana> + Configurando estas opciones a '<booleana>' muestra al usuario, en una + pequenia ventana, la posicion exacta de la ventana mientras el usuario + esta arrastrandola. Permite un posicionamiento preciso de la ventana + en la pantalla. Default: <booleana> +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.decorateTransient: <booleana> +session.screen0.showposinsidewindow: <booleana> +session.screen0.menuMode: Delay +session.screen0.focusNewWindows: <booleana> +session.screen0.workspaceNames: workspace1, workspaceN + Aqui es donde el usuario puede nombrar sus ventanas de trabajo + <workspaces>. De todos modos, es recomendable que utilice la herramienta + disponible en el Menu de Configuracion para hacer esto. Default: one, + two, three, four. +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.menuDelayClose: 0 + Esta variable marca el tiempo de demora en milisegundos que el usuario + quiere que el menu permanezca visible despues de que ha movido el + mouse de arriba. Default: 0 +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.edgeSnapThreshold: <entero> + Cuando movemos una ventana en la pantalla, Fluxbox es capaz de pegarla + al borde de la pantalla para "facil posicionamiento". Esta variable le + dice a Fluxbox la distancia en pixels de cuando la ventana va a saltar + al borde. Default : 0 +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.windowPlacement: RowSmartPlacement +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.fullMaximization: <booleana> +session.screen0.sloppywindowgrouping: <booleana> +session.screen0.rootCommand: <command> + Esto sobreescribe el rootCommand del estilo. Cuando esta variable esta + seteada va a mantener el fondo de pantalla, mas halla de lo que cualquier + estilo tenga configurado. NOTA: Este comando puede ser peligroso. Por + favor este seguro de lo que esta haciendo cuando configure esta + variable a otro valor distinto de un comando de fondo de pantalla. +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.imageDither: <booleana> +session.screen0.opaqueMove: <booleana> + Determina el nivel de visibilidad de la aplicacion cuando esta siendo + arrastrada. Default: True +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.menuDelay: <msec> +session.screen0.workspaces: <entero> + Determina el numero de ambientes de trabajos <ventanas> que el usuario quiere. + Default: 4 +.fi +.RE +.sp +.RS 4 +.nf +session.screen0.focusLastWindow: <booleana> +session.screen0.windowMenu: +.fi +.RE +.sp +.RS 4 +.nf +session.appsFile: <ubicacion> +session.groupFile: <ubicacion> +session.keyFile: <ubicacion> +session.menuFile: <ubicacion> +session.slitlistFile: <ubicacion> +session.styleFile: <ubicacion> + Todas estas variables de configuracion requieren una direccion a su + recurso especifico. Aqui es cuando podes especificar diferentes + archivos. La mayoria de las configuraciones por default estaran en el + directorio ~/.fluxbox. +.fi +.RE +.sp +.RS 4 +.nf +session.autoRaiseDelay: <entero> + Ajusta el retraso en milisegundos que toma las ventanas enfocadas + levantarse cuando tienen la opcion Autoraise marcada. + El default es 250. +.fi +.RE +.sp +.RS 4 +.nf +session.cacheLife: <entero> + Esto le dice a Fluxbox cuando tiempo (en minutos) los pixmaps no + usados van a permanecer en la memoria del servidor X. Default: 5 +.fi +.RE +.sp +.RS 4 +.nf +session.cacheMax: <entero> + Esto le dice a Fluxbox cuanta memoria (en kb) puede usar para guardar + pixmaps cacheados en el servidor X. Si tu maquina tiene poca memoria + disponible, podes disminuir este valor. Default: 200 +.fi +.RE +.sp +.RS 4 +.nf +session.colorsPerChannel: <entero> + Esto le dice a Fluxbox cuantos colores debe tomar del servidor X en + pantallas con pseudo\-colores. Un canal seria rojo , verde o azul. + Fluxbox guarda estas variables y las mantiene siempre disponibles. + El valor debe estar siempre entre 2 y 6. Cuando se ejecuta Fluxbox en una + pantalla de 8bpp, debe setear este componente a 4. El default es 4. +.fi +.RE +.sp +.RS 4 +.nf +session.doubleClickInterval: <entero> + Ajusta el tiempo en milisegundos que Fluxbox considera doble\-click + a dos clicks consecutivos. El default es 250. +.fi +.RE +.sp +.RS 4 +.nf +session.forcePseudoTransparency: <booleana> +session.focusTabMinWidth: 0 +session.iconbar: <booleana> + Configura este valor a 'true' o 'false' para habilitar o + deshabilitar que la barra de herramientas de Fluxbox muestre ventanas + iconificadas. El default es: true +.fi +.RE +.sp +.RS 4 +.nf +session.ignoreBorder: <booleana> +session.imageDither: <booleana> + Setear a 'true' o 'false', respectivamente, para habilitar o + deshabilitar la agitacion en las imagenes <dithering>. Solo es + necesario en sistemas con una profundidad de color de 8bpp o inferior. + Default: <booleana> +.fi +.RE +.sp +.RS 4 +.nf +session.numLayers: 13 +session.opaqueMove: <booleana> + Cuando estas moviendo una ventana, con esta variable en 'true', + dibujara el contenido de la ventana mientras se mueve. (Esto disminuye el + rendimiento en sistemas con poco recursos). Si el valor es 'true' solo + dibujara el recuadro del borde de la ventana. Default: true +.fi +.RE +.sp +.RS 4 +.nf +session.tabs: <booleana> +session.tabPadding: 0 +session.tabsAttachArea: Window +session.titlebar.left: Stick +session.titlebar.right: Minimize Maximize Close +session.updateDelayTime: 0 +session.useMod1: <booleana> +.fi +.RE +.SH "KEYS" +Se puede customizar (personalizar) las combinaciones de teclas en Fdateluxbox a traves del archivo ~/.fluxbox/keys. El archivo toma la forma de: +.sp +.sp +.RS 4 +.nf +<modificador> <tecla> :[...] <operacion> +.fi +.RE +Como se vera en el ejemplo de mas abajo, Mod1 es la tecla ALT y Mod4 es una de las tres teclas extras en los teclados pc104 que esta marcada con el logo de una empresa muy conocida. Las lineas que comienzan con \fI#\fR o \fI!\fR se consideran comentarios y no son interpretadas por Fluxbox. +.sp +.sp +.RS 4 +.nf +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +# Fluxbox keys file. +Mod1 Tab :NextWindow +Mod1 Shift Tab :PrevWindow +Mod1 F1 :Workspace 1 +Mod1 F2 :Workspace 2 +Mod1 F3 :Workspace 3 +Mod1 F4 :Workspace 4 +Mod1 F5 :Workspace 5 +Mod1 F6 :Workspace 6 +Mod1 F7 :Workspace 7 +Mod1 F8 :Workspace 8 +Mod1 F9 :Workspace 9 +Mod4 b :PrevWorkspace +Mod4 c :Minimize +Mod4 r :ExecCommand rxvt +Mod4 v :NextWorkspace +Mod4 x :Close +Mod4 m :RootMenu +Control n Mod1 n :NextTab +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +.fi +.RE +Como se puede observar en la ultima linea, las \fIkeybindings\fR pueden ser encadenadas al estilo de las combinaciones de Emacs. +.sp +Algunas cosas que hay que saber: \- Los comandos distinguen mayusculas de minusculas. \- La numeracion de los workspaces empieza en "1". \- Algunos comandos tienen sinonimos \- El espacio entre la ultima tecla y :Comando es obligatorio. +.sp +Aqui van los comandos de Fluxbox para usar con teclas: +.sp +.SS "Comandos del manejador de ventanas" +.TP 4 +\(bu +Restart <argumento> +.TP 4 +\(bu +Quit +.TP 4 +\(bu +Reconfigure +.TP 4 +\(bu +SetStyle <argumento> +.TP 4 +\(bu +ExecCommand <argumento> +.SS "Comandos de la ventana en foco" +.TP 4 +\(bu +Minimize +.TP 4 +\(bu +MinimizeWindow +.TP 4 +\(bu +Iconify +.TP 4 +\(bu +Maximize +.TP 4 +\(bu +MaximizeWindow +.TP 4 +\(bu +MaximizeHorizontal +.TP 4 +\(bu +MaximizeVertical +.TP 4 +\(bu +ResizeTo <ancho> <altura> +.TP 4 +\(bu +Resize <delta\-ancho> <delta\-altura> +.TP 4 +\(bu +ResizeHorizontal <delta\-ancho> +.TP 4 +\(bu +ResizeVertical <delta\-altura> +.TP 4 +\(bu +MoveTo <x> <y> +.TP 4 +\(bu +Move <delta\-x> <delta\-y> +.TP 4 +\(bu +MoveRight <delta\-x> +.TP 4 +\(bu +MoveLeft <delta\-x> +.TP 4 +\(bu +MoveUp <delta\-y> +.TP 4 +\(bu +MoveDown <delta\-y> +.TP 4 +\(bu +Raise +.TP 4 +\(bu +Lower +.TP 4 +\(bu +Close +.TP 4 +\(bu +Shade +.TP 4 +\(bu +ShadeWindow +.TP 4 +\(bu +Stick +.TP 4 +\(bu +StickWindow +.TP 4 +\(bu +ToggleDecor +.TP 4 +\(bu +SendToWorkspace <numero> +.TP 4 +\(bu +SentToWorkspace <numero> +.TP 4 +\(bu +KillWindow +.TP 4 +\(bu +NextTab +.TP 4 +\(bu +PrevTab +.TP 4 +\(bu +MoveTabLeft +.TP 4 +\(bu +MoveTabRight +.TP 4 +\(bu +DetachClient +.SS "Comandos de Workspace" +.TP 4 +\(bu +NextWorkspace +.TP 4 +\(bu +PrevWorkspace +.TP 4 +\(bu +RightWorkspace <por\-numero> +.TP 4 +\(bu +LeftWorkspace <por\-numero> +.TP 4 +\(bu +Workspace <numero> +.TP 4 +\(bu +NextWindow <bitmask> +.TP 4 +\(bu +PrevWindow <bitmask> +.TP 4 +\(bu +NextGroup <por\-numero> +.TP 4 +\(bu +PrevGroup <por\-numero> +.TP 4 +\(bu +ArrangeWindows +.TP 4 +\(bu +ShowDesktop (Iconifica todas las ventanas) +.TP 4 +\(bu +RootMenu +.TP 4 +\(bu +WorkspaceMenu +.TP 4 +\(bu +WindowMenu +.TP 4 +\(bu +SetWorkspaceName <nombre> +.SS "Comandos especiales" +.TP 4 +\(bu +MacroCmd +.TP 4 +\(bu +ReloadStyle +.TP 4 +\(bu +SetResourceValue <resourcename> <resource> value +.TP 4 +\(bu +BindKey <key><value>: <action> +.SS "Un par de cosas" +.TP 4 +\(bu +SentToWorkspace: Nos enviara junto con la ventana al workspace seleccionado. SendToWorkspace solo envia la ventana. +.TP 4 +\(bu +Los parametros PrevWindow/NextWindow toman valores enteros: 0 o no especificado = comportamiento Default/actual \- no se saltea 1 = Ignorar las Tabs de mas abajo 2 = Ingnorar las ventanas +\fIStickeadas\fR +3 = Ignorar las Tabs de mas abajo/ventanas +\fIStickeadas\fR +4 = Ignorar las ventanas foldeadas 5 = Ignorar las Tabs de mas abajo/ventanas foldeadas 6 = Ignorar ventanas stickeadas/foldeadas 7 = Ignorar las tabs de mas abajo/ventanas stickeadas/foldeadas +.TP 4 +\(bu +Bindkey agregara una combinacion de teclas y una accion al archivo keys. +.TP 4 +\(bu +El valor +\fIdelta\fR +significa la diferencia entre el valor actual y configuracion solicitada. De modo que si tenemos una ventana con un ancho de 100 pixels, podemos setear +.sp +.RS 4 +.nf +Mod1 r :ResizeHorizontal 10 +.fi +.RE +y cuando usamos esa combinacion incrementara el tamanio de la ventana a 110 pixels. Si hemos usado +.sp +.sp +.RS 4 +.nf +Mod1 r :ResizeHorizontal \-10 +.fi +.RE +el tamanio ha disminuido 10 pixels llevando la ventana a 90 pixels. +.sp +.TP 4 +\(bu +Los comandos Resize no necesariamente cambian el numero de pixels. De modo que muchas terminales usaran el tamanio de un caracter como la unidad para cambiar el tamanio. La mayoria de las aplicaciones sin embargo usaran pixels. +.TP 4 +\(bu +MacroCmd: +.sp +.RS 4 +.nf +Mod1 r MacroCmd: {command1} {command2} +.fi +.RE +permite ejecutar mas de un comando con una sola combinacion. Los mismos se ejecutaran de modo serial. +.sp +.SH "LAYERS" +La layers (capas) afectan el modo en que las ventanas se solapan unas a otras en la pantalla. Las ventanas en una capa mas alta apareceran por encima de aquellas en una mas baja, sea que esten en foco o no. Por defecto, Fluxbox usa 13 capas, empezando desde 1 (la mas alta). El numero de capas puede ser cambiado usando el siguiente recurso: +.sp +.sp +.RS 4 +.nf +session.numLayers: <entero> +.fi +.RE +Hay dos maneras de asignar una ventana a una capa diferente. Cuando la ventana esta abierta, se puede seleccionar la capa en el submenu \fILayer \&...\fR del menu de ventana. El menu da seis opciones para la capa, los cuales Fluxbox maneja por nombre. Los nombres son (de la capa mas alta a la mas baja): +.sp +.TP 4 +\(bu +2 \- Above Dock +.TP 4 +\(bu +4 \- Dock +.TP 4 +\(bu +6 \- Top +.TP 4 +\(bu +8 \- Normal +.TP 4 +\(bu +10 \- Bottom +.TP 4 +\(bu +12 \- Desktop +La otra manera es indicar la capa para una ventana en al archivo \fIapps\fR. Este metodo es indicado en la seccion APLICACIONES. +.sp +.SH "FOCUS MODEL" +Focus Model (modelo de foco) define como las ventanas obtienen foco. (Por ej. convertirse en la ventana activa, la que recibe los eventos de teclado y mouse). El Focus Model puede ser cambiado en el menu de configuracion (generalmente ubicado bajo el menu \fIfluxbox\fR, en el menu \fIroot\fR). +.sp +Hay dos aspectos principales del modo de enfocado: como las ventanas ganan foco y como las tabs (pestanias) ganan foco. Cada uno tiene dos opciones: el foco sigue al mouse y al click para enfocar. Que el foco sigue al mouse significa que las ventanas ganaran foco cuando el mouse pase sobre ellas. Click para enfocar significa que las ventanas ganaran foco cuando reciben un click del mouse. +.sp +Por lo tanto, hay cuatro opciones principales cuando se elige el modelo de foco. Se debe elegir una de las dos primeras y una de las dos ultimas. Estas son: +.sp +.TP 4 +\(bu + +\fBClick To Focus\fR: click para enfocar las ventanas +.TP 4 +\(bu + +\fBMouse Focus\fR: el foco de las ventanas sigue el movimiento del mouse +.TP 4 +\(bu + +\fBClickTabFocus\fR: click para enfocar las pestanias +.TP 4 +\(bu + +\fBMouseTabFocus\fR: el foco de las pestanias sigue el movimiento del mouse +Hay una opcion mas en el menu de Focus Model. Se llama AutoRaise. Cuando AutoRaise esta habilitada las ventanas enfocadas apareceran por encima de otras ventanas en la misma capa. Cuando esta deshabilitada se debe alzar explicitamente una ventana en foco usando el menu \fIWindow\fR o una combinacion de teclas. +.sp +.SH "TAB OPTIONS" +Esta seccion del menu de configuracion de fluxbox nos permite configurar muchas de las caracteristicas de las tabs. Dentro de ella hay tres opciones principales: +.sp +.TP 4 +\(bu + +\fBPlacement\fR: se puede elegir donde deben estar ubicadas las tabs externas. Las opciones son +.RS 4 +.TP 4 +\(bu +Top Left: las tabs se encuentran a la izquierda del borde superior de la ventana. +.TP 4 +\(bu +Top Right: las tabs se encuentran a la derecha del borde superior de la ventana. +.TP 4 +\(bu +Left Top: las tabs se encuentran en la parte superior del borde izquierdo de la ventana. +.TP 4 +\(bu +Right Top: las tabs se encuentran en la parte superior del borde derecho de la ventana. +.TP 4 +\(bu +Left Bottom: las tabs se encuentran en la parte inferior del borde izquierdo de la ventana. +.TP 4 +\(bu +Right Bottom: las tabs se encuentran en la parte inferior del borde derecho de la ventana. +.TP 4 +\(bu +Bottom Left: las tabs se encuentran a la izquierda del borde inferior de la ventana. +.TP 4 +\(bu +Bottom Right: las tabs se encuentran a la derecha del borde inferior de la ventana. +.sp +.RS 4 +.nf +para que estas opciones funcionen la opcion 'Tabs in Titlebar' debe estar desactivada. +.fi +.RE +.RE +.TP 4 +\(bu + +\fBTabs in Titlebar\fR: cuando esta opcion esta activada las tabs estan fijas en la barra de titulo y su ancho varia de acuerdo a la cantidad de ventanas agrupadas. +.TP 4 +\(bu + +\fBExternal Tab Width\fR: especifica en pixels el ancho de las tabs externas. +Como la mayoría de las configuraciones de fluxbox(1) esto se puede hacer editando el archivo init. Los recursos que debemos buscar son: +.sp +.sp +.RS 4 +.nf +session.screen0.tabs.intitlebar: <booleana> +session.screen0.tab.width: <entero> +session.screen0.tab.placement: <direccion> +.fi +.RE +.SH "ESTILOS" +Fluxbox permite usar archivos especializados (estilos) que contienen recursos de las X(1) para especificar colores, texturas, pixmaps y fuentes, y por lo tanto el aspecto de los bordes de ventanas, menus y la barra de tareas. +.sp +La instalacion de Fluxbox por defecto provee algunos de estos archivos de estilos. Ver fluxstyle(1) para conocer el creciente numero de componentes de estilos. +.sp +.SH "APLICACIONES" +Es posible forzar una aplicacion para que siempre tenga las mismas dimensiones, posicion, y otras configuraciones cuando es lanzada por primera vez. Esto se hace usando el submenu \fIRemember \&...\fR del menu \fIwindow\fR, o directamente usando el archivo ~/.fluxbox/apps. Se debe tener cuidado de editar el archivo apps cuando Fluxbox no se esta ejecutando, de otro modo nuestros cambios seran sobreescritos. A continuacion se listan las entradas validas para el mencionado archivo. El submenu \fIRemember \&...\fR tiene entradas para la mayoria de las opciones que se almacenan en \fIapps\fR para cargarse la proxima vez. +.sp +El formato de una linea en \fIapps\fR es: +.sp +.sp +.RS 4 +.nf +[app] (aplicacion) {count \- opcional} + [Propiedad1] {valor1} + [Propiedad2] {valor2} + ... +[end] +.fi +.RE +Cada \fIaplicacion\fR puede ser una cadena o una expresion regular. Por defecto el nombre se hace coincidir con una propiedad de ventana WM_CLASS (la primer cadena en ella, llamada "instancia"). Se puede emparejar contra el titulo, nombre de instancia (por defecto), nombre de clase o rol (la propiedad WM_WINDOW_ROLE) especificandola explicitamente. Tambien se puede especificar multiples coincidencias, de las cuales TODAS deben coincidir con las propiedades a ser aplicadas. Si una \fIcount\fR es suministrada entre llaves al final de la linea de la aplicacion entonces la entrada coincidira con, como mucho, con la dada cantidad en cualquier momento (por defecto coincidiran todas las ventanas que encajen en dicho perfil). +.sp +.sp +.RS 4 +.nf +# coincidir una xterm estandar +[app] (xterm) + +# coincidir con una xterm iniciada como: xterm \-nombre myshell +[app] (myshell) + +# coincidir con cualquier ventana de Firefox (el nombre de la instancia es "Gecko") +[app] (class=Firefox\-bin) {1} + +# coincidir con la ventana 'buddy list' de gaim +[app] (role=buddy_list) + +# coincidir en una ventana rdesktop en un host determinado +[app] (title=rdesktop \- nombre_de_host.*) +.fi +.RE +Las siguientes son las propiedades que pueden ser definidas en cada entrada [app]. Cada nombre debe estar encerrado entre corchetes, y valor generalmente entre llaves: +.sp +.TP 4 +\(bu +[Workspace] {0\-N}: Fuerza la aplicacion a que se habra en un workspace especificado. Los workspaces se indican con numero empezando desde 0. +.TP 4 +\(bu +[Dimensions] {Ancho Alto}: Abre la aplicacion con la altura y ancho especificados, en pixels. +.TP 4 +\(bu +[Position] (\fBpunto de referencia\fR) {X Y} Posiciona la aplicacion en un punto determinado: +.RS 4 +.TP 4 +\(bu +WINCENTER +.TP 4 +\(bu +CENTER +.TP 4 +\(bu +UPPERLEFT +.TP 4 +\(bu +UPPERRIGHT +.TP 4 +\(bu +LOWERLEFT +.TP 4 +\(bu +LOWERRIGHT +.sp +.RS 4 +.nf +Opcionalmente se de pueden especificar los valores realativos de X e Y. +UPERLEFT localiza la esquina superior izquierda en las coordenadas de +pantalla (0,0). Si se especifica LOWERRIGHT, entonces la esquina inferior +derecha de la ventana se posicionara en la esquina inferior derecha de la +pantalla. CENTER coloca la esquina superior izquierda en el centro de la +pantalla (WINCENTER actua como el resto \- posiciona el centro de la ventana +relativo la centro de la pantalla). +.fi +.RE +.RE +.TP 4 +\(bu +Especifica la capa en que se abrira la ventana (por numero). Cada capa tiene un numero. Las capas con nombre son: 2\-AboveDock, 4\-Dock, 6\-Top, 8\-Normal, 10\-Bottom, 12\-Desktop. +.TP 4 +\(bu +[Shaded] {yes|no}: La ventana inicia foldedada (enrollada) o desenrrollada. +.TP 4 +\(bu +[Tab] {yes|no}: Indica si esta ventana puede ser agrupada en pestanias con otras. +.TP 4 +\(bu +[IconHidden] {yes|no}: Esconde la aplicacion de la barra de iconos. +.TP 4 +\(bu +[FocusHidden] {yes|no}: Esconde la aplicacion de la lista de ciclo de ventanas usando la combinacion de teclas Next/PrevWindow +.TP 4 +\(bu +[Hidden] {yes|no}: es ambas [IconHidden] mas [FocusHidden] +.TP 4 +\(bu +[Deco] {NONE|NORMAL|TOOL|TINY|BORDER}: Especifica el estado de decoracion. Hay muchos sets de decoracion predefinidos: +.sp +.RS 4 +.nf +o NORMAL \- decoraciones estandard +o NONE \- sin decoraciones +o BORDER \- como NONE solo que mantiene el borde de X window +o TINY \- Barra de titulo con boton de iconificar +o TOOL \- solamente barra de titulo +.fi +.RE +.sp +.RS 4 +.nf +Tambien puede ser usada una mascara de bit para un control mas fino. +los bits son (de "1" a 1<<10): barra de titulo, grips de manipulacion, borde, +boton de iconificar, boton de maximizar, boton de cerrar, menu activado, +boton pegajoso, boton de foldeo, solapas activadas, foco activado. +.fi +.RE +.TP 4 +\(bu +[Sticky] {si|no}: Si la ventana inicialmente esta en modo pegajoso (aparece en todos los escritorios) o no. +.TP 4 +\(bu +[Jump] {si|no}: Saltar a un workspace. Esto es util solamente si +\fIWorkspace tambien esta activado\fR. El workspace es cambiado al que tiene la aplicacion que esta siendo lanzada. +.TP 4 +\(bu +[Close] {si|no}: Guarda la configuracion al salir. Por defecto, las configuraciones de aplicacion no son guardadas cuando se cierra la ventana. +El archivo apps tambien permite especificar aplicaciones que deben ser iniciadas en el puede especificar la pantalla, no el workspace en que la aplicacion debe ser iniciada. Startup todavia no es configurable a traves del menu. +.sp +Finalmente, se puede configurar las ventanas para que se agrupen usando \fIapps\fR. Esto se logra con expresiones regulares usando: +.sp +.sp +.RS 4 +.nf +[app] (propiedad=expresion) ... {numero} +.fi +.RE +Propiedad puede ser uno de los siguientes tags: +.sp +o name \- el nombre de la ventana (el primer campo de WM_CLASS) o class \- clase de la ventana (el segundo campo de WM_CLASS) o title \- titulo de la ventana (propiedad WM_NAME) o role \- rol de la ventana (la propiedad WM_WINDOW_ROLE) +.sp +Si no se especifica ninguna \fIpropiedad\fR, es asumida la propiedad name. Podemos averiguar los valores de estos campos para una ventana particular ejecutando xprop. +.sp +Tambien se puede colocar el tag [group] alrededor de varias tags [app] con el tag [end] para indicar el final del grupo. Tambien podemos especificar dimensiones, posiciones, etc. para el grupo como para las entradas app normales. A continuacion se lista un corto ejemplo de un archivo \fIapps\fR: +.sp +.sp +.RS 4 +.nf +[startup] {xterm} +# coincidir con cualquiera que termine en term, hasta dos instancias +[app] (.*[tT]erm) {2} +# coincidir con cualquiera que tenga 'gaim' en el titulo +[app] (title=.*gaim.*) +[app] (kate) + [Dimensions] (WINCENTER) {1022 747} + [Position] {0 0} + [Close] {yes} +[end] +[app] (konqueror) + [Workspace] {1} + [Dimensions] {1006 749} + [Position] {16 0} + [Jump] {yes} +[end] +# iniciar todas las aterm sin decoraciones de ventana +[app] (aterm) + [Deco] {NONE} +[end] +# un grupo con todas las ventanas denominadas "special\-term", +# aparece en layer 4 (abajo) +[group] +[app] (special\-term) + [Layer] {4} +[end] +.fi +.RE +Los parametros en el archivo apps distinguen mayusculas de minusculas. Los nombres de las aplicaciones son tomados del primer atributo WM_CLASS de X window por defecto (WM_NAME = title, WM_WINDOW_ROLE = role). Se puede ver este atributo usando el comando xprop. Las ventanas temporales no son afectadas por las configuraciones de aplicaciones. Se debe tener cuidado cuando se usan expresiones regulares. Si no se esta familiarizado con ellas se puede desactivar esta caracteristica especificando \-\-disable\-regexp during configure. Entonces se haran coincidir lineas de texto plano. +.sp +.SH "GRUPOS" +Desde la version 0.1.11, Fluxbox tiene una funcion llamada autogrouping, mediante la cual las agrupaciones son agrupadas juntas si estan en el mismo grupo. NOTA: esta funcion esta en desuso desde la version 0.9.1 en favor del agrupamiento usando el archivo apps, ya que es mucho mas potente. +.sp +Se pueden crear grupos simplemente editando el archivo ~/.fluxbox/groups. Este archivo el siguiente formato: +.sp +.sp +.RS 4 +.nf +<aplicacion1> <aplicacion2> <aplicacion3> <...> <aplicacionN> +.fi +.RE +donde los elementos pueden ser encontrados con el siguiente comando: +.sp +.sp +.RS 4 +.nf +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +$> xprop WM_CLASS +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +.fi +.RE +Solo se tipea este comando en una terminal y se usa el mouse para clickear en la aplicacion deseada y nos dira que escribir como elemento (usar los primeros dos nombres que devuelva). Cada linea forma un grupo diferente. por ej.: +.sp +.sp +.RS 4 +.nf +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +Navigator nedit +xterm +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +.fi +.RE +Esto creara dos grupos, uno con netscape y nedit y otro con xterm. La nueva ventana solamente se agrupara con otras ventanas en el mismo workspace y con la ultima ventana enfocada. +.sp +.SH "LA SLIT" +La slit es una marco de ventana especial de FLuxbox que puede contener aplicaciones dockeables, por ej. \fIbbtools\fR o \fIwmapps\fR. +.sp +Cuando las aplicaciones se ejecutan en la slit no tienen bordes de ventana propios; en cambio estan enmarcadas en la slit, y estan siempre visibles en el workspace actual. +.sp +Se puede hacer click con el boton 3 del mouse en el borde de ventana de la slit para obtener un menu para determinar su posicion, si las aplicaciones contenidas deben estar agrupadas horizontal o verticalmente y si la slit debe auto ocultarse cuando el mouse no esta sobre ella. +.sp +La mayoria de las aplicaciones dockeables usan la opcion \-w para correr en la slit. Por ejemplo podriamos poner lo siguiente en ~/.xinitrc: +.sp +.sp +.RS 4 +.nf +\-\-\-\-\-\-\-\-\-\-\-\-\-\- +bbmail \-w & +bbpager \-w & +wmdrawer & +exec fluxbox +\-\-\-\-\-\-\-\-\-\-\-\-\-\- +.fi +.RE +NOTA: Tambien se puede poner todo esto el script startfluxbox(8). de esta manera en en ~/.xinitrc pondriamos solamente la linea \fIexec startfluxbox\fR. +.sp +Para usar la slit debe estar compilada con fluxbox. Esta es la opcion por defecto. +.sp +.SH "ARCHIVO SLITLIST" +El archivo slitlist de Fluxbox esta disponible para aquellos que usan dockapps en la slit. Esto ayuda a Fluxbox a rastrear el \fBorden\fR de los dockapps que se quieren iniciar. El archivo esta localizado generalmente en ~/.fluxbox/slitlist +.sp +Un procedimiento simple para obtener la secuencia de la slit del modo que queremos es el siguiente: +.sp +.TP 4 +1. +Ejecutamos Fluxbox sin iniciar ningun dockapp. +.TP 4 +2. +Ejecutamos los dockapps individualmente en el orden que queremos. +.TP 4 +3. +Agregamos los dockapps en nuestro script auto\-inicio (si tenemos uno), o mejor aun, los agregamos al script startfluxbox(8). +Esta secuencia sera guardada por defecto en ~/.fluxbox/slitlist y sera mantenida en futuras versiones de Fluxbox. +.sp +Los usuarios son libres de editar manualmente el archivo slitlist. Es una simple lista de nombres de ventanas, una por dockapp. Al igual que el archivo init no deberia ser editado mientras se esta ejecutando Fluxbox. De otro modo los cambios podrian sobreescribirse. +.sp +El usuario tambien tiene la opcion de elegir una ruta diferente para slitlist. La siguiente es la componente del archivo init que deber ser cambiado +.sp +.sp +.RS 4 +.nf +session.session0.slitlistfile: <ruta_al_archivo> +.fi +.RE +.SH "ENTORNO" +.PP +HOME +.RS 4 +Fluxbox usa HOME para encontrar su archivo .fluxbox/init y para resolver los nombres de archivo y de directorio. +.RE +.PP +DISPLAY +.RS 4 +Cuando no se ha especificado otro display en la linea de comandos, Fluxbox iniciara en el display indicado en esta variable. +.RE +Fluxbox tambien puede tomar ventaja de otras variables de entorno si son seteadas antes de que inicie. Por ejemplo, si $XTERM es seteada, entonces Fluxbox permitira que $XTERM sea usada en los archivos keys y menu. Entonces podriamos hacer: +.sp +.sp +.RS 4 +.nf +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +Mod1 x :ExecCommand $XTERM +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +.fi +.RE +Las formas de usar esto de manera practica e \fIinteligente\fR son interminables. +.sp +.SH "SENIALES" +Fluxbox reconoce las siguiente seniales: +.sp +.TP 4 +\(bu +SIGHUP Fluxbox carga la configuracion. +.TP 4 +\(bu +SIGUSR1 Fuerza la recarga de la configuracion. +.TP 4 +\(bu +SIGUSR2 Fuerza la recarga del archivo menu. +.SH "AUTOR Y CREDITOS" +Fluxbox es escrito y mantenido por Henrik Kinnunen <fluxgen@fluxbox.org>, Simon Bowden <rathnor@fluxbox.org> y Mathias Gumz <akira@fluxbox.org>; con contribuciones y parches hechos por muchos individuos alrededor del mundo. +.sp +Blackbox fue escrito y mantenido por Brad Hughes <blackbox@alug.org> y Jeff Raven <jraven@psu.edu> +.sp +Sitio oficial de Fluxbox: http://www.fluxbox.org +.sp +Temas compatibles: \- http://boxwhore.org \- http://themes.freshmeat.net +.sp +Este manpage es el trabajo combinado de: +.sp +.TP 4 +\(bu +Curt Micol <asenchi@asenchi.com> (>fluxbox\-0.9.11) +.TP 4 +\(bu +Tobias Klausmann <klausman@users.sourceforge.net> (<=fluxbox\-0.9.11) +.TP 4 +\(bu +Grupert <grubert@users.sourceforge.net> (fluxbox) +.TP 4 +\(bu +Matthew Hawkins <matt@mh.dropbear.id.au> (blackbox) +.TP 4 +\(bu +Wilbert Berendsen <wbsoft@xs4all.nl> (blackbox) +Traduccion al espaniol realizada por: +.sp +.TP 4 +\(bu +Guillermo Patterer <gmpatterer@gmail.com> +.TP 4 +\(bu +Matias Brutti <matiasbrutti@gmail.com> +Por razones de compatibilidad se han omitido todos los caracteres especiales, por ej. acentos, especificos del idioma espaniol. De esta manera nos aseguramos que este manpage se vea lo mejor posible. +.sp +.TP 4 +\(bu +Muchos otros lenguajes podrian estar disponible si algun voluntario estuviera dispuesto. +.SH "BUGS" +Si se encuentran bugs, por favor visitar el canal de irc #fluxbox en irc.freenode.net. O pueden suscribirse a alguna de las listas de correo. Se puede encontrar mas informacion en el sitio web oficial. +.sp +.SH "VER TAMBIEN" +bsetroot(8) fbsetbg(8) fbrun(8) fluxstyle(8) +.sp
M doc/asciidoc/fluxbox.es.txtdoc/asciidoc/fluxbox.es.txt

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

fluxbox(1) ========= fluxgen <fluxgen@fluxbox.org> -v1.0rc3, Abril 16 de 2007 +v1.0rc3, Abril 21 de 2007 NAME ------ -Fluxbox - Un liviano manejador de ventanas para el X Windowing System +fluxbox - Un liviano manejador de ventanas para el X Windowing System SYNOPSIS --------
M doc/asciidoc/fluxbox.txtdoc/asciidoc/fluxbox.txt

@@ -1,7 +1,7 @@

fluxbox(1) ========== Henrik Kinnunen <fluxgen@fluxbox.org> -v1.0rc2, 26th July 2006 +v1.0rc3, 21th April 2007 NAME ----
A doc/asciidoc/fluxstyle.1

@@ -0,0 +1,451 @@

+.\" Title: fluxstyle +.\" Author: +.\" Generator: DocBook XSL Stylesheets v1.71.1 <http://docbook.sf.net/> +.\" Date: 04/21/2007 +.\" Manual: +.\" Source: +.\" +.TH "FLUXSTYLE" "1" "04/21/2007" "" "" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +fluxstyle \- A comprehensive look at styles/themes for fluxbox(1). +.SH "SYNOPSIS" +This document describes various options available for fluxbox styles. +.sp +.SH "DESCRIPTION" +What is a Style? +.sp +Styles, sometimes referred to as Themes, are a graphical overlay for the fluxbox(1) window manager. If you wanted to get to know fluxbox, the styles would be the \fIlook\fR of the \fIlook and feel\fR. +.sp +Styles are simple ASCII text files that tell fluxbox(1) how to generate the appearance of different components of the window manager. The default installation of fluxbox(1) is shipped with many classic examples that show a great deal of what one could do. To use one of the standard styles navigate to the \fISystem Styles\fR menu under your main fluxbox(1) menu. +.sp +fluxbox(1) uses its own graphics class to render its images on the fly. By using styles you can determine, at a great level of configurability, what your desktop will look like. Since fluxbox(1) was derived from blackbox many often wonder if old themes will work on the latest releases of fluxbox(1). Well they basically do, but you will have to tune them since the fluxbox(1) code has changed quite a bit since the initial grab. +.sp +.SH "STRUCTURE" +A style is made up of a few major components which then have their own sub\-directives. The major components are as follows: +.sp +The \fIwindow.*\fR directives control the appearance of the window frames, window.tab.* controls the appearance of the window tabs, \fImenu.*\fR controls the appearance of the popup menu that you see when you right click on the desktop. \fItoolbar.*\fR is the bar you will see at the top or bottom of your screen. Finally the \fIslit.*\fR has options you can use to customize the appearance of the slit. However if you don't set the slit directives specifically, the slit's appearance is controlled by the toolbar directives instead. +.sp +To understand how the style mechanism works, it is nice to know a little about how X11 resources work. X11 resources consist of a key and a value. The key is constructed of several smaller keys (sometimes referred to as children), delimited by a period (.). Keys may also contain an asterisk (*) to serve as a wildcard, which means that one line of text will match several keys. This is useful for styles that are based on one or two colors. +.sp +A more complete reference to this can be found in X(7), section \fIRESOURCES\fR. +.sp +.SH "LOCATION" +There are many places to store your styles, the most common is in your \fI~/.fluxbox/styles\fR directory. The initial installation will place the default styles in \fI@pkg_datadir@/styles\fR providing a basic usable configuration. +.sp +When creating your own style, create a directory (normally the name of your style) in \fI~/.fluxbox/styles/\fR (If the \fIstyles\fR directory doesn't exist, create that also). While there isn't an official structure, it is common to create a directory named after your style and place your pixmaps directory (if required) in there along with a file called theme.cfg (may also be named style.cfg). This file is where you will construct your style using the components covered later in this manual page. An example of steps taken when beginning a style project of your own may look like: +.sp +.sp +.RS 4 +.nf +$ cd +$ mkdir \-p ~/.fluxbox/styles/YourStyle/pixmaps +$ cd ~/.fluxbox/styles/YourStyle +$ nano theme.cfg +.fi +.RE +Output of a packaged style should look like the following: +.sp +.sp +.RS 4 +.nf +$ cd +$ tar \-tjvf YourStyle.tar.bz2 + .fluxbox/styles/YourStyle/theme.cfg + .fluxbox/styles/YourStyle/pixmaps + .fluxbox/styles/YourStyle/pixmaps/stick.xpm + ... +.fi +.RE +Of course, all of these are just preferences, fluxbox(1) allows for the customization of many things, including how you handle your styles. Just remember, however, that if you plan to distribute your style you may find some community bickering if you don't follow practices. :) +.sp +.SH "CREATING YOUR STYLE" +As discussed above, fluxbox(1) allows you to configure its four main components: the toolbar, menus, slit and window decorations. Remember that you can customize the slit with its own directives, otherwise the slit will take the appearance of the toolbar. +.sp +Here are some quick examples to illustrate basic syntax: +.sp +.sp +.RS 4 +.nf +toolbar.clock.color: green +.fi +.RE +This sets the color resource of the toolbar clock to \fIgreen\fR. Another example: +.sp +.sp +.RS 4 +.nf +menu*color: rgb:3/4/5 +.fi +.RE +This sets the color resource of the menu and all of its \fIchildren\fR to `rgb:3/4/5'. (For a description of color names, see X(1).) So this one also applies to \fImenu.title.color\fR and \fImenu.frame.color\fR. And with +.sp +.sp +.RS 4 +.nf +*font: \-b&h\-lucida\-medium\-r\-normal\-*\-*\-140\-* +.fi +.RE +you set the font resource for all keys to this font name all at once (For information about the fonts installed on your system, you can use a program like xfontsel(1), gtkfontsel, or xlsfonts(1).) +.sp +In the last example you will notice the wildcard (*) before font. In a Fluxbox style you can set a value with a wildcard. The example means that every font in the style will be what is specified. You can do this with any component/value. For example if you wanted all of the text to be one color you would do: +.sp +.sp +.RS 4 +.nf +*textColor: rgb:3/4/5 +.fi +.RE +This means that you can setup a very simple style with very few properties. See the EXAMPLES below for an example of this in practice. fluxbox(1) also allows you to override wildcards in your style. Lets take our example above and add an override for the toolbar.clock.textColor component: +.sp +.sp +.RS 4 +.nf +*textColor: rgb:3/4/5 +toolbar.clock.textColor: rgb:255/0/0 +.fi +.RE +With that all of the text will be \fIrgb:3/4/5\fR except the toolbar clock text which will be \fIrgb:255/0/0\fR. +.sp +Now what makes fluxbox(1) so spectacular is its ability to render textures on the fly. A texture is a fillpattern that you see on some styles. Texture descriptions are specified directly to the key that they should apply to, e.g.: +.sp +.sp +.RS 4 +.nf +toolbar.clock: Raised Gradient Diagonal Bevel1 +toolbar.clock.color: rgb:8/6/4 +toolbar.clock.colorTo: rgb:4/3/2 +.fi +.RE +Don't worry, we will explain what these mean. A texture description consists of up to five fields, which are as follows: +.sp +.PP +\fBFlat | Raised | Sunken\fR. gives the component either a flat, raised or sunken appearance. +.PP +\fBGradient | Solid\fR. tells fluxbox(1) to draw either a solid color or a gradient texture. +.PP +\fBHorizontal | Vertical | Diagonal | Crossdiagonal | Pipecross | Elliptic | Rectangle | Pyramid\fR. Select one of these texture types. They only work when +\fBGradient\fR +is specified. +.PP +\fBInterlaced\fR. tells fluxbox(1) to interlace the texture (darken every other line). This option is most commonly used with gradiented textures, but it also works in solid textures. +.PP +\fBBevel1 | Bevel2\fR. tells fluxbox(1) which type of bevel to use. Bevel1 is the default bevel. The shading is placed on the edge of the image. Bevel2 is an alternative. The shading is placed one pixel in from the edge of the image. +Instead of a texture description, also the option \fBParentRelative\fR is available, which makes the component appear as a part of its parent, e.g. totally transparent. +.sp +Or for even more possibilities Pixmap. If pixmap texture is specified (it might not be necessary on every occasion) the pixmap file is specified in a separate pixmap resource. +.sp +.sp +.RS 4 +.nf +toolbar.clock: pixmap +toolbar.clock.pixmap: clock_background.xpm +.fi +.RE +This feature might need some investigation, reports say that sometimes the resources color and colorTo must be set and then they may not be set. +.sp +All gradiented textures are composed of two color values: the \fIcolor\fR and \fIcolorTo\fR resources. When \fBInterlaced\fR is used in \fBSolid\fR mode, the \fIcolorTo\fR resource is used to find the interlacing color. +.sp +.SH "A WORD ABOUT FONTS" +We should comment about fonts before we move on to the complete component list. fluxbox(1) supports different options for text. These options currently include bold, halo and shadow. To set these do this: fontname\-size:options for any of the font components in the style file. For example: +.sp +.sp +.RS 4 +.nf +menu.title.font: sans\-8:bold,shadow +.fi +.RE +The latest versions of fluxbox(1) (> 0.9.8) also support different values for these text options. The possibilities are as follows: +.sp +.sp +.RS 4 +.nf +\-\-\-\-\-\-\-\- +Shadow color=<colorname> offsetx=<integer> offsety=<integer> Halo color=<colorname> +\-\-\-\-\-\-\-\- +.fi +.RE +For the case of completeness, here are some real world examples: +.sp +.sp +.RS 4 +.nf +*.font: Verdana\-10:bold,shadow:offsetx=2;offsety=4;color=green +*.font: Verdana\-10:halo:color=blue +.fi +.RE +Of course this could all be placed on one line. Also note that for the offset options, negative integers are allowed. +.sp +.SS "FONT PROBLEMS" +If you have problems installing fonts or getting them to work, you should read the docs page at xfree.org. Here is a link to one of these: \fIhttp://xfree.org/4.3.0/fonts2.html#3\fR +.sp +.SH "FULL COMPONENT LIST" +Here is the exhaustive component list for fluxbox(1) styles. Each one is listed with their type of value required. Comments in a style file are preceded with an exclamation point (!) which we also use here so that these can be pasted into a new theme.cfg to be customized appropiately. Please note that in order to keep styles consistent it is often the practice of stylists to provide all of the theme\-items in their style file even if they are not used. This allows the user the ease of changing different components. +.sp +.SH "WINDOW OPTIONS" +Many, many things you can do with window design in fluxbox(1), below are your options. Have fun. +.sp +.sp +.RS 4 +.nf +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +window.bevelWidth: <integer> +window.borderColor: <color> +window.borderWidth: <integer> +window.button.focus: <texture type> +window.button.focus.color: <color> +window.button.focus.colorTo: <color> +window.button.focus.picColor: <color> +window.button.focus.pixmap: <filename> +window.button.pressed: <texture type> +window.button.pressed.color: <color> +window.button.pressed.colorTo: <color> +window.button.pressed.pixmap: <filename> +window.button.unfocus: <texture type> +window.button.unfocus.color: <color> +window.button.unfocus.colorTo: <color> +window.button.unfocus.picColor: <color> +window.button.unfocus.pixmap: <filename> +window.close.pixmap: <filename> +window.close.pressed.pixmap: <filename> +window.close.unfocus.pixmap: <filename> +window.font: <font> +window.frame.focusColor: <color> +window.frame.unfocusColor: <color> +window.grip.focus: <texture type> +window.grip.focus.color: <color> +window.grip.focus.colorTo: <color> +window.grip.focus.pixmap: <filename> +window.grip.unfocus: <texture type> +window.grip.unfocus.color: <color> +window.grip.unfocus.colorTo: <color> +window.grip.unfocus.pixmap: <filename> +window.handle.focus: <texture type> +window.handle.focus.color: <color> +window.handle.focus.colorTo: <color> +window.handle.focus.pixmap: <filename> +window.handle.unfocus: <texture type> +window.handle.unfocus.color: <color> +window.handle.unfocus.colorTo: <color> +window.handle.unfocus.pixmap: <filename> +window.handleWidth: <integer> +window.iconify.pixmap: <filename> +window.iconify.pressed.pixmap: <filename> +window.iconify.unfocus.pixmap: <filename> +window.justify: <{Left|Right|Center}> +window.label.active: <texture type> +window.label.active.textColor: <color> +window.label.focus: <texture type> +window.label.focus.color: <color> +window.label.focus.colorTo: <color> +window.label.focus.pixmap: <filename> +window.label.unfocus: <texture type> +window.label.unfocus.color: <color> +window.label.unfocus.colorTo: <color> +window.label.unfocus.pixmap: <filename> +window.label.focus.textColor: <color> +window.label.unfocus.textColor: <color> +window.maximize.pixmap: <filename> +window.maximize.pressed.pixmap: <filename> +window.maximize.unfocus.pixmap: <filename> +window.roundCorners: <{Top|Bottom}{Left|Right}> +window.shade.pixmap: <filename> +window.shade.pressed.pixmap: <filename> +window.shade.unfocus.pixmap: <filename> +window.stick.pixmap: <filename> +window.stick.pressed.pixmap: <filename> +window.stick.unfocus.pixmap: <filename> +window.stuck.pixmap: <filename> +window.stuck.unfocus.pixmap: <filename> +window.title.focus: <texture type> +window.title.focus.color: <color> +window.title.focus.colorTo: <color> +window.title.focus.pixmap: <filename> +window.title.height: <integer> +window.title.unfocus: <texture type> +window.title.unfocus.color: <color> +window.title.unfocus.colorTo: <color> +window.title.unfocus.pixmap: <filename> +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +.fi +.RE +.SH "MENU OPTIONS" +Everything you need to make your menu look pretty. +.sp +.sp +.RS 4 +.nf +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +menu.bevelWidth: <integer> +menu.borderColor: <color> +menu.borderWidth: <integer> +menu.bullet: <{empty|square|triangle|diamond}> +menu.bullet.position: <{left|right}> +menu.frame: <texture type> +menu.frame.color: <color> +menu.frame.colorTo: <color> +menu.frame.disableColor: <color> +menu.frame.font: <font> +menu.frame.justify: <{Left|Right|Center}> +menu.frame.pixmap: <filename> +menu.frame.textColor: <color> +menu.hilite: <texture type> +menu.hilite.color: <color> +menu.hilite.colorTo: <color> +menu.hilite.pixmap: <filename> +menu.hilite.textColor: <color> +menu.itemHeight: <integer> +menu.title: <texture type> +menu.title.color: <color> +menu.title.colorTo: <color> +menu.title.font: <font> +menu.title.pixmap: <filename> +menu.title.textColor: <color> +menu.title.justify: <{Left|Right|Center}> +menu.titleHeight: <integer> +menu.roundCorners: <{Top|Bottom}{Left|Right}> +menu.selected.pixmap: <filename> +menu.submenu.pixmap: <filename> +menu.unselected.pixmap: <filename> +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +.fi +.RE +.SH "BACKGROUND" +Every style must specify the background option. If you don't want your style to change the user's background, then use `background: none'. The options `centered', `aspect', `tiled', and `fullscreen' require the `background.pixmap' resource to contain a valid file name. The `random' option requires `background.pixmap' to contain a valid directory name. For these options, fluxbox(1) will call fbsetbg(1) to set the background. The options `gradient', `solid', and `mod' all require `background.color' to be set. `gradient' and `mod' both require `background.colorTo'. `mod' requires `background.modX' and `background.modY' to be set as well. These options will be passed to fbsetroot(1) to set the background. +.sp +.sp +.RS 4 +.nf +background: centered|aspect|tiled|fullscreen|random|solid|gradient <texture>|mod|none +background.pixmap: <file or directory> +background.color: <color> +background.colorTo: <color> +background.modX: <integer> +background.modY: <integer> +.fi +.RE +.SH "SLIT" +Here are all of the options for the slit. +.sp +.sp +.RS 4 +.nf +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +slit: <texture type> +slit.bevelWidth: <integer> +slit.borderColor: <color> +slit.borderWidth: <integer> +slit.color: <color> +slit.colorTo: <color> +slit.pixmap: <filename> +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +.fi +.RE +.SH "TOOLBAR OPTIONS" +Below you will find all of the configuration possibilities for the toolbar. The list is pretty extensive and offers you many options to make your toolbar look just the way you want it. +.sp +.sp +.RS 4 +.nf +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +toolbar: <texture type> +toolbar.bevelWidth: <integer (0\-255)> +toolbar.borderColor: <color> +toolbar.borderWidth: <integer> +toolbar.button.scale: <integer> +toolbar.color: <color> +toolbar.colorTo: <color> +toolbar.clock: <texture type> +toolbar.clock.borderColor: <color> +toolbar.clock.borderWidth: <integer> +toolbar.clock.font: <font> +toolbar.clock.justify: <{Left|Right|Center}> +toolbar.clock.pixmap: <filename> +toolbar.clock.color: <color> +toolbar.clock.colorTo: <color> +toolbar.clock.textColor: <color> +toolbar.height: <integer> +toolbar.iconbar.focused: <texture type> +toolbar.iconbar.focused.color: <color> +toolbar.iconbar.focused.colorTo:<color> +toolbar.iconbar.focused.pixmap: <filename> +toolbar.iconbar.unfocused: <texture type> +toolbar.iconbar.unfocused.color: <color> +toolbar.iconbar.unfocused.colorTo: <color> +toolbar.iconbar.unfocused.pixmap: <filename> +toolbar.iconbar.empty: <texture type> +toolbar.iconbar.empty.color: <color> +toolbar.iconbar.empty.colorTo: <color> +toolbar.iconbar.empty.pixmap: <filename> +toolbar.iconbar.focused.borderColor: <color> +toolbar.iconbar.focused.borderWidth: <integer> +toolbar.iconbar.unfocused.borderColor: <color> +toolbar.iconbar.unfocused.borderWidth: <integer> +toolbar.iconbar.borderColor: <color> +toolbar.iconbar.borderWidth: <integer> +toolbar.iconbar.focused.font: <font> +toolbar.iconbar.focused.justify: <{Left|Right|Center}> +toolbar.iconbar.focused.textColor: <color> +toolbar.iconbar.unfocused.font: <font> +toolbar.iconbar.unfocused.justify: <{Left|Right|Center}> +toolbar.iconbar.unfocused.textColor: <color> +toolbar.pixmap: <filename> +toolbar.shaped: <boolean> +toolbar.workspace.font: <font> +toolbar.workspace.justify: <{Left|Right|Center}> +toolbar.workspace.textColor: <color> +toolbar.workspace: <texture type> +toolbar.workspace.borderColor: <color> +toolbar.workspace.borderWidth: <integer> +toolbar.workspace.color: <color> +toolbar.workspace.colorTo: <color> +toolbar.workspace.pixmap: <filename> +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +.fi +.RE +.SH "EXAMPLES" +This list may seem intimidating, but remember, when you create your own style you can easily set a majority of these keys with a single component. For an example of this: +.sp +.sp +.RS 4 +.nf +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +*color: slategrey +*colorTo: darkslategrey +*unfocus.color: darkslategrey +*unfocus.colorTo: black +*textColor: white +*unfocus.textColor: lightgrey +*font: lucidasans\-10 +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- +.fi +.RE +This sets nice defaults for many components. +.sp +.SH "COLOR FORMATS" +These are the color formats for styles: +.sp +.sp +.RS 4 +.nf +#000000 (Hexadecimal) +rgb:<0\-255>/<0\-255>/<0\-255> +.fi +.RE +See /usr/X11R6/lib/X11/rgb.txt for an explaination. +.sp +.SH "AUTHOR AND CREDITS" +Blackbox was written and maintained by Brad Hughes <blackbox@alug.org> and Jeff Raven <jraven@psu.edu>. +.sp +fluxbox(1) is written and maintained by Henrik Kinnunen <fluxgen@fluxbox.org> with contributions and patches merged from many individuals around the world. +.sp +The Official fluxbox(1) website: \fIhttp://www.fluxbox.org\fR You can find a lot of styles here: \fIhttp://tenr.de/\fR +.sp +This manpage was composed from various resources including the official documentation, fluxbox(1) man page and numerous other resources by Curt "Asenchi" Micol. If you notice any errors or problems with this page, please contact him here: <asenchi@asenchi.com> and using the great contributions of <grubert@users.sourceforge.net>. Numerous other languages could be available if someone jumps in. +.sp +.SH "SEE ALSO" +fluxbox(1) fbsetbg(1) fbsetroot(1) +.sp