Hi,

It's too bad that I wasn't aware of this list so far, now I'm :)

I'm using POD for a long period to write my mod_perl guide
(http://perl.apache.org/guide/). I use it as well for generating my
tutorials handouts and slides. Finally we use it in the book we are
currently working for.

Since I need to generate PS/PDF book versions, I've adopted the html2ps
utility and integrated into a package of my own, which I've called
Pod::HtmlPsPdf, since it converts a number of files, (which may be
scattered across many directories) and generates HTML, PS and PDF
versions.

Currently it's based on the hacked version of Pod::Html from the perl
5.005_03 distro, but should be ported to the Pod::Tree and other modules,
when I have the time. I've extended the pod with new tags, that I needed.
They are documented in the distro.

Nevertheless you may find it useful. You can get it from my CPAN
directory:
http://search.cpan.org/search?mode=module&query=Pod%3A%3AHtmlPsPdf

You can see how it works by grabbing the mod_perl guide sources and
building the HTML, PS and PDF versions of it.
http://search.cpan.org/search?mode=module&query=apache%3A%3Amod_perl_guide

If you want to see the final PDF version you can grab it here:
http://perl.apache.org/guide/mod_perl_guide.pdf.gz (warning: the file is
big)

As I've mentioned before I use it also to generate slides and handouts,
you can check some of these here: http://www.stason.org/talks/. My module
allows you an easy way to create bullets by preparsing the source and
converting '*' into =over/=item/=back on the fly.

Finally it produces a split version of the HTML, which improves the
searching results presentation for otherwise huge HTML file.
e.g. you can see:  http://thingy.kcilink.com/modperlguide/index.html and
test the search from http://thingy.kcilink.com/cgi-bin/modperlguide.cgi

Enjoy...

_____________________________________________________________________
Stas Bekman              JAm_pH     --   Just Another mod_perl Hacker
http://stason.org/       mod_perl Guide  http://perl.apache.org/guide
mailto:[EMAIL PROTECTED]   http://apachetoday.com http://logilune.com/
http://singlesheaven.com http://perl.apache.org http://perlmonth.com/


Reply via email to