Web Paging - Minimal Distribution

Webpaging Distribution - a minimal set of files

The minimal webpaging distribution contains a "starting" set of files for using Dr. RK's method of generating Web pages.

This entire website package has been drastically updated. If you grabbed the minimal distribution prior to 01 Feb 1999, you should download the latest one. Some of the changes are:

• New look and feel
• Updated the macros with more features
• Improved the documentation ... it's actually current!

• ---

• Generates frames and non-frames pages from the same set of source files
• Broke up the driving macro definition files into logical subcategories
• All Makefiles are now generated by the Setupmake script
• Renamed the source files to use the .html extension

A recent snapshot has been taken from the current set of files as of 16 Jun 2004, with bug fixes, rearranged things, and eliminated any C++ tools in favor of perl scripts.

The advantages of m4 method for web page generation is that certain header & footer parts of the web page can be changed easily & globally for all the generated web pages. All the web page author needs to worry about is the actual content and not the web page garnish. Let the m4 macro package worry about that.

This minimal distribution is a subset of the web pages for this site providing the "current" macro package, scripts, Makefiles and web documentation.

THIS IS NOT MEANT FOR BEGINNERS.
This method leans to the Un*x environment and requires a knowledge of both m4 and html.

Once you grab the minimal distribution and place it somewhere with

	gunzip -c webm4.tar.gz | tar -xvf -

or some similar invocation, then type

	make help

for a brief description of what the Makefile does. The usual way to generate the web pages is to do

	make rebuild
	make rebuild

It needs to be run twice, to prime the pump, as it were. If this doesn't work then edit the Makefile until it does.

---

Look at the overview for more information.