LecternToHTML

LecternToHTML(1)

NAME

LecternToHTML - generate HTML describing repository of Lectern documents

SYNTAX

LecternToHTML [-quiet] path

DESCRIPTION

This program walks a subtree of the filesystem rooted at the specified path, and annotates each directory, say p, by creating files named p/.ascending.html and p/.descending.html that each contain an HTML document describing the contents of that directory. Each such document contains a hypertext link for each Lectern document and for each subdirectory containing (directly or indirectly) one or more Lectern documents. If a directory contains no Lectern documents, no .ascending.html or .descending.html file is generated for it. The hypertext link for a document is labeled with title, author and date attributes extracted from the Lectern document file -- see BuildLectern{1}.

The hypertext link for a directory, say q, is labeled with the contents of the file named q/.title, if such a file exists; otherwise the path q is used as the label. The referent for this link is q/index.html if the directory q/ contains a file or symbolic link named index.html or q/.ascending.html otherwise.

If a directory contains a file named .prefix, its contents are inserted at the beginning of the generated HTML. Similarly, if a file named .postfix exists, its contents are inserted at the end.

If -quiet is not specified, LecternToHTML prints to standard error the name of each directory or file it visits.

AUTHOR

Paul McJones

SEE ALSO

Lectern(1), BuildLectern(1), BuildLecternIndex(1)

COPYRIGHT

Copyright 1994 Digital Equipment Corporation.
Distributed only by permission.

 Last modified on Fri Feb 17 17:45:14 PST 1995 by birrell  
      modified on Sun Jan  1 09:33:44 PST 1995 by glassman 
      modified on Tue Aug 30 15:27:12 PDT 1994 by mcjones