Some ruminations -- Re: [PEAR-DOC] Upgrading to Docbook 4.3
| From: | Jesus M. Castagnetto | 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/