nilix/fluxbox
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Rename fluxboxstyle to fluxstyle.

Browse source
This commit is contained in:
grubert 2004-02-06 16:10:50 +00:00
parent 54fcccc44e
commit 75a8850001
1 changed files with 219 additions and 177 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

396
doc/fluxboxstyle.1 → doc/fluxstyle.1
View file

@ -1,14 +1,14 @@
.\" .\" AT THE BOTTOM IS ADD ONS TO THE PAGE search /ADDITIONS
.\" Manual page for Fluxbox Styles .\" Manual page for Fluxbox Styles
.\" .\"
.\" Fluxbox is Copyright (c) 2001-2004 Henrik Kinnunen .\" Fluxbox is Copyright (c) 2001-2004 Henrik Kinnunen
.\" Fluxstyle(1) is Copyright (c) 2004 Curtis Micol .\" Fluxstyle(1) is Copyright (c) 2004 Curt Micol
.\" .\"
.\" This manual page is freely distrubted and modified. .\" This manual page is freely distrubted and modified.
.\" Parts of the text are taken from websites and style .\" Parts of the text are taken from websites and style
.\" files on http://www.fluxbox.org and http://www.fluxmod.dk .\" files on http://www.fluxbox.org and http://www.fluxmod.dk
.\" .\"
.\" Created and Updated for version 0.9.7 by Curtis Micol <asenchi@asenchi.com> .\" Created and Updated for version 0.9.7 by Curt Micol <asenchi@asenchi.com>
.\" .\"
.\" Define this: <blockquote><pre> .\" Define this: <blockquote><pre>
.de EX .de EX
@ -26,7 +26,7 @@
.. ..
.\" Begin actual page .\" Begin actual page
.\" .\"
.TH fluxstyle 1 "January 7th, 2004" "0.9.7" .TH fluxstyle 1 "January 7th, 2004" "0.9.8"
.SH NAME .SH NAME
fluxstyle \- all you need to know about Fluxbox styles fluxstyle \- all you need to know about Fluxbox styles
.SH DESCRIPTION .SH DESCRIPTION
@ -91,12 +91,17 @@ providing a default configureation at installation.
.PP .PP
Once you create your own, you can create a directory in Once you create your own, you can create a directory in
.IR ~/.fluxbox/ .IR ~/.fluxbox/
called 'styles'. Place your styles here and you will be able to access them from the configure called 'styles'. While there isn't an official structure of how to package your style, one way that is recommended is creating a directory named after your style and placing your pixmaps directory in there along with a theme.cfg. The theme.cfg file being your created style. So for example if I created a style called 'MyStyle' I would create the following:
portion of the Root Menu called 'User Styles'. This goes true for any directories associated .EX
with your style. An example being, if you create a style with pixmaps, create mkdir -p ~/.fluxbox/styles/MyStyle
.IR ~/.fluxbox/pixmaps cd ~/.fluxbox/styles/MyStyle
and place your pixmaps here. Of course, this means that the path to your pixmaps in your style mkdir pixmaps
file will be the same. vi theme.cfg (this being where you design your style with
the necessary components)
.EE
If you follow this, the path to your pixmaps will be:
.IR ~/fluxbox/styles/MyStyle/pixmaps
which makes it a bit easier to setup up and distribute your style.
.SH CREATING STYLES .SH CREATING STYLES
As discussed in the As discussed in the
@ -207,176 +212,206 @@ mode, the
.I colorTo .I colorTo
resource is used to find the interlacing color. resource is used to find the interlacing color.
.PP .PP
Here is the complete component list, also all components together with .SH A WORD ABOUT FONTS
which kind of value they can contain. We should comment about fonts before we move on to the complete component
list.
.PP
Fluxbox supports different options for text. These options currently include bold and shadow. To set these do this, fontname-size:options, for any of the font components in the style file. For example:
.EX
menu.title.font: sans-8:bold,shadow
.EE
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 complete component list, together with which kind of value they take.
Comments are preceded with an exclamation sign (!), which is also used for Comments are preceded with an exclamation sign (!), which is also used for
comments in Fluxbox style c.q. X resource files. comments in Fluxbox style c.q. X resource files.
.PP .PP
.ta \w'window.button.unfocus.picColor:\ 'u
.nf
.\"
.\" The comments also to be translated! .\" The comments also to be translated!
.\" .SS WINDOW OPTIONS
! The toolbar itself Many, many things you can do with window design in Fluxbox, below are your options. Have fun.
toolbar: Texture .EX
toolbar.color: Color window.label.focus: <texture type>
toolbar.colorTo: Color window.label.focus.pixmap: <filename>
window.label.focus.color: <color>
! The buttons on the toolbar window.label.focus.colorTo: <color>
toolbar.button: Texture or \fIParentRelative\fR window.label.unfocus: <texture type>
toolbar.button.color: Color window.label.unfocus.pixmap: <filename>
toolbar.button.colorTo: Color window.label.unfocus.color: <color>
window.label.unfocus.colorTo: <color>
! Color of the button arrows window.title.focus: <texture type>
toolbar.button.picColor: Color window.title.focus.pixmap: <filename>
window.title.focus.color: <color>
! Buttons in pressed state window.title.focus.colorTo: <color>
toolbar.button.pressed: Texture \fI(e.g. Sunken)\fR or \fIParentRelative\fR window.title.unfocus: <texture type>
toolbar.button.pressed.color: Color window.title.unfocus.pixmap: <filename>
toolbar.button.pressed.colorTo: Color window.title.unfocus.color: <color>
window.title.unfocus.colorTo: <color>
! Color of pressed button arrows window.handle.focus: <texture type>
toolbar.button.pressed.picColor: Color window.handle.focus.pixmap: <filename>
window.handle.focus.color: <color>
! The toolbar workspace label window.handle.focus.colorTo: <color>
toolbar.label: Texture or \fIParentRelative\fR window.handle.unfocus: <texture type>
toolbar.label.color: Color window.handle.unfocus.pixmap: <filename>
toolbar.label.colorTo: Color window.handle.unfocus.color: <color>
toolbar.label.textColor: Color window.handle.unfocus.colorTo: <color>
window.button.focus: <texture type>
! The toolbar window label window.button.focus.pixmap: <filename>
toolbar.windowLabel: Texture or \fIParentRelative\fR window.button.focus.color: <color>
toolbar.windowLabel.color: Color window.button.focus.colorTo: <color>
toolbar.windowLabel.colorTo: Color window.button.unfocus: <texture type>
toolbar.windowLabel.textColor: Color window.button.unfocus.pixmap: <filename>
window.button.unfocus.color: <color>
! The toolbar clock window.button.unfocus.colorTo: <color>
toolbar.clock: Texture or \fIParentRelative\fR window.button.pressed: <texture type>
toolbar.clock.color: Color window.button.pressed.pixmap: <filename>
toolbar.clock.colorTo: Color window.button.pressed.color: <color>
toolbar.clock.textColor: Color window.button.pressed.colorTo: <color>
window.grip.focus: <texture type>
! How the toolbar's text should be justified. window.grip.focus.pixmap: <filename>
toolbar.justify: \fIcenter\fR, \fIleft\fR, or \fIright\fR window.grip.focus.color: <color>
window.grip.focus.colorTo: <color>
! Font to be used for all toolbar components window.grip.unfocus: <texture type>
toolbar.font: Font \fI(e.g. -*-helvetica-medium-r-normal-*-*-100-*)\fR window.grip.unfocus.pixmap: <filename>
window.grip.unfocus.color: <color>
! The menu titlebar window.grip.unfocus.colorTo: <color>
menu.title: Texture window.label.focus.textColor: <color>
menu.title.color: Color window.label.unfocus.textColor: <color>
menu.title.colorTo: Color window.frame.focusColor: <color>
menu.title.textColor: Color window.frame.unfocusColor: <color>
menu.title.font: Font window.button.focus.picColor: <color>
menu.title.justify: \fIcenter\fR, \fIleft\fR, or \fIright\fR window.button.unfocus.picColor: <color>
window.font: <font>
! The menu frame window.justify:
menu.frame: Texture window.roundCorners:
menu.frame.color: Color window.alpha: <integer>
menu.frame.colorTo: Color window.title.height: <integer>
menu.frame.textColor: Color window.bevelWidth: <integer>
menu.frame.disableColor: Color window.handleWidth: <integer>
menu.frame.font: Font window.borderWidth: <integer>
menu.frame.justify: \fIcenter\fR, \fIleft\fR, or \fIright\fR window.borderColor: <color>
window.close.pixmap: <filename>
! Bullets for submenu items window.close.unfocus.pixmap: <filename>
menu.bullet: \fIempty\fR, \fItriangle\fR, \fIsquare\fR, or \fIdiamond\fR window.close.pressed.pixmap: <filename>
menu.bullet.position: \fIright\fR or \fIleft\fR window.maximize.pixmap: <filename>
window.maximize.unfocus.pixmap: <filename>
! The highlighted menu item window.maximize.pressed.pixmap: <filename>
menu.hilite: Texture (e.g. \fIRaised\fR) window.iconify.pixmap: <filename>
menu.hilite.color: Color window.iconify.unfocus.pixmap: <filename>
menu.hilite.colorTo: Color window.iconify.pressed.pixmap: <filename>
menu.hilite.textColor: Color window.shade.pixmap: <filename>
window.shade.unfocus.pixmap: <filename>
! A focused window window.shade.pressed.pixmap: <filename>
window.title.focus: Texture window.stick.pixmap: <filename>
window.title.focus.color: Color window.stick.unfocus.pixmap: <filename>
window.title.focus.colorTo: Color window.stick.pressed.pixmap: <filename>
window.stuck.pixmap: <filename>
! An unfocused window window.stuck.unfocus.pixmap: <filename>
window.title.unfocus: Texture .EE
window.title.unfocus.color: Color .SS MENU OPTIONS
window.title.unfocus.colorTo: Color Everything you need to make your menu look pretty.
.EX
! Window label in window.title menu.title.textColor: <color>
window.label.focus: Texture or \fIParentRelative\fR menu.frame.textColor: <color>
window.label.focus.color: Color menu.hilite.textColor: <color>
window.label.focus.colorTo: Color menu.frame.disableColor: <color>
window.label.focus.textColor: Color menu.title: <texture type>
menu.title.pixmap: <filename>
window.label.unfocus: Texture or \fIParentRelative\fR menu.title.color: <color>
window.label.unfocus.color: Color menu.title.colorTo: <color>
window.label.unfocus.colorTo: Color menu.frame: <texture type>
window.label.unfocus.textColor: Color menu.frame.pixmap: <filename>
menu.frame.color: <color>
! Handlebar menu.frame.colorTo: <color>
window.handle.focus: Texture menu.hilite: <texture type>
window.handle.focus.color: Color menu.hilite.pixmap: <filename>
window.handle.focus.colorTo: Color menu.hilite.color: <color>
menu.hilite.colorTo: <color>
window.handle.unfocus: Texture menu.title.font: <font>
window.handle.unfocus.color: Color menu.frame.font: <font>
window.handle.unfocus.colorTo: Color menu.frame.justify:
menu.title.justify:
! Resize grips menu.bullet.position:
window.grip.focus: Texture menu.bullet:
window.grip.focus.color: Color menu.borderWidth:
window.grip.focus.colorTo: Color menu.bevelWidth:
menu.borderColor: <color>
window.grip.unfocus: Texture menu.submenu.pixmap: <filename>
window.grip.unfocus.color: Color menu.selected.pixmap: <filename>
window.grip.unfocus.colorTo: Color menu.unselected.pixmap: <filename>
menu.roundCorners:
! Window buttons .EE
window.button.focus: Texture or \fIParentRelative\fR .SS ROOT COMMAND OPTION
window.button.focus.color: Color This is how you set your background within your style. Use the official fluxbox background program, fbsetbg. It is distributed with Fluxbox, and can also be downloaded from here: http://www.xs4all.nl/~hanb/software/fluxbox/fbsetbg.html
window.button.focus.colorTo: Color .EX
window.button.focus.picColor: Color rootCommand: <string>
.EE
window.button.unfocus: Texture or \fIParentRelative\fR .SS SLIT
window.button.unfocus.color: Color Here are all of the options for the slit.
window.button.unfocus.colorTo: Color .EX
window.button.unfocus.picColor: Color slit: <texture type>
slit.pixmap: <filename>
window.button.pressed: Texture (e.g. \fISunken\fR) slit.color: <color>
window.button.pressed.color: Color slit.colorTo: <color>
window.button.pressed.colorTo: Color slit.borderWidth: <integer>
slit.bevelWidth: <integer>
! Frame around window slit.borderColor: <color>
window.frame.focusColor: Color .EE
window.frame.unfocusColor: Color .SS 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.
! Font and justification for window labels .EX
window.font: Font toolbar: <texture type>
window.justify: \fIcenter\fR, \fIleft\fR, or \fIright\fR toolbar.pixmap: <filename>
toolbar.color: <color>
! Slit resources toolbar.colorTo: <color>
slit: toolbar.borderWidth: <integer>
slit.color: Color toolbar.borderColor: <color>
slit.colorTo: Color toolbar.bevelWidth: <0-255>
toolbar.shaped: <boolean>
! Miscellaneous resources toolbar.alpha: <integer>
toolbar.height: <integer>
! A border can be drawn round all components toolbar.clock.font: <font>
borderWidth: a number of pixels, e.g. \fI1\fR toolbar.clock.textColor: <color>
borderColor: Color toolbar.clock.justify:
toolbar.clock: <texture type>
bevelWidth: a number of pixels > 0 toolbar.clock.pixmap: <filename>
handleWidth: a number of pixels > 0 toolbar.clock.color: <color>
toolbar.clock.colorTo: <color>
! Width of the window frame toolbar.clock.borderWidth: <integer>
! When not specified, frameWidth defaults to the value of bevelWidth toolbar.clock.borderColor: <color>
frameWidth: a number of pixels >= 0 toolbar.workspace.font: <font>
toolbar.workspace.textColor: <color>
! This command is executed whenever this style is selected. toolbar.workspace.justify:
! Typically it sets the root window to a nice picture. toolbar.workspace: <texture type>
rootCommand: Shell command, e.g. \fIbsetroot -mod 4 4 -fg rgb: 5/6/6 -bg grey20\fR toolbar.workspace.pixmap: <filename>
toolbar.workspace.color: <color>
! Some of the bbtools read these old 0.51 resources toolbar.workspace.colorTo: <color>
menuFont: Font toolbar.workspace.borderWidth: <integer>
titleFont: Font toolbar.workspace.borderColor: <color>
.fi toolbar.iconbar.focused: <texture type>
toolbar.iconbar.focused.pixmap: <filename>
toolbar.iconbar.focused.color: <color>
toolbar.iconbar.focused.colorTo: <color>
toolbar.iconbar.unfocused: <texture type>
toolbar.iconbar.unfocused.pixmap: <filename>
toolbar.iconbar.unfocused.color: <color>
toolbar.iconbar.unfocused.colorTo: <color>
toolbar.iconbar.empty: <texture type>
toolbar.iconbar.empty.pixmap: <filename>
toolbar.iconbar.empty.color: <color>
toolbar.iconbar.empty.colorTo: <color>
toolbar.iconbar.focused.borderWidth: <integer>
toolbar.iconbar.focused.borderColor: <color>
toolbar.iconbar.unfocused.borderWidth: <integer>
toolbar.iconbar.unfocused.borderColor: <color>
toolbar.iconbar.borderWidth: <integer>
toolbar.iconbar.borderColor: <color>
toolbar.iconbar.focused.font: <font>
toolbar.iconbar.focused.textColor: <color>
toolbar.iconbar.focused.justify:
toolbar.iconbar.unfocused.font: <font>
toolbar.iconbar.unfocused.textColor: <color>
toolbar.iconbar.unfocused.justify:
.EE
.SH EXAMPLES .SH EXAMPLES
This may seem like a long list, but remember, when you create your own style, you This may seem like a long list, but remember, when you create your own style, you
can easily set lots of keys with a single command, e.g. can easily set lots of keys with a single command, e.g.
@ -433,7 +468,7 @@ You can also find more styles here:
.B http://themes.freshmeat.net/ .B http://themes.freshmeat.net/
.PP .PP
This manpage was composed from various resources including the documentation, fluxbox This manpage was composed from various resources including the documentation, fluxbox
man page and numerous other resources by Curtis Micol man page and numerous other resources by Curt Micol
.nh .nh
<asenchi@asenchi.com> <asenchi@asenchi.com>
.hy .hy
@ -445,3 +480,10 @@ Numerous other languages could be available if someone jumps in.
.SH SEE ALSO .SH SEE ALSO
.IR fluxbox (1) .IR fluxbox (1)
.IR bsetroot (1) .IR bsetroot (1)
.\" ADDITIONS TO MAKE
.\" Create a font section
.\" Change layout of theme items
.\" Obtain new theme items, grubert just placed in new man page
.\" Become a little more verbose on color usage.
.\"