AVE Calendar Docklet has built-in support for different icon-sets. Each icon-set is called a calendar skin, or just skin.

Each skin must have it's own directory. It's common to name this directory after the skins name.
In this directory there should be a skin.ini file. Without this file, the Calendar Docklet won't reconize the directory as a skin.

Skin.ini

The skin.ini file tells the Calendar Docklet everything about your skin.
You must supply at least 2 sections:
	+ MAIN
		General information about your skin.
	+ ICON
		Information about to alignment of the icons used.
       (+ SPECIALDATES)
		This section is optional and can contain Information about
		 the so-called specialdates. (more in section SPECIALDATES).

Icons

All icons must be in PNG format and preferable have the size 128 x 128. The docklets
icon is build by putting together a month icon and a day icon.
There are 4 different types of icons:

	+ Default icons
	 	currently this is only default.png that is used for the "You have an 
	 	appointment"-dialog.

	+ Month icons
		For every month, you must supply an icon, they must be named
		cal_m1.png for January ... to ... cal_m12.png for December.

	+ Day icons
		For every day, you must supply an icon, they must be named
		cal_1.png for the first day of a month to cal_31.png for the last
		day of a month.

	+ Specialdate icons
		You can supply additional icons for the so-called Specialdates (more
		in section SPECIALDATES). There is no naming-convention.


Skin.ini -> MAIN-section

You must supply 3 keys:
	+ Name
		the name of your skin, this may not be empty, otherwise your skin
		won't be used by Calendar Docklet.
	+ Author
		here you can put your own name.
	+ Info
		here you can put additional information.


Skin.ini -> ICON-section
	
You must supply all following keys:
	+ Width
		The total width the day + month icon together will use.
	+ Height
		The total height the day + month icon together will use.
	+ DayXOffset
		The vertical offset from (0,0) [left-upper corner) the
		day icon will be painted in the docklets icon.
	+ DayYOffset
		The horizontal offset from (0,0) [left-upper corner) the
		day icon will be painted in the docklets icon.
	+ MonthXOffset
		The vertical offset from (0,0) [left-upper corner) the
		month icon will be painted in the docklets icon.
	+ MonthYOffset
		The horizontal offset from (0,0) [left-upper corner) the
		month icon will be painted in the docklets icon.
	+ DayOverMonth
		Can be 1 or 0. If it's 1 than the month image will be painted
		first and the day image will be painted over the month image.
		If 0, vice versa.


Skin.ini -> SPECIALDATES-section

The skin can define other images for special dates. For example, the skin can use
an newyear.png to show up as the docklets icon on New-yearsday, instead of the regular 
month + day combo. newyear.png must be supplied along with the skin.


To define some specialdates you must define a SPECIALDATES section in the skin.ini file.
This Section has one main key:
	+ Count
		Count tells the Calendar Docklet how many specialdates there are defined
		in this skin.

After Count, there should be for every special date the keys that define the specialdate.
All these keys will be followed by a number that represent the number of the specialdates.
For example, if you have 3 specialdates defined in a skin (COUNT=3) then you will have keys
with names like Day1, Month1, Icon1, Day2, Month2, Icon2, Day3, Month3, Icon3.

SpecialDate keys:
	+ Day
		The day of this specialdate.
	+ Month
		The month of this specialdate.
       (+ Year)
		Optional, the year of this specialdate. If you don't define this, or you
		define it as 0, it won't be used.
	+ Icon
		The icon the docklet must show if this specialdate will occur.



by Andreas Verhoeven
e-mail averhoev.2@hccnet.nl


//////////////////////////////
voor Frances...