| 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'.

| << | < | > | >> | htmlpp - The HTML Preprocessor | Installing Htmlpp | Getting Started | Htmlpp Reference | Frequently Asked Questions | Other Information | Copyright © 1996-97 iMatix