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