Re: Re: Examples at pear documentation
| From: | Jesus M. Castagnetto | Date: | Wed, 29 Oct 2003 23:08:34 +0000 |
| Subject: | Re: Re: Examples at pear documentation | ||
| References: | 1 | Groups: | php.pear.doc |
| Request: | Send a blank email to pear-doc+get-1818@lists.php.net to get a copy of this message | ||
No much luck, short of fixing all the DSSSL for HTML
that came w/ my Linux distribution, the output is not
really XHTML compliant. Fixing the local definitions
in peardoc just works for examples, etc.
On a hunch I tried using the xsl stylesheets on the
phpdoc dir tree (main PHP manual), and that does
generate tags that are lowercased, but the model is
not strictly XHTML, but HTML, similar results than the
docs generated from the DSSSL (except for the case of
tags and attributes).
Hacking the xsl/html.xsl in phpdoc to point to import
the xhtml/chunkfast.xsl that I have from my distro
seems to work better. Tested using 'tidy' on the
generated HTML files and tidy was happy with the
output.
Bottomline: not the ultimate solution, but perhaps
using XSL stylesheets instead of the default DSSSL
might make life easier (at least I can understand
what's going on in XSLT). Also there are other XSL for
HTMLHelp and such, eg.
http://www.dpawson.co.uk/docbook/styling/htmlhelp.html
Won't have time to keep playing with this for at least
a couple of weeks, so if someone wants to keep
investigating the XSL possibilities for PEARDOC, check
the URL above and the way they are doing it in phpdoc.
--- "Jesus M. Castagnetto" <jmcastagnetto@yahoo.com>
wrote:
> Yep, the stylesheets might use some cleaning up to
> make them XHTML strict. My experience w/ DSSSL is
> limited, I'll try hacking up html-common.dsl.in
> today
> (the institute is almost empty because of the fires
> in
> San Diego, most places have been closed since
> Monday).
>
> --- Klaus Guenther <klaus@capitalfocus.org> wrote:
> >
> > > > <tt
> > > > CLASS="parameter"
> > > > ><i
> > > > >'=='</i
> > > > ></tt
> > > > > like the colon in short options.
> > > >
> > > > should IMO be:
> > > > <tt
> > > > CLASS="parameter"><i>'=='</i></tt> like
> the
> > > > colon in short options.
> > >
> > > Those tags are valid ones, generated using the
> > > stylesheets applied to the original DocBook XML
> > > source. They do not need to look nice, they just
> > need
> > > to be valid (and they are AFAIK). If you would
> > like
> > > them to look nice, you could modify the XSL or
> > DSSSL
> > > stylesheets and send the patches to us (or even
> > better
> > > to the DocBook developers so others can also
> > benefit).
> >
> > Jesus,
> >
> > In spite of your being correct about breakage,
> there
> > is still a problem...
> > XHTML requires that the attribute name be written
> > "class", not "CLASS".
> >
> > http://www.w3.org/TR/xhtml1/#h-4.2
> >
> > Maybe that can be corrected...
> >
> > Klaus
> >
> > --
> > PEAR Documentation List Mailing List
> > (http://pear.php.net/)
> > To unsubscribe, visit:
> http://www.php.net/unsub.php
> >
>
> =====
> --- Jesus M. Castagnetto <jmcastagnetto@php.net>
>
> __________________________________
> Do you Yahoo!?
> Exclusive Video Premiere - Britney Spears
> http://launch.yahoo.com/promos/britneyspears/
>
> --
> PEAR Documentation List Mailing List
> (http://pear.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
>
=====
--- Jesus M. Castagnetto <jmcastagnetto@php.net>
__________________________________
Do you Yahoo!?
Exclusive Video Premiere - Britney Spears
http://launch.yahoo.com/promos/britneyspears/