Directions for the Document Builder

Purpose

The purpose of the Document Builder is to allow developers of HTML documents to easily produce templates for their documents. At the user's specification, the Document Builder will produce a series of files, one for each major heading in the user's document. These files are linked together into a single hypertext document, and provide the user with a built-in mechanism for navigating from one portion of the document to another. To use the Document Builder at the Geometry Center, you must add the line

   application/html-builder

to your .mime.types file, and the line

   application/html-builder;	/u/www/root/local/apps/doc_builder/read_builder

to your .mailcap file.

Example

Suppose you are interested in building a document on Shakespeare's works. Here's how you might proceed:

Specify the full pathname of the directory for saving the html files. The default is PWD, which is the directory from which your web-browser was launched.
Specify a short running title. For example, The Complete Works of Shakespeare.
Produce an outline of your document. The syntax is
Filename/[Title for this portion of the document]:
Note that a "slash" delimits the name of the file from the title, and that a "colon" must end each line. The title is optional; if it is omitted, then the document builder will use the filename as the title.
For example, if you type in:
```
      Introduction/:
      Historical/The Historical Works:
      Tragedies/The Tragedies:
      Comedies/The Comedies:
      Sonnets/The Sonnets:
      
```
Then the Document Builder will create the files welcome.html, Historical.html, Tragedies.html, Comedies.html and Sonnets.html.
Decide whether you want the first file in the document to contain an outline (or Table of Contents).
Invoke the Document Builder by pressing the button marked Build Document.

The document produced by the above example is included here.

Frederick J. Wicklin <fjw@geom.umn.edu>

Document Created: Tue Dec 13 1994
Last modified: Mon Apr 3 10:30:32 1995