Some ruminations -- Re: [PEAR-DOC] Upgrading to Docbook 4.3

From: Date: Fri, 14 May 2004 22:30:28 +0000
Subject: Some ruminations -- Re: [PEAR-DOC] Upgrading to Docbook 4.3
References: 1  Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-3981@lists.php.net to get a copy of this message
Apart from moving to Docbook 4.3, we should also think on moving the translations out of the main (English) documentation and into their own CVS dirs. It will make life easier in the future and now it will be less painful than later, we should repeat the pain that happened when that was done in PHPDOC, the sooner the better. Another thing, is that (apart from Livedocs for rendering), there has been some talk on the management of the documentation itself. Some eons ago (years perhaps?) Rasmus pointed out Mandrake's "Borges" project [1] . Back then when I looked at it, the project was very alpha, maybe a it will warrant a second look now that we are planning on doing some changes to PEARDOC. Kind of off a tangent, but when googling for some reST to DocBook tools (to play with), I stumbled in a discussion at OpenACS on Docbook making it difficult for people to write documentation for their project [2]. Cheers. [1] http://www.linux-mandrake.com/en/doc/project/Borges/ [2] http://openacs.org/forums/message-view?message_id=108949 --- Alexander Merz <alexander.merz@web.de> wrote: > Stefan Neufeind wrote: > > >I'll try to dig a bit deeper into > docbook-generation using > >OpenOffice. Maybe there is a way that we can hack > special XSLT-files > >that are used in OpenOffice as templates. > > > > > The problem is deeper - not on application level, it > is on the > XML-Parser level. > Entities are part of the DTD and already resolved, > if you access a XML > document by SAX or DOM. So it is also too late for > any XSLT actions. > If i rember right the Jave XML-API gives you a > callback-based > possibiltiy for evaluting entities manualy in a > limited way, > this could be a solution for OO. > > In general this problem can not be solved by an > userland implementation, > until you understand implementing > a XML parser as a part of the userland. > > -- > 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!? SBC Yahoo! - Internet access at a great low price. http://promo.yahoo.com/sbc/

« previous php.pear.doc (#3981) next »