Text_Wiki doc ... DocBook

bertrand Gugger <[email protected]> Sat, 04 Feb 2006 12:46:02 +0100
Newsgroups gmane.comp.php.pear.devel,gmane.mail.eyebrowse.user
Message-ID <[email protected]>
Bonjour,
As announced, I started a DocBook renderer for Text_Wiki.
I currently did the initial revisions for 35 rules (classes) among the 
45 to do (78% done :) )
You can see the progress here : 
http://cvs.php.net/viewcvs.cgi/pear/Text_Wiki/Text/Wiki/Render/Docbook/
I would be very happy if some DocBook gurus could take a look and 
correct me or suggest better ways.
It must be noted that DocBook is essentially semantic, does not normally 
care of the pure rendering of the document. So several rules as, e.g., 
Italic or Box, are not meaningful for Docbook. For those rules, I simply 
used some <emphasis>, <phrase> or <para> element with a 'role' (and 
exceptionally a 'condition') common attribute(s) specifying the initial 
goal of the element. The intention is to enable some specific CSS to 
possibly render them.

Now, why such a renderer ? Simply to enable the conversion of any wiki 
(or bbcode) syntax implemented in Text_Wiki to well-formed DocBook. I 
don't expect to get some 100% full conversions but at least to much ease 
them.
I hope it to help picking some interesting wiki pieces to integrate them 
in some DocBook documentation.

For Text_Wiki itself, the intention is to enable some "copy" of the 
official wiki doc to integrate it in the PEAR manual.
However, I consider that the official, primary doc should stay as it is 
in the wiki format, as it is still much easier to manage. This DocBook 
production would only be some rendering of it.

** Paul **
A practical question, could you enable me to update this wiki 
http://wiki.ciaweb.net/yawiki/index.php?area=Text_Wiki ?
First to actualize it, we have several new rules and configs, also we 
need some pages for all extensions as BBCode or Tiki (or this Docbook :) )
Secondly, to start some experiments, in real size, of such DocBook 
production.

Any comment / suggestion / correction / test greatly appreciated.
Merci
à+
-- 
toggg

-- 
PEAR Development Mailing List (http://pear.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php