$Id: README 1513 2008-10-15 17:39:41Z sergei $

"Stripes" -- chat plugin for Tkabber.


I. The Idea

This plugin allows to colorize backgrounds of the whole
messages placed in the conversation logs of Tkabber chat
windows. Backgrounds of even and odd messages can be
configured separately from each other (or not configured
at all).


II. Usage

The colors of even and odd messages can be manipulated using the
Tk option database resources which are:

* Chat.oddBackground for odd messages.

* Chat.evenBackground for even messages.

When the particular resource is not defined, it's not used thus
not affecting the appearance of the corresponding messages.

By default these resources are not defined.

The color may be specified in any form accepted by Tk which mean
any named color (from the X server's color database on
systems using X Window or listed in [1] on other systems) or the
color specification such as #RRGGBB.
For the strict explanation or color specifications read [2].


III. Examples

1) To set up gray colors using the Tkabber configuration file
   add these lines to your config.tcl file:

# Colors for the stripes plugin:
option add *Chat.oddBackground  gray77
option add *Chat.evenBackground gray84

2) To do the same using XRDB (systems based on X Window):

! Colors for the stripes plugin:
Tkabber*Chat.oddBackground:  AntiqueWhite
Tkabber*Chat.evenBackground: bisque


IV. Bugs and limitations

* Changing any color resource at runtime won't affect already
  opened chat windows.


V. References

1. http://www.tcl.tk/man/tcl8.5/TkCmd/colors.htm
2. http://www.tcl.tk/man/tcl8.5/TkLib/GetColor.htm


# vim:tw=64:noet
