BbZero Style Documentation

BbZero Style Documentation

Foreword

bbZero styles, like their siblings, are written as X resource databases. bbZero reads styles in the blackbox 0.65 and 0.7 style formats and has a few additions of it's own.

This document is inspired by OpenBox' excellent theme documentation and the more venerable blackbox style documentation. The goal of this document is to be the definitive complete guide to styling bbZero.

X resource databases

An X resource database is a text file containing key-value pairs. Each line contains either a key-value pair, a comment or whitespace.

The format for key-value pairs is: <key>: <value> Comments start with an exclamation mark (! This is a comment)

The key in a resource file can contain the wildcard character *, which has the same meaning as in a regular expression (match everything any number of times). As a special rule, .*, .*. and *. mean the same thing as *.

So a resource specified as toolbar.*.borderColor: red applies to toolbar.borderColor toolbar.label.borderColor, toolbar.clock.borderColor, toolbar.button.borderColor, ...

Data types

Integer

A whole positive number.

Example: *borderWidth: 2

String

Color

Rgb: rgb: <red>/<green>/<blue> where <red>, <green> and <blue> are 1 to 4 hexadecimal digits (0-9A-F). Web: #RRGGBB or #RGB By X11 color name: red, cornsilk (definitive resource: X11 rgb.txt

Font

Alignment

Left, Right or Center

Texture

Style elements