Thank you for purchasing HyperWAG! We here at Wang, Chrisman & Co. have slaved many hard hours to bring you the best in Week At a Glance readers! We hope that you find HyperWAG as easy to use as we have found it to be. Before you get started there are several things you should learn about HyperWAG.
Starting the HyperWAG program is simple as can be. At the command line you simply type: wag. Once that is typed in, press enter and you are off to the wonderful world of wagging!
Before we go any further, we should first learn the general structure of HyperWAG. The HyperWAG program deals with only one file every time it is started. After the command line is typed in, you will be asked for this file. If you are using a Wagalang file you must mark it with the suffex .wag. Similarly if you are using a Yawl file you should mark it with the suffex .yawl. If your filenames are not correctly marked, the program will not run! For more information of the difference between Wagalang and Yawl please read the sections below on how to make one of each.
Once you have typed in the file, you will be asked what .html file you would like to save it under. At this point most HyperWAG's would just output the table. But we value you far too much as a customer to do something like that!
After you have specified the files you will be given a chance to view a plain text of the week. From there you can decide if you want to make any last minute changes, or change the color of the html file.
Once you are satisfied with your week, and want it changed into an .html file, simply quit the program, and the your week will be written to the file that you specified earlier.
Yes. it's that easy! If you have any further questions, the rest of this documentation goes into further detail.
One quick note about time conflicts. HyperWAG has been built to realize if there is a time conflict in your scedule. If there is it will keep the first event that it read in, and then tell you about the confilict.
One more note for advanced users: you can type in the name of the file for input and output at the command line. Thus if you want to open the file week.wag and save it to week.html you can do it by typing at the command line:
wag week.wag week.html
Of course you can always just type wag and it will ask you for the file after that.
After you have specified the input and output files, you will be brought to the main menu. In this menu you have several options. To select the option that you want, you simply type the letter in the brackets of the choice that you want, and press enter. The menu options are each given a small section below.
There are three parts to creating a new appointment. First, you will be asked for the day of the week on which this appointment is supposed to take place. To do this ONLY enter the letter that corresponds to the correct day. To find the right letter read the section on making a Wagalang file.
After you enter the day, you are asked for a time. To do this, you may write the time as you would either in a Wagalang file or a Yawl file. Please read the sections below to determine how to do this. Make sure that you do not combine the two styles or you appointment will not be placed into your week.
After the time has been entered, it is time to enter your description. You may type whatever you wish for the description. Once you are done press enter to record the description.
Congratulations you have created a new appointment!
Changing the color for the backgrounds of the .html file is quite simple. First you select what part of the table you would like to change, by typing in the number correspoinding to it and pressing enter. Then you select what color you would like that item to be, by typing in the number corresponding to that. And with that the color has been changed, it's that simple!!
By the way the default colors are: Time and Days are light green, free time is red, and active time is yellow.
There is one big advantage to printing the text version. Since the .html version of the table must be printed in a limited space, there is only so many times that can be allowed. As a ruesult, it reports the times that you put in only by the hour. Thus it rounds off the original time that you put in. The text version however, does not have the same constraints, and the full time, down to the minute, will be reported. Also looking at the text is a good way to see if you are missing any appointments before you save your final version to file.
Once you are fully satisfied with the colors, and appointments, quit the program and your .html file will be saved. After that find your favorite with your viewer, and enjoy your beautiful new week at a glance.
Before you run HyperWAG for the first time, you are going to need to create a file. There are two ways to do this: either through wagalang or yawl. Please read the details below to find which is better for you, and on how to create one.
One final note: make sure that the Wagalang file has a .wag suffix, and the yawl has a .yawl suffix or your program will not work. Alos, you can make comments in a file by placing # at the start of the line. If you do this, HyperWAG will ignore that entire line.
A file to be read into HyperReader should look somewhat like the following:
m 9:30,12:00 sleep and sleep m 9,12 wake up th 9:45,10 cps110 w 9:05,10 breakfast f 9,10 running mtwhf 12,13 lunch wf 10,12 cps108 t 10,12 breakfast
As you can see, each line consists of one event, and the days and time at which that eventshould happen. There are several components to each line, we will go into each in detail.
The Day:
On the start of each line you should state which days the event is ment to happen. To do this you should write the letters for the days wanted, the letters are as follows:
S or s Sunday
M or m Monday
T or t Tuesday
W or w Wednesday
H or h Thursday
F or f Friday
A or a Saturday
Do not put any spaces between the day letters. If you write the same letter more than once the second letter will be ignored.
The Time:
After you write the day letters, it is time to write the time that that event should happen. If you have put down multiple days then the event will happen at the same time each day. If you want to have the same event but at a different time, you will have to create a new line for it.
To state the time, put a space or tab between the day dates, and enter the start and times. Times should always be entered on the 24 hour clock, thus 1PM should be entered as 13. You can write the times in two different ways. If you appointment is on the hour you can write just the hour (10), but if it is during the hour you can write the full time (10:15). You can also write (10:00) if you would like to keep things neater. Make sure to place a comma between the start and end times, but do not place a space.
The Description:
After placing the time put another space or tab, and then type in the description of what should happen. There can be as many words as you would like, but make sure that it is all on the same line.
If you are not satisfied with the Wagalag file, an alternate way of making a file, called YAWL has been provided. It has both its advantages and disadvantages. It is better than wagalag in that you can put as long a description for an event as you wish. However, you can only make an appointment on the hour. It is up to you to decide what is best for you. A YAWL file might look as follows:
monday 10-13 eat lunch %%END-YAWL%% saturday 14-15 go running %%END-YAWL%%
As you can see the first line of each appointment should state the day. Next is the start an end times with a dash between them. Once again the time must be put in on a 24 hour clock. The next line, or lines should consist of the description, you can put as many words and lines as you wish. Once you are done with the description, on the line below place %%END-YAWL%%, which tells the program to look for the next appointment.