|  | HTML |  |

|  | Splash! |  |

|  | PostScript |  |

| Template Toolkit Examples: Splash! Library: Config |

| index

|  | config |  |

colours |

# Config

The splash/config file is used to specify various configuration values for the Splash! library. The most important item is 'splash.images' which defines the URL prefix for the Splash! images. If this value is wrong, you'll notice that your interface elements don't have smooth, rounded corners but empty, square chunks of broken image links. Afer that, everything is pretty much a matter of personal taste.

If you want to make changes without modifying the main configuration file then you can always PROCESS the splash/config file and then change values afterwards. So you might have your own config file (automatically processed as a PRE_PROCESS template, for example) which does something like this:

    [% PROCESS splash/config;
       splash.images                 = '/~abw/tt2/splash/images'
       splash.style.default.col.fore = 'green75'
       splash.style.select.col.fore  = 'green50'
    %]

Here's what your splash/config file currently looks like:

    [%  #--------------------------------------------------------------------
        # the following hash is user-definable and can/should
        # be changed to suit your local environment and/or
        # preferences
        #--------------------------------------------------------------------

        splash = {

    	# URL prefix to Splash images
    	# NOTE: this is set by the Makefile.PL at installation time
    	images  = '/tt2/images/splash'

    	style = {
    	    default = {
    		name = "Default"
    		# border/space/pad widths
    		border = 2
    		space  = 2
    		pad    = 2

    		col = {
    		    page => 'lilac'   # page border
    		    back => 'white'   # background
    		    fore => 'lilac'   # foreground (e.g. button)
    		    edge => 'lilac'   # edging strip
    		    fill => 'white'   # fill (e.g. panels)
    		    text => 'black'   # text
    		    icon => 'black'   # icons
    		}

    		font = {
    		    # face = 'Helvetica, Arial, Sans-Serif'
    		    # size = '+1'
    		    # bold = 1
    		}

    		tab = {
    		    locate = 'right'		# tab location on box
    		    align  = 'center'		# text alignment
    		    limit  = 9                  # max number before scroll
    		}

    		button = {
    		    width  = 0			# grow to fit
    		    align  = 'center'		# text alignment
    		}

    		bar = {
    		    width  = 0			# grow to fit
    		    align  = 'left'		# text alignment
    		}
    	    }

    	    select = {
    		name = "Selected"
    		col = {
    		    fore = 'mauve'
    		    edge = 'mauve'
    		    fill = 'grey75'
    		    text = 'white'
    		}
    		font = {
    		    bold = 1
    		}
    	    }
    	}
        };
    -%]
    [%  #--------------------------------------------------------------------
        # hands off - you shouldn't need to mess with anything below here! :-)
        #--------------------------------------------------------------------

        splash_sys = {
    	name     = 'Splash!'
    	version  = 0.02
    	homepage = 'http://www.template-toolkit.org/splash/'
    	about    = 'The Template Toolkit HTML Library / Widget Set'
    	imgsize  = 8
    	imgtype  = 'gif'
        };

        splash.import(splash_sys);

        splash.link = "<a href=\"$splash.homepage\">$splash.name</a>";
        splash.bold = "<b>$splash.name</b>";

        # load rgb table from HTML library
        PROCESS html/rgb;
        splash.rgb = rgb;
    -%]