On Tue, 2009-10-20 at 14:19 +0100, Mitch Gower wrote:
> The pod to html conversion used on search.cpan.org seems to produce
> quite nice output. What tool is being used there, and is it publicly
> available? I couldn't see any evidence in the html itself of what's
> being used.
As far as I know, the source for Graham Barr's search.cpan.org site is
not available in a public repo. There are a number of modules on CPAN
that can deliver HTML from POD in a similar form.
At the moment, I'm using Apache2::Pod and have this snippet in my Apache
config:
<Location /perldoc>
SetHandler perl-script
PerlHandler Apache2::Pod::HTML
PerlSetVar INDEX 1
PerlSetVar STYLESHEET /pod-style.css
PerlSetVar LINKBASE LOCAL
</Location>
In my browser I can view the POD of installed modules using a URL like
this:
http://putnam/perldoc/Apache2::Pod::HTML
The module has a built-in CSS stylesheet which you can use like this:
PerlSetVar STYLESHEET auto
But I've got a slightly modified version in /pod-style.css which more
closely emulates the styles on search.cpan.org.
Cheers
Grant
