Re: Moving peardoc to XSLT

Hi Christian, I think that is a great idea. For what its worth, I've just posted Nexista as a pear package on google's code project. I mention this as nexista has some useful xsl tools you may want to review. I will likely setup a nexista channel in the future, but first I'll need to conform to PEAR's coding standards. :-) Albert On 6/1/07, Christian Weiske <cweiske@cweiske.de> wrote:

Hello all, Most of you which ever tried to compile peardoc know that the dsssl stylesheets are a pain to setup and get running. Since we all want more documentation and have it easy to write documentation, we need to do something. The first thing that needs to be done is dropping the DSSSL stylesheets in favor of XSLT. It has several advantages: - XSLT is faster than DSSSL (citation needed) - I know nobody in PEAR that is familiar customizing the current dsssl stylesheets - There are some PEAR devs that know XSLT - XSLT is more easy to setup - phpdoc, php-gtk-doc and Livedocs use XSLT, too - Switching to XSLT would bring us livedocs - We could finally customize the looks of the manual on the webpage and make it more user friendly. See http://www.markwiesemann.eu/tmp/pear-manual4.png and the discussion in http://news.php.net/php.pear.doc/9704 (click the references to get more shots) Since I currently am working on my diploma thesis, someone else would need to take the lead in this project. The following tasks are to be done: - Check out phpdoc and see if we can use its system with as few changes as possible - Contact phpdoc people and ask them how to start best - Contact livedoc gsoc people and ask what we need to do to be livedoc-compatible - When all info is collected, make peardoc's build system to use xslt and support different sheets - Create XSLT sheets for the website, maybe modify the standard html xslt for offline docs Having customized php-gtk-doc in a great deal, I have experience in editing XSLT. You can count on my help once this stage is reached. peardoc bug entry: http://pear.php.net/bugs/bug.php?id=10843 Livedocs gsoc project: http://de3.php.net/ideas.php and http://wiki.phpdoc.info/LiveDocs Further ideas are also welcome! -- Christian Weiske -- PEAR Development Mailing List (http://pear.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php

-- My Blogs: http://www.docunext.com/ http://www.albertlash.com/