Project

General

Profile

unexist.dev

subtle

Assorted tidbits and projects

Panel » History » Version 11

Anonymous, 10/06/2010 07:59 PM

1 11
h1. Panel\015\012\015\012[[subtle]] comes with two panels per screen, one at the top and one at the bottom of the screen. The location of both panels is fix and cannot be changed, the height is determined by the max. height of the font and can't also be changed directly. Per default only the top panel on the first screen is used, it's up to the user to enable the bottom panel or disable either one or both.\015\012\015\012Using [[subtle]]'s panels is no must, foreign panels can also be used as long as they support the @WM_STRUT@ or @DOCK@ window type properties. If this is not the case, [[subtle]] can be advised to spare some parts of the screen with the @&#58;padding]@ option in the config.\015\012\015\012h2. Types\015\012\015\012Both bars can contain different items and will be hidden when empty.\015\012\015\012Following items are available:\015\012\015\012| *&#58;views*     | List of views with buttons                      |\015\012| *&#58;title*     | Title of the current active window              |\015\012| *&#58;tray*      | Systray icons (Can be used once)                |\015\012| *&#58;sublets*   | Catch-all for installed [[sublets]]             |\015\012| *&#58;sublet*    | Name of a [[sublet]] for direct placement       |\015\012| *&#58;spacer*    | Variable spacer (free width / count of spacers) |\015\012| *&#58;separator* | Insert separator                                |\015\012\015\012All items can be used freely in any combination across both panels but besides *&#58;spacer* and *&#58;separator* only once. When using [[sublets]] the catch-all item *&#58;sublets*  will display all in a block, but it's also possible to place [[sublets]] independently as standalone item on the panel by adding the name of the [[sublet]] as item name (like clock) into one of the panels.\015\012\015\012h2. Examples\015\012\015\012<pre>{{hide}}<code class="ruby">screen 1 do\015\012  top    [ :views, :title, :spacer, :tray, :sublets ]\015\012  bottom [ ]\015\012end\015\012\015\012screen 1 do\015\012 top    [ :tray, :title, :spacer, :sublets, :spacer, :views ]\015\012 bottom [ :clock, :spacer, :mpd ]\015\012end\015\012</code></pre>