******************
* Themes and CSS *
******************
NaSMail users can customize the look of the interface by selecting
a custom theme and the font style.

CSS
===
Font style is set in CSS files stored in css/ directory. NaSMail 
provides some basic stylesheets with different font sizes and 
typefaces. You can find more information about CSS at
http://www.w3.org/Style/CSS/.

Only files that are stored in css/ directory and have .css extension 
are available to end user in Font Style selection.

Themes
======
Themes set interface colors. Each theme is a set of 16 colors.

NaSMail themes are stored in themes directory. Each theme is stored 
in own subdirectory. Name of subdirectory is used as theme identifier.

Theme data is stored in two files, setup.php and theme.php. setup.php
file stores theme color information. theme.php file stores information
about theme.

When setup.php file is loaded, core scripts extract color information
from nsm_theme_init_<theme-name> function. Replace <theme-name> with
theme directory name. Theme init function should return array
with 16 keys. Array key values store html color codes. See 'Color data 
keys' chapter for more information about key usage.

When theme.php file is loaded, core scripts extract information about 
theme from nsm_theme_load_<theme-name> function. Function should return
array with information about theme. Currently only 'NAME' array key is
used. 'NAME' key value should store theme name that is displayed to end 
users.

Recommendations
---------------
1. Theme subdirectory should use 15 or less symbols. Longer names are truncated
   when they are displayed in console based configuration utility.
2. Theme should use colors in '#xxxxxx' format. For example '#ffffff' color 
   code can be used to set white color. Color codes without '#' prefix will be 
   broken, if interface runs in html compliance mode. RGB color names (like 
   'white') might be parsed incorrectly by plugins.
3. Theme should set all 16 color array keys. If some color key is not set,
   interface will use standard theme colors and these colors might conflict 
   with theme colors.

Color data keys
---------------
 0 - TitleBar color
 1 - Border of error messages box, usually red
 2 - Warning/Error Messages
 3 - Left Bar Background
 4 - Normal Background
 5 - Table Headers
 6 - Text on left bar
 7 - Links
 8 - Normal text
 9 - Darker version of #0
 10 - Darker version of #9
 11 - Special Folders color
 12 - Alternate color for message list.
 13 - Color for quoted text -- > 1st level quote.
 14 - Color for quoted text -- >> 2nd or higher level quote.
 15 - Color for unselectable folders. Is used in left bar.
