SPLASHY-THEME.XML(5) Splashy POSIX boot splash system SPLASHY-THEME.XML(5)NAME
Splashy - a user-mode, POSIX and LSB compliant, boot splashing system
for UNIX.
SYNOPSIS
/etc/splashy/themes/*/theme.xml - Splashy theme configuration file
DESCRIPTION
/etc/splashy/themes/*/theme.xml describes the theme's behaviour
The theme on which the file will have effect is the one which is
contained in the same directory as this theme.xml file
This configuration file is an XML file where all values are enclosed in
tags
A tag is anything enclosed between < and >. An opening tag has the form
"<tag>" while a closing tag has its name preceded with a backslash (\)
character as in "<\tag>"
Tags can be considered as folders. Each tag either contains tags or
contains a value
The value of the final tag affects in the field defined by its parents
tags
The following tag folders are supported:
<splashy>
This is the main container. All tags must be contained inside
this tag
The following values are allowed in it: <theme>, <progressbar>,
<background>, <textbox>, <autoverboseonerror>,
<progressbaronboot>, <progressbaronshutdown>
<theme> Defines the theme's metadata information
The following values are allowed in it: <name>, <version>,
<description>, <urls>, <author>
<progressbar>
Defines how the theme's progress bar should look like and
behave
The following values are allowed in it: <x>, <y>, <width>,
<height>, <red>, <green>, <blue>, <alpha>, <border>
<border>
Defines how the border should be displayed
The following values are allowed in it: <show>, <red>, <green>,
<blue>, <alpha>
<background>
Defines how the background image in the theme should look
The following values are allowed in it: <boot>, <shutdown>,
<errorimg>, <width>, <height>
<textbox>
Defines how the textbox should be displayed
The following values are allowed in it: <enable>, <x>, <y>,
<width>, <height>, <background>, <border>, <text>
<text> Describes how the text should look like
The following values are allowed in it: <font>, <red>, <green>,
<blue>, <alpha>
<font> Describes the font to use for text
The following values are allowed in it: <file>, <height>
The following values are supported:
<name> Name of the theme
<version>
Version of the theme
<description>
Brief description about the theme
<urls> Official URL(s) of the theme or the author
<author>
Name or nickname of the theme's author
<x> Vertical starting possition of the element in pixels counting
from the top of the display
<y> Horitzontal starting possition of the element in pixels
counting from the left of the display
<width> Width of the element in pixels
<height>
Height of the element in pixels
<red> Amount of red to colour the element. The value must be in the
range 0-255
<green> Amount of green to colour the element. The value must be in the
range 0-255
<blue> Amount of blue to colour the element. The value must be in the
range 0-255
<alpha> Level of transparency the element. The value must be in the
range 0-255
<show> Display or hide the element. Possible values are 'yes' and 'no'
<boot> Complete path to a file containing the image to show as
background on boot
<shutdown>
Complete path to a file containing the image to show as
background on shutdown
<errorimg>
Complete path to a file containing the image to show as
backgraund when an error occurs
<enable>
Display or hide the element. Possible values are 'yes' and 'no'
<file> Complete path to a file containing the data refered by the
parent tag
<autoverboseonerror>
Switch to console if error happens. Possible values are 'yes'
and 'no'
<progressbaronboot>
Display a progress bar while the system boots. Possible values
are 'yes' and 'no'
<progressbaronshutdown>
Display a progress bar while the system shuts down. Possible
values are 'yes' and 'no'
EXAMPLES
The following is a complete and valid splashy theme configuration file:
<splashy>
<theme>
<!-- theme name is case sensitive. use directory name -->
<name>default</name>
<version>1.0</version>
<description>Default splashy theme</description>
<urls>http://splashy.alioth.debian.org/themes</urls>
<author>Splashy Team</author>
</theme>
<progressbar>
<!-- here are tags to set the bar... x coordinate,
y coordinate, width and height are for the progress bar.
Remember that x, y, width and height are expressed in percentage -->
<x>10</x>
<y>90</y>
<width>80</width>
<height>5</height>
<!-- here you can set the color of the progressbar...
set the amount of red, green, blue and alpha channel.
Remember that the max value is 255 and the minumun value is 0-->
<red>255</red>
<green>156</green>
<blue>0</blue>
<alpha>255</alpha>
<!-- whether or not you want a border around the progressbar. default: no -->
<border>
<show>yes</show>
<red>0</red>
<green>0</green>
<blue>0</blue>
<alpha>255</alpha>
</border>
</progressbar>
<!-- conventional path: /etc/splashy/themes + theme-name -->
<background>
<boot>background.jpg</boot>
<shutdown>background.jpg</shutdown>
<errorimg>error.jpg</errorimg>
<!-- resolution of the images. this value affects where
the progressbar will be drawn. If VALUE <= 0, then percentages
of the screen width and hight will be assumed -->
<width>0</width>
<height>0</height>
</background>
<textbox>
<!-- whether you want the textbox always
shown or no. If no, it will be shown only on error,
see autoverboseonerror -->
<enable>yes</enable>
<!-- here are tags to set the text area... x coordinate,
y coordinate, width and height are for the text area.
Remember that x, y, width and height are expressed in percentage
or pixel units -->
<x>20</x>
<y>50</y>
<width>60</width>
<height>40</height>
<!-- here you can set the color of the text area...
set the amount of red, green, blue and alpha channel.
Remember that the max value is 255 and the minumun value is 0-->
<background>
<red>0</red>
<green>0</green>
<blue>0</blue>
<alpha>127</alpha>
</background>
<!-- whether or not you want a border around the progressbar. default: no -->
<border>
<show>yes</show>
<red>0</red>
<green>0</green>
<blue>0</blue>
<alpha>255</alpha>
</border>
<text>
<!-- font file to use, path relative to theme -->
<font>
<file>FreeMono.ttf</file>
<height>10</height>
</font>
<!-- here you can set the color of the text/font...
set the amount of red, green, blue and alpha channel.
Remember that the max value is 255 and the minumun value is 0-->
<red>128</red>
<green>128</green>
<blue>32</blue>
<alpha>255</alpha>
</text>
</textbox>
<autoverboseonerror>yes</autoverboseonerror>
<progressbaronboot>yes</progressbaronboot>
<progressbaronshutdown>yes</progressbaronshutdown>
</splashy>
NOTES
Values are refered by their tag name prefixed with all of its parent
tag's names. For example: "/splashy/theme/name"
All values must be defined. Otherwise unpredictable things may happen
FILES
/etc/splashy/themes/*/theme.xml
Main theme configuration. Defines the theme's layout
/etc/splashy/themes/
Location where splashy themes are stored
SEE ALSOsplashy(1), splashy_config(1), splashy_config(1), splashy-config.xml(5)AUTHORS
Jacobo Vilella <jacobo221@gmail.com>
perl v5.10.0 2009-02-25 SPLASHY-THEME.XML(5)