Installing Htmlpp

| iMatix home page
| htmlpp home page
| << | < | > | >>

htmlpp
Version 4.2a

Installing Htmlpp

Getting Htmlpp

Htmlpp is available from the iMatix website as a zip file for Windows or DOS or OS/2 and as a tgz file for UNIX.
You need PKUNZIP for MS-DOS, Info-zip's unzip for most platforms, or some other compatible unzip tool.
You need Perl 4.x or 5.x for your platform, or bperl for MS-DOS.
Htmlpp comes with a small example - its own documentation. A larger example - the Libero documentation - is also on-line as a zip file from the iMatix website.

Installation Under Unix

Make sure your PERLLIB environmental variable is set, e.g.:

$ echo $PERLLIB
/usr/lib/perl5

This is the path where the Perl interpreter can find standard Perl libraries. If you see a blank line after the echo command, then your PERLLIB environmental (shell) variable is not set. For Perl 5 distributions, the default PERLLIB path is /usr/lib/perl5. It is a good idea just to put the assignment of the PERLLIB variable into your login command file. See the appropriate man page for your shell for more information.

Then:

Download either the htmlpp.tgz or the htmlpp.zip file.
Make a directory for the contents of this distribution:
```
mkdir /usr/local/htmlpp
```
Copy the downloaded archive to this directory:
```
cp htmlpp.X /usr/local/htmlpp
```

cd to this directory and extract the archive file:

Archive:        Extract using:
--------        --------------
htmlpp.tgz              tar zxvf htmlpp.tgz
htmlpp.zip              unzip -a htmlpp.zip

Copy the htmlpp file to a common directory, such as /usr/local/bin. Make sure the htmlpp file has execute permission.

Copy all the .pl file and the htmlpp.d file from htmlpp directory to the PERLLIB directory (Usually, /usr/lib/perl5).

cp /usr/local/htmlpp/*.pl $PERLLIB/

Run the htmlpp command with no arguments and you will see the following ouput:

Htmlpp - a HTML pre-processor V4.2a
This is free software and may be freely modified and distributed.
Copyright (c) 1996-98 iMatix Corporation - http://www.imatix.com

syntax: htmlpp [-debug] [-guru] [-env] [-nofunc] [-page list] [-set name=value]
               [-charset value] <filename>...

    -debug      Leave work files: useful for debugging macros and loops
    -guru       Work in Guru Mode
    -env        Load all environment variables into document symbol table
    -nofunc     Ignore unknown intrinsic functions (&xxx)
    -page       Produce only specified pages; list can take any of these
                forms: 'nn', 'nn-nn', 'nn,nn,nn'.  E.g. -page 1 -page 3,7
                You can also refer to output filenames: -page index3.htm
    -set        Set symbol value. This override any default settings or
                settings made from within the htmlpp input.
    -charset    Define the character set for the source input.
                Valid values are 'iso-8859-1' and 'ms-dos'.

If you see an error message such as the following:

Can't locate sflcvdp.pl in @INC
(@INC contains: /usr/lib/perl5/i586-linux/5.00404
/usr/lib/perl5 /usr/lib/perl5/site_perl/i586-linux
/usr/lib/perl5/site_perl .)
at /usr/local/bin/htmlpp line 26.

This means that the Perl interpreter cannot find a file specified by the 'require' command in the @INC path. Make sure you have copied all the *.pl files from the htmlpp directory into $PERLLIB and that the PERLLIB shell variable is set to this path.

Installation Under MS-DOS

You must have Perl 4.x or 5.x on your system; I recommend you use Big Perl. Bperl requires a 386 and a certain amount of memory. Check the Bperl documentation for details.
Download and unzip htmlpp.zip.
Check htmlpp.bat - it assumes that the files are installed in C:\SPECIAL, which is how my system is set-up. Also, it assumes that Big Perl is called bperl; it might be called simply perl.
Install htmlpp, htmlpp.bat, and htmlpp.d in some convenient directory that is on your path.
Install all the .pl files that come with htmlpp in the same directory.
Change your autoexec.bat to define a variable PERLLIB. On my system, this is defined like this: set perllib=c:\special;c:\gnutools. Reboot or create a new DOS window.

Run the htmlpp command without arguments. You should get a message like this:

Htmlpp - a HTML pre-processor V4.2a
This is free software and may be freely modified and distributed.
Copyright (c) 1996-98 iMatix Corporation - http://www.imatix.com

syntax: htmlpp [-debug] [-guru] [-env] [-nofunc] [-page list] [-set name=value]
               [-charset value] <filename>...

    -debug      Leave work files: useful for debugging macros and loops
    -guru       Work in Guru Mode
    -env        Load all environment variables into document symbol table
    -nofunc     Ignore unknown intrinsic functions (&xxx)
    -page       Produce only specified pages; list can take any of these
                forms: 'nn', 'nn-nn', 'nn,nn,nn'.  E.g. -page 1 -page 3,7
                You can also refer to output filenames: -page index3.htm
    -set        Set symbol value. This override any default settings or
                settings made from within the htmlpp input.
    -charset    Define the character set for the source input.
                Valid values are 'iso-8859-1' and 'ms-dos'.

Installation Under 32-bit Windows

Download Perl for Windows from http://www.activestate.com/.
Download and unzip htmlpp.zip.
Check htmlpp.bat - it assumes that the files are installed in C:\SPECIAL, which is how my system is set-up. Also, it assumes that Perl is called bperl; change this to 'perl'.
Install htmlpp, htmlpp.bat, and htmlpp.d in some convenient directory that is on your path.
Install all the .pl files that come with htmlpp in the same directory.
Change your autoexec.bat to define a variable PERLLIB. On my system, this is defined like this: set perllib=c:\special;c:\gnutools. Reboot or create a new DOS window.

Run the htmlpp command it without arguments. You should get a message like this:

Htmlpp - a HTML pre-processor V4.2a
This is free software and may be freely modified and distributed.
Copyright (c) 1996-98 iMatix Corporation - http://www.imatix.com

syntax: htmlpp [-debug] [-guru] [-env] [-nofunc] [-page list] [-set name=value]
               [-charset value] <filename>...

    -debug      Leave work files: useful for debugging macros and loops
    -guru       Work in Guru Mode
    -env        Load all environment variables into document symbol table
    -nofunc     Ignore unknown intrinsic functions (&xxx)
    -page       Produce only specified pages; list can take any of these
                forms: 'nn', 'nn-nn', 'nn,nn,nn'.  E.g. -page 1 -page 3,7
                You can also refer to output filenames: -page index3.htm
    -set        Set symbol value. This override any default settings or
                settings made from within the htmlpp input.
    -charset    Define the character set for the source input.
                Valid values are 'iso-8859-1' and 'ms-dos'.