Section C:
Extensions to Wagalang and YAWL

The extensions to Wagalang and YAWL give you more power and flexibility in designing a visual schedule. The extensions cover two general areas, adding the ability to specify certain global settings at the beginning of a file to apply to the entire schedule, and the ability to customize the attributes of an individual appointment's representation with a description following the basic appointment, on the same line.

1. Global Extensions

Attributes that are specified for the representation of the entire schedule are found at the beginning of a Wagalang or YAWL file. There are three basic properties that can be assigned in this way:

1. The colors of like sections of the schedule
2. The cell spacing and padding to be used in generating the schedule table
3. The schedule's start and end times

Each property is defined by a three letter reserved key for the property being defined, followed by a colon, followed by the value being assigned to the property. Examples will follow.

The four sections of the schedule to which colors can be assigned are:

1. Days of the week, usually the header
2. Times
3. Appointments
4. Free time

Reserved keys for color properties:

• ABG -- Appointment Background
• AFG -- Appointment Foregound
• DBG -- Day Background
• DFG -- Day Foreground
• TBG -- Time Background
• TFG -- Time Foreground
• FBG -- Free Time Background
• FFG -- Free Time Foreground

The property key should be followed by a string corresponding to one of the colors listed in the user manual section of this documentation, like this:

• DBG:blue

Cell spacing and padding can be specified with the keys CSP (cell spacing) and CPD(cell padding). The key should be followed by a colon and an integer between 1 and 10, inclusive, like this:

• CSP:3

Start and end times must be given in whole hours (i.e., 10, 11; not 10:30). They should be specified by the keys STM (start time)and ETM (end time), followed by a colon and an integer corresponding to a whole hour, like this:

• STM:9

All global attribute descriptions must be on individual lines to be parsed correctly. The global section must be separated from the specific appointments by a blank line.

2. Specific Appointment Extensions

Wagalang and YAWL support these extensions to the description of individual appointments:

• Appointment times can be specified on the hour, the half hour, or the quarter hour. This is implemented in the language in the most natural way -- as 24-hour conventional colon-separated times (i.e., 10:30, 21:15).
• There is a set of properties of the appointment representation that can be specified after the three parts of the basic appointment description. In Wagalang, these extended descriptions are found on the same line as the appointment, after the basic specification. Here, the three-element base description should be terminated by a double backslash, and the extended description should follow. In YAWL, these properties are each described by a separate line, following the three lines of the initial appointment and before the closing %%END-YAWL%%. Each extended property is described by a two letter reserved key, followed by a colon and the value to be assigned to the property. Examples to follow. These properties can be specified in this way:
  1. Color. Use the keys BG (background color) and FG (foreground color), followed by a colon and a string corresponding to one of the colors listed in the user manual section of this documentation, like this:
     • BG:blue
  2. Font. Use the key FO followed by a colon and a string corresponding to one of the fonts listed in the user manual section of this documentation, like this:
     • FO:Times
  3. Hyperlink. Use the key HL followed by a colon and the address to which the link leads, like this:
     • HL:http://www.cs.duke.edu/~ruby

  In Wagalang, if a given appointment line contains more than one of these extended descriptions, each must be separated from the others by space or tabs. In YAWL, multiple property notes must each be placed on a separate line.

Previous Section: Using Wagalang

Back to Table of Contents