web.calendar - A web based calendar program

The web.calendar program takes an input file which contains information regarding dates and events and produces calendar pages suitable for inclusion on a web site.

The information file contains several types of lines.

• # text Any blank lines or lines begining with "#" are ignored.
• Year=1997 The Year lines specifies the year that the following events are in.
• Month=5 The Month lines specifies the month that the following events are in.
• 10=Meeting The date lines specifies events. The events are placed in the indicated day. HTML tags of all sorts may be placed in the text portion of the event. If multiple events are placed in the same date, they are forced to be on distinct lines (i.e. there is a <BR> following each event).

This program takes a number of arguments to control the presentation. It is probably best if these parameters are stored into a Makefile or other automated program so you don't have to type them in all of the time.

• --data datafile
  This is the name of the calendar data file. It contains which are of the form:
  • # Comment line
  • Year=1999 Introduces a new year
  • Month=10 Introduces a new month
  • 1=event Some event on the specified day
  • TBA=event Some event at an unknown date within the month.
  The event calendar must be in order. If not specified, the event calendar's filename is assumed to be "calendar.data". The events may contain HTML, but keep it simple.
• --start 1998/10
  This specifies the starting month. This must be in the format shown. If unspecified, it starts as early as possible.
• --end 1999/05
  This specifies the ending month. If unspecified, the calendar goes as long as possible.
• --bg color
  This specifies the background color. This can be anything that HTML allows. This defaults to no specific color.
• --title "some title"
  This specifies the title of the calendar.
• --banner "some message"
  This is the header text of the calendar.
• --html directory
  This is the directory to store the generated HTML. This defaults to the current directory.

Note that this is a rather simple program. Don't let your expectation get carried away.

---

Another program, called web.calendar2, takes the same data file as shown above and makes a compact, one page, calendar. This shows the events with a small monthly calendar off to the side. You should note that the calendar definition and many of the command line arguments are the same in these two programs. This allows you to easily provide two views of the same data.

This program takes a number of arguments to control the presentation. It is probably best if these parameters are stored into a Makefile or other automated program so you don't have to type them in all of the time.

• --data datafile
  This is the name of the calendar data file. It contains which are of the form:
  • # Comment line
  • Year=1999 Introduces a new year
  • Month=10 Introduces a new month
  • 1=event Some event on the specified day
  • TBA=event Some event at an unknown date within the month.
  The event calendar must be in order. If not specified, the event calendar's filename is assumed to be "calendar.data". The events may contain HTML, but keep it simple.
• --start 1998/10
  This specifies the starting month. This must be in the format shown. If unspecified, it starts as early as possible.
• --end 1999/05
  This specifies the ending month. If unspecified, the calendar goes as long as possible.
• --bg color
  This specifies the background color. This can be anything that HTML allows. This defaults to no specific color.
• --title "some title"
  This specifies the title of the calendar.
• --banner "some message"
  This is the header text of the calendar.

You can retrieve the tar archive at web.calendar-0.11.tar.gz.

Last modified 27 May 2006
Dave Regan
http://mordred.ao.com/

Comments to: Dave Regan