summaryrefslogtreecommitdiff
path: root/etc/nationaldays/README
blob: 71af75b826508c01102e4e3976253e546f59cb41 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
Config files for the nationalholiday plugin

Format is simple:
Standard-xml file. 
It must always enclosed by
<nationaldays>
...
</nationaldays>

then a short description tag.
<description value="german holidays"/>

for example. It should be used later on.

then a list of holidays follows, encapsulated with 
<entries>
...
</entries>

A non-floating holiday entry has the form 
<entry date="M-D" name="description of holiday"/>

floating holidays:
<entry name="<name>" type="floating">
<calculation>
 ... calc entries ..
</calculation>
</entry>

The calcentries may following tags:

date - a short date (without Year!) in form M-D or the string "easter"
offset - integer. these days will added (or substracted) after all other calcs are made.
weekday - the day of week as monday, tuesday and so on.
dayofmoth - in combination with weekday you can say "first <weekday> of ..." or "second <weekday> of ..."
month - monthname(!) eg. january, february and so on.
datedep - dependy to "date", may "before" or "after".

example:
<calculation>
   <weekday value="sunday"/>
   <datedep value="before"/>
   <date value="12-24"/>
</calculation>

these will calculate sunday before christmaseve or christmas eve itself if it is a sunday.

see german.xml for futher examples.