Version 1.0
===========

Introduction
------------

The program is started with the following command line:

  WebGen <Config_FileName> <Target_Folder>

If either the Config_FileName or the Target_Folder do not exist, the
software will terminate.

The Config_FileName can be any acceptable filename for the system,
as can the Target_Folder.

The configuration file pointed to by Config_FileName should follow
the format as appears below:

  %[Option] [Value]
  1
  .1_1
  2
  .2_1
  .2_2
  ..2_2_1
  ...2_2_1_1
  %[NodeOption] [Value]
  ..2_2_2
  3

  ...etc

Each of the '.' represents a level of menu depth.  Incorrect sequencing
of these depth indicators will result in a menu structure that does
not follow the required branching.

Where examples are given below, the '"' should be ignored.

Each line must be terminated with a carriage return.  Please also note
that each entry must be one line only, so it is advised that the text
editor used to edit the configuration file be set to wrap around.

Menu Options
------------

These should appear before the main menu tree, although they can appear
anywhere in the file, if you need 'special' effects.

%MenuWidth <Value> [%]

The width of the left hand side menu, expressed as an absolute (ie "200")
or a percentage of the %PageWidth (ie "20%"). 

%MenuFont <Comma,Separated,List>

The font used for the menu text.  Where alternative fonts should be given,
the list must be comma separated with no spaces (ie "Tahoma,Palatino,Arial").

%MenuFontSize <Value>

The starting font size for the root nodes.  A single number between 00 and 99.

%MenuMinimumFontSize <Value>

The smallest font size to be used for child nodes.

%MenuBackground <Value>

The color to be used for shading the menu area.  Can be either a W3C
recognised name (ie "White") or an absolute hex representation (ie "#F0F0F0").

Template Options
----------------

%PageWidth <Value>

The width of each entire page, expressed as an absolute (ie "200") or a 
percentage of the %PageWidth (ie "20%"). Defaults to 800.

%BaseFont <Value>

The font used for the page text.  Where alternative fonts should be given,
the list must be comma separated with no spaces (ie "Tahoma,Palatino,Arial").

Please note that using this feature will cause the generated document to
violate the W3C HTML 4.01 Transitional specification, if followed by a block
level tag such as <CENTER>.  The resulting document set will, however,
display correctly on all known browsers.

%BaseFontSize <Value>

The base font size for the page text.  A single number between 00 and 99.

%GlobalHeading <Value>

Text that will appear in the title bar, preceding the page name, taken from
the node title.  Can include spaces (ie "My Page").  The result will akin to:

  "My Page : Page One"

In the title bar of the browser.

%Header <Value>

Freeform HTML representation of the banner that will appear accross the top
of each page.  May include spaces, and any HTML.

%Footer <Value>

Freeform HTML representation of the banner that will appear accross the bottom
of each page.  May include spaces, and any HTML.

Node Options
------------

%NodeBody <Value>

Freeform HTML representation of the body text for the node in question.

%NodeBodyFile <Value>

The path to a file to be included instead of specifying a %NodeBody value,
the two may co-exist, however.

Bugs
----

There are no known bugs at this time.  Please report any to the author,
indicating the version number, operating system, and including the
configuration file that appears to be causing the problem.

Author : Guy_W@Lecky-Thompson.net

[End of Document]