sample example readme
----------------------

For pmpp version 0.01
$Id: README,v 1.2 1999/02/21 05:11:01 kev Exp kev $

This is a sample example of how to use pmpp.  It's more involved than the
simple example, but still limited in usefulness.  Again, it should be good
in giving you a feel for how pmpp works in a more advanced way.

First, have a look at it in action.  Choose the "text" mode of output by
running:

./changeto txt

then run pmpp with:

pmpp sample.pmpp

This will create the text file sample.out, using the config file
sample.pmpp, and, by virtue of the symlinks, the template file
sample.tmpl.txt, header file sample.header.txt and footer file
sample.footer.txt.

Now choose the "html" mode of output by running:

./changeto html

then run pmpp with:

pmpp sample.pmpp

This will regenerate sample.out, but this time using sample.tmpl.html,
sample.header.html and sample.footer.html.  Load sample.out in your web
browser, and notice how the same information can be displayed very
differently.

(Yeah, I know the symlinks are very kludgey, the next version of pmpp
should make it easier to use different sets of templates, headers and
footers with the same articles.)

If you now want to know how it all works, check out the templates, headers
and footers for both the text and html modes.  The file changeto is a
simple shell script to setup the symlinks sample.template, sample.header,
and sample.footer to point to either the txt or html versions of those
files.


