Node: Top
How2 - A Linux HOWTO document viewer and query program
how2www - The LDP HOWTO
Node to HTML Gateway
Copyright: This program is in the Public Domain.
Latest version is 2.0.1 - see the
README text or
readme.html
for more information.
The how2www script makes your
CGI compliant HTTP/1.0 or later server a gateway to all that
information you have "stacked away" in the LDP HOWTO
Nodes (also accessible from www.biblio.org).
The HOWTO Nodes are parsed and formatted on the fly by
how2www, presenting hyperlinks to other HOWTO Nodes that your WWW
browser can use.
Configuration and installation
The following steps are necessary for getting how2www up and
running:
Make sure that Perl is installed on your system
Choose a directory under your DocumentRoot directory,
e.g. DocumentRoot/how2-www
for keeping your documents in.
Place the how2www CGI
(currently in the zip-file how2.zip
in the DocumentRoot/cgi-bin directory
Edit the how2www script and make the following changes:
Change the first line to use the path to where
Perl is installed on your system.
Change the @INFOPATH
array to contain the directory(-ies) where
you keep your LDP HOWTO Node files.
Change the %ALIAS
associative array to map aliases the way you
like.
If the path to your how2www directory is
different than DocumentRoot/how2-www
then change the references to where the
icons are really located (relative to DocumentRoot).
You can even set one or more icon references to
"" and that icon will not be used!
If you want to use your own local copy of this
document then change $DOCREF to point at
your own URL for this document.
Copy or make a link of how2www to your CGI script
directory - e.g. DocumentRoot/cgi-bin.
Include hyperlinks to the how2www CGI interface wherever
you want in your other hypertext documents.
Using how2www
The how2www script should be called with 0 or 1 argument as
follows:
how2www - The LDP HOWTO
Node to HTML Gateway