CODEWITHSUNDEEP
perl
Jonathan Swartz
Jonathan Swartz

Reputation: 1983

Modern POD to HTML converter to produce results like search.cpan.org

Is there code available to convert POD to HTML in a similar manner as search.cpan.org? I'd like to run it over my CPAN distribution modules to see how they'll look before releasing.

The pod2html that comes with Perl seems rather outdated. It does quaint things like depositing temporary files in the current directory and creating links like "the so-and-so manpage", and the output is far inferior to the beautiful output of search.cpan.org. But not sure what other people are using.

Upvotes: 7

Views: 1648

Answers (4)

toolic
toolic

Reputation: 62083

Before I upload to CPAN, I check my POD by looking at it in a browser from http://search.cpan.org/pod2html.

Form there, I click on Browse...

I navigate to the directory containing my code and double-click on the .pm file.

Then click on Submit Query.

It's the closest I've seen to the real thing.

See also pod2cpanhtml.

Upvotes: 12

mob
mob

Reputation: 118605

According to this perlmonks thread, the trick is to use Pod::HtmlEasy. Or maybe the trick is to use Apache::Pod::HTML. Or Pod::Tree? I don't know, but there are a few suggestions there.

Upvotes: 2

bvr
bvr

Reputation: 9697

Adding to mob's suggestions, I was quite happy with Pod::ProjectDocs. It needed few minor tweaks, but it looks more or less like CPAN.

Upvotes: 4

jmcnamara
jmcnamara

Reputation: 41594

I wrote pod2cpanhtml for exactly the reasons you describe.

It is only a tiny piece of code that makes use of Pod::Simple::HTML and the search.cpan.org CSS but I find it very useful.

Upvotes: 8

Related Questions