[Bioperl-l] BioPerl POD

[Chris Fields]

pdoc, I believe, is used for the doc.bioperl.org site:

http://pdoc.sourceforge.net/

Most POD->HTML converters are simple for a reason, sites generally use CSS to deal with formatting.  You could get around that with a few tools that embed the formatting with the HTML elements (see below link for examples), but I highly suggest using CSS if possible.  

Here's a stackoverflow article on the search.cpan.org HTML output:

http://stackoverflow.com/questions/4996684/modern-pod-to-html-converter-to-produce-results-like-search-cpan-org

Also, ActiveState has another one that generates their custom HTML (pretty nice), it comes with their perl dist I think.

chris

On Mar 2, 2011, at 10:01 AM, Daniel Standage wrote:

> BioPerl,
> 
> I've been writing Perl (and BioPerl) for several years now, but I have
> little to know experience using POD. I've added some POD to a module I wrote
> and now I am trying to create an HTML page from it. I was able to do so with
> *pod2html*, but the output is...underwhelming. The docs at
> http://doc.bioperl.org aren't the essence of beauty themselves, but they do
> have a bit of color and really nice features (like links to the code, etc).
> 
> Which tool(s) was/were used to generate the BioPerl HTML docs?
> 
> --
> Daniel S. Standage
> Graduate Research Assistant
> Bioinformatics and Computational Biology Program
> Iowa State University
> _______________________________________________
> Bioperl-l mailing list
> Bioperl-l at lists.open-bio.org
> http://lists.open-bio.org/mailman/listinfo/bioperl-l