Re: [PHP-DOC] Someone that can help w/ our XSLT stylesheets

[Gabor Hojtsy]

>> I am cc'ing him in this message, and hopefully the
>> DSSSL/XSLT gurus in the PHPDOC team could get in touch
>> with Doug and see what can be done. He has the
>> expertise, the desire and the availability.
>
>
> I added the unofficial official manual generation
> gurus to the cc list. See also:
>
> http://cvs.php.net/co.php/phpdoc/RFC/pdf_problems


Welcome Doug :)

Some information on how to get started with phpdoc and XSLT.

A. Build system:

The current build system searches for xsltproc, which as we tested is the speediest XSLT processor. This search works on Linux and Windows too (cygwin on windows includes xsltproc). There are two make targets using XSLT sheets, html_xsl and chm_xsl. The latter *is* used to generate the http://weblabor.hu/php-doc-chm edition of the manual, so it is proven that it works.

B. Stylesheets

We have our XSLT customizations in phpdoc/xsl, and a copy of the used parts of the DocBook XSL sheets in phpdoc/xsl/docbook. This is to avoid the problems of non-compatible XSLT sheets. Our customizations may not work with all versions of the DocBook sheets, as we have some heavy modifications at some points (particularly in the htmlhelp sheets).

C. Problems, work to do

As far as I know, the html, phpweb (will be used to build up the PHP files for php.net and mirror sites) and htmlhelp (used for php-doc-chm edition) sheets are tested, and nearly ready for usage, but we have one problem. The TOCs are too deep. There is no general parameter in DocBook XSL to limit toc deepness to some level, as far as I know. I don't know of any other problem, we cannot change to use XSLT sheets for HTML / PHP generation. I cannot provide you more information on PDFs then what's written in phpdoc/RFC/pdf_problems, I have not tested PDF generation myself with any tool.

Using xsltproc also has some effects on other parts of the build system, but I would not like to go into detail about it, not to threaten Doug, as the rendering issues are the first to solve...

Goba



--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php