Monday, November 26. 2007PhD docu builds are online!
The docs generated by the brand new docu build system PhD ([CVS], [releases]) written by Hanness Magnusson, after several months of development are finally online!
Feel the difference: With the old OpenJade/DocBook it took 40-60 minutes to build 'many htmls' version of the manual. With PhD it takes less than 2 minutes to build all three formats (`phpweb`, `one big html` and `many htmls`). Kudos to Bjori! Trackbacks
Trackback specific URI for this entry
No Trackbacks
Comments
Display comments as
(Linear | Threaded)
Thanks!
 We are now working on a massive structural upgrade of the docs - hopefully exposing information to the user that he may never had found otherwise. Furthermore Object Oriented documentation should be readable after the upgrade \o/ These upgrades will be running on our experimental/test server, http://docs.php.net, and should show up later today/tomorrow so stay tuned! 
Awesome news!
Question about PhD. Is it a general-purpose DocBook parsing tool in/for PHP, or is it only really useful for the PHP Documentation? I've a DocBook project that I've been building using the normal DocBook XSL toolchain in Java, and it breaks every time I touch it because of some Java classpath or versioning problem. I've been pondering switching over to PHP for the build tools, but I've found little documentation on building a complex DocBook project, with DocBook XSL or anything else. Is PhD something worth looking into for that?
At the moment PhD only implements the subset of Docbook elements that phpdoc uses.
Furthermore there is no "generic template", its highly php.net tuned. PhD will be a general purpose Docbook renderer in the future, but since phpdoc is going through a major restructure all work on PhD is pretty much on hold until we finish the restructuring of phpdoc. So, in all honesty, I'd wait with looking into PhD for other projects for at least couple of months. However, adding support for more Docbook elements - and creating a template/theme - is extremely easy in PhD if you know the PHP syntax, its basically one-to-one mapping of Docbook elements to PHP functions. I'd be more than happy assist in adding better/more support for various Docbook elements and writing generic template/theme if someone is interested in helping out
Likely the next project that uses PhD is the PEAR manual... but don't distract Hannes from the PHP Manual yet!
Ha, perish the thought.
I'll try to struggle through with the Java toolchain for the time being. Do you know of any decent tutorials on using PHP for the DocBook XSL project, instead of a collection of a dozen Java tools?
ASAIK PhD is the only PHP based tool in the "Docbook business".
Up until now we have been using our own customized Docbook XSL stylesheets (called phpbook), rendered with xsltproc.
AFAIK , phpDocumentor also implements a subset of docbook elements. And , except highlighting ( at least i'm not aware how to use it) , xsltproc works just fine for text output.
|
QuicksearchArchivesCategoriesSyndicate This Blog |
