cowlark.com

NearSited

The way it works is that you give it a set of input file that looks like this:

Title: NearSited
Description: think this site's nifty? This is the tool I used to make it
Keywords: programming, WWW

NearSited is the system that I use to create these web pages. It's a
cheesy awk script that builds the HTML files and the indices from a
set of templates I provide. It's really cool.

<P>The way it works is that you give it an input file that looks
like this:

There are three scripts available.

ns-render <input file>

Converts an input file into an HTML file, expanding the various templates. The output is written to standard out.

ns-render understands the following headers.

Template

Sets the template used to generate the page. If unspecified, _template.i is used.

Title

Sets the page title. Any reference to @@@TITLE@@@ is expanded to this.

Keywords

Specifies the keywords for this page. ns-render builds a table containing references to all the keywords that is available using the @@@KEYWORDS@@@ substitution.

ns-index <keyword;> <input files...>

Generates an index.

All the input files are read and parsed for keywords. Another file is then written to standard out that is an index to these. The first parameter specifies an optional keyword (use "" if you want to omit it). If present, only those pages that contain that keyword will be considered. This is useful when writing partial pages.

A special index template must be present, called keyword.i. If no keyword is present, it will be master-index.i. This is inserted at the beginning of the output file.

ns-index understands the following headers.

Title

Sets the page title, used for the link in the index reference.

Description

A short page description. This is written after the link in the index reference.