Re: Moving peardoc to XSLT

On 6/1/07, Christian Weiske <cweiske@cweiske.de> wrote:

Hannes,

- Switching to XSLT would bring us livedocs

Thats not true. livedocs has (almost) nothing to do with either DSSSSSSL or XSL. Then I was wrongly informed. In php-gtk-doc I did the livedocs with xslt, and we have a method to generated only one single page only - also via xslt. I thought your livedocs would be similar, but it seems I'm wrong here.

You generated "single pages" probably with xsltproc using the xsl stylesheets (xsltproc --stringparam rootid <insert-id-here> <xslt-stylesheet> <root.xml.file>, i.e. xsltproc --stringparam rootid function.strpos phpbook/phpboo-xsl/phpweb.xsl manual.xml to generate the strpos() manual page). With livedocs you'll just hit http://localhost/strpos in your browser and tata.

I will be working on livedocs for the next few months and I would much rather spend time on peardoc+livedocs than xsl The main problem, that nobody is able to actually change DSSSL sheets, remains and that means that we cannot deeply influence pear's documentation on the website. Only xsl will resolve that issue in my opinion.

Indeed, which is why I moved phpdoc to use xsl few months ago (well, the main reason was actually I got fed up waiting more than 24hours for a dsssl build..). Anyway. If you really want to move to xsl and then again to livedocs in few months I'll make it happen, but I do recommend waiting for livedocs (unless there are major changes you want to implement into the docs _now_). -Hannes