RE: automatic generation of quickref.html

At 11:51 PM 3/21/2005 -0500, Jelks Cabaniss wrote:
>Charlie wrote:
> > I third the motion.  I originally generated quickref.html from an XML
> > file.  The idea being you could generate a man page and quick
> > reference from the same doc source.  I have attached what I think are
> > the original XSLT stylesheet and XML data file.
>
>I very much like your XML file.  Perfect.

Thanks

> > You end up wanting to embed basic HTML within the documentation for
> > each option.  Modularizing HTML is still pretty much broken.
>
>What kind of HTML do you want to embed?  Something like ...
>
>         <tag> tag's contents </tag>
>
>... doesn't work?  What are you trying to do?

That works - sort of.  It becomes difficult to distinguish between example 
markup (which is common and useful in a quick reference) and actual 
rendering <code>&lt;code&gt;</code>, IYSWIM.


> > What most folks end up doing is embed CDATA sections, in which
> > case the result is no good for man pages.
>
>Maybe it's not getting parsed?   Also, something like this might provide a
>base:
>
>         http://docbook2x.sourceforge.net/latest/doc/manpages.html

Doc Book (or something like it) may be a good choice.




-------------------------------------------------------
SF email is sponsored by - The IT Product Guide
Read honest & candid reviews on hundreds of IT Products from real users.
Discover which products truly live up to the hype. Start reading now.
http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click