Contents
What is Hyperwag?
Getting Started
Adding Appointments
wagML: Wag Markup
Language
YAWL: Yet Another
Wag Language
Viewing Appointments
Daily List
Weekly List
Yearly List
Monthly
Calendar
Weekly
Calendar
Business
Week Calendar
Daily
Calendar
What is Hyperwag?
Hyperwag reads in a file of appointments (in either wagML format or YAWL format) and allows you to store and access your daily appointments. After adding your appointments, you will be able to view your appointments in a web broswer as a daily list, weekly list, weekly calendar (both complete and business), monthly calendar and yearly calendar.
Getting Started
Upon loading, today's appointments will appear in the main window of Hyperwag in list format. In this version, the user is not able to add appointments to their file from the web browser. This will be implemented in version 2.0.
Adding Appointments
Appointments can be added by running hyperwag from a Unix workstation. The program will give prompts as to appointment information and this data will be added and processed to create your online schedule. At this point, it is not possible to add appointments directly via the internet. This site is mainly for viewing those appointments.
back to contents
wagML: Wag Markup Language
wagML stands for Week-at-A-Glance Mark-up Language and is a format used in files to input single and recurring appointments with or without a start and end date. wagML files are specified with the end suffix .wagml and uses tags to specify appointments. The legal tags in wagML are:
- <appointment>
This is the top-level tag for an appointment. It has an (optional) attribute of kind="recurs", see the example below.
- <name>
This is the label used to identify the appointment in a month/day/week view.
- <date>
- Specified in MM/DD/YYYY format with optional attributes when="start" and when="end", see the example below.
- <time>
These have required attributes when="start" and when="end". Time is specified in 24-hour/military time or using am/pm designations. For example, 17:30 and 5:30pm specify the same time. Colons aren't required so that the time 15 is the same as 3:00pm and 0730 is the same as 7:30am.
- <days>
The days for a recurring appointment. This is one string whose letters are any combination of S,M,T,W,H,A.
- <info>
This is any string, used to provide more information about an appointment, e.g., a description, location, etc.An example of one appointment is:
<appointment> <name>Meet Bob</name> <date>09/28/2001</date> <time when="start">9:00am</time> <time when="end">10:00am</time> <info>Meet Bob for Breakfast at Alpine</info> </appointment>>The lunch appointment might be specified as follows if lunch will be a recurring appointment from September 1 to December 11 of this year.
<appointment kind="recurs"> <name>lunch</name> <days>MTWHF</days> <date when="start">09/01/2001</date> <date when="end">12/11/2001</date> <time when="start">12</time> <time when="end">13</time> </appointment>The tags for an appointment can come in any order, but should always occur between the open/close <appointment> tags.
Appointments in a file can be separated by blank lines and information between tags can be spread over more than one line, but a tag must not be broken over a line.
wagML comments are started by the four character sequence <!-- and terminated by the three characer sequence -->. Anything between comment begin/end tags should not be read in as part of the appointment. For example, the info field could be commented out of the first appointment above as shown below.
<appointment> <name>Meet Bob</name> <date>09/28/2001</date> <time when="start">9:00am</time> <time when="end">10:00am</time> <!-- <info>Meet Bob for Breakfast at Alpine</info> --> </appointment>>YAWL: Yet Another Wag Language
YAWL stands for Yet Another Wag Language and is format for used in files to input single and recurring appointments without a start and end date. YAWL files are specified with the end suffix .yawl and uses lines and semicolons to specify appointments.
Lines of a file written in YAWL must be either comments, blank lines, or appointments.
- A comment line begins with a # hash/number character as the first character.
- Blank lines must be completely empty.
- An appointment line is specified in the following format where semi-colons terminate each of the five required features of an appointment.
Name of event;Days or Date;Start time;End time;Information;
- Name is the description of the appointment.
- Days or Date specify when the appointment occurs. A one-time appointment is specified in MM/DD/YYYY format. A recurring appointment is specified by the days on which it recurs, e.g., MWF for Monday, Wednesday, Friday and SMTWHFA for every day of the week (H is Thursday, A is Saturday).
- The Start and End times specify the start and end, respectively, of an appointment. These can be specified in 24-hour/military time or using am/pm designations. For example, 17:30 and 5:30pm specify the same time. Colons aren't required so that the time 15 is the same as 3:00pm and 0730 is the same as 7:30am.
- Information about the appointment is optional. If there is no information, a semi-colon must still be used to signal the end of the appointment so for appointments with no information there will be two consecutive semi-colons (see below) terminating the appointment specification.
For example:
Meet Bob;09/28/2001;9:00am;10am;Meet Bob for Breakfast at Alpine.;The lunch appointment might be specified as
lunch;MTWHF;12;13;;
Viewing Appointments
Hyperwag is very user friendly when it comes to viewing appointments. From the main page, simply click on "View Appointments." You will then be asked to fill out a form indicating a date and which view you prefer. Simply fill out all the elements of this form and click "go" and your Hyperwag schedule will pop up in the main window.
You may have noticed that when Hyperwag loaded, a daily list of appointments for today appeared in the main window. If, at any time, you should wish to see today's appointments in list format simply click "Home."
Daily List
To get a daily list for any day, simply select "Single Day" in the pull down menu in the "View Appointments" form.
Weekly List (printable version)
This one is a little bit tricky. You must first go through the "View Appointments" form and selct "Weekly View" (either complete or business will do). Once the page has loaded with your weekly table, you will see a red link to a printable version. Click that and you will see that week's appointments in list format.
Weekly Calendar
In the "View Appointments" form select "Weekly View(complete)". An attractive table of appointments will appear in the main menu. If you would like to print a list format of this simply click the printable version link.
Don't be alarmed by the red, it simply means that you may have two conflicting appointments.
Business Week Calendar
In the "View Appointments" form select "Weekly View(Business)". An attractive table of appointments will appear in the main menu. If you would like to print a list format of this simply click the printable version link.
In the "View Appointments" form, select "Monthly View." A calendar will appear in your browser. You can click on different weeks or different days and change the view within and without that month.
Yearly View
In the "View Appointments" form select "Year View." You will then be directed to a page with a list of links to different months. Click the one you would like to see.
