Re: how is the html on search.cpan.org generated?

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