$Id: kastyleformat.txt,v 1.3 2003/10/17 11:26:25 hyriand Exp $

.kastyle format
--------------------------------------------

Most of the parameters themselves are described in kahakai(1) man page.

The style format is inspired by Python's indented structure:

# Comments are like this, on the line by themselves.
rootCommand = Esetroot -scale ...
baseFont    = arial

menu:
        justify = left|right|center
        item:
                height = 20
        title:
                # You can use variable substitution too. 
                # Parentheses are obligatory.
                font   = $(baseFont)-10:bold [xft]
                style  = pixmap stretched
                pixmap = titlebar.png
                text:
                        color = #000000
                # transparency = 100 means completely transparent while
                # transparency =   0 means completely opaque (default)
                transparency = 15
        # menu.frame specifies the overall style for the menus, inherited by
        # items and title (unless specified). 
        frame:
                font  = ...
                # See kahakai man page for description of the style, font and 
                # pixmap parameters
                style = flat solid 
                ...
        # Style for highlighted items
        hilite:
                ...
        bullet:
                # Specify the character used to the right of the menu items
                look = :
                

window:
        # window title font
        font = ...
        borderColor = ...
        # thickness of the handle at the bottom of the window 
        # (between the two grips) in pixels
        handleWidth = ...
        
        # You can refer to any variable no matter how nested.
        justify = $(menu.justify)
        
        title:
                # title height in pixels
                height = 
        
        # Styling of the window that currently has focus
        focused:
                # window title bar
                title:
                       style = 
                       ...
                # window title text. note that font is specified in window.font
                label:
                       style = parentrelative
                       text:
                             color = #000000
                # handle style             
                handle:
                        ...
                # left/right grips (used for resizing)
                grip:
                        ...
        # Same for unfocused                
        unfocused:
                ...

        # Window buttons specification        
        buttons:               
                close:
                        foreground = false
                        autoplace  = false|left|right
                        # Horizontal position in pixels from left to right
                        # No needed if autoplace is not false.
                        position   = 3
                        
                        # Style for not activated/false button 
                        # (makes sense for maximize/shade)
                        false:
                                # Style for when button is in a focused window
                                focused:
                                        style = ...
                                        ...
                                # Same for unfocused window        
                                unfocused:
                                        ...
                                # When button is pressed        
                                pressed:
                                        ....         
                       # Style for activated button                 
                       true:

                               # One of the most important features of
                               # the format: ability to copy blocks to
                               # avoid repetition.  Block is specified
                               # using dot-separated notation.
                               @window.buttons.close.false
                maximize:
                        ...
                shade:
                        ...
                # One can use arbitrary numeric suffix to repeat a button for
                # layout purposes
                shade2:
                        ...
                # Any unknown names are silently ignored for now
                menu2:                
                        ...
