Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

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

Tags:

perl

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.

like image 495
Jonathan Swartz Avatar asked Feb 14 '11 20:02

Jonathan Swartz


2 Answers

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.

like image 84
toolic Avatar answered Sep 21 '22 18:09

toolic


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.

like image 31
jmcnamara Avatar answered Sep 25 '22 18:09

jmcnamara