Title	:	ht test page
	Author	:	AR
	Abstract:
		<b>ht</b> is a <em>pre-processor</em> for HTML.
		It facilitates the maintenance of a large site by abstracting
		out common 'boilerplate' segments of code, e.g. header and
		footer segments that are similar system-wide. A number of
		varying styles and macros can also be supported.
		This file is intended to serve not only as documentation but
		also as the main test case for ht.
		The Abstract is a descriptive paragraph with important keywords.
		+++
	Valid	:	Yes
	Content	:
	I believe most people think you only have two choices for creating HTML
	- use an editor or code by hand.
	But there's a third one which works very well for us:
	we use a (home-grown) preprocessor. If you like it's a variant of the
	template method; we have a number of styles built in and can modify them
	with some parameters.
	<b><a href="ht">ht</a></b>
	is a Perl preprocessor that I wrote for maintaining The WDVL. It
	allows me to write HTML without having to put on all the 'boilerplate'.
<p>
	ht generates all the header, table and footer HTML... Using a
	preprocessor such as ht provides much more flexibility than typical
	HTML editors (which anyway tend to generate bloated and unreadable code)
	- for example I can easily change the site style by changing ht and
	running source files through it..  (very powerful when combined with
	style sheets).
<p>
	An <a href="ht.ht">ht file looks like this</a>.
<p>
	You run the file through 'ht' and it sticks on the boilerplate,
	modified if necessary according to the header parameters and with any
	macros expanded. This makes it very easy to create HTML in one of our
	standard styles, but you can also control as much as you want the end
	result since the input can contain HTML. And it's also very useful for
	our mirrors, e.g. there can be small differences automatically
	introduced such as crediting the host or pointing to CGI programs on the
	primary site because we don't have CGI access on every mirror.
	With 1,000 pages to maintain this would hard to do with an editor..
<p>
	We don't currently use a database but a logical extension of this
	method would be to put the ht files into a db and then we could generate
	the pages dynamically, e.g. to account for browser differences.

	This approach isn't for everyone but anyone who wallows in Perl and
	HTML should love it.. 

	<h2>The Header</h2>

	Every ht file needs a header. The minimum header is:-
<xmp>
Content:
</xmp>
	after which comes actual content.
	Typically I only use a couple at any time. The minimum is
	"Content" and other things are defaulted or deduced - e.g. since I use
	meaningful directory names the Title usually can be derived from that
	(tho' that tends to be too brief). "Class" is very useful to specify the
	general style - e.g. "Astro" for the black background..
	You can also specify:-
<p>
<center>
<table	cellpadding=2>
	<tr>
		<th class=Type>Heading</th>	<th class=Type>Content</th>
	</tr>
	<tr>
		<th class=Name>Abstract</th>	<td class=Value>Descriptive paragraph with important keywords.</td>
	</tr>
	<tr>
		<th class=Name>Author	</th><td class=Value>Author's name or initials if regular (e.g. 'SS').
			<table cellpadding=4>
				<tr><th>	AR </th><td>	Alan Richmond</td></tr>
				<tr><th>	LR </th><td>	Lucy Richmond</td></tr>
				<tr><th>	CM </th><td>	Charlie Morey</td></tr>
				<tr><th>	DL </th><td>	Diana Luckevich</td></tr>
				<tr><th>	DW </th><td>	David Walker</td></tr>
				<tr><th>	LC </th><td>	Linda Cole</td></tr>
				<tr><th>	LM </th><td>	Laurie Mann</td></tr>
				<tr><th>	KM </th><td>	Kate Moore</td></tr>
				<tr><th>	RH </th><td>	Reaz Hoque</td></tr>
				<tr><th>	RM </th><td>	Rhonda McGuinness</td></tr>
				<tr><th>	SJT </th><td>	Steve J. Thompson</td></tr>
				<tr><th>	SS </th><td>	Selena Sol</td></tr>
			</table>
		</td>
	</tr>
	<tr>
		<th class=Name>Background</th><td class=Value>URL of background image or'<a href="/Images/Backgrounds/starfiel.gif">Stars</a>'</td>
	</tr>
	<tr>
		<th class=Name>Banner	</th>
		<td class=Value>One of
			<a href="/Images/Banners/M31.gif">WDVL</a>,
			<a href="/Images/Banners/CWSW.gif">CWSW</a>,
			None, ...
			Defaults to DoubleClick.
		</td>
	</tr>
	<tr>
		<th class=Name>Base	</th><td class=Value>Reference URL for relative links.</td>
	</tr>
	<tr>
		<th class=Name>Bgcolor	</th><td class=Value>Background color.</td>
	</tr>
	<tr>
		<th class=Name>Class	</th>
		<td class=Value>One of Astro, Plain, Table, Text, ... 
			<table>
			<tr><th>Astro</th><td>Gold text on black background</td></tr>
			<tr><th>Plain</th><td>Black text on white background</td></tr>
			<tr><th>WebTV</th><td>Obsolete</td></tr>
			<tr><th>NavMar</th><td>Obsolete</td></tr>
			<tr><th>Table</th><td>Obsolete</td></tr>
			</table>
		</td>
	</tr>
	<tr>
		<th class=Name>CSS</th>	<td class=Value>'No' to omit style sheets or 'Yes'</td>
	</tr>
	<tr>
		<th class=Name>JavaScript</th>	<td class=Value>For JavaScript functions</td>
	</tr>
	<tr>
		<th class=Name>Keywords</th>	<td class=Value>To go in the Meta tag.</td>
	</tr>
	<tr>
		<th class=Name>Link	</th>	<td class=Value>Link color.</td>
	</tr>
	<tr>
		<th class=Name>Refresh	</th>	<td class=Value>Num.seconds; URL=redirect page.</td>
	</tr>
	<tr>
		<th class=Name>Style	</th>	<td class=Value>Inline CSS.
			Probably the best way to add specific styles is to use the ht header 'Style:',
			e.g.
			<xmp>
Title : Graphics for Rocket Scientists
Author: KM
Style :
	.count	
	{
	font-family:	Arial;
	background:	transparent;
	color:		#ff6600;
	}
	+++
Content	:
Ready for blast off&nbsp;?
<span class=count>5-4-3-2-1-liftoff!</span>
			</xmp>
				You can use classes in other HTML elements such as table cells, etc.
				It looks more elaborate than just using FONT, but you get used to it..
				And if you find you want to use the same class in other files we can
				add it to the standard style sheet, and then you can easily change it
				in future, in just one place.
		</td></tr><tr>
		<th class=Name>Text	</th>	<td class=Value>Text color.</td></tr><tr>
		<th class=Name>Title	</th>	<td class=Value>Page title and first heading.</td></tr><tr>
		<th class=Name>Valid	</th>	<td class=Value>'No' or 'Yes'.</td></tr><tr>
		<th class=Name>Vlink	</th>	<td class=Value>Visited link color.</td></tr>
		<tr><th class=Name>Width</th>	<td class=Value>Text width (defaults to 85%)</td></tr>
</table>
</center>
<p>
	View the
	<a href="ht.ht">ht file for this page</a> for examples.
<p class=Info>
	Any that need more than one line should start on the line <em>after</em>
	the ':' and be terminated with '+++' on it's own line.
</p>
	If there
	is just a single lines worth, then it goes on the same line as the
	item name,
<xmp>
Abstract :   This is a very short description.
</xmp>
	If there is more than one line's worth,
	then
<ol>
<li>	the content part begins a new line and 
<li>	it ends with a line containing only +++
</ol>
<xmp>
Abstract :
	This is a much longer description. 
	It can go on for several lines.
	The indenting is just to make it easier
	to read - it has no effect on ht.
	+++
</xmp>
	<h2>	Tables	</h2>

	The other main thing about ht files is there's a few 'macros'
(shorthand or abbreviations), esp for commonly-used table layouts..
<xmp>
[!{{	Big Bold Heading	}}!|

	Next cell in the row. Blah blah.
	|;
|!{{	Next Row, Big Bold Heading	}}!|

	Bottom right cell
|]
</xmp>
	Looks like this:
[!{{	Big Bold Heading	}}!|

	Next cell in the row. Blah blah.
	|;
|!{{	Next Row, Big Bold Heading	}}!|

	Bottom right cell
|]
<xmp>
	[!   Begin table with header
        [|   Begin table with data cell
        |!   table header
        !!   table header
        |_   table cell
        !|   table cell
        {{   bigger
        }}   bigger end
        !;   end of table row
        |;   end of table row
        !]   end of table
        |]   end of table
</xmp>
	There are probably some notes that need to go with these but for now
just look at some examples..

	<h2>	Other Macros	</h2>

	There are some more macros, typically functional like href:-
<xmp>
Title   :       The Two Best Sites for Web Developers
Class   :       Plain
Content :
[!{{    @href(http://www.w3.org/,The W3C)       }}!|

	This is the site of the
	World Wide Web Consortium...
	|;
|!{{	@href(http://WWW.Stars.com/,The WDVL)   }}!|

	The Web Developer's Virtual Library...
|]
</xmp>
<center>
	@Prev (ht.html) @Up (index.html) @Next (ht.html)
</center>
<xmp>
<center>
	@Prev (ht.html) @Up (index.html) @Next (ht.html)
</center>
</xmp>