Installing Xhtmlpp

Getting Xhtmlpp

Xhtmlpp is available from the Xhtmlpp website as a tgz file for UNIX.
You need gunzip and tar to extract the files from the archive.
You need Perl 5.x for your platform.
You need Image::Size from cpan.
Xhtmlpp comes with a small example - its own documentation.

Installation Under Unix

Download the xhtmlpp.tgz file.
Extract the archive file:
```
	tar zxvf xhtmlpp.tgz
```
This will create a directory (in the current directory) called xhtmlpp which contains all the source and documentation.
cd to the xhtmlpp directory and
```
	make install
```
This will install the main script in /usr/local/bin the documentation in /usr/local/doc/xhtmlpp-1.0d the support files in /usr/local/lib/xhtmlpp the perl modules in /usr/lib/perl5/site_perl/5.6.0. You may need to be root to put files in some of these directories.
If you want them installed in other places (for example, if you aren't root), edit the Makefile. Alter PREFIX to put things somewhere other than /usr/local and alter PERLLIBDIR to put the modules somewhere other than /usr/lib/perl5/site_perl/5.6.0. For example, you may wish to create a xhtmlpp directory in your home directory, and add $HOME/xhtmlpp/bin to your path.
Make sure the xhtmlpp file has execute permission.
```
	chmod +x xhtmlpp
```

Run the xhtmlpp command with no arguments and you will see the following output:

XHtmlpp - an XHTML pre-processor V1.0d
This is free software and may be freely modified and distributed.
Copyright (c) 2001 Kathryn Andersen http://www.katspace.com

syntax: xhtmlpp [-debug] [-guru] [-notable] [-nounderline] [-l] [-env] [-nofunc] [-page list] [-set name=value]
               [-charset value] ...

    -debug      Leave work files: useful for debugging macros and loops
    -guru       Work in Guru Mode
    -notable    No tables in Guru Mode
    -nounderline No underlines in Guru Mode
    -l          Short line length 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 FindFile.pm 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/xhtmlpp line 26.

This means that the Perl interpreter cannot find a file specified by the 'require' command in the @INC path. There are two solutions to this problem: set your PERL5LIB environment variable to include the directory defined in PERLLIBDIR in the Makefile, or alter PERLLIBDIR in the makefile to be one of the directories mentioned in the error message, and make install again (and check the files were actually copied).

KatSpace
Validate Me!