---
name: "LecternToHTML"
section: "1"
platform: "linux"
package: "pm3-extra"
version: "1.1.15-1"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/LecternToHTML"
---

# LecternToHTML(1)

generate HTML describing repository of Lectern documents

## 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 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

mcjones@src.dec.com (Paul McJones)

## FILES

/proj/m3/pkg/lecterntohtml  -- sources\

## SEE ALSO