Thnx for the links. I also found a use.perl.org entry reviewing Pod::POM::Web with a screenshot link. And then found several other solutions on CPAN. I'd forgotten about the Pod::POM namespace.

But based on what I've seen thus far, Pod::ProjectDocs comes closest to what I'm after: a minimal solution to format the complete POD for a project, and that I can subclass for some add'l features I need. I don't really need/want a full webserver based solution, just the docs, and I'd rather not have to navigate an entire document model. With ProjectDocs, I can just grab or filter out what I need with a few regexen. Then just copy it up to a website for public consumption.

Which leads me to think I've got 2 distinct issues:

  1. The general problem of converting nested HTML lists to a JS tree
  2. The specific issue of easing navigation of POD project docs
(Note that if the nested lists were in their own div, or if the outermost list had a unique ID, the conversion could be done entirely in Javascript. But that much recursive Javascript in the browser makes me nervous).

After some minor changes to my HTML nested lists hack, I successfully applied it to some other non-POD web pages in dire need of refreshing/easier navigation. Which also leads me to think that using HTML nested lists might be a nice notation for generating JS tree widgets, since the HTML would be pretty standard, whereas there are about 1,000,000 different JS tree widget APIs roaming the web.

Perl Contrarian & SQL fanboy

In reply to Re^2: Convert nested list HTML TOC to JS Tree ? by renodino
in thread Convert nested list HTML TOC to JS Tree ? by renodino

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.