agarsha has asked for the wisdom of the Perl Monks concerning the following question:

If you look at www.perldoc.com documentation it looks like jazzed up pod2html output. Is there a jazzier pod2html script/utility available (that I can use for my stuff)?

Title edit by tye

  • Comment on Better pod2html, like www.perldoc.com ?

Replies are listed 'Best First'.
Re: pod2html
by edoc (Chaplain) on Jun 04, 2003 at 02:43 UTC

    I found pods2html to be pretty cool. You can specify the css to use and it'll include a reference to that in every doc page. I use the following command and css. (actually I just cut out a heap of guff from the css, it was a bit of a mess.. could probably do with more work, but it's a starting point)

    pods2html --css http://www.example.com/css/perldoc.css --index MyDocs +--toc /path/to/modules /path/where/docs/should/go BODY { background: white; color: black; font-family: arial,sans-serif; margin: 0; padding: 1ex; } TABLE { border-collapse: collapse; border-spacing: 0; border-width: 0; color: inherit; } TD { margin: 0; padding: 0; } DIV { border-width: 0; } DT { margin-top: 1em; } TH { background: #bbbbbb; color: inherit; padding: 0.4ex 1ex; text-align: left; } TH A:link, TH A:visited { background: transparent; color: black; } PRE { background: #dddddd; border: 1px solid black; color: black; padding-top: 1em; padding-bottom: 1em; white-space: pre; } H1 { background: transparent; color: #006699; font-size: large; } H2 { background: transparent; color: #006699; font-size: medium; } LI { line-height: 1.2em; list-style-type: none; }

    cheers,

    J

      Beautiful. Thanks! --adam
Re: pod2html
by jsprat (Curate) on Jun 04, 2003 at 06:36 UTC
    Look here - the author of perldoc.com uses Pod::Tree::HTML.

    If it's good enough for him, it may be good enough for you? ;-)

Re: pod2html
by halley (Prior) on Jun 04, 2003 at 03:07 UTC
    The pod2html encoder sometimes has some spurious /PRE PRE breaks in the middle of preformatted text, which makes two outlines on some browsers if your CSS does outlines. I filter any adjacent /PRE PRE tags out with a post-process. I also do a little color-coding of comments inside PRE blocks. Nothing exciting.

    --
    [ e d @ h a l l e y . c c ]

      Thanks, I just ran into that. Good advice. --adam

      I think this might be caused by blank lines that aren't really blank, ie they contain spaces or tabs.

      cheers,

      J