开发者

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.开发者_JAVA百科 But not sure what other people are using.


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.


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.


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.


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.

0

上一篇:

下一篇:

精彩评论

暂无评论...
验证码 换一张
取 消

最新问答

问答排行榜